### ### # 10 Cookies used by Zabbix # 10 Cookies emprades per Zabbix # 10 Discovery using WMI queries # 10 Descoberta emprant consultes WMI # 10 Graph prototype # 10 Prototipus de gràfic # 10 Graph prototype # 10 Prototipus de gràfic # 10 Inclusion # 10 Inclusió # 10 IPMI agent # 10 Verificacions IPMI # 10 Notes on selecting processes in proc.mem and proc.num items # 10 Notes sobre la selecció de processos als elements proc.mem i proc.num # 10 Notifications upon events # 10 Notificacions dels esdeveniments # 10 Oracle plugin # 10 Plugin d'Oracle # 10 Queue # 10 Cua # 10 Upgrade notes for 6.0.0 These notes are for upgrading from Zabbix 5.4.x to Zabbix 6.0.0. All notes are grouped into: - `Critical` - the most critical information related to the upgrade process and the changes in Zabbix functionality - `Informational` - all remaining information describing the changes in Zabbix functionality It is possible to upgrade to Zabbix 6.0.0 from versions before Zabbix 5.4.0. See the [upgrade procedure](/manual/installation/upgrade) section for all relevant information about upgrading from previous Zabbix versions. # 10 Notes d'actualització per 6.0.0 Aquestes notes són per actualitzar de Zabbix 5.4.x a Zabbix 6.0.0. Totes les notes s'agrupen en: - `Critical`: la informació més crítica relacionada amb el procés d'actualització i els canvis de funcions de Zabbix - `Informal`: tota la informació restant que descriu els canvis a la funcionalitat de Zabbix És possible actualitzar a Zabbix 6.0.0 des de versions anteriors a Zabbix 5.4.0. Veieu la secció [procediment d'actualització](/manual/installation/upgrade) per obtindre tota la informació rellevant sobre l'actualització de versions anteriors de Zabbix. # 10 Version compatibility # 10 Compatibilitat de versió # 10. Virtual machine monitoring # 10. Monitoratge de màquines virtuals # 10 What's new in Zabbix 6.0.5 # 10 Què hi ha de nou al Zabbix 6.0.5 # 10 Zabbix agent on Microsoft Windows # 10 Agent Zabbix per a Microsoft Windows # 11 Database error handling If Zabbix detects that the backend database is not accessible, it will send a notification message and continue the attempts to connect to the database. For some database engines, specific error codes are recognized. # 11 Gestió dels errors de base de dades Si Zabbix troba que la base de dades principals no és pas accessible, enviarà un missatge de notificació i seguirà provant de connectar a la base de dades. Per alguns motors de base de dades, els codis d'error específics són reconeguts. # 11 Discovery using ODBC SQL queries # 11 Descoberta emprant consultes ODBC SQL # 11 Host availability # 11 Disponibilitat de l'equip # 11 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. # 11 Detalls d'implementació de les verificacions net.tcp.service i net.udp.service La implementació de les verificacions de net.tcp.service i net.udp.service ve detallada en aquesta pàgina pels diferents serveis especificats al paràmetre del servei. # 11 Macros # 11 Macros # 11. Maintenance # 11. Manteniment # 11 PostgreSQL plugin # 11 Plugin de PostgreSQL # 11 SAML setup with Microsoft Entra ID # 11 Configuració de SAML amb Microsoft Entra ID # 11 SSH agent # 11 Verificacions SSH # 11 Time zones # 11 Fusos horaris # 11 Upgrade notes for 6.0.1 # 11 Notes d'actualització per 6.0.1 # 11 Value cache # 11 Cau de valor # 11 What's new in Zabbix 6.0.6 # 11 Què hi ha de nou al Zabbix 6.0.6 # 12 Discovery using Prometheus data # 12 Descoberta emprant dades de Prometheus # 12 Execute now # 12 Executar ara # 12 Item value # 12 Valor dels elements # 12 Item value # 12 Valor dels elements # 12 Redis plugin # 12 Plugin de Redis # 12. Regular expressions # 12. Expressions regulars # 12 Resetting password # 12 Restablir el mot de pas # 12 SAML setup with Okta This section describes how to configure Okta to enable SAML 2.0 authentication for Zabbix. # 12 Configuració de SAML amb Okta Aquesta secció descriu com configurar Okta per habilitar l'autenticació SAML 2.0 per a Zabbix. # 12 Telnet agent # 12 Verificacions Telnet # 12 Unreachable/unavailable host interface settings # 12 Paràmetres de la interfície de l'equip inaccessibles/indisponibles # 12 Upgrade notes for 6.0.2 This minor version doesn't have any upgrade notes. # 12 Comentaris d'actualització a la versió 6.0.2 Aquesta actualització és una versió menor i no té pas comentaris. # 12 Users and user groups # 12 Usuaris i grups d'usuaris # 12 What's new in Zabbix 6.0.7 # 12 Què hi ha de nou al Zabbix 6.0.7 # 12 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. See also [known issues](/manual/installation/known_issues#missing-files-in-windows-agent-archive). **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. # 12 Biblioteca d'enllaços dinàmics del remitent Zabbix per a Windows #### Vista general En un entorn Windows, les aplicacions poden enviar dades a Zabbix servidor/proxy mitjançant la biblioteca d'enllaços dinàmics del remitent Zabbix (zabbix\_sender.dll) en lloc d'haver de llançar un procés extern (zabbix\_sender.exe). zabbix_sender.h i zabbix_sender.lib calen per compilar aplicacions d'usuari amb zabbix_sender.dll. #### Aconseguir-los Hi ha dues maneres d'obtindre zabbix_sender.dll. **1.** [Descarregar](https://www.zabbix.com/download_agents) els fitxers zabbix_sender.h, zabbix_sender.lib i zabbix_sender.dll com a arxiu ZIP. Quan trieu les opcions de descàrrega, assegureu-vos de triar "Sense xifrat" a *Xifrat* i "Arxiu" a *Paquet*. A continuació, descarregueu l'agent Zabbix (no pas l'agent Zabbix 2). Els fitxers zabbix_sender.h, zabbix_sender.lib i zabbix_sender.dll seran dins de l'arxiu ZIP descarregat al directori `bin\dev`. Descomprimiu els fitxers on us calgui. Veieu també els [problemes coneguts](/manual/installation/known_issues#missing-files-in-windows-agent-archive). **2.** Creeu zabbix_sender.dll des de la font (llegiu les [instruccions](/manual/installation/install/win_agent#overview)). Trobareu la biblioteca d'enllaços dinàmics amb els fitxers de desenvolupament al directori `bin\winXX\dev`. Per emprar-lo, incloeu la capçalera zabbix_sender.h fitxer i enllaç amb la biblioteca zabbix_sender.lib. #### Veieu també - [exemple](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/build/win32/examples/zabbix_sender/sender.c) d'una senzilla utilitat de remitent de Zabbix implementada amb la biblioteca d'enllaços dinàmics de remitent de Zabbix per entendre l'ús de la biblioteca; - Fitxer [zabbix_sender.h](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/zabbix_sender/win32/zabbix_sender.h) per a les funcions d'interfície de la biblioteca d'enllaços dinàmics de Zabbix sender. Aquest fitxer conté documentació que explica el propòsit de cada funció d'interfície, els seus arguments i el valor de retorn. # 13 Discovery of block devices In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover block devices and their type. # 13 Descoberta de perifèric de bloc De la mateixa manera que es descobreixen [sistemes de fitxers](/manual/discovery/low_level_discovery#configuring_low-level_discovery), també és possible descobrir dispositius de bloc i el seu tipus. # 13 JMX agent # 13 Agent JMX # 13 Map # 13 Mapa # 13 Map # 13 Mapa # 13 Oracle database setup # 13 Configuració de la base de dades Oracle # 13. Problem acknowledgment # 13. Reconeixement del problema # 13 Python library for Zabbix API # 13 Biblioteca de Python per a l'API Zabbix # 13 Remote monitoring of Zabbix stats # 13 Monitoratge remot de es estadístiques de Zabbix # 13 Restricting agent checks # 13 Restringir les verificacions de l'agent # 13 SMART plugin # 13 Plugin SMART # 13 Storage of secrets # 13 Emmagatzematge de secrets # 13 Upgrade notes for 6.0.3 This minor version doesn't have any upgrade notes. # 13 Comentaris d'actualització a la versió 6.0.3 Aquesta actualització és una versió menor i no té pas comentaris. # 13 What's new in Zabbix 6.0.8 # 13 Què hi ha de nou al Zabbix 6.0.8 # 14 Calculated item # 14 Elements calculats # 14. Configuration export/import # 14. Exportació i importació de la configuració # 14 Configuring Kerberos with Zabbix # 14 Configurar Kerberos amb Zabbix # 14 Discovery of host interfaces in Zabbix # 14 Descoberta d'interfícies d'equips a Zabbix # 14 Map navigation tree # 14 Arbre de navegació del mapa # 14 Map navigation tree # 14 Arbre de navegació del mapa # 14 Plugins # 14 Plugins # 14 Scheduled reports # 14 Informes programats # 14 Service monitoring upgrade # 14 Actualització del monitoratge dels serveis # 14 Setting up scheduled reports # 14 Configuració dels informes programats # 14 Upgrade notes for 6.0.4 This minor version doesn't have any upgrade notes. # 14 Comentaris d'actualització a la versió 6.0.4 Aquesta actualització és una versió menor i no té pas comentaris. # 14 What's new in Zabbix 6.0.9 # 14 Què hi ha de nou al Zabbix 6.0.9 # 15 Additional frontend languages # 15 Llengües d'interfície Web addicionals # 15 Dependent item # 15 Element dependent # 15. Discovery Please use the sidebar to access content in the Discovery section. # 15. Descoberta Empreu la barra lateral per accedir al contingut de la secció de Descoberta. # 15 modbus.get parameters # 15 Paràmetres de modbus.get # 15 Other issues # 15 Altres problemes # 15 Plain text # 15 Text pla # 15 Plain text # 15 Text pla # 15 Upgrade notes for 6.0.5 # 15 Comentaris d'actualització a la versió 6.0.5 # 15 What's new in Zabbix 6.0.10 # 15 Què hi ha de nou al Zabbix 6.0.10 # 16 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/config/items/loadablemodules) in C.|Custom [plugins](/manual/config/items/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. Note that 3.0.x is supported since Zabbix 6.0.4.<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 is supported since Zabbix 4.4.8.<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.| |Scheduled/flexible intervals|Supported for passive checks only.|Supported for passive and active checks.| |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.| |Timeout settings|Defined on an agent level only.|Plugin timeout can override the timeout defined on an agent level.| |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) # 16 Diferències entre l'agent i l'agent 2 Aquesta secció descriu les diferències entre l'agent de Zabbix i l'agent 2 de Zabbix. |Paràmetre|Agent|Agent 2| |--|------|------| |Llenguatge de programació|C|Go amb algunes parts en C| |Demonització|sí|només per systemd (sí a Windows)| |Extensions permeses|[mòduls carregables](/manual/config/items/loadablemodules) personalitzats, en C.|[Plugins](/manual/config/items/plugins) en Go.| |*Requeriments*|<|<| |Plataformes admeses|Linux, IBM AIX, FreeBSD, NetBSD, OpenBSD, HP-UX, Mac OS X, Solaris: 9, 10, 11, Windows: totes les versions de servidor i client des de XP|Linux, Windows: totes les versions de servidor i client, on s'hi pugui instal·lar l'actualització de la [versió de Go suportada](/manual/installation/requirements#agent-2).| |Biblioteques criptogràfiques admeses|GnuTLS 3.1.18 i posteriors<br>OpenSSL 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x. Veieu que la versió 3.0.x és admesa des de Zabbix 6.0.4.<br>LibreSSL - provat amb les versions 2.7.4, 2.8.2 (amb algunes limitacions; per a més detalls, veieu la pàgina [Encriptació](/manual/encryption#compiling_zabbix_with_encryption_support)).|Linux: es suporta la versió 1.0.1 i posteriors d'OpenSSL des de Zabbix 4.4.8.<br>MS Windows: OpenSSL 1.1.1 o superior.<br>La biblioteca OpenSSL ha de tindre el suport PSK activat. No es suporta pas LibreSSL.| |Processos de monitoratge|<|<| |Processos|Un procés de verificació actiu diferent per cada registre de servidor/proxy.|Processos únics amb els fils creats automàticament.<br>El nombre màxim de fils ve donat per la variable d'entorn GOMAXPROCS.| |Mètriques|**UNIX**: veieu la llista d'[elements](/manual/config/items/itemtypes/zabbix_agent) admesos.<br><br>**Windows**: veieu la llista d'altres [elements](/manual/config/items/itemtypes/zabbix_agent/win_keys) específics de Windows.|**UNIX**: Totes les mètriques suportades per l'agent de Zabbix.<br>A més, l'agent 2 proporciona una solució de monitoratge nadiu de Zabbix per a: Docker, Memcached, MySQL, PostgreSQL, Redis, systemd, i altres sistemes - veieu la llista sencera dels [elements](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) específics de l'agent 2.<br><br>**Windows**: Totes les mètriques suportades per l'agent de Zabbix, així com les verificacions net.tcp.service\* d'HTTPS, LDAP.<br>A més, l'agent 2 proporciona una solució de monitoratge nadiua per a: PostgreSQL, Redis.| |Concurrència|Les verificacions actives per a un sol servidor s'executen de manera sequencial.|Les verificacions de diferents plugins o altres verificacions d'un plugin permeten executar-se simultàniament.| |Intervals programats/flexibles|Només admet les verificacions passives.|Admet verificacions passives i actives.| |Traces de tercers|no|sí| |*Funcionalitats suplementàries*|<|<| |Emmagatzematge persistent|no|sí| |Arxius persistents per les mètriques log\*\[\] metrics|sí (només sota Unix)|no| |Càrrega de dades de registre|Es pot fer durant la recopilació de registres per alliberar la memòria intermèdia.|La recopilació de registres s'atura quan la memòria intermèdia és plena, per tant, el paràmetre [BufferSize](/manual/appendix/config/zabbix_agent2) ha de ser com a mínim MaxLinesPerSecond x 2 .| |Paràmetres de temps d'espera|Definits a nivell de l'agent, només.|El temps d'espera del plugin pot substituir el temps de caducitat definit a nivell de l'agent.| |Canviar d'usuari quan s'executa|sí (només amb sistemes de tipus Unix)|no (controlat per systemd)| |Suites de xifrat configurables per l'usuari|sí|no| **Veieu també:** - *Descripció dels processos de Zabbix*: [agent Zabbix](/manual/concepts/agent), [agent 2 Zabbix](/manual/concepts/agent2) - *Paràmetres de configuració*: agent Zabbix [UNIX](/manual/appendix/config/zabbix_agentd) / [Windows](/manual/appendix/config/zabbix_agentd_win), agent 2 Zabbix [UNIX](/manual/appendix/config/zabbix_agent2) / [Windows](/manual/appendix/config/zabbix_agent2_win) # 16 Creating custom performance counter names for VMware # 16 Creació de noms de comptadors de rendiment personalitzats per VMware # 16. Distributed monitoring # 16. Monitoratge distribuït # 16 Issues with SELinux Socket-based inter-process communication has been added since Zabbix 3.4. On systems where SELinux is enabled it may be required to add SELinux rules to allow Zabbix create/use UNIX domain sockets in the `SocketDir` directory. Currently socket files are used by server (alerter, preprocessing, IPMI) and proxy (IPMI). Socket files are persistent, meaning are present while the process is running. # 16 Problemes amb SELinux La comunicació entre processos basada en els sockets s'ha afegit des de Zabbix 3.4. Sota sistemes on SELinux és actiu, podria caldre afegir les regles SELinux per permetre que Zabbix crei/empri els sockets de domini UNIX al directori "SocketDir". Actualment, els arxius de socket s'empren per el servidor (alertes, pretractament, IPMI). Els arxius de socket són persistents; vol dir que són presents durant l'execució de processos. # 16 Problem hosts # 16 Equips amb problemes # 16 Problem hosts # 16 Equips amb problemes # 16 Script item # 16 Elements d'script # 16 Upgrade notes for 6.0.6 # 16 Notes d'actualització de la versió 6.0.6 # 16 What's new in Zabbix 6.0.11 # 16 Què hi ha de nou al Zabbix 6.0.11 # 17. Encryption # 17. Xifrat # 17 Escaping examples # 17 Exemples d'escapament # 17 Notes on system.cpu.util items on Windows # 17 Notes sobre els elements system.cpu.util a Windows # 17 Problems # 17 Problemes # 17 Problems # 17 Problemes # 17 Prometheus checks # 17 Verificacions Prometheus # 17 Upgrade notes for 6.0.7 # 17 Notes d'actualització de la versió 6.0.7 # 17 What's new in Zabbix 6.0.12 # 17 Què hi ha de nou al Zabbix 6.0.13 # 18 Problems by severity # 18 Problemes per gravetat # 18 Problems by severity # 18 Problemes per gravetat # 18 Upgrade notes for 6.0.8 This minor version doesn't have any upgrade notes. # 18 Comentaris d'actualització a la versió 6.0.8 Aquesta actualització és una versió menor i no té pas comentaris. # 18. Web interface # 18. Interfície Web # 18 What's new in Zabbix 6.0.13 # 18 Què hi ha de nou al Zabbix 6.0.13 # 19. API # 19. API # 19 SLA report # 19 Informe SLA # 19 SLA report # 19 Informe SLA # 19 Upgrade notes for 6.0.9 This minor version doesn't have any upgrade notes. # 19 Comentaris d'actualització a la versió 6.0.9 Aquesta actualització és una versió menor i no té pas comentaris. # 19 What's new in Zabbix 6.0.14 # 19 Què hi ha de nou al Zabbix 6.0.14 # 1 Action log # 1 Registre d'accions # 1 Additional JavaScript objects # 1 Objectes JavaScript addicionals # 1 Aggregate calculations # 1 Càlculs agregats # 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) 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) 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 # 1 Funcions d'afegit Excepte on s'hi especifiqui el contrari, totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Les funcions d'afegit poden funcionar amb: - l'històric d'elements, com ara `min(/host/key,1h)` - les funcions [foreach](/manual/appendix/functions/aggregate/foreach) com a paràmetre únic; com per exemple `min(last_foreach(/*/key))` (només elements calculats; no es pot pas emprar a triggers) Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb `<` `>` - Els paràmetres específics es descriuen amb cada funció - Els paràmetres `/host/key` i `(sec|#num)<:time shift>` mai han d'anar entre cometes # 1 Best practices for secure Zabbix setup # 1 Bones pràctiques per la configuració securitzada de Zabbix # 1 Building loadable plugins # 1 Construir plugins carregables # 1 Building Zabbix agent on Windows # 1 Compilar l'agent Zabbix sota Windows # 1 Ceph plugin # 1 Plugin Ceph # 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 Problemes de compilació Aquests són els problemes coneguts sobre la compilació de Zabbix des de les fonts. Per a la resta de casos, consulteu la pàgina de [problemes coneguts](/manual/installation/known_issues). # 1 Conditions # 1 Condicions # 1 Configuring a host # 1 Configuració d'un equip # 1 Configuring a network discovery rule # 1 Configurant una regla de descoberta de xarxa # 1 Configuring a network map # 1 Configurar un mapa de xarxa # 1 Configuring a template # 1 Configuració d'una plantilla # 1 Configuring a trigger # 1 Configurant un trigger # 1 Configuring a user # 1 Configurant un usuari # 1 Connection type or permission problems # 1 Tipus de connexió o problemes de permisos # 1 Creating an item # 1 Crear un element # 1 Dashboard # 1 Tauler # 1 Dashboard widgets # 1 Ginys del tauler # 1 Database creation # 1 Creació de la base de dades # 1 Debian/Ubuntu frontend installation # 1 Instal·lació del portal sobre Debian/Ubuntu # 1 Discovery of mounted filesystems # 1 Descoberta de sistemes d'arxius muntats ##### 1 Download the source archive Go to the [Zabbix download page](http://www.zabbix.com/download_sources#60LTS) and download the source archive. Once downloaded, extract the sources, by running: tar -zxvf zabbix-6.0.0.tar.gz ::: notetip Enter the correct Zabbix version in the command. It must match the name of the downloaded archive. ::: ##### 1 Descàrrega de l'arxiu font Accediu al [lloc web de descàrrega de Zabbix](http://www.zabbix.com/download_sources#60LTS) i descarregueu l'arxiu font. Un cop descarregat, descomprimiu la font executant: tar -zxvf zabbix-6.0.0.tar.gz ::: notetip Poseu la versió correcta de Zabbix a la comanda. Ha de correspondre amb el nom de l'arxiu descarregat. ::: # 1 Dynamic indexes # 1 Index dinàmics # 1 E-mail # 1 Correu-e # 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 Escapar caràcters especials dels valors de macro LLD a JSONPath Quan s'empren macros de descoberta de baix nivell en el preprocessament de JSONPath i es resolen els seus valors, s'apliquen les regles d'escapament de caràcters especials següents: - només les barres invertides (\\) i les cometes dobles ("") es consideren per escapar; - si el valor de la macro resolta conté aquests caràcters, cadascun d'ells s'escapa amb una barra invertida (/); - si ja s'escapa amb una barra invertida, aquesta no es considera com a escapada i la barra invertida així com els caràcters especials següents es tornen a escapar. Per exemple: |JSONPath|Valor de la macro LLD|Després de la substitució| |--------|---------------|------------------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]| |^|c:\\temp|$.\[?(@.value == "c:\\\\temp")\]| |^|a\\\\b|$.\[?(@.value == "a\\\\\\\\b")\]| Quan s'empra a l'expressió, la macro que pot contindre caràcters especials s'ha de lliurar d'entre cometes: |JSONPath|Valor de macro LLD|Després de la substitució|Resultat| |--------|---------------|------------------|------| |$.\[?(@.value == "{\#MACRO}")\]|special "value"|$.\[?(@.value == "special \\"value\\"")\]|OK| |$.\[?(@.value == {\#MACRO})\]|^|$.\[?(@.value == special \\"value\\")\]|**Bad JSONPath expression**| Quan s'empra al camí, la macro que pot contindre caràcters especials s'ha de lliurar entre claudàtors **i** cometes: |JSONPath|Valor de macro LLD|Després de la substitució|Resultat| |--------|---------------|------------------|------| |$.\["{\#MACRO}"\].value|c:\\temp|$.\["c:\\\\temp"\].value|OK| |$.{\#MACRO}.value|^|$.c:\\\\temp.value|**Bad JSONPath expression**| # 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 Extensions dels agents Zabbix Aquest tutorial ofereix instruccions passa a passa per ampliar la funcionalitat de l'agent Zabbix mitjançant un [paràmetre d'usuari](/manual/config/items/userparameters). # 1 Foreach functions # 1 Funcions Foreach # 1 General # 1 General # 1 Getting Zabbix # 1 Obtenir Zabbix # 1 Global notifications # 1 Notificacions globals # 1 Graphs # 1 Gràfics # 1 Graphs # 1 Gràfics # 1 High availability # 1 Alta disponibilitat # 1 Host groups # 1 Grups d'equips # 1 Host groups In the frontend host groups can be [exported](/manual/xml_export_import) only with host or template export. When a host or template is exported all groups it belongs to are exported with it automatically. API allows to export host groups independently from hosts or templates. # 1 Grups d'equips Des de la interfície web, els grups d'equips només es poden exportar amb l'exportació d'equips o de plantilla. Quan s'exporta un equip o una plantilla, tots els grups als quals pertany s'exporten automàticament. L'API permet exportar grups d'equips independentment dels equips o plantilles. # 1 Hosts and host groups # 1 Equips i grups d'equips # 1 Installation and setup Please use the sidebar to access content in this section. # 1 Instal·lació i configuració # 1. Introduction Please use the sidebar to access content in the Introduction section. # 1. Introducció Empreu la barra lateral per accedir al contingut de la secció d'introducció. # 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 Format de clé clau d'element El format de clau d'element, inclosos els paràmetres clau, han de seguir unes regles de sintaxi. Les il·lustracions següents mostren la sintaxi admesa. Els elements i caràcters permesos a cada punt es poden determinar seguint les sagetes - si un bloc es pot assolir seguint la línia, és autoritat; cas que no, no és autoritzat. {width="600"} Per construir una clau d'element vàlida, comencem per especificar el nom de la clau, i després tenim opció de tindre-hi paràmetres o no - com il·lustren les dues línies que es poden seguir. # 1 Item keys specific to agent 2 # 1 Claus d'elements específiques de l'agent 2 # 1 Item prototypes # 1 Prototips d'elements # 1 Item prototypes # 1 Prototips d'elements # 1 Item prototypes Once a rule is created, 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.  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 Prototip d'element Un cop creada la regla, navegueu fins als elements d'aquesta regla i premeu "Crea un prototip d'element" per crear un prototip d'element. Observeu com s'empra la macro {\#FSNAME} quan es requereix un nom de sistema de fitxers. Quan es processi la regla de descoberta, aquesta macro es substituirà pel sistema de fitxers descobert.  Tant les [macros de descoberta de baix nivell](/manual/config/macros/lld_macros) com les [macros d'usuari](/manual/appendix/macros/supported_by_location_user) s'admeten a la configuració del prototip d'element i a la configuració del [preprocessament del valor de l'element](/manual/config/items/item#item_value_preprocessing). Tingueu en compte que quan s'empra en intervals d'actualització, una sola macro hauria d'omplir tot el camp. No s'admeten diverses macros en un camp o les macros barrejades amb text. :::noteclassic L'escapament específic del context de macros de descoberta de baix nivell es fa per a un ús segur en paràmetres d'expressió regular i preprocessament XPath. ::: Atributs específics dels prototips d'elements: |Paràmetre|Descripció| |--|---------| |*Crear activat*|Si és marcat, l'element s'afegirà a estat activat.<br>Si no és marcat, l'element s'afegirà a una entitat descoberta, però en estat desactivat.| |*Descoberta*|Si és marcat (per defecte), l'element s'afegirà a una entitat descoberta.<br>Si no és marcat, l'element no s'afegirà a una entitat descoberta tret que aquesta configuració sigui [substituïda](/manual/discovery/low_level_discovery#override) a la regla de descoberta.| Podem crear diversos prototips d'elements per a cada mètrica del sistema de fitxers que ens interessa:  Feu clic a la icona de tres punts per obrir el menú del prototip d'element específic amb aquestes opcions:<br> - *Crear un prototip de trigger* - crea un prototip de trigger basat en aquest prototip d'element - *Prototips de triggers* - feu clic per veure una llista amb enllaços a prototips de triggers ja configurats d'aquest prototip d'element - *Crea un element dependent* - crea un element dependent per a aquest prototip d'element L'opció d'*[actualització massiva](/manual/config/items/itemupdate#using_mass_update)* és disponible si voleu actualitzar les propietats de diversos prototips d'elements alhora. # 1 Items # 1 Elements # 1 Items # 1 Elements # 1 Items supported by platform The table displays support for Zabbix [agent items](/manual/config/items/itemtypes/zabbix_agent) on various platforms: - Items marked with "**X**" are supported, the ones marked with "**-**" are not supported. - If an item is marked with "**?**", it is not known whether it is supported or not. - If an item is marked with "**r**", it means that it requires root privileges. - Parameters that are included in angle brackets **<**like\_this**>** are optional. ::: noteclassic [Windows-only](/manual/config/items/itemtypes/zabbix_agent/win_keys) Zabbix agent items are not included in this table. ::: | | | | | | | | | | | | | | |---|---|---|---|---|---|---|---|---|---|---|---|---| |NetBSD|<|<|<|<|<|<|<|<|<|<|<|▼▼| |OpenBSD|<|<|<|<|<|<|<|<|<|<|▼▼|^| |Mac OS X|<|<|<|<|<|<|<|<|<|▼▼|^|^| |Tru64|<|<|<|<|<|<|<|<|▼▼|^|^|^| |AIX|<|<|<|<|<|<|<|▼▼|^|^|^|^| |HP-UX|<|<|<|<|<|<|▼▼|^|^|^|^|^| |Solaris|<|<|<|<|<|▼▼|^|^|^|^|^|^| |FreeBSD|<|<|<|<|▼▼|^|^|^|^|^|^|^| |Linux 2.6 (and later)|<|<|<|▼▼|^|^|^|^|^|^|^|^| |Linux 2.4|<|<|▼▼|^|^|^|^|^|^|^|^|^| |Windows|<|▼▼|^|^|^|^|^|^|^|^|^|^| |▼ Item ▼|<|1|2|3|4|5|6|7|8|9|10|11| |**agent.hostmetadata**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.hostname**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.ping**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.variant**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.version**|<|X|X|X|X|X|X|X|X|X|X|X| |**kernel.maxfiles**|<|\-|X|X|X|\-|\-|\-|?|X|X|X| |**kernel.maxproc**|<|\-|\-|X|X|X|\-|\-|?|X|X|X| |**kernel.openfiles**|<|\-|X|X|?|?|?|?|?|?|?|?| |**log\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**log.count\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt.count\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**modbus.get\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]**|<|X|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.dns\[<ip>,zone,<type>,<timeout>,<count>,<protocol>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.dns.record\[<ip>,zone,<type>,<timeout>,<count>,<protocol>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.if.collisions\[if\]**|<|\-|X|X|X|X|\-|X|\-|X|X|r| |**net.if.discovery**|<|X|X|X|X|X|X|X|\-|\-|X|X| |**net.if.in\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|X|\-|X|\-|\-|X|X|r| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|frame|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|multicast|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.out\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|collision|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|carrier|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.total\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(default)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.tcp.listen\[port\]**|<|X|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.tcp.port\[<ip>,port\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.udp.listen\[port\]**|<|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.udp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**proc.cpu.util\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]**|<|\-|X|X|\-|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|\-|\-|\-|\-|\-| |*type* ▲|total *(default)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|user|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|system|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(default)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*zone* ▲|current *(default)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**proc.mem\[<name>,<user>,<mode>,<cmdline><memtype>\]**|<|\-|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|X|X|\-|X|X| |*mode* ▲|sum *(default)*|\-|X|X|X|X|\-|X|X|\-|X|X| |^|avg|\-|X|X|X|X|\-|X|X|\-|X|X| |^|max|\-|X|X|X|X|\-|X|X|\-|X|X| |^|min|\-|X|X|X|X|\-|X|X|\-|X|X| |*memtype* ▲|<|\-|X|X|X|X|\-|X|\-|\-|\-|\-| |**proc.num\[<name>,<user>,<state>,<cmdline>,<zone>\]**|<|X|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|\-|X|X| |*state* ▲|all *(default)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|disk|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|sleep|\-|X|X|X|X|X|X|X|\-|X|X| |^|zomb|\-|X|X|X|X|X|X|X|\-|X|X| |^|run|\-|X|X|X|X|X|X|X|\-|X|X| |^|trace|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |*cmdline* ▲|<|\-|X|X|X|X|X|X|X|\-|X|X| |*zone* ▲|current *(default)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**sensor\[device,sensor,<mode>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|X|\-| |**system.boottime**|<|\-|X|X|X|X|\-|\-|\-|X|X|X| |**system.cpu.discovery**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.intr**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.load\[<cpu>,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*cpu* ▲|all *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|percpu|X|X|X|X|X|X|X|\-|X|X|X| |*mode* ▲|avg1 *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|avg5|X|X|X|X|X|X|X|X|X|X|X| |^|avg15|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.num\[<type>\]**|<|X|X|X|X|X|X|X|\-|X|X|X| |*type* ▲|online *(default)*|X|X|X|X|X|X|X|\-|X|X|X| |^|max|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**system.cpu.switches**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.util\[<cpu>,<type>,<mode>,<logical\_or\_physical>\]**|<|X|X|X|X|X|X|X|X|\-|X|X| |*type* ▲|user *(default)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|nice|\-|X|X|X|\-|X|\-|X|\-|X|X| |^|idle|\-|X|X|X|X|X|X|X|\-|X|X| |^|system *(default for Windows)*|X|X|X|X|X|X|X|X|\-|X|X| |^|iowait|\-|\-|X|\-|X|\-|X|\-|\-|\-|\-| |^|interrupt|\-|\-|X|X|\-|\-|\-|\-|\-|X|\-| |^|softirq|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|steal|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest\_nice|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(default)*|X|X|X|X|X|X|X|X|\-|X|X| |^|avg5|X|X|X|X|X|X|X|\-|\-|X|X| |^|avg15|X|X|X|X|X|X|X|\-|\-|X|X| |*logical\_or\_physical* ▲|logical *(default)*|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|physical|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**system.hostname\[<type>,<transform>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.hw.chassis\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.cpu\[<cpu>,<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.devices\[<type>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.macaddr\[<interface>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.localtime\[<type>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*type* ▲|utc *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|local|X|X|X|X|X|X|X|X|X|X|X| |**system.run\[command,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|wait *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|nowait|X|X|X|X|X|X|X|X|X|X|X| |**system.stat\[resource,<type>\]**|<|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |**system.sw.arch**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.sw.os\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.sw.packages\[<regexp>,<manager>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.swap.in\[<device>,<type>\]**<br>*(specifying a device is only supported under Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(pages will only work if<br>device was not specified)*|count *(default under all except Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(default under Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.out\[<device>,<type>\]**<br>*(specifying a device is only supported under Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(pages will only work if<br>device was not specified)*|count *(default under all except Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(default under Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.size\[<device>,<type>\]**<br>*(specifying a device is only supported under FreeBSD, for other platforms must be empty or "all")*|<|X|X|X|X|X|\-|X|X|\-|X|\-| |*type* ▲|free *(default)*|X|X|X|X|X|\-|X|X|\-|X|\-| |^|total|X|X|X|X|X|\-|X|X|\-|X|\-| |^|used|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pfree|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pused|X ^**[6](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|\-|X|X|\-|X|\-| |**system.uname**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.uptime**|<|X|X|X|X|X|\-|X|?|X|X|X| |**system.users.num**|<|\-|X|X|X|X|X|X|X|X|X|X| |**systemd.unit.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.get**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.info**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.dev.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.read\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(default for OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(default for Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(default for Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(default for FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible only with<br>type in: sps, ops, bps)*|avg1 *(default)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.write\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(default for OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(default for Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(default for Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(default for FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible only with<br>type in: sps, ops, bps)*|avg1 *(default)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dir.count\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.get\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.size\[dir,<regex\_incl>,<regex\_excl>,<mode>,<max\_depth>,<regex\_excl\_dir>\]**|<|X|X|X|?|?|?|?|?|?|?|?| |**vfs.file.cksum\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.contents\[file,<encoding>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.exists\[file,<types\_incl>,<types\_excl>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.get\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.md5sum\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.owner\[file,<ownertype>,<resulttype>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.permissions\[file\]**|<|\-|X|X|?|?|?|?|?|?|?|?| |**vfs.file.regexp\[file,regexp,<encoding>,<start line>,<end line>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.regmatch\[file,regexp,<encoding>,<start line>,<end line>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.size\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.file.time\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|modify *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|access|X|X|X|X|X|X|X|X|X|X|X| |^|change|X^**[5](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.discovery**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.get**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.inode\[fs,<mode>\]**|<|\-|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|\-|X|X|X|X|X|X|X|X|X|X| |^|free|\-|X|X|X|X|X|X|X|X|X|X| |^|used|\-|X|X|X|X|X|X|X|X|X|X| |^|pfree|\-|X|X|X|X|X|X|X|X|X|X| |^|pused|\-|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.size\[fs,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pfree|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |**vm.memory.size\[<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(default)*|X|X|X|X|X|X|X|X|X|X|X| |^|active|\-|\-|\-|X|\-|X|\-|\-|X|X|X| |^|anon|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|buffers|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|cached|X|X|X|X|\-|\-|X|\-|\-|X|X| |^|exec|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|file|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|inactive|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|pinned|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|shared|\-|X|\-|X|\-|\-|\-|\-|\-|X|X| |^|wired|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |^|available|X|X|X|X|X|X|X|X|X|X|X| |^|pavailable|X|X|X|X|X|X|X|X|X|X|X| |**web.page.get\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.perf\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.regexp\[host,<path>,<port>,regexp,<length>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| ::: notetip See also a description of [vm.memory.size parameters](vm.memory.size_params). ::: # 1 Elements suportats per la plataforma La taula de sota mostra el suport dels [elements de l'agent Zabbix](/manual/config/items/itemtypes/zabbix_agent) sota les diferents plataformes: - Els elements marcats amb "**X**" tenen suport, aquells marcats amb "**-**" no es tenen pas. - Si un element és marcat amb "** ?**", no sabem si té suport o no. - Si un element és marcat amb "**r**", vol dir que calen privilegis de root. - Els paràmetres entre claus angulars **<**comme\_ceci**>** són opcionals. ::: noteclassic Els elements [només de Windows](/manual/config/items/itemtypes/zabbix_agent/win_keys) de l'agent Zabbix no són pas inclosos en aquestsa taula. ::: | | | | | | | | | | | | | | |---|---|---|---|---|---|---|---|---|---|---|---|---| |NetBSD|<|<|<|<|<|<|<|<|<|<|<|▼▼| |OpenBSD|<|<|<|<|<|<|<|<|<|<|▼▼|^| |Mac OS X|<|<|<|<|<|<|<|<|<|▼▼|^|^| |Tru64|<|<|<|<|<|<|<|<|▼▼|^|^|^| |AIX|<|<|<|<|<|<|<|▼▼|^|^|^|^| |HP-UX|<|<|<|<|<|<|▼▼|^|^|^|^|^| |Solaris|<|<|<|<|<|▼▼|^|^|^|^|^|^| |FreeBSD|<|<|<|<|▼▼|^|^|^|^|^|^|^| |Linux 2.6 (i versions posteriors)|<|<|<|▼▼|^|^|^|^|^|^|^|^| |Linux 2.4|<|<|▼▼|^|^|^|^|^|^|^|^|^| |Windows|<|▼▼|^|^|^|^|^|^|^|^|^|^| |▼ Item ▼|<|1|2|3|4|5|6|7|8|9|10|11| |**agent.hostmetadata**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.hostname**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.ping**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.variant**|<|X|X|X|X|X|X|X|X|X|X|X| |**agent.version**|<|X|X|X|X|X|X|X|X|X|X|X| |**kernel.maxfiles**|<|\-|X|X|X|\-|\-|\-|?|X|X|X| |**kernel.maxproc**|<|\-|\-|X|X|X|\-|\-|?|X|X|X| |**kernel.openfiles**|<|\-|X|X|?|?|?|?|?|?|?|?| |**log\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**log.count\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**logrt.count\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]**|<|X^**[4](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |*persistent\_dir* ▲|<|\-|X|X|X|X|X|X|X|X|X|X| |**modbus.get\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]**|<|X|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.dns\[<ip>,zone,<type>,<timeout>,<count>,<protocol>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.dns.record\[<ip>,zone,<type>,<timeout>,<count>,<protocol>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.if.collisions\[if\]**|<|\-|X|X|X|X|\-|X|\-|X|X|r| |**net.if.discovery**|<|X|X|X|X|X|X|X|\-|\-|X|X| |**net.if.in\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(par défaut)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|X|\-|X|\-|\-|X|X|r| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|frame|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|multicast|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.out\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(per defecte)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|collision|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|carrier|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.if.total\[if,<mode>\]**|<|X|X|X|X|X|X ^**[1](/manual/appendix/items/supported_by_platform#footnotes)**^|X|\-|X|X|r| |*mode* ▲|bytes *(per defecte)*|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|packets|X|X|X|X|X|X|X|\-|X|X|r| |^|errors|X|X|X|X|X ^**[2](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|X|X|r| |^|dropped|X|X|X|\-|\-|X|\-|\-|\-|\-|\-| |^|overruns|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|compressed|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.tcp.listen\[port\]**|<|X|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.tcp.port\[<ip>,port\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.tcp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**net.udp.listen\[port\]**|<|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**net.udp.service\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.service.perf\[service,<ip>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**net.udp.socket.count\[<laddr>,<lport>,<raddr>,<rport>,<state>\]**|<|X^**[7](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**proc.cpu.util\[<name>,<user>,<type>,<cmdline>,<mode>,<zone>\]**|<|\-|X|X|\-|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|\-|\-|\-|\-|\-| |*type* ▲|total *(per defecte)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|user|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|system|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(per defecte)*|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|\-|X|\-|\-|\-|\-|\-|\-| |*zone* ▲|current *(per defecte)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**proc.mem\[<name>,<user>,<mode>,<cmdline><memtype>\]**|<|\-|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|\-|X|X|\-|X|X| |*mode* ▲|sum *(per defecte)*|\-|X|X|X|X|\-|X|X|\-|X|X| |^|avg|\-|X|X|X|X|\-|X|X|\-|X|X| |^|max|\-|X|X|X|X|\-|X|X|\-|X|X| |^|min|\-|X|X|X|X|\-|X|X|\-|X|X| |*memtype* ▲|<|\-|X|X|X|X|\-|X|\-|\-|\-|\-| |**proc.num\[<name>,<user>,<state>,<cmdline>,<zone>\]**|<|X|X|X|X|X ^**[3](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|\-|X|X| |*state* ▲|all *(per defecte)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|disk|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|sleep|\-|X|X|X|X|X|X|X|\-|X|X| |^|zomb|\-|X|X|X|X|X|X|X|\-|X|X| |^|run|\-|X|X|X|X|X|X|X|\-|X|X| |^|trace|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |*cmdline* ▲|<|\-|X|X|X|X|X|X|X|\-|X|X| |*zone* ▲|current *(per defecte)*|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |^|all|\-|\-|\-|\-|X|\-|\-|\-|\-|\-|\-| |**sensor\[device,sensor,<mode>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|X|\-| |**system.boottime**|<|\-|X|X|X|X|\-|\-|\-|X|X|X| |**system.cpu.discovery**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.intr**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.load\[<cpu>,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*cpu* ▲|all *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|percpu|X|X|X|X|X|X|X|\-|X|X|X| |*mode* ▲|avg1 *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|avg5|X|X|X|X|X|X|X|X|X|X|X| |^|avg15|X|X|X|X|X|X|X|X|X|X|X| |**system.cpu.num\[<type>\]**|<|X|X|X|X|X|X|X|\-|X|X|X| |*type* ▲|online *(per defecte)*|X|X|X|X|X|X|X|\-|X|X|X| |^|max|\-|X|X|X|X|\-|\-|\-|X|\-|\-| |**system.cpu.switches**|<|\-|X|X|X|X|\-|X|\-|\-|X|X| |**system.cpu.util\[<cpu>,<type>,<mode>,<logical\_or\_physical>\]**|<|X|X|X|X|X|X|X|X|\-|X|X| |*type* ▲|user *(par défaut)*|\-|X|X|X|X|X|X|X|\-|X|X| |^|nice|\-|X|X|X|\-|X|\-|X|\-|X|X| |^|idle|\-|X|X|X|X|X|X|X|\-|X|X| |^|system *(per defecte sota Windows)*|X|X|X|X|X|X|X|X|\-|X|X| |^|iowait|\-|\-|X|\-|X|\-|X|\-|\-|\-|\-| |^|interrupt|\-|\-|X|X|\-|\-|\-|\-|\-|X|\-| |^|softirq|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|steal|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|guest\_nice|\-|\-|X|\-|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲|avg1 *(per defecte)*|X|X|X|X|X|X|X|X|\-|X|X| |^|avg5|X|X|X|X|X|X|X|\-|\-|X|X| |^|avg15|X|X|X|X|X|X|X|\-|\-|X|X| |*logical\_or\_physical* ▲|logical *(par défaut)*|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|physical|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**system.hostname\[<type>,<transform>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.hw.chassis\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.cpu\[<cpu>,<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.devices\[<type>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.hw.macaddr\[<interface>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.localtime\[<type>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*type* ▲|utc *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|local|X|X|X|X|X|X|X|X|X|X|X| |**system.run\[command,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|wait *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|nowait|X|X|X|X|X|X|X|X|X|X|X| |**system.stat\[resource,<type>\]**|<|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |**system.sw.arch**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.sw.os\[<info>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.sw.packages\[<package>,<manager>,<format>\]**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**system.swap.in\[<device>,<type>\]**<br>*(especificar un perifèric no s'admet pas sota Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(les pàgines no funcionen pas si <br>l'aparell no s'especifica)*|count *(per defecte sota tot excepte Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(per defecte sota Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.out\[<device>,<type>\]**<br>*(l'especificació d'un perifèric no és admesa excepte sota Linux)*|<|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |*type* ▲<br>*(les pàgines no funcionaran si <br>no s'ha especificat l'aparell)*|count *(per defecte sota tot excepte Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |^|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|pages *(per defecte sota Linux)*|\-|X|X|\-|X|\-|\-|\-|\-|X|\-| |**system.swap.size\[<device>,<type>\]**<br>*(l'especificació d'un perifèric només s'admet amb FreeBSD; per les altres plataformes ha d'ésser buit o "all")*|<|X|X|X|X|X|\-|X|X|\-|X|\-| |*type* ▲|free *(per defecte)*|X|X|X|X|X|\-|X|X|\-|X|\-| |^|total|X|X|X|X|X|\-|X|X|\-|X|\-| |^|used|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pfree|X|X|X|X|X|\-|X|X|\-|X|\-| |^|pused|X ^**[6](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|\-|X|X|\-|X|\-| |**system.uname**|<|X|X|X|X|X|X|X|X|X|X|X| |**system.uptime**|<|X|X|X|X|X|\-|X|?|X|X|X| |**system.users.num**|<|\-|X|X|X|X|X|X|X|X|X|X| |**systemd.unit.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.get**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**systemd.unit.info**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.dev.discovery**|<|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.read\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(per defecte sota OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(per defecte sota Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(per defecte sota Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(per defecte sota FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible només amb <br>type dans : sps, ops, bps)*|avg1 *(per defecte)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dev.write\[<device>,<type>,<mode>\]**|<|\-|X|X|X|X|\-|X|\-|\-|X|\-| |*type* ▲|sectors|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|operations *(per defecte sota OpenBSD, AIX)*|\-|X|X|X|X|\-|X|\-|\-|X|\-| |^|bytes *(per defecte sota Solaris)*|\-|\-|\-|X|X|\-|X|\-|\-|X|\-| |^|sps *(per defecte sota Linux)*|\-|X|X|\-|\-|\-|\-|\-|\-|\-|\-| |^|ops|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|bps *(per defecte sota FreeBSD)*|\-|\-|\-|X|\-|\-|\-|\-|\-|\-|\-| |*mode* ▲<br>*(compatible només amb <br>type dans : sps, ops, bps)*|avg1 *(per defecte)*|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg5|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |^|avg15|\-|X|X|X|\-|\-|\-|\-|\-|\-|\-| |**vfs.dir.count\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.get\[dir,<regex\_incl>,<regex\_excl>,<types\_incl>,<types\_excl>,<max\_depth>,<min\_size>,<max\_size>,<min\_age>,<max\_age>,<regex\_excl\_dir>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.dir.size\[dir,<regex\_incl>,<regex\_excl>,<mode>,<max\_depth>,<regex\_excl\_dir>\]**|<|X|X|X|?|?|?|?|?|?|?|?| |**vfs.file.cksum\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.contents\[file,<encoding>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.exists\[file,<types\_incl>,<types\_excl>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.get\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.md5sum\[file\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.owner\[file,<ownertype>,<resulttype>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.permissions\[file\]**|<|\-|X|X|?|?|?|?|?|?|?|?| |**vfs.file.regexp\[file,regexp,<encoding>,<start line>,<end line>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.regmatch\[file,regexp,<encoding>,<start line>,<end line>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**vfs.file.size\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| |**vfs.file.time\[file,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|modify *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|access|X|X|X|X|X|X|X|X|X|X|X| |^|change|X^**[5](/manual/appendix/items/supported_by_platform#footnotes)**^|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.discovery**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.get**|<|X|X|X|X|X|X|X|\-|X|X|X| |**vfs.fs.inode\[fs,<mode>\]**|<|\-|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(per defecte)*|\-|X|X|X|X|X|X|X|X|X|X| |^|free|\-|X|X|X|X|X|X|X|X|X|X| |^|used|\-|X|X|X|X|X|X|X|X|X|X| |^|pfree|\-|X|X|X|X|X|X|X|X|X|X| |^|pused|\-|X|X|X|X|X|X|X|X|X|X| |**vfs.fs.size\[fs,<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pfree|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |**vm.memory.size\[<mode>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |*mode* ▲|total *(per defecte)*|X|X|X|X|X|X|X|X|X|X|X| |^|active|\-|\-|\-|X|\-|X|\-|\-|X|X|X| |^|anon|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|buffers|\-|X|X|X|\-|\-|\-|\-|\-|X|X| |^|cached|X|X|X|X|\-|\-|X|\-|\-|X|X| |^|exec|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|file|\-|\-|\-|\-|\-|\-|\-|\-|\-|\-|X| |^|free|X|X|X|X|X|X|X|X|X|X|X| |^|inactive|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|pinned|\-|\-|\-|\-|\-|\-|X|\-|\-|\-|\-| |^|shared|\-|X|\-|X|\-|\-|\-|\-|\-|X|X| |^|wired|\-|\-|\-|X|\-|\-|\-|\-|X|X|X| |^|used|X|X|X|X|X|X|X|X|X|X|X| |^|pused|X|X|X|X|X|X|X|X|X|X|X| |^|available|X|X|X|X|X|X|X|X|X|X|X| |^|pavailable|X|X|X|X|X|X|X|X|X|X|X| |**web.page.get\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.perf\[host,<path>,<port>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |**web.page.regexp\[host,<path>,<port>,regexp,<length>,<output>\]**|<|X|X|X|X|X|X|X|X|X|X|X| |<|<|1|2|3|4|5|6|7|8|9|10|11| ::: notetip Veieu també una descripció de [vm.memory.size_parameters](vm.memory.size_params). ::: # 1 Login and configuring user # 1 Connexió i configuració d'usuari # 1 Macro functions # 1 Funcions de macro # 1 Manual structure # 1 Estructura del manual # 1 Media types # 1 Tipus de suport # 1 Menu # 1 Menú # 1 Monitoring # 1 Monitoratge # 1 MySQL encryption configuration [comment]: # (tags: ssl) # 1 Configuració de xifrat MySQL [comentari]: # (etiquetes: ssl) # 1 Network discovery # 1 Descoberta de xarxa # 1 Overview # 1 Vista general # 1 Prometheus check # 1 Verificacions Prometheus # 1 Proxies # 1 Proxys # 1 Recommended UnixODBC settings for MySQL # 1 Paràmetres UnixODBC recomanats per MySQL # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Red Hat Enterprise Linux # 1 Sending message # 1 Enviament de missatges # 1 Server # 1 Servidor # 1 Server-proxy data exchange protocol # 1 Protocol de bescanvi de dades servidor-proxy # 1 Services # 1 Serveis # 1 Services # 1 Serveis # 1 Service tree 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) 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 Arbre de serveis L'arbre de serveis es configura a la secció de menú *Serveis->Serveis*. A l'extrem superior dret, canvieu de [Vista](/manual/web_interface/frontend_sections/services/service) al mode d'edició. {width=600} Per [configurar](#service_configuration) un servei nou, feu clic al botó *Crear un servei* a la part superior dreta. Per afegir ràpidament un servei per als fills, també podeu tocar una icona al costat del servei pare. Això obrirà el mateix formulari de configuració del servei, però la configuració de Serveis parentals s'emplenarà prèviament. # 1 Simple graphs # 1 Gràfics senzills ##### 1 Stop agent Stop Zabbix agent. ##### 1 Aturada de l'agent Atureu l'agent Zabbix. ##### 1 Stop proxy Stop Zabbix proxy. ##### 1 Aturada del proxy Zabbix Atureu el proxy Zabbix. ##### 1 Stop server Stop Zabbix server to make sure that no new data is inserted into database. ##### 1 Atureu el servidor Zabbix Atureu el servidor Zabbix per assegurar-vos que no s'insereixin dades noves a la base de dades. ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database. # systemctl stop zabbix-server If upgrading the proxy, stop proxy too. # systemctl stop zabbix-proxy ::: noteimportant It is no longer possible to start the upgraded server and have older, yet unupgraded proxies report data to a newer server. This approach, which was never recommended nor supported by Zabbix, now is officially disabled, as the server will ignore data from unupgraded proxies. ::: ##### 1 Atureu els processos Zabbix Atureu el servidor Zabbix per assegurar-vos que no s'insereixin dades noves a la base de dades. # systemctl atura el servidor zabbix Si actualitzeu el proxy Zabbix, atureu-lo també. # systemctl iniciar zabbix-server ::: noteimportant Ja no és possible iniciar el servidor actualitzat i que els proxy més antics, però no actualitzats, passin dades a un servidor més nou. Aquest enfocament, que mai va ser recomanat ni admès per Zabbix, ara està desactivat oficialment, ja que el servidor ignorarà les dades dels proxys no actualitzats. ::: ##### 1 Stop Zabbix processes Stop Zabbix server to make sure that no new data is inserted into database. systemctl stop zabbix-server If upgrading Zabbix proxy, agent, or agent 2, stop these components too: systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ##### 1 Aturar els processos Zabbix Atureu el servidor Zabbix per assegurar-vos que no s'insereixin dades noves a la base de dades. systemctl stop zabbix-server Si actualitzeu el proxy Zabbix, l'agent o l'agent 2, atureu també aquests components: 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. systemctl stop zabbix-server If upgrading Zabbix proxy, agent, or agent 2, stop these components too: systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ::: noteimportant It is no longer possible to start the upgraded server and have older and unupgraded proxies report data to a newer server. This approach, which was never recommended nor supported by Zabbix, now is officially disabled, as the server will ignore data from unupgraded proxies. ::: ##### 1 Aturar els processos Zabbix Atureu el servidor Zabbix per assegurar-vos que no s'hi afegeixen dades noves base de dades. systemctl stop zabbix-server Si actualitzeu el proxy, l'agent o l'agent 2 de Zabbix, atureu també aquests components: systemctl stop zabbix-proxy systemctl stop zabbix-agent systemctl stop zabbix-agent2 ::: noteimportant Ja no és possible iniciar el servidor actualitzat i tindre proxys antics i no actualitzats informant de dades a un servidor més nou. Aquest enfocament, que mai ha estat recomanat ni recolzat per Zabbix, ara és oficialment desactivat, ja que el servidor ignorarà les dades dels proxys no actualitzats. ::: # 1 Supported macros # 1 Macros admeses # 1 System information # 1 Informació del sistema # 1 Trigger-based event correlation # 1 Correlació d'esdeveniments basats en triggers # 1 Trigger event generation # 1 Generació d'esdeveniments per trigger # 1 Upgrade from sources # 1 Actualització des de les fonts # 1 Usage examples # 1 Exemples d'ús # 1 Using certificates # 1 Emprant certificats # 1 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.| |vmware.datastore.discovery|<|<| |Performs datastore discovery.|{\#DATASTORE}|Datastore name.| |^|{\#DATASTORE.EXTENT}|JSON object with an array of {instanceName:partitionId}.| |vmware.dc.discovery|<|<| |Performs datacenter discovery.|{\#DATACENTER}|Datacenter name.| |^|{\#DATACENTERID}|Datacenter ID.| |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>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<br>This field is supported since Zabbix 5.2.2.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#PARENT.NAME}|Name of container that stores the hypervisor.<br>Supported since Zabbix 4.0.3.| |^|{\#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.<br>Supported since Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Performs hypervisor datastore discovery. Note that multiple hypervisors can use the same datastore.|{\#DATASTORE}|Datastore name.| |^|{\#MULTIPATH.COUNT}|Registered number of datastore paths.| |^|{\#MULTIPATH.PARTITION.COUNT}|Number of available disk partitions.| |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.| |^|{\#DATACENTER.NAME}|Datacenter name.| |^|{\#CLUSTER.NAME}|Cluster name, might be empty.| |^|{\#VM.IP}|Virtual machine IP address, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.DNS}|Virtual machine DNS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|Guest virtual machine OS family, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|Full guest virtual machine OS name, might be empty.<br>Supported since Zabbix 5.2.2.| |^|{\#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.<br>Supported since Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Performs virtual machine network interface discovery.|{\#IFNAME}|Network interface name.| |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.| # 1 Camps clau de descoberta de màquines virtuals La taula següent llista els camps retornats per les claus de descoberta relacionades amb les màquines virtuals. |**Clau d'element**|<|<| |--|--|----| |**Descripció**|**Camp**|**Contingut recuperat**| |vmware.cluster.discovery|<|<| |Fer descoberta de clúster.|{\#CLUSTER.ID}|Identificador de clúster.| |^|{\#CLUSTER.NAME}|Nom del clúster.| |vmware.datastore.discovery|<|<| |Feu la descoberta del magatzem de dades.|{\#DATASTORE}|Nom del magatzem de dades.| |^|{\#DATASTORE.EXTENT}|Objecte JSON amb una matriu de {instanceName:partitionId}.| |vmware.dc.discovery|<|<| |Feu la descoberta del centre de dades.|{\#DATACENTER}|Nom del centre de dades.| |^|{\# DATACENTERID}|Identificador del centre de dades.| |vmware.hv.discovery|<|<| |Fer descoberta d'hipervisor.|{\#HV.UUID}|Identificador únic de l'hipervisor.| |^|{\#HV.ID}|ID de l'hipervisor (nom de l'objecte gestionat de HostSystem).| |^|{\#HV.NAME}|Nom de l'hipervisor.| |^|{\#HV.NETNAME}|Nom d'equip de la xarxa de l'hipervisor.| |^|{\#HV.IP}|L'adreça IP de l'hipervisor pot ésser buida.<br>En el cas d'una configuració HA amb diverses interfícies de xarxa, s'observa la següent prioritat de selecció per a la interfície:<br>- prefereix IP que comparteix la subxarxa IP amb la IP de vCenter<br>- prefereix la IP de la subxarxa IP amb la passarel·la predeterminada<br>- prefereix la IP de la interfície de vCenter amb l'ID més baix<br>Aquest camp és compatible des de Zabbix 5.2.2.| |^|{\#CLUSTER.NAME}|Nom del clúster, pot ésser buit.| |^|{\#DATACENTER.NAME}|Nom del centre de dades.| |^|{\#PARENT.NAME}|Nom del contenidor que emmagatzema l'hipervisor.<br>Admès des de Zabbix 4.0.3.| |^|{\#PARENT.TYPE}|Tipus de contenidor on s'emmagatzema l'hipervisor. Els valors poden ser `Datacenter`, `Folder`, `ClusterComputeResource`, `VMware`, on 'VMware' representa un tipus de contenidor desconegut.<br>Suportat des de Zabbix 4.0.3.| |vmware.hv.datastore.discovery|<|<| |Realitza la descoberta del magatzem de dades de l'hipervisor. Tingueu en compte que diversos hipervisors poden emprar el mateix magatzem de dades.|{\#DATASTORE}|Nom del magatzem de dades.| |^|{\#MULTIPATH.COUNT}|Nombre registrat de camins de magatzem de dades.| |^|{\#MULTIPATH.PARTITION.COUNT}|Nombre de particions de disc disponibles.| |vmware.vm.discovery|<|<| |Trobar màquines virtuals.|{\#VM.UUID}|Identificador únic de la màquina virtual.| |^|{\#VM.ID}|Identificador de la màquina virtual (nom de l'objecte gestionat de VirtualMachine).| |^|{\#VM.NAME}|Nom de la màquina virtual.| |^|{\#HV.NAME}|Nom de l'hipervisor.| |^|{\#DATACENTER.NAME}|Nom del centre de dades.| |^|{\#CLUSTER.NAME}|Nom del clúster, pot ésser buit.| |^|{\#VM.IP}|L'adreça IP de la màquina virtual, pot ésser buida.<br>S'admet des de Zabbix 5.2.2.| |^|{\#VM.DNS}|Nom DNS de la màquina virtual, pot ésser buit.<br>S'admet des de Zabbix 5.2.2.| |^|{\#VM.GUESTFAMILY}|La família del sistema operatiu de la màquina virtual convidada, pot ésser buida.<br>S'admet des de Zabbix 5.2.2.| |^|{\#VM.GUESTFULLNAME}|El nom complet del sistema operatiu de la VM convidada, pot ésser buit.<br>S'admet des de Zabbix 5.2.2.| |^|{\#VM.FOLDER}|La cadena de carpetes pare de la VM, es pot emprar com a valor per a grups imbricats; els noms de les carpetes es combinen amb "/". Pot ésser buida.<br>S'admet des de Zabbix 5.4.2.| |vmware.vm.net.if.discovery|<|<| |Trobar la interfície de xarxa de la màquina virtual.|{\#IFNAME}|Nom de la interfície de xarxa.| |vmware.vm.vfs.dev.discovery|<|<| |Trobar dispositius de disc de la màquina virtual.|{\#DISKNAME}|Nom del dispositiu de disc.| |vmware.vm.vfs.fs.discovery|<|<| |Trobar el sistema de fitxers de la màquina virtual.|{\#FSNAME}|Nom del sistema de fitxers.| # 1 VMware monitoring item keys # 1 Elements clau de monitoratge VMware # 1 Webhook script examples # 1 Exemples d'scripts de Webhook # 1 Web monitoring items # 1 Elements de monitoratge web # 1 Zabbix agent # 1 Agent Zabbix # 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 the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 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%2F6.0) - [HAProxy by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [IIS by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.0) - [MySQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Nginx by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) - [PostgreSQL by Zabbix agent](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) # 1 Funcionament del model d'agent Zabbix Passes per garantir el bon funcionament dels models que recullen mètriques amb l'[agent Zabbix](/manual/concepts/agent): 1. Assegureu-vos que l'agent Zabbix sigui instal·lat a l'equip. Per a les comprovacions actives, també assegureu-vos que l'adreça del servidor/proxy Zabbix s'afegeix a la configuració 'ServerActive' del [fitxer de configuració] de l'agent (/manual/appendix/config/zabbix_agentd). 2. [Enllaçar](/manual/config/templates/linking#linking-a-template) la plantilla a un equip destí (si la plantilla no és disponible a la vostra instal·lació de Zabbix, és possible que hagueu d'importar el fitxer .yaml primer de la plantilla - veieu les [plantilles predefinides](/manual/config/templates_out_of_the_box) per obtindre instruccions). 3. Ajusteu els valors de macro necessaris segons calgui. 4. Configureu la instància monitorada per permetre compartir dades amb Zabbix. Una descripció detallada d'una plantilla, inclosa la llista completa de macros, elements i triggers, és disponible al fitxer Readme.md de la plantilla (accessible fent clic al nom d'una plantilla). Les següents plantilles són disponibles: -[Apache per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HAProxy per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[IIS per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[IIS per agent actiu de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/iis_agent_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Microsoft Exchange Server 2016 per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Microsoft Exchange Server 2016 per agent actiu de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/exchange_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[MySQL per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Nginx per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[PHP-FPM per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[PostgreSQL per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Clúster de RabbitMQ per agent Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 1 Zabbix server # 1 Servidor Zabbix # 20. Modules # 20. Mòduls # 20 System information # 20 Informació del sistema # 20 Upgrade notes for 6.0.10 # 20 Notes d'actualització de la versió 6.0.10 # 20 What's new in Zabbix 6.0.15 # 20 Què hi ha de nou al Zabbix 6.0.15 # 21. Appendixes Please use the sidebar to access content in the Appendixes section. # 21. Annexes Feu anar la barra lateral per accedir al contingut de la secció Annexes. # 21 Top hosts # 21 Equips top # 21 Top hosts # 21 Equips principals # 21 Upgrade notes for 6.0.11 # 21 Notes d'actualització de la versió 6.0.11 # 21 What's new in Zabbix 6.0.16 # 21 Què hi ha de nou al Zabbix 6.0.16 # 22 Trigger overview # 22 Vista general del trigger # 22 Trigger overview # 22 Vista general del trigger # 22 Upgrade notes for 6.0.12 # 22 Notes d'actualització per 6.0.12 # 22 What's new in Zabbix 6.0.17 # 22 què hi ha de nou a Zabbix 6.0.17 # 23 Upgrade notes for 6.0.13 # 23 Notes d'actualització per 6.0.13 # 23 URL # 23 URL # 23 URL # 23 URL # 23 What's new in Zabbix 6.0.18 # 23 Què hi ha de nou al Zabbix 6.0.18 # 24 Upgrade notes for 6.0.14 # 24 Notes d'actualització per 6.0.14 # 24 Web monitoring # 24 Monitoratge Web # 24 Web monitoring # 24 Monitoratge Web # 24 What's new in Zabbix 6.0.19 # 24 Què hi ha de nou al Zabbix 6.0.19 # 25 Upgrade notes for 6.0.15 This minor version doesn't have any upgrade notes. # 25 Comentaris d'actualització a la versió 6.0.15 Aquesta actualització és una versió menor i no té pas comentaris. # 25 What's new in Zabbix 6.0.20 # 25 Què hi ha de nou al Zabbix 6.0.20 # 26 Upgrade notes for 6.0.16 This minor version doesn't have any upgrade notes. # 26 Comentaris d'actualització a la versió 6.0.16 Aquesta actualització és una versió menor i no té pas comentaris. # 26 What's new in Zabbix 6.0.21 # 26 Què hi ha de nou al Zabbix 6.0.21 # 27 Upgrade notes for 6.0.17 # 27 Notes d'actualització de la versió 6.0.17 # 27 What's new in Zabbix 6.0.22 # 27 Què hi ha de nou al Zabbix 6.0.22 # 28 Upgrade notes for 6.0.18 # 28 Notes d'actualització per 6.0.18 # 28 What's new in Zabbix 6.0.23 See [breaking changes](/manual/installation/upgrade_notes_6023#breaking_changes) for this version. # 28 Què hi ha de nou al Zabbix 6.0.23 Veieu els [canvis més importants](/manual/installation/upgrade_notes_6023#breaking_changes) per a aquesta versió. # 29 Upgrade notes for 6.0.19 # 29 Notes d'actualització per 6.0.19 # 29 What's new in Zabbix 6.0.24 # 29 Què hi ha de nou al Zabbix 6.0.24 # 2 Actions [comment]: # (tags: action) # 2 Accions [comentari]: # (etiquetes: acció) # 2 Active agent autoregistration # 2 Enregistrament automàtic d'agent actiu # 2 Agent # 2 Agent ##### 2 Back up configuration files and Zabbix agent binaries Make a backup copy of the Zabbix agent binary and configuration file. ##### 2 Còpia de seguretat dels arxius de configuració i els binaris de l'agent Zabbix Feu una còpia de seguretat dels binaris de l'agent Zabbix i de l'arxiu de configuració. ##### 2 Back up configuration files and Zabbix proxy binaries Make a backup copy of the Zabbix proxy binary and configuration file. ##### 2 Còpia de seguretat dels arxius de configuració i els binaris del proxy Zabbix Feu una còpia de seguretat dels binaris del proxy Zabbix i de l'arxiu de configuració. ##### 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 Feu una còpia de seguretat de la base de dades Zabbix existent Aquesta és una passa molt important. Assegureu-vos que teniu una còpia de seguretat de la vostra base de dades. Això ajudarà si el procediment d'actualització falla (manca d'espai al disc, apagat, problemes inesperats). ##### 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 Feu una còpia de seguretat de la base de dades Zabbix existent Aquesta és una passa molt important. Assegureu-vos que teniu una còpia de seguretat de la vostra base de dades. Això ajudarà si el procediment d'actualització falla (manca d'espai al disc, apagat, problemes inesperats). ##### 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 Feu una còpia de seguretat de la base de dades Zabbix existent Aquesta és una passa molt important. Assegureu-vos que teniu una còpia de seguretat de la vostra base de dades. Això ajudarà si el procediment d'actualització falla (manca d'espai al disc, apagat, problemes inesperats). ##### 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 Feu una còpia de seguretat de la base de dades Zabbix existent Aquesta és una passa molt important. Assegureu-vos que teniu una còpia de seguretat de la vostra base de dades. Això ajudarà si el procediment d'actualització falla (manca d'espai al disc, apagat, problemes inesperats). # 2 Bitwise functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) 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 `<` `>` |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**bitand** (value,mask)|<|<| |Value of "bitwise AND" of an item value and mask.|**value** - value to check<br>**mask** (mandatory) - 64-bit unsigned integer (0 - 18446744073709551615)|Supported value types: int<br><br>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.<br><br>Examples:<br>=> **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<br>=> **bitand**(last(/host/key),**20**)=16 → 3rd bit not set and 5th bit set.| |**bitlshift** (value,bits to shift)|<|<| |Bitwise shift left of an item value.|**value** - value to check<br>**bits to shift** (mandatory) - number of bits to shift|Supported value types: int<br><br>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)|<|<| |Value of "bitwise NOT" of an item value.|**value** - value to check<br>|Supported value types: int<br><br>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)|<|<| |Value of "bitwise OR" of an item value and mask.|**value** - value to check<br>**mask** (mandatory) - 64-bit unsigned integer (0 - 18446744073709551615)|Supported value types: int<br><br>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)|<|<| |Bitwise shift right of an item value.|**value** - value to check<br>**bits to shift** (mandatory) - number of bits to shift|Supported value types: int<br><br>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)|<|<| |Value of "bitwise exclusive OR" of an item value and mask.|**value** - value to check<br>**mask** (mandatory) - 64-bit unsigned integer (0 - 18446744073709551615)|Supported value types: int<br><br>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.| # 2 Funciones binàries Totes les funcions llistades aquí són suportades a: - [Expressions de triggers](/manual/config/triggers/expression) - [Elements calculats](/manual/config/items/itemtypes/calculated) Algunes notes generals sobre els paràmetres de la funció: - Els paràmetres de funció són separats per una coma - Les expressions s'accepten com a paràmetres - Els paràmetres de funció opcionals (o parts dels paràmetres) venen indicats amb `<` `>` |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**bitand** (valor,màscara)|<|<| |Valor de "I binari" d'un valor d'element i d'una màscara.|**valor** : valor a verificar<br>**màscara** (obligatori) : enter no signat 64 bits (0 - 18446744073709551615)|Tipus de valors suportats: int<br><br>Encara que la comparació es faci a nivell de bit, tots els valors s'han de proveir i reenviades en decimal. Per exemple, la verificació del 3r bit es fa comparant a 4, no pas a 100.<br><br>Exemples:<br>=> **bitand**(last(/host/key),**12** )=8 o **bitand**(last(/host/key),**12**)=4 → 3r o 4t bit definit, però no les dues al mateix temps<br>=> **bitand** (last(/host/key),**20**)=16 → 3r bit no definit i 5è bit definit.| |**bitlshift** (valor,bits a canviar)|<|<| |Canvi a nivell de bit a l'esquerra d'un valor d'element.|**valor**: valor a verificar<br>**bits a canviar** (obligatori) : nombre de bits a canviar|Tipus de valors admesos: int<br><br> Encara que la comparació es faci a nivell de bit, tots els valors han de proporcionar-se i reenviar-se en decimal. Per exemple, la verificació del 3r bit es fa comparant a 4, no pas a 100.| |**bitnot** (valor)|<|<| |Valor de "NO binari" d'un valor d'element.|**valor** - valor a verificar<br>|Tipus de valors admesos: int<br><br>Encara que la comparació es faci a nivell de bit, tots els valors han de proporcionar-se i reenviar-se en decimal. Per exemple, la verificació del 3r bit es fa comparant a 4, no pas a 100.| |**bitor** (valor,màscara)|<|<| |Valor d'"O binari" d'un valor d'element i d'una màscara.|**valor** : valor a verificar<br>**màscara** (obligatori) : enter no signat de 64 bits (0 - 18446744073709551615)|Valor admès: int<br><br>Encara que la comparació es faci a nivell de bit, tots els valors han de proporcionar-se i reenviar-se en decimal. Per exemple, la verificació del 3r bit es fa comparant a 4, no pas a 100.| |**bitrshift** (valors,bits a desplaçar)|<|<| |Canvi a nivell de bit sobre la dreta d'un valor d'element.|**valor** : valor a verificar<br>**bits a canviar** (obligatori) : nombre de bits a canviar|Valor admès: int<br><br> Encara que la comparació es faci a nivell de bit, tots els valors han de proporcionar-se i reenviar-se en decimal. Per exemple, la verificació del 3r bit es fa comparant a 4, no pas a 100.| |**bitxor** (valor,màscara)|<|<| |Valor d'"O exclusiu binari" d'un valor d'element i d'una màscara.|**valor** : valor a verificar<br>**màscara** (obligatori) : enter no signat de 64 bits (0 - 18446744073709551615)|Valor admès: int<br><br>Encara que la comparació es faci a nivell de bit, tots els valors han de proporcionar-se i reenviar-se en decimal. Per exemple, la verificació del 3r bit es fa comparant a 4, no pas a 100.| # 2 Building Zabbix agent 2 on Windows # 2 Construint l'agent Zabbix 2 sota Windows # 2 Certificate problems # 2 Problemes de certificat # 2 Clock # 2 Rellotge # 2 Clock # 2 Rellotge # 2 Configuring a host group # 2 Configuració d'un grup d'equips ##### 2 Create user account For all of the Zabbix daemon processes, an unprivileged user is required. If a Zabbix daemon is started from an unprivileged user account, it will run as that user. However, if a daemon is started from a 'root' account, it will switch to a 'zabbix' user account, which must be present. To create such a user account (in its own group, "zabbix"), on a RedHat-based system, run: groupadd --system zabbix useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix Monitoring System" zabbix on a Debian-based system, run: addgroup --system --quiet zabbix adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix ::: noteimportant Zabbix processes do not need a home directory, which is why we do not recommend creating it. However, if you are using some functionality that requires it (e. g. store MySQL credentials in `$HOME/.my.cnf`) you are free to create it using the following commands. 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 ::: A separate user account is not required for Zabbix frontend installation. If Zabbix [server](/manual/concepts/server) and [agent](/manual/concepts/agent) are run on the same machine it is recommended to use a different user for running the server than for running the agent. Otherwise, if both are run as the same user, the agent can access the server configuration file and any Admin level user in Zabbix can quite easily retrieve, for example, the database password. ::: noteimportant Running Zabbix as `root`, `bin`, or any other account with special rights is a security risk. ::: ##### 2 Crear un compte d'usuari Per a tots els processos del dimoni Zabbix, cal un usuari sense privilegis. Si s'inicia un dimoni Zabbix amb un usuari sense privilegis, s'executarà com a usuari. Tanmateix, si s'inicia un dimoni des del compte "root", canviarà al compte d'usuari "zabbix", que ha d'ésser present. Per crear aquest compte d'usuari (en el seu propi grup, "zabbix"), als sistemes RedHat executeu: groupadd --system zabbix useradd --system -g zabbix -d /usr/lib/zabbix -s /sbin/nologin -c "Zabbix monitoring" zabbix als sistemes Debian executeu: addgroup --system --quiet zabbix adduser --quiet --system --disabled-login --ingroup zabbix --home /var/lib/zabbix --no-create-home zabbix ::: noteimportant Els processos Zabbix no necessiten un directori d'inici, per això no recomanem crear-lo. Tanmateix, si empreu una funció que ho requereix (per exemple, emmagatzemar credencials de MySQL a `$HOME/.my.cnf`), podeu crear-la amb les ordres següents. Als sistemes RedHat, executeu: mkdir -m u=rwx,g=rwx,o= -p /usr/lib/zabbix chown zabbix:zabbix /usr/lib/zabbix Als sistemes Debian, executeu: mkdir -m u=rwx,g=rwx,o= -p /var/lib/zabbix chown zabbix:zabbix /var/lib/zabbix ::: No cal un compte d'usuari independent per instal·lar la interfície d'usuari de Zabbix. Si el [servidor](/manual/concepts/server) i l'[agent](/manual/concepts/agent) Zabbix s'executen a la mateixa màquina, es recomana emprar un usuari diferent per executar el servidor que per executar l'agent. En cas contrari, si tots dos s'executen amb el mateix usuari, l'agent pot accedir al fitxer de configuració del servidor i qualsevol usuari de nivell administrador de Zabbix pot recuperar, per exemple, el mot de pas de la base de dades molt fàcilment. ::: noteimportant Executar Zabbix com a root, bin o qualsevol altre compte amb drets especials té un risc de seguretat. ::: # 2 Custom graphs # 2 Gràfics personalitzats # 2 Custom intervals # 2 Intervals personalitzats # 2 Debian/Ubuntu # 2 Debian/Ubuntu # 2 Debian/Ubuntu/Raspbian # 2 Debian/Ubuntu/Raspbian # 2. Definitions # 2. Definicions # 2 Discovery of network interfaces In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover network interfaces. # 2 Descoberta de les interfícies de xarxa De la mateixa manera que es descobreixen [sistemes de fitxers](/manual/discovery/low_level_discovery#configuring_low-level_discovery), també es poden descobrir interfícies de xarxa. # 2 Docker plugin # 2 Plugin de Docker 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. No empreu "ps -ef" per explorar processos: només ensenya processos que no són del nucli. Empreu "ps -Af" per veure tots els processos que veurà l'agent Zabbix. 3. Veieu un exemple de 'topasrec' com l'agent Zabbix proc.mem[] tria els processos. ``` $ 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, 16 de març de 2023 ``` proc.mem[] té arguments: ``` proc.mem[<nom>,<usuari>,<mode>,<línia de cmd>,<tipus mem>] ``` # 2 Frontend sections Please use the sidebar to access content in the Frontend sections section. # 2 Seccions del tauler # 2 Global event correlation # Correlació global d'esdeveniments # 2 Host group elements # 2 elements del grup d'equips # 2 Hosts # 2 Equips # 2 Items # 2 Elements # 2 Item value preprocessing # 2 Preprocessament del valor de l'element # 2 Linking/unlinking # 2 Enllaçar/desenllaçar # 2 Network maps [comment]: # (tags: map) # 2 Mapes de xarxa [comentari]: # (etiquetes: mapa) # 2 New host # 2 Nou equip # 2 Operations # 2 Operacions # 2 Other event sources # 2 Altres fonts d'esdeveniments # 2 Permissions # 2 Permissos # 2 PostgreSQL encryption configuration [comment]: # (tags: ssl) # 2 Configuració de xifrat PostgreSQL [comentari]: # (etiquetes: ssl) # 2 Preprocessing details # 2 Detalls de preprocessament # 2 Problems # 2 Problemes # 2 Process configuration Please use the sidebar to access content in this section. # 2 Configuració dels processos # 2 Proxies # 2 Proxys # 2 Real-life scenario # 2 Escenari de la vida real # 2 Recommended UnixODBC settings for PostgreSQL # 2 Paràmetres UnixODBC recomanats per a PostgreSQL # 2 Remote commands # 2 Comandes remotes # 2 Repairing Zabbix database character set and collation # 2 Reparant el joc de caràcters i la col·lació de la base de dades de Zabbix # 2 Requirements # 2 Requeriments # 2 Scheduled reports # 2 Informes programats # 2 Service actions # 2 Accions de servei # 2 Service actions # 2 Accions de servei # 2 Services # 2 Serveis # 2 Setup from RHEL packages # 2 Configurar des dels paquets de RHEL # 2 Setup from RHEL packages # 2 Configurar des dels paquets de RHEL # 2 Simple check # 2 Verificacions simples # 2 SMS # 2 SMS # 2 Sound in browsers # 2 Sons dels navegadors # 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 OID especials Alguns dels OID SNMP més emprats es tradueixen automàticament en representació numèrica per Zabbix. Per exemple, **ifIndex** es tradueix com a **1.3.6.1.2.1.2.2.1.1**, i **ifIndex.0** com a **1.3.6.1.2.1.2.2.1.1.0**. La següent taula conté la llista dels OID especials. |OID Especial|Identificador|Descripció| |-----------|----------|-----------| |ifIndex|1.3.6.1.2.1.2.2.1.1|Un valor únic per cada interfície.| |ifDescr|1.3.6.1.2.1.2.2.1.2|Una cadena de text que conté la informació de la interfície. Aquesta cadena ha d'incloure el nom del fabricant, el nom de producte i la versió de la interfície.| |ifType|1.3.6.1.2.1.2.2.1.3|El tipus d'interfície, distingida en funció de/ls protocol/s físic/s o d'enllaç immediatament "en desús" de la capa de xarxa a la pila del protocol.| |ifMtu|1.3.6.1.2.1.2.2.1.4|La mida del datagrama més gran que es pot enviar/rebre a la interfície, especificada en octets.| |ifSpeed|1.3.6.1.2.1.2.2.1.5|Una estimació de l'amplada de banda actual de la interfície, en bits per segon.| |ifPhysAddress|1.3.6.1.2.1.2.2.1.6|L'adreça de la interfície a nivell de la capa de protocol és immediatament inferior a la capa xarxa a la pila de protocol.| |ifAdminStatus|1.3.6.1.2.1.2.2.1.7|L'estat administratiu actual de la interfície.| |ifOperStatus|1.3.6.1.2.1.2.2.1.8|L'estat operacional actual de la interfície.| |ifInOctets|1.3.6.1.2.1.2.2.1.10|Nombre total d'octets rebuts a la interfície, inclosos els caràcters marc.| |ifInUcastPkts|1.3.6.1.2.1.2.2.1.11|Nombre de paquets sub-network-unicast lliurats a un protocol de capa superior.| |ifInNUcastPkts|1.3.6.1.2.1.2.2.1.12|Nombre de paquets no monodifusió (és a dir, sota xarxa difosa o sota xarxa multidifusió) transmesos a un protocol de capa superior.| |ifInDiscards|1.3.6.1.2.1.2.2.1.13|Nombre de paquets entrants que s'han triat per ésser descartats encara que no s'hagi detectat pas cap error per evitar que es puguin lliurar a un protocol de capa superior. Una possible raó per descartar aquest paquet podria ésser alliberar espai de memòria intermitja.| |ifInErrors|1.3.6.1.2.1.2.2.1.14|Nombre de paquets entrants que contenien errors que impedien que es puguin lliurar a un protocol de capa superior.| |ifInUnknownProtos|1.3.6.1.2.1.2.2.1.15|Nombre de paquets rebuts a través de la interfície que s'han descartat a causa d'un protocol desconegut o no compatible.| |ifOutOctets|1.3.6.1.2.1.2.2.1.16|Nombre total d'octets transmesos fora de la interfície, inclosos els caràcters d'enquadrament.| |ifOutUcastPkts|1.3.6.1.2.1.2.2.1.17|Nombre total de paquets que els protocols de nivell superior han demanat transmetre i que no s'han enviat a una adreça de multidifusió o difusió en aquesta subcapa, inclosos els que es van descartar o no enviats.| |ifOutNUcastPkts|1.3.6.1.2.1.2.2.1.18|Nombre total de paquets que els protocols de nivell superior van sol·licitar transmetre i que es van enviar a una adreça de multidifusió o difusió en aquesta subcapa, inclosos els que es van descartar o no enviats.| |ifOutDiscards|1.3.6.1.2.1.2.2.1.19|Nombre de paquets de sortida que s'han triat per ser descartats tot i que no s'ha detectat cap error per evitar que es transmetin. Una possible raó per descartar aquest paquet podria ser alliberar espai de memòria intermitja.| |ifOutErrors|1.3.6.1.2.1.2.2.1.20|Nombre de paquets de sortida que no s'han pogut transmetre a causa d'errors.| |ifOutQLen|1.3.6.1.2.1.2.2.1.21|La longitud de la cua de paquets de sortida (en paquets).| # 2 Templates # 2 Plantilles # 2 Templates # 2 Plantilles # 2 Trigger expression # 2 Expressió de trigger # 2 Trigger prototypes # 2 Prototips de triggers # 2 Trigger prototypes # 2 Prototips de triggers # 2 Trigger prototypes We create trigger prototypes in a similar way as item prototypes:  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 as well (supported since Zabbix 3.0). 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 Prototips de triggers Creem prototips de triggers de la mateixa manera que els prototips d'elements:  Atributs específics per activar prototips: |Paràmetre|Descripció| |--|---------| |*Crea activat*|Si és marcat, el trigger s'afegirà a un estat activat.<br>Si no és marcat, el trigger s'afegirà a una entitat descoberta, però en estat desactivat.| |*Descoberta*|Si és marcat (per defecte), el trigger s'afegirà a una entitat descoberta.<br>Si no és marcat, el trigger no s'afegirà a una entitat descoberta tret que aquesta configuració sigui [substituïda](/manual/ discovery/ low_level_discovery#override) a la regla de descoberta.| Quan es creen triggers reals a partir dels prototips, pot ser necessari ser flexible sobre la constant ('20' en el nostre exemple) per emprar la comparació a l'expressió. Veieu com [macros d'usuari amb context](/manual/config/macros/user_macros_context#use-cases) pot ser útil per aconseguir aquesta flexibilitat. També podeu definir [dependències](/manual/config/triggers/dependencies) entre prototips de triggers (admeses des de Zabbix 3.0). Per fer-ho, aneu a la pestanya *Dependències*. Un prototip de trigger pot dependre d'un altre prototip de trigger de la mateixa regla de descoberta de baix nivell (LLD) o d'un trigger senzill. Un prototip de trigger no pot dependre d'un prototip de trigger d'una regla LLD diferent o d'un trigger creat a partir d'un prototip de trigger. El prototip de trigger de l'equip no pot pas dependre del trigger d'una plantilla.  # 2 Triggers # 2 Triggers # 2 Triggers # 2 Triggers # 2 Upgrade from packages # 2 Actualització dels paquets # 2 User macros # 2 Macros d'usuari # 2 User macros supported by location # 2 Macros d'usuaris admeses per ublicació # 2 Using pre-shared keys # 2 emprant claus pre-compartides # 2 vm.memory.size parameters # 2 Paràmetres vm.memory.size # 2 Web scenarios # 2 Escenaris web # 2 What is Zabbix # 2 Què és Zabbix # 2 Windows-specific item keys # 2 claus d'elements específiques de Windows # 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 the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 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%2F6.0) - [Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/memcached/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) - [Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SMART by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SMART by Zabbix agent 2 active](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Systemd by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/systemd/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) # 2 Funcionament de la plantilla de l'agent Zabbix 2 Passes per garantir el bon funcionament dels models que recullen mètriques amb l'agent [Zabbix agent 2](/manual/concepts/agent2): 1. Assegureu-vos que l'Agent 2 sigui instal·lat a l'equip i que la versió instal·lada contingui el connector necessari. En alguns casos, és possible que primer hagueu d'[actualitzar](https://www.zabbix.com/documentation/current/manual/installation/upgrade) l'agent 2. 2.[Enllaç](/manual/config/templates/linking#linking-a-template) la plantilla a un equip destí (si la plantilla no és disponible a la vostra instal·lació de Zabbix, és possible que hagueu d'importar primer el fitxer .yaml d'importació de la plantilla - veieu les [plantilles per defecte](/manual/config/templates_out_of_the_box) per obtindre instruccions). 3. Ajusteu els valors de macro necessaris segons calgui. Tingueu en compte que les macros d'usuari es poden emprar per anul·lar els paràmetres de configuració. 4. Configureu la instància monitorada per permetre compartir dades amb Zabbix. ::: noteimportant Les plantilles d'agent Zabbix 2 funcionen juntament amb els connectors. Tot i que la configuració bàsica es pot fer simplement ajustant les macros d'usuari, es pot aconseguir una millor personalització mitjançant la [configuració del connector](/manual/extensions/config/items/plugins#named-sessions). Per exemple, si un connector admet sessions amb nom, és possible monitorar diverses entitats del mateix tipus (per exemple, MySQL1 i MySQL2) especificant una sessió amb nom amb el seu propi URI, nom d'usuari i mot de pas per a cada entitat al fitxer de configuració. ::: Una descripció detallada d'una plantilla, inclosa la llista completa de macros, elements i triggers, ésdisponible al fitxer Readme.md de la plantilla (accessible fent clic al nom d'una plantilla). Les següents plantilles són disponibles: - [Ceph de l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ceph_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Memcached](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/memcached/README.md?at=refs%2Fheads%2Frelease%2F6.0)|** {$MEMCACHED.CONN.URI}** - cadena de connexió en format URI; el port és opcional; no s'empra el mot de pas.<br>Si no s'estableix, s'empra el valor predeterminat del connector: tcp://localhost:11211.<br>Exemples: tcp://127.0.0.1:11211, tcp://localhost, unix:/var/run/memcached.sock.|Funciona amb el connector *Memcached*; s'admeten sessions amb nom.<br><br>Per provar la disponibilitat, executeu:<br>`zabbix_get -s memcached-host -k memcached.ping`| - [Clúster MongoDB de l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb_cluster/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Node MongoDB de l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mongodb/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL de l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) - [Agent PostgreSQL 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Agent SMART by Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Agent actiu SMART by Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/module/smart_agent2_active/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Systemd de l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/systemd/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Certificat del lloc web de l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/certificate_agent2/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 2 Zabbix agent protocol Please refer to [Passive and active agent checks](/manual/appendix/items/activepassive) page for more information. # 2 Protocol de l'agent Zabbix Llegiu la pàgina [Verificacions de l'agent actiu i passiu](/manual/appendix/items/activepassive) per tindre més informació. # 2 Zabbix proxy # 2 proxy Zabbix # 30 Upgrade notes for 6.0.20 This minor version doesn't have any upgrade notes. # 30 Comentaris d'actualització a la versió 6.0.20 Aquesta actualització és una versió menor i no té pas comentaris. # 30 What's new in Zabbix 6.0.25 # 30 Què hi ha de nou a Zabbix 6.0.25 # 31 Upgrade notes for 6.0.21 # 31 Notes d'actualització per 6.0.21 # 31 What's new in Zabbix 6.0.26 # 31 Què hi ha de nou al Zabbix 6.0.26 ##### 32 bit Open MinGW environment (Windows command prompt) and navigate to *build/mingw* directory in the Zabbix source tree. Run: mingw32-make clean mingw32-make ARCH=x86 PCRE=c:\dev\pcre32 OPENSSL=c:\dev\openssl32 ##### 32 bit Obrir l'entorn de MinGW (línia de comandes de Windows) i accediu al directori *build/mingw* a l'arbre de Zabbix. Executeu: mingw32-make clean mingw32-make ARCH=x86 PCRE=c:\dev\pcre32 OPENSSL=c:\dev\openssl32 # 32 Upgrade notes for 6.0.22 # 32 Notes d'actualització per 6.0.22 # 32 What's new in Zabbix 6.0.27 # 32 Què hi ha de nou al Zabbix 6.0.27 # 33 Upgrade notes for 6.0.23 # 33 Notes d'actualització per 6.0.23 # 33 What's new in Zabbix 6.0.28 # 33 Què hi ha de nou al Zabbix 6.0.28 # 34 Upgrade notes for 6.0.24 # 34 Comentaris d'actualització a la versió 6.0.24 # 34 What's new in Zabbix 6.0.29 # 34 Què hi ha de nou al Zabbix 6.0.29 # 35 Upgrade notes for 6.0.25 # 35 Comentaris d'actualització a la versió 6.0.25 # 35 What's new in Zabbix 6.0.30 # 35 Què hi ha de nou al Zabbix 6.0.30 # 36 Upgrade notes for 6.0.26 This minor version doesn't have any upgrade notes. # 36 Comentaris d'actualització a la versió 6.0.26 Aquesta actualització és una versió menor i no té pas comentaris. # 36 What's new in Zabbix 6.0.31 # 36 Què hi ha de nou al Zabbix 6.0.31 # 37 Upgrade notes for 6.0.27 # 37 Comentaris d'actualització a la versió 6.0.27 Aquesta actualització és una versió menor i no té pas comentaris. # 37 What's new in Zabbix 6.0.32 # 37 Què hi ha de nou al Zabbix 6.0.32 # 38 Upgrade notes for 6.0.28 # 38 Notes d'actualització per 6.0.28 # 38 What's new in Zabbix 6.0.33 # 38 Què hi ha de nou al Zabbix 6.0.33 # 39 Upgrade notes for 6.0.29 This minor version doesn't have any upgrade notes. # 39 Comentaris d'actualització a la versió 6.0.29 Aquesta actualització és una versió menor i no té pas comentaris. # 39 What's new in Zabbix 6.0.34 # 39 Què hi ha de nou al Zabbix 6.0.34 # 3 Additional operations # 3 Operacions addicionals # 3 Ad-hoc graphs # 3 Gràfics ad-hoc # 3 Agent 2 # 3 Agent 2 # 3 Authentication [comment]: # (tags: ldap, saml) # 3 Autenticació [comentari]: # (etiquetes: ldap, saml) # 3 Availability report # 3 Informe de disponibilitat ##### 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 Feu una còpia de seguretat dels arxius de configuració, dels arxius PHP i dels binaris de Zabbix Feu una còpia de seguretat dels binaris de Zabbix, dels arxius de configuració i del directori d'arxius PHP. ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. Configuration files: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ PHP files and Zabbix binaries: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Feu una còpia de seguretat de fitxers de configuració, fitxers PHP i binaris Zabbix Feu una còpia de seguretat dels fitxers binaris Zabbix, fitxers de configuració i directori de fitxers PHP. Fitxers de configuració: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/apache2/conf-enabled/zabbix.conf /opt/zabbix-backup/ Arxius PHP i binaris Zabbix : cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. Configuration files: # mkdir /opt/zabbix-backup/ # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ # cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ PHP files and Zabbix binaries: # cp -R /usr/share/zabbix/ /opt/zabbix-backup/ # cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Feu una còpia de seguretat de fitxers de configuració, fitxers PHP i binaris Zabbix Feu una còpia de seguretat dels fitxers binaris Zabbix, fitxers de configuració i directori de fitxers PHP. Fitxers de configuració: # mkdir /opt/zabbix-backup/ # cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ # cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ Arxius PHP i binaris Zabbix : # cp -R /usr/share/zabbix/ /opt/zabbix-backup/ # cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Back up configuration files, PHP files and Zabbix binaries Make a backup copy of Zabbix binaries, configuration files and the PHP file directory. Configuration files: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ PHP files and Zabbix binaries: cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ ##### 3 Feu una còpia de seguretat de fitxers de configuració, fitxers PHP i binaris Zabbix Feu una còpia de seguretat dels fitxers binaris Zabbix, fitxers de configuració i directori de fitxers PHP. Fitxers de configuració: mkdir /opt/zabbix-backup/ cp /etc/zabbix/zabbix_server.conf /opt/zabbix-backup/ cp /etc/httpd/conf.d/zabbix.conf /opt/zabbix-backup/ Arxius PHP i binaris Zabbix : cp -R /usr/share/zabbix/ /opt/zabbix-backup/ cp -R /usr/share/zabbix-* /opt/zabbix-backup/ # 3 Building Zabbix agent on macOS # 3 Construir l'agent Zabbix sobre 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 Crear la base de dades Zabbix Per als dimonis [servidor](/manual/concepts/server) et [proxy](/manual/concepts/proxy), així com l'interfície Web, cal una base de dades. Això no cal per l'[agent](/manual/concepts/agent) Zabbix. Hi ha [scripts SQL proveïts](/manual/appendix/install/db_scripts) per crear l'esquema de la base de dades i inserir el conjunt de dades. La base de dades del proxy Zabbix no té pas necessitat de l'esquema mentre que la base de dades del servidor Zabbix requereix legalment el recull de dades de l'esquema. Després d'haver creat la base de dades Zabbix, passeu a les passes següents de la compilació de Zabbix. # 3 Custom alert scripts # 3 Scripts d'alerta personalitzats # 3 Dashboards [Dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard) and their widgets provide a strong visualization platform with such tools as modern graphs, maps, slideshows, and many more. {width="600"} # 3 Taulers Els [taulers](/manual/web_interface/frontend_sections/monitoring/dashboard) i els seus ginys proveeixen una bona plataforma de visualització amb utilitats com gràfics moderns, mapes, diapositives i d'altres. {width="600"} # 3 Database upgrade to primary keys # 3 Actualització de la base de dades envers les claus primàries # 3 Data overview # 3 Vista general de les dades # 3 Data overview # 3 Vista general de les dades # 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) ::: 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 function). For detailed information on how date and time functions work within expressions, see [Calculation time](/manual/config/triggers#calculation_time). ::: |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**date**|<|<| |Current date in YYYYMMDD format.| |Example:<br>=> **date**()<20220101| |**dayofmonth**|<|<| |Day of month in range of 1 to 31.| |Example:<br>=> **dayofmonth**()=1| |**dayofweek**|<|<| |Day of week in range of 1 to 7 (Mon - 1, Sun - 7).| |Example (only weekdays):<br>=> **dayofweek**()<6<br><br>Example (only weekend):<br>=> **dayofweek**()>5| |**now**|<|<| |Number of seconds since the Epoch (00:00:00 UTC, January 1, 1970).| |Example:<br>=> **now**()<1640998800| |**time**|<|<| |Current time in HHMMSS format.| |Example (only nighttime, 00:00-06:00):<br>=> **time**()<060000| # 3 Funcions de data i hora Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) ::: noteimportant Les funcions de data i hora no es poden emperar per elles mateixes a l'expressió; almenys una funció d'[un altre grup](/manual/appendix/functions), que faci referència a l'element amfitrió, s'ha d'incloure a l'expressió (excepte la funció nodata). Per obtindre informació detallada sobre com funcionen les funcions de data i hora dins de les expressions, veieu [Temps de càlcul](manual/config/triggers#calculation_time). ::: |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**date**|<|<| |Data actual en format YYYYMMDD.| |Exemple:<br>=> **data**()<20220101| |**dayofmonth**|<|<| |Dia del mes, entre 1 i 31.| |Exemple:<br>=> **dayofmonth**()=1| |**dayofweek**|<|<| |Dia de la setmana, entre 1 i 7 (Dil - 1, Dim - 7).| |Exemple (només dies entre setmana):<br>=> **dayofweek**()<6<br><br>Exemple (només cap de setmana):<br>=> **dayofweek**()>5| |**now**|<|<| |Nombre de segons des d'Epoch (00:00:00 UTC, 1r de gener de 1970).| |Exemple:<br>=> **now**()<1640998800| |**time**|<|<| |Hora actual en format HHMMSS.| |Exemple:<br>=> **time**()>000000 i **time**()<060000| # 3 Discovery of CPUs and CPU cores In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover CPUs and CPU cores. # 3 Descoberta de CPUs i nuclis de CPU De la mateixa manera que es descobreixen [sistemes de fitxers](/manual/discovery/low_level_discovery#configuring_low-level_discovery), també és possible descobrir CPU i nuclis de CPU. # 3 Ember+ plugin # 3 Plugin Ember+ # 3 Graph prototypes # 3 Prototips de gràfics # 3 Graph prototypes # 3 Prototips de gràfics # 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.  *Note*: For configuring host prototypes, see the section about [host prototype](/manual/vm_monitoring#host_prototypes) configuration in virtual machine monitoring. # 3 Prototipus de gràfics També podem crear prototips de gràfics:  Atributs específics dels prototips de gràfics: |Paràmetre|Descripció| |--|---------| |*Discover*|Si és marcat (per defecte), el gràfic s'afegirà a una entitat descoberta.<br>Si no és marcat, el gràfic no s'afegirà a una entitat descoberta, tret que aquesta configuració sigui [substituïda](/manual/ discovery /low_level_discovery#override) a la regla de descoberta.|  Finalment, hem creat una regla de descoberta que s'assembla a la que es mostra tot seguit. Té cinc prototips d'elements, dos prototips de trigger i un prototip de gràfic.  *Nota*: Per configurar prototips d'equips, consulteu la secció sobre Configuració de [prototips d'equips](/manual/vm_monitoring#host_prototypes) per al monitoratge de VM. # 3 Graphs # 3 Gràfics # 3 Graphs # 3 Gràfics # 3 Hosts # 3 Equips # 3 Hosts # 3 Equips # 3 Hosts # 3 Equips # 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 and specify an IP address or DNS name of the monitoring target as the main 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 the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 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%2F6.0) - [Apache by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Asterisk by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [AWS by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) - [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) - [Cisco SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http/README.md?at=release%2F6.0) - [ClickHouse by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Cloudflare by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [CockroachDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cockroachdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) - [Elasticsearch Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) - [Etcd by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitLab by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Google Cloud Platform by HTTP (GCP by HTTP)](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Hadoop by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HAProxy by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Vault by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Hikvision camera by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) - [InfluxDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jenkins by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft SharePoint by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [NGINX by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OpenWeatherMap by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/openweathermap_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud/README.md?at=release%2F6.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%2F6.0) - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [RabbitMQ cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) - [VMware SD-WAN VeloCloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ZooKeeper by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 3 Operació de plantilla HTTP Passes per garantir el correcte funcionament de les plantilles que recullen mètriques amb [agent HTTP](/manual/config/items/itemtypes/http): 1. Creeu un equip a Zabbix i especifiqueu una adreça IP o un nom DNS de l'objectiu de monitoratge com a interfície principal. Això és necessari per a la macro {HOST.CONN} per resoldre correctament als elements de la plantilla. 2. [Enllaç](/manual/config/templates/linking#linking-a-template) la plantilla a l'equip creat a la passa 1 (si la plantilla no és disponible a la vostra instal·lació de Zabbix, és possible que hagueu d'importar primer el fitxer .yaml de la plantilla - veieu la secció [Plantilles fora de la caixa](/manual/config/templates_out_of_the_box) per obtindre instruccions). 3. Ajusteu els valors de les macros obligatòries segons sigui necessari. 4. Configureu la instància que s'és monitorant per permetre compartir dades amb Zabbix. Una descripció detallada d'una plantilla, inclosa la llista completa de macros, elements i triggers, és disponible al fitxer Readme.md de la plantilla (accessible fent clic al nom d'una plantilla). Les següents plantilles són disponibles: -[Acronis Cyber Protect Cloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Apache per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/apache_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Asterisk per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/tel/asterisk_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[AWS per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_http/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0) -[Azure per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Cisco Meraki organization per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/meraki_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Cisco SD-WAN per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http/README.md?at=release%2F6.0) -[ClickHouse per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/clickhouse_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Cloudflare per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/cloudflare_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[CockroachDB per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cockroachdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Control-M enterprise manager per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Control-M server per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/controlm_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[DELL PowerEdge R720 per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r720_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[DELL PowerEdge R740 per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r740_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[DELL PowerEdge R820 per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r820_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[DELL PowerEdge R840 per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell/dell_r840_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Elasticsearch Cluster per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/elasticsearch_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Envoy Proxy per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/envoy_proxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Etcd per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/etcd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[FortiGate per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GitHub repository per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[GitLab per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/gitlab_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Google Cloud Platform per HTTP (GCP per HTTP)](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Hadoop per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/hadoop_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HAProxy per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/haproxy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HashiCorp Consul Cluster per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul_cluster/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HashiCorp Consul Node per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/consul_http/consul/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HashiCorp Nomad per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HashiCorp Vault per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vault_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Càmera Hikvision per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cctv/hikvision/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HPE iLO per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HPE MSA 2040 Storage per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2040_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HPE MSA 2060 Storage per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_msa2060_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HPE Primera per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/hpe_primera_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[HPE Synergy per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_synergy_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[InfluxDB per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/influxdb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Jenkins per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jenkins/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Kubernetes API server per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_api_server_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Kubernetes cluster state per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Kubernetes Controller manager per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_controller_manager_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Kubernetes kubelet per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_kubelet_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Kubernetes nodes per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_nodes_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Kubernetes Scheduler per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_scheduler_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[MantisBT per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Microsoft 365 reports per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Microsoft SharePoint per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/sharepoint_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[NetApp AFF A700 per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/netapp_aff_a700_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[NGINX per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[NGINX Plus per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nginx_plus_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Nutanix Prism Element per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[OpenStack per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[OpenWeatherMap per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/openweathermap_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) [Oracle Cloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud/README.md?at=release%2F6.0) -[PHP-FPM per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/php-fpm_agent/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Proxmox VE per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[RabbitMQ cluster per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/rabbitmq_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[TiDB per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tidb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[TiDB PD per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_pd_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[TiDB TiKV per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/tidb_http/tidb_tikv_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Travis CI per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/travis_ci_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Veeam Backup Enterprise Manager per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/enterprise_manager_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Veeam Backup and Replication per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/veeam/backup_replication_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[VMware SD-WAN VeloCloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/velocloud_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[ZooKeeper per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zookeeper_http/README.md?at=refs%2Fheads%2Frelease%2F6.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 Instal·lació des de les fonts Podeu obtindre la darrera versió de Zabbix compilant-la des de la font. Aquí es proporciona un tutorial passa a passa per instal·lar Zabbix des de la font. ##### 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·lació dels nous binaris d’agent Empreu les [instruccions](/manual/installation/install#installing_zabbix_daemons) per compilar l'agent Zabbix des de la font. Sinó, podeu descarregar un agent precompilat des del [lloc de descàrrega de Zabbix](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·lació dels nous binaris del proxy Empreu les [instruccions](/manual/installation/install#installation_zabbix_daemons) per compilar el proxy Zabbix des de la font. # 3 Inventory # 3 Inventari # 3 Inventory # 3 Inventari # 3 Item types # 3 Tipus d'elements # 3 JSONPath functionality # 3 Funcionalitat JSONPath # 3 Link indicators # 3 Indicadors d'enllaços # 3 Low-level discovery # 3 Descoberta de baix nivell # 3 Manual closing of problems # 3 Tancament manual dels problemes # 3 MIB files # 3 Arxius MIB # 3 Nesting # 3 Niuatge # 3 New item # 3 Element nou # 3 Passive and active agent checks # 3 Verificacions dels agents actius i passius # 3 Protocols Please use the sidebar to access content in this section. # 3 Protocols # 3 PSK problems [comment]: # (tags: ssl) # 3 problemes PSK [comentari]: # (etiquetes: ssl) # 3 Receiving notification on unsupported items # 3 Recepció de notificacions per els elements no admesos # 3 Recommended UnixODBC settings for Oracle # 3 Paràmetres recomanats per UnixODBC sota Oracle # 3 Recovery operations # 3 Operacions de recuperació # 3 Setup from Debian/Ubuntu packages # 3 Configuració des dels paquets Debian/Ubuntu # 3 SLA # 3 SLA # 3 SLA # 3 SLA # 3 SNMP agent [comment]: # (tags: snmp) # 3 agent SNMP [comentari]: # (tags: snmp) # 3 SUSE Linux Enterprise Server # 3 SUSE Linux Enterprise Server # 3 Trigger dependencies # 3 Dependència dels triggers # 3 Triggers # 3 Triggers # 3 Troubleshooting # 3 Solució de problemes # 3 User groups # 3 Grups d'usuaris # 3 User macros with context # 3 Macros d'usuari amb context # 3 User settings # 3 Configuració d'usuari # 3 Zabbix agent 2 protocol # 3 Protocol de l'agent Zabbix 2 # 3 Zabbix agent (UNIX) # 3 Zabbix agent (UNIX) # 3 Zabbix features # 3 Funcionalitats de Zabbix # 3. Zabbix processes Please use the sidebar to access content in the Zabbix process section. # 3. Processos Zabbix Feu anar la barra lateral per accedir al contingut de la secció Processos Zabbix, # 40 Upgrade notes for 6.0.30 This minor version doesn't have any upgrade notes. # 40 Comentaris d'actualització a la versió 6.0.30 Aquesta actualització és una versió menor i no té pas comentaris. # 40 What's new in Zabbix 6.0.35 # 40 Novetats del Zabbix 6.0.35 # 41 Upgrade notes for 6.0.31 This minor version doesn't have any upgrade notes. # 41 Comentaris d'actualització a la versió 6.0.31 Aquesta actualització és una versió menor i no té pas comentaris. # 41 What's new in Zabbix 6.0.36 # 41 Què hi ha de nou al Zabbix 6.0.36 # 42 Upgrade notes for 6.0.32 # 42 Notes d'actualització per 6.0.32 # 42 What's new in Zabbix 6.0.37 This minor version does not have any functional changes. # 42 Novetats a Zabbix 6.0.37 Aquesta versió menor no té pas cap canvi funcional. # 43 Upgrade notes for 6.0.33 This minor version does not have any upgrade notes. # 43 Comentaris d'actualització a la versió 6.0.33 Aquesta actualització és una versió menor i no té pas comentaris. # 43 What's new in Zabbix 6.0.38 See [breaking changes](/manual/installation/upgrade_notes_6038#breaking-changes) for this version. # 43 Què hi ha de nou al Zabbix 6.0.38 Veieu els [canvis més importants](/manual/installation/upgrade_notes_6038#breaking-changes) per a aquesta versió. # 44 Upgrade notes for 6.0.34 # 44 Notes d'actualització per 6.0.34 # 44 What's new in Zabbix 6.0.39 See [breaking changes](/manual/installation/upgrade_notes_6039#breaking-changes) for this version. # 44 Què hi ha de nou al Zabbix 6.0.39 Veieu els [canvis més importants](/manual/installation/upgrade_notes_6039#breaking-changes) per a aquesta versió. # 45 Upgrade notes for 6.0.35 # 45 Comentaris d'actualització a la versió 6.0.35 # 45 What's new in Zabbix 6.0.40 # 45 Què hi ha de nou al Zabbix 6.0.40 # 46 Upgrade notes for 6.0.36 This minor version does not have any upgrade notes. # 46 Comentaris d'actualització a la versió 6.0.36 Aquesta actualització és una versió menor i no té pas comentaris. # 46 What's new in Zabbix 6.0.41 # 46 Què hi ha de nou al Zabbix 6.0.41 # 47 Upgrade notes for 6.0.37 This minor version does not have any upgrade notes. # 47 Comentaris d'actualització a la versió 6.0.37 Aquesta actualització és una versió menor i no té pas comentaris. # 47 What's new in Zabbix 6.0.42 # 47 Què hi ha de nou al Zabbix 6.0.42 # 48 Upgrade notes for 6.0.38 # 48 Notes d'actualització per 6.0.38 # 48 What's new in Zabbix 6.0.43 See [breaking changes](/manual/installation/upgrade_notes_6043#breaking-changes) for this version. # 48 Què hi ha de nou al Zabbix 6.0.43 Veieu els [canvis més importants](/manual/installation/upgrade_notes_6043#breaking-changes) per a aquesta versió. # 49 Upgrade notes for 6.0.39 # 49 Notes d'actualització per 6.0.39 # 49 What's new in Zabbix 6.0.44 # 49 Què hi ha de nou al Zabbix 6.0.44 # 4 Aggregation in graphs # 4 Agregació als gràfics ##### 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 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: - Command-line utilities zabbix\_get and zabbix\_sender are compiled if --enable-agent option is used. - --with-libcurl and --with-libxml2 configuration options are required for virtual machine monitoring; --with-libcurl is also required for SMTP authentication and `web.page.*` Zabbix agent [items](/manual/config/items/itemtypes/zabbix_agent). Note that cURL 7.20.0 or higher is [required](/manual/installation/requirements) with the --with-libcurl configuration option. - Zabbix always compiles with the PCRE library (since version 3.4.0); installing it is not optional. --with-libpcre=\[DIR\] only allows pointing to a specific base install directory, instead of searching through a number of common places for the libpcre files. - You may use the --enable-static flag to statically link libraries. If you plan to distribute compiled binaries among different servers, you must use this flag to make these binaries work without required libraries. Note that --enable-static does not work in [Solaris](https://docs.oracle.com/cd/E18659_01/html/821-1383/bkajp.html). - Using --enable-static option is not recommended when building server. In order to build the server statically, you must have a static version of every external library needed. There is no strict check for that in configure script. - Add optional path to the MySQL configuration file --with-mysql=/<path\_to\_the\_file>/mysql\_config to select the desired MySQL client library when there is a need to use one that is not located in the default location. It is useful when there are several versions of MySQL installed or MariaDB installed alongside MySQL on the same system. - Use --with-oracle flag to specify location of the OCI API. ::: noteimportant If ./configure fails due to missing libraries or some other circumstance, please see the `config.log` file for more details on the error. 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 While `config.log` has a more detailed description: /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) for encryption support - [Known issues](/manual/installation/known_issues/compilation_issues#compiling_zabbix_agent_on_hp-ux) with compiling Zabbix agent on HP-UX ##### 4 Configurar les fonts Es requereix C99 amb extensions GNU per crear un servidor Zabbix, un proxy Zabbix o un agent Zabbix. Aquesta versió es pot especificar explícitament configurant CFLAGS="-std=gnu99": export CFLAGS="-std=gnu99" ::: noteclassic Si instal·leu des d'un [repositori Git de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), cal que executeu abans: `./bootstrap.sh` ::: Quan configureu les fonts per a un servidor o proxy Zabbix, heu d'especificar el tipus de base de dades que s'emprarà. Només es pot compilar un tipus de base de dades amb un servidor o un procés proxy alhora. Per veure totes les opcions de configuració admeses, dins del directori d'origen de Zabbix extret, executeu: ./configure --help Per configurar les fonts per a un servidor i agent Zabbix, podeu executar quelcom com ara: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openipmi Per configurar les fonts per a un servidor Zabbix (amb PostgreSQL, etc.), podeu executar: ./configure --enable-server --with-postgresql --with-net-snmp Per configurar les fonts per a un proxy Zabbix (amb SQLite, etc.), podeu executar: ./configure --prefix=/usr --enable-proxy --with-net-snmp --with-sqlite3 --with-ssh2 Per configurar les fonts per a un agent Zabbix, podeu executar: ./configure --enable-agent o, per a l'agent Zabbix 2: ./configure --enable-agent2 ::: noteclassic Cal una [versió de Go suportada](/manual/installation/requirements#agent-2) per crear l'agent Zabbix 2. ::: Notes sobre les opcions de compilació: - Les utilitats de línia d'ordres zabbix\_get i zabbix\_sender es compilen si s'empra l'opció --enable-agent. - Calen les opcions de configuració --with-libcurl i --with-libxml2 per al monitoratge de la màquina virtual; --with-libcurl també cal per a l'autenticació SMTP i l'element `web.page.*` de l'[Agent Zabbix](/manual/config/items/itemtypes/zabbix_agent). Tingueu en compte que cURL 7.20.0 o superior és [requerit](/manual/installation/requirements) amb l'opció de configuració --with-libcurl. - Zabbix sempre compila amb la biblioteca PCRE (des de la versió 3.4.0); instal·lar-ho no és opcional. --with-libpcre=\[DIR\] només permet apuntar a un directori d'instal·lació bàsic específic, en lloc de cercar a través d'una sèrie de llocs comuns per als fitxers libpcre. - Podeu emprar l'assenyalador --enable-static per enllaçar estàticament biblioteques. Si teniu previst distribuir binaris compilats entre diferents servidors, heu d'emprar aquesta marca per fer que aquests binaris funcionin sense les biblioteques necessàries. Tingueu en compte que --enable-static no funciona a [Solaris](https://docs.oracle.com/cd/E18659_01/html/821-1383/bkajp.html). - No es recomana emprar l'opció --enable-static quan es construeix el servidor. Per tal de construir el servidor de manera estàtica, heu de tindre una versió estàtica de totes les biblioteques externes necessàries. No hi ha cap comprovació estricta d'això a l'script de configuració. - Afegiu un camí opcional al fitxer de configuració de MySQL --with-mysql=/<path\_to\_the\_file>/mysql\_config per triar la biblioteca client de MySQL desitjada quan calgui emprar-ne una que no es troba a la ubicació predeterminada. És útil quan hi ha diverses versions de MySQL instal·lades o MariaDB al costat de MySQL al mateix sistema. - Empreu l'assenyalador --with-oracle per especificar la ubicació de l'API OCI. ::: nota important Si ./configure falla per la manca de biblioteques o d'alguna altra circumstància, consulteu el fitxer `config.log` per obtindre més detalls sobre l'error. Per exemple, si manca `libssl`, el missatge d'error immediat pot ser enganyós: checking for main in -lmysqlclient... no configure: error: Not found mysqlclient library Tot i que `config.log` té una descripció més detallada: /usr/bin/ld: no es pot trobar -lssl /usr/bin/ld: no es pot trobar -lcrypto ::: Veieu també: - [Compilació de Zabbix amb suport de xifrat](/manual/encryption#compiling_zabbix_with_encryption_support) - [Problemes coneguts](/manual/installation/known_issues/compilation_issues#compiling_zabbix_agent_on_hp-ux) amb la compilació de l'agent Zabbix a HP-UX # 4 Discovery of SNMP OIDs # 4 Descoberta de OIDs SNMP # 4 Discovery rules # 4 Regles de descoberta # 4 Discovery rules # 4 Regles de descoberta # 4 Discovery status # 4 Estat de descoberta # 4 Events # 4 Esdeveniments # 4 Global search It is possible to search Zabbix frontend for hosts, host groups and templates. 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 Cerca global És possible cercar equips, grups d'equips i patrons a la interfície Zabbix. El quadre d'entrada de cerca es troba sota el logotip de Zabbix al menú. La cerca es pot iniciar prement *Enter* o fent clic a la icona de cerca .  Si un equip conté la cadena introduïda en qualsevol part del nom, apareixerà una llista desplegable amb tots aquests equips (amb la part corresponent ressaltada en carbassa). La llista desplegable també mostra un equip si el nom visible d'aquest equip coincideix amb el nom tècnic introduït com a cadena de cerca; apareixerà l'equip corresponent, però sense ressaltar-ho. # 4 History and trends # 4 Històric i tendències # 4 History functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) 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 # 4 Funcions d'historial Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb `<` `>` - Els paràmetres específics es descriuen amb cada funció - Els paràmetres `/host/key` i `(sec|#num)<:time shift>` mai han d'anar entre cometes # 4 Host dashboards # 4 Taulers d'equips # 4 Host prototypes # 4 Prototips d'equips # 4 Host prototypes # 4 Prototips d'equips # 4 Installation and first steps # 4 Instal·lació i primeres passes # 4 Installation from packages # 4 Instal·lació des dels paquets ##### 4 Install new server binaries Use these [instructions](/manual/installation/install#installing_zabbix_daemons) to compile Zabbix server from sources. ##### 4 Instal·lació dels nous binaris del servidor Empreu les [instruccions](/manual/installation/install#installation_zabbix_daemons) per compilar el servidor Zabbix des de la font. # 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 the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 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%2F6.0) # Operació de plantilla IPMI Els models IPMI no requereixen cap configuració específica. Per començar a monitorar, [enllaceu](/manual/config/templates/linking#linking-a-template) la plantilla a un equip destí (si la plantilla no és disponible a la vostra instal·lació de Zabbix, és possible que hagueu d'importar la plantilla .yaml). Consulteu la secció [plantilles per defecte](/manual/config/templates_out_of_the_box) per obtindre instruccions). Una descripció detallada d'una plantilla, inclosa la llista completa de macros, elements i triggers és disponible al fitxer README de la plantilla (accessible fent clic al nom de la plantilla). Plantilla disponible: - [Xassís per IPMI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/chassis_ipmi/README.md?at=refs%2Fheads%2Frelease%2F6.0)| # 4 Items Please use the sidebar to access content in this section. # 4 Elements # 4 JavaScript preprocessing # 4 Preprocessament de JavaScript # 4 Latest data # 4 Darreres dades # 4 Low-level discovery macros # 4 Macros de descoberta de baix nivell # 4 Maintenance # 4 Manteniment # 4 Mass update # 4 Actualització massiva # 4 Mass update # 4 Actualització massiva # 4 Memcached plugin # 4 Plugin Memcached # 4 Network maps # 4 Mapes de xarxa # 4 New trigger [comment]: # (tags: trigger) # 4 Trigger nou [comentari]: # (etiquetes: trigger) # 4 Notes on low-level discovery # 4 Notes sobre la descoberta de baix nivell # 4 Recommended UnixODBC settings for MSSQL # 4 Paràmetres UnixODBC recomanats per MSSQL # 4 Reports # 4 Informes ##### 4 Review agent configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew600) page. ##### 4 Reviseu els paràmetres de configuració de l'agent Assegureu-vos de revisar les [Notes d'actualització](/manual/installation/upgrade_notes_600) per comprovar si cal fer canvis en els paràmetres de configuració. Per obtindre nous paràmetres opcionals, consulteu la pàgina [Novetats](/manual/introduction/whatsnew600). ##### 4 Review proxy configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew600) page. ##### 4 Reviseu els paràmetres de configuració del proxy Assegureu-vos de revisar les [Notes d'actualització](/manual/installation/upgrade_notes_600) per comprovar si cal fer canvis en els paràmetres de configuració. Per obtindre nous paràmetres opcionals, consulteu la pàgina [Novetats](/manual/introduction/whatsnew600). # 4 Secure connection to the database # 4 Assegurar la connexió a la base de dades # 4 Setup example # 4 Exemple de configuració # 4 SLA report # 4 Informe SLA # 4 SNMP trap # 4 SNMP trap # 4 Trapper items # 4 Elements Trapper # 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 Gravetat dels triggers La gravetat del trigger defineix la importància d'un trigger.  Zabbix admet les següents gravetats de triggers: |Gravetat|Color|Descripció| |-|-|--------| |No classificat|Gris|Es pot emprar quan es desconeix el nivell de gravetat d'un esdeveniment, no s'ha determinat, no forma part de l'àmbit de monitoratge habitual, etc., per exemple, durant la configuració inicial, com a marcador de posició per a una avaluació futura, o com a part d'un procés d'integració.| |Informació|Blau clar|Es pot emprar per a esdeveniments informatius que no requereixen atenció immediata, però que encara poden proporcionar informació valuosa.| |Avís|Groc|Es pot emprar per indicar un problema potencial que pot requerir investigació o acció, però que no és crític.| |Mitjana|Carbassa|Es pot emprar per indicar un problema important que s'hauria d'abordar relativament aviat per evitar més problemes.| |Alt|Vermell clar|Es pot emprar per indicar problemes crítics que necessiten atenció immediata per evitar interrupcions importants.| |Desastre|Vermell|Es pot emprar per indicar un incident greu que requereix una acció immediata per evitar, per exemple, interrupcions del sistema o pèrdua de dades.| ::: noteclassic Els noms i colors de la gravetat del trigger es poden [personalitzar](/manual/config/triggers/customseverities). ::: Les gravetats s'empren per a: - una representació visual dels desencadenants - Diferents colors per a diferents gravetats; - àudio en alarmes globals - diferents sons d'àudio per a diferents gravetats; - suports d'usuaris - diferents suports (canals de notificació) per a diferents gravetats (per exemple, SMS - alta gravetat, correu electrònic - en cas contrari); - limitar les accions per condició en funció de la gravetat del trigger. # 4 Triggers top 100 # 4 Top 100 de triggers # 4 Update operations # 4 Operacions d'actualització ##### 4 Update repository configuration package Before proceeding with the upgrade, uninstall your current repository package: rm -Rf /etc/apt/sources.list.d/zabbix.list 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: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian12_all.deb dpkg -i zabbix-release_latest+debian12_all.deb On **Debian 11**, run: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian11_all.deb dpkg -i zabbix-release_latest+debian11_all.deb On **Debian 10**, run: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_latest+debian10_all.deb dpkg -i zabbix-release_latest+debian10_all.deb For older Debian versions, replace the link above with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/). Note, however, that packages for those versions may not include all Zabbix components. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=debian&os_version=9&components=agent&db=&ws=). On **Ubuntu 24.04**, run: wget https://repo.zabbix.com/zabbix/6.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: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu22.04_all.deb dpkg -i zabbix-release_latest+ubuntu22.04_all.deb On **Ubuntu 20.04**, run: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu20.04_all.deb dpkg -i zabbix-release_latest+ubuntu20.04_all.deb On **Ubuntu 18.04**, run: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_latest+ubuntu18.04_all.deb dpkg -i zabbix-release_latest+ubuntu18.04_all.deb For older Ubuntu versions, replace the link above with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/). Note, however, that packages for those versions may not include all Zabbix components. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=16.04&components=agent&db=&ws=). You may see a prompt about the Zabbix repository configuration: 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: apt update ##### 4 Actualització del paquet de configuració del repositori Per poder actualitzar, el paquet del repositori s'ha de desinstal·lar. rm -Rf /etc/apt/sources.list.d/zabbix.list Ara, instal·leu el nou paquet de configuració del repositori. Sota **Debian 12** executeu: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-5+debian12_all.deb dpkg -i zabbix-release_6.0-5+debian12_all.deb Sota **Debian 11** executeu: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian11_all.deb dpkg -i zabbix-release_6.0-1+debian11_all.deb Sota **Debian 10** executeu: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian10_all.deb dpkg -i zabbix-release_6.0-1+debian10_all.deb Sota **Debian 9** executeu: wget https://repo.zabbix.com/zabbix/6.0/debian/pool/main/z/zabbix-release/zabbix-release_6.0-1+debian9_all.deb dpkg -i zabbix-release_6.0-1+debian9_all.deb Sota **Ubuntu 20.04** executeu: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu20.04_all.deb dpkg -i zabbix-release_6.0-1+ubuntu20.04_all.deb Sota **Ubuntu 18.04** executeu: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu18.04_all.deb dpkg -i zabbix-release_6.0-1+ubuntu18.04_all.deb Sota **Ubuntu 16.04** executeu: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu16.04_all.deb dpkg -i zabbix-release_6.0-1+ubuntu16.04_all.deb Sota **Ubuntu 14.04** executeu: wget https://repo.zabbix.com/zabbix/6.0/ubuntu/pool/main/z/zabbix-release/zabbix-release_6.0-1+ubuntu14.04_all.deb dpkg -i zabbix-release_6.0-1+ubuntu14.04_all.deb És possible que veieu un missatge sobre la configuració del dipòsit Zabbix: Fitxer de configuració '/etc/apt/sources.list.d/zabbix.list' ==> Esborrat (per tu o per un script) des de la instal·lació. ==> El distribuïdor de paquets ha enviat una versió actualitzada. Què voleu fer al respecte? Les opcions són: Y o I : instal·leu la versió del responsable del paquet N o O : mantingueu la versió instal·lada actualment D : veieu les diferències entre les versions Z: inicieu un shell per examinar la situació L'acció per defecte és mantindre la versió actual. *** zabbix.list (Y/I/N/O/D/Z) [per defecte=N]? Premeu "Y" (o "I") per instal·lar la versió del responsable del paquet de la configuració del dipòsit Zabbix. Actualitzeu la informació del repositori. apt-get 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: rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm On **RHEL 8**, run: rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm For older RHEL versions, replace the link above with the correct one from [Zabbix repository](https://repo.zabbix.com/zabbix/6.0/rhel/). Note, however, that packages for those versions may not include all Zabbix components. For a list of components included, see [Zabbix packages](https://www.zabbix.com/download?zabbix=6.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): 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 Actualitza el paquet de configuració del dipòsit Abans de procedir amb l'actualització, actualitzeu el nou paquet de configuració del repositori per garantir la compatibilitat amb els nous paquets i incloure qualsevol pedaç de seguretat o de correcció d'errors. A **RHEL 9**, executeu: rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm A **RHEL 8**, executeu: rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-latest.el8.noarch.rpm Per versions més antigues de RHEL, canvieu aquest enllaç per el correcte del [repositori de Zabbix](https://repo.zabbix.com/zabbix/6.0/rhel/). Fixeu-vos també que els paquests d'aquestes versions poden no incloure tots els components de Zabbix. Per obtindre un llistat dels components inclosos, veieu els [paquets de Zabbix]https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=7&components=agent&db=&ws=). A continuació, netegeu la memòria cau del gestor de paquets `dnf` (incloses les capçaleres, metadades i fitxers de paquets descarregats durant instal·lacions o actualitzacions anteriors): dnf clean all A la següent operació `dnf`, `dnf` baixarà metadades noves dels repositoris, ja que s'esborraran les metadades antigues. Veieu també els [problemes coneguts](/manual/installation/known_issues#expired-signing-key-for-rhel-packages) per actualitzar el paquet de configuració del repositori amb RHEL. ##### 4 Update repository configuration package To proceed with the upgrade your current repository package has to be updated. # rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm ##### 4 Actualitza el paquet de configuració del dipòsit Per continuar amb l'actualització, s'ha d'actualitzar el vostre paquet de repositori actual. # rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/8/x86_64/zabbix-release-6.0-1.el8.noarch.rpm # 4 User groups # 4 Grups d'usuaris # 4 Using macros in messages # 4 Emprar macros a missatges # 4 Webhook # 4 Webhook # 4 Windows agent installation from MSI # 4 Instal·lació de l'agent Windows des d'MSI # 4 Zabbix agent 2 plugin protocol Please refer to the [connection protocol](https://www.zabbix.com/documentation/guidelines/en/plugins#connection-protocol) section on *Building plugins* page for more information. # 4 Protocol del plugin de l'agent Zabbix 2 Reviseu la secció [protocol de connexió](https://www.zabbix.com/documentation/guidelines/en/plugins#connection-protocol) a la pàgina *Créació de plugin* per tindre més informació. # 4 Zabbix agent 2 plugin protocol Zabbix agent 2 protocol is based on code, size and data model. # 4 Protocol del plug-in agent Zabbix 2 El protocol de l'agent Zabbix 2 es basa sobre el codi, mida i model de dades. # 4 Zabbix agent 2 (UNIX) # 4 Zabbix agent 2 (UNIX) # 4 Zabbix overview # 4 Vista general de Zabbix # 50 Upgrade notes for 6.0.40 This minor version does not have any upgrade notes. # 50 Comentaris d'actualització a la versió 6.0.40 Aquesta actualització és una versió menor i no té pas comentaris. # 50 What's new in Zabbix 6.0.45 # 50 Què hi ha de nou al Zabbix 6.0.45 # 51 Upgrade notes for 6.0.41 # 51 Notes d'actualització per 6.0.41 # 51 What's new in Zabbix 6.0.46 # 51 Què hi ha de nou al Zabbix 6.0.46 # 52 Upgrade notes for 6.0.42 This minor version does not have any upgrade notes. # 52 Comentaris d'actualització a la versió 6.0.42 Aquesta actualització és una versió menor i no té pas comentaris. # 52 What's new in Zabbix 6.0.47 # 52 Què hi ha de nou al Zabbix 6.0.47 # 53 Upgrade notes for 6.0.43 # 53 Notes d'actualització per 6.0.43 # 53 What's new in Zabbix 6.0.48 # 53 Què hi ha de nou al Zabbix 6.0.48 # 54 Upgrade notes for 6.0.44 This minor version does not have any upgrade notes. # 54 Comentaris d'actualització a la versió 6.0.44 Aquesta actualització és una versió menor i no té pas comentaris. # 55 Upgrade notes for 6.0.45 # 55 Comentaris d'actualització a la versió 6.0.45 # 56 Upgrade notes for 6.0.46 This minor version does not have any upgrade notes. # 56 Comentaris d'actualització a la versió 6.0.46 Aquesta actualització és una versió menor i no té pas comentaris. # 57 Upgrade notes for 6.0.47 This minor version does not have any upgrade notes. # 57 Comentaris d'actualització a la versió 6.0.47 Aquesta actualització és una versió menor i no té pas comentaris. # 58 Upgrade notes for 6.0.48 # 58 Notes d'actualització per 6.0.48 # 5 Actions # 5 Accions # 5 Audit # 5 Auditoria # 5 Configuration # 5 Configuració # 5 CSV to JSON preprocessing # 5 Preprocessament CSV cap a JSON # 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 Personalització de la gravetat dels triggers Els noms i els colors de la gravetat del trigger per als elements de la GUI relacionats amb la gravetat es poden configurar a *Administració → General → Visualització del trigger.*. Els colors es comparteixen entre tots els temes de la GUI. # 5 Discovery of JMX objects # 5 Descoberta d'objectes JMX # 5 Discovery rules Please use the sidebar to see discovery rule configuration examples for various cases. # 5 Regles de descoberta Utilitzeu la barra lateral per veure exemples de configuració de regles de descoberta per a diferents casos. # 5 Escalations # 5 Escalades # 5 Event correlation # 5 Correlació d'esdeveniments # 5 Expression macros # 5 Macros d'expressió # 5 Favorite graphs # 5 Gràfics preferits # 5 Frontend maintenance mode # 5 Mode de manteniment de la interfície Web # 5 Installation from containers # 5 Instal·lació des de contenidors # 5 Java gateway # 5 Passarel·la Java # 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 the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions. 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%2F6.0) - [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.0) # Operació de plantilla JMX Passes per garantir el correcte funcionament de les plantilles que recullen mètriques de [JMX](/manual/config/items/itemtypes/jmx_monitoring): 1. Assegureu-vos que Zabbix [Java Gateway](/manual/concepts/java#getting-java-gateway) sigui instal·lat i configurat correctament. 2. [Enllaceu](/manual/config/templates/linking#linking_a_template) la plantilla a l'equip destí. L'equip hauria de tindre la interfície JMX configurada.\ Si la plantilla no és disponible a la vostra instal·lació de Zabbix, és possible que hagueu d'importar primer el fitxer .yaml de la plantilla; veieu les [plantilles predefinides](/manual/config/templates_out_of_the_box) per obtindre instruccions. 3. Ajusteu els valors de les macros obligatòries segons sigui necessari. 4. Configureu la instància que és monitorant-se per permetre compartir dades amb Zabbix. Una descripció detallada d'una plantilla, inclosa la llista completa de macros, elements i triggers, és disponible al fitxer Readme.md de la plantilla (accessible fent clic al nom de la plantilla). Les següents plantilles són disponibles: - [Apache ActiveMQ per JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Cassandra de JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Kafka de JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Apache Tomcat de JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GridGain de JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Ignite per JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira Data Center per JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0) - [Domini WildFly de JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Servidor WildFly de JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 5 Mac OS agent installation from PKG # 5 Instal·lació de l'agent Mac OS des de PKG ##### 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 Construcció i instal·lació ::: noteclassic Si instal·leu des del repositori [Git Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), cal executar: `$ make dbschema` ::: make install Aquesta passa s'hauria d'executar amb un usuari amb prou permisos (normalment 'root', o via 'sudo'). L'execució de `make install` instal·larà per defecte els binaris del dimoni (zabbix\_server, zabbix\_agentd, zabbix\_proxy) a /usr/local/sbin i els binaris del client (zabbix\_get, zabbix\_sender) a /usr/local/bin. :::noteclassic Per triar una ubicació diferent de /usr/local, empreu la clau --prefix a la passa anterior de configuració de fonts; per exemple --prefix=/home/zabbix. En aquest cas, els binaris s'instal·laran sota <prefix>/sbin, mentre que les utilitats seran sota <prefix>/bin. Les pàgines man s'instal·laran sota <prefix>/share. ::: # 5 Maps [comment]: # (tags: map) # 5 Mapes [comentari]: # (etiquetes: mapa) # 5 Media types # 5 Tipus de suport # 5 Minimum permission level for Windows agent items # 5 Nivell mínim de permisos per als elements de l'agent Windows # 5 Modbus plugin # 5 Plugin Modbus # 5. Quickstart Please use the sidebar to access content in the Quickstart section. # 5. Inici ràpid Empreu la barra lateral per accedir al contingut de la secció d'Inici ràpid. # 5 Receiving problem notification # 5 Rebre una notificació de problema ##### 5 Review server configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. For new optional parameters, see the [What's new](/manual/introduction/whatsnew600) page. ##### 5 Reviseu els paràmetres de configuració del servidor Assegureu-vos de revisar les [Notes d'actualització](/manual/installation/upgrade_notes_600) per comprovar si cal fer canvis en els paràmetres de configuració. Per obtindre nous paràmetres opcionals, consulteu la pàgina [Novetats](/manual/introduction/whatsnew600). ##### 5 Start new Zabbix agent Start the new Zabbix agent. Check log files to see if the agent has started successfully. ##### 5 Engegar el nou agent Zabbix Engegueu el nou agent Zabbix. Verifiqueu els arxius de registre per verificar que l'agent s'ha engegat correctament. ##### 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 Inicieu el nou proxy Zabbix Inicieu el nou proxy Zabbix. Comproveu els fitxers de registre per veure si el proxy s'ha iniciat correctament. El proxy Zabbix actualitzarà automàticament la base de dades. L'actualització de la base de dades es fa de la mateixa manera que quan s'inicia el [Servidor Zabbix](/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, left, length, ltrim, mid, repeat, replace, right, rtrim, trim| These functions are supported in [trigger expressions](/manual/config/triggers/expression) and [calculated items](/manual/config/items/itemtypes/calculated). Foreach functions are supported only for [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate). # 5 Funcions admeses Feu clic al grup de funcions per veure'n els detalls. |Grup de funcions|<|Funcions| |-|----------|----------------------------------------| |[Funcions d'agregació](/manual/appendix/functions/aggregate)|<|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| | |[Funcions Foreach](/manual/appendix/functions/aggregate/foreach)|avg\_foreach,bucket\_rate\_foreach,count\_foreach,exists\_foreach,last\_foreach,max\_foreach,min\_foreach,sum\_foreach| |[Funcions binàries](/manual/appendix/functions/bitwise)|<|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Funcions de date i hora](/manual/appendix/functions/time)|<|date, dayofmonth, dayofweek, now, time| |[Funcions d'històric](/manual/appendix/functions/history)|<|change, changecount, count, countunique, find, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate| |[Funcions de tendència](/manual/appendix/functions/trends)|<|baselinedev, baselinewma, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[Funcions matemàtiques](/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| |[Funcions d'operador](/manual/appendix/functions/operator)|<|between, in| |[Funcions predictives](/manual/appendix/functions/prediction)|<|forecast, timeleft| |[Funcions de cadena de caràcters](/manual/appendix/functions/string)|<|ascii, bitlength, bytelength, char, concat, insert, left, length, ltrim, mid, repeat, replace, right, rtrim, trim| Aquestes funcions són admeses a les [expressions de trigger](/manual/config/triggers/expression) i els [elements calculats](/manual/config/items/itemtypes/calculated) Les funcions Foreach només s'admeten per als [càlculs afegits](/manual/config/items/itemtypes/calculated/aggregate). # 5 TimescaleDB setup # 5 Configuració TimescaleDB # 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) server parameter. Triggers that reference trend functions **only** are evaluated once per the smallest time period in the expression. For instance, a trigger like 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()) 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) 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 # 5 Funcions de tendència Les funcions de tendència, contràriament a les[funcions d'històric](/manual/appendix/functions/history), empren les dades de [tendències](/manual/config/items/history_and_trends#keeping-trends) per als seus càlculs. Les tendències emmagatzemen els valors horaris afegits. Les funcions de tendència empren les mitjanes horàries i són útils per fer anàlisi a llarg termini. Els resultats de la funció de tendència són es desen a la cau per tal que múltiples crides amb els mateixos paràmetres a la mateixa funció rebin la informació de la base de dades un sol cop. La cau de la funció de tendència es controla per el paràmetre de servidor [TrendFunctionCacheSize](/manual/appendix/config/zabbix_server). Els triggers que referencien les funcions de tendència **només** s'avaluen una sola vegada durant el període més curt de l'expressió. Per exemple, un trigger com ara trendavg(/host/key,1d:now/d) > 1 or trendavg(/host/key2,1w:now/w) > 2 s'avaluarà un cop al dia. Si el trigger té a la vegada funcions de tendència i històriques (o les funciona [data i hora](/manual/appendix/functions/time) i/o nodata()), calcularà segons els [usos principals](/manual/config/triggers#calculation-time). Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb `<` `>` - Els paràmetres específics es descriuen amb cada funció - Els paràmetres `/host/key` i `time period:time shift` mai han d'anar entre cometes ##### 5 Upgrade Zabbix components To upgrade Zabbix components you may run something like: apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent - If using PostgreSQL, substitute `mysql` with `pgsql` in the command. - If upgrading the proxy, substitute `server` with `proxy` in the command. - If upgrading the Zabbix agent 2, substitute `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: 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 the web frontend with Apache and restart Apache, run: apt install zabbix-apache-conf systemctl restart apache2 Distributions **prior to Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster)** do not provide PHP 7.2 or newer, which is required for Zabbix frontend 6.0. See [information](/manual/installation/frontend/frontend_on_debian) about installing Zabbix frontend on older distributions. ##### 5 Actualització dels components de Zabbix Per actualitzar els components de Zabbix, podeu executar: apt install --only-upgrade zabbix-server-mysql zabbix-frontend-php zabbix-agent - Si empreu PostgreSQL, substituïu `mysql` per `pgsql` a l'ordre. - Si sou actualitzant el proxy, substituïu "server" per "proxy" a l'ordre. - Si sou actualitzant l'agent 2, substituïu `zabbix-agent` per `zabbix-agent2 zabbix-agent2-plugin-*` a l'ordre. ::: noteimportant Actualitzar el Zabbix agent 2 amb la comanda `apt install zabbix-agent2` pot donar error. Per obtindre més informació, veieu els [*Errors coneguts*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: És possible que veieu un missatge sobre la configuració del servidor Zabbix (o proxy): Fitxer de configuració '/etc/zabbix/zabbix_server.conf' ==> Modificat (per vós o per un script) des de la instal·lació. ==> El distribuïdor de paquets ha enviat una versió actualitzada. Què voleu fer al respecte? Les opcions són: Y o I : instal·leu la versió del responsable del paquet N o O : mantingueu la versió instal·lada actualment D : veieu les diferències entre les versions Z: inicieu una shell per examinar la situació L'acció predeterminada és mantindrela versió actual. *** zabbix_server.conf (Y/I/N/O/D/Z) [per defecte=N]? Trieu l'opció que millor s'adapti a la vostra situació. Per exemple, trieu `D` per comparar la configuració actual i la nova, i després decidiu si voleu instal·lar la versió del responsable del paquet (`Y` o `I`). Tot seguit, actualitzeu la interfície web amb Apache i reinicieu-lo, executant: apt install zabbix-apache-conf systemctl restart apache2 Les distribucions **anteriors a Debian 10 (buster) / Ubuntu 18.04 (bionic) / Raspbian 10 (buster)** no tenen PHP7.2 o més nou, que és un requisit per la interfície de Zabbix 6.0. Veieu [informació](/manual/installation/frontend/frontend_on_debian) sobre com instal·lar la interfície de Zabbix a distribucions antigues. ##### 5 Upgrade Zabbix components To upgrade Zabbix components you may run something like: dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent - If using PostgreSQL, substitute `mysql` with `pgsql` in the command. - If upgrading the proxy, substitute `server` with `proxy` in the command. - If upgrading the agent 2, substitute `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 the web frontend with Apache and restart Apache, run: dnf install zabbix-apache-conf systemctl restart httpd ##### 5 Actualitzar els components de Zabbix Per actualitzar els components de Zabbix, podeu fer-ho executant: dnf install zabbix-server-mysql zabbix-web-mysql zabbix-agent - Si empreu PostgreSQL, substituïu `mysql` per `pgsql` a l'ordre. - Si sou actualitzant el proxy, substituïu "server" per "proxy" a l'ordre. - Si sou actualitzant l'agent 2, substituïu `zabbix-agent` per `zabbix-agent2 zabbix-agent2-plugin-*` a l'ordre. ::: noteimportant Actualitzar el Zabbix agent 2 amb la comanda `dnf install zabbix-agent2` pot donar error. Per obtindre més informació, veieu els [*Errors coneguts*](/manual/installation/known_issues#upgrading-zabbix-agent-2-6.0.5-or-older). ::: Tot seguit, actualitzeu la interfície Web d'Apache i reinicieu-lo, executant: dnf install zabbix-apache-conf systemctl restart httpd ##### 5 Upgrade Zabbix components To upgrade Zabbix components you may run something like: # yum upgrade zabbix-server-mysql zabbix-web-mysql zabbix-agent If using PostgreSQL, substitute `mysql` with `pgsql` in the command. If upgrading the proxy, substitute `server` with `proxy` in the command. If upgrading the agent 2, substitute `zabbix-agent` with `zabbix-agent2` in the command. To upgrade the web frontend with Apache **on RHEL 8** correctly, also run: # yum install zabbix-apache-conf and make the necessary [changes](/manual/installation/install_from_packages/rhel#zabbix_frontend_configuration) to this file. To upgrade the web frontend **on RHEL 7** follow [distribution-specific instructions](/manual/installation/frontend/frontend_on_rhel7) (extra steps are required to install PHP 7.2 or newer). ##### 5 Actualització dels components de Zabbix Per actualitzar els components de Zabbix, podeu executar: # # yum update zabbix-server-mysql zabbix-web-mysql zabbix-agent Si empreu PostgreSQL, substituïu `mysql` per `pgsql` a l'ordre. Si sou actualitzant el proxy, substituïu "server" per "proxy" a l'ordre. Si sou actualitzant l'agent Zabbix 2, substituïu `zabbix-agent` per `zabbix-agent2` a l'ordre. A continuació, per actualitzar correctament la interfície web amb Apache **a RHEL 8**, executeu: # yum install zabbix-apache-conf i feu els [canvis] necessaris (/manual/installation/install_from_packages/rhel#zabbix_frontend_configuration) a aquest fitxer. Per actualitzar la interfície web **a RHEL 7**, seguiu les [instruccions específiques de la distribució](/manual/installation/frontend/frontend_on_rhel7) (calen passes addicionals per instal·lar PHP 7.2 o posterior). # 5 User parameters # 5 Paràmetres d'usuari # 5 User roles # 5 Rols d'usuari # 5 Web scenarios # 5 Escenaris web # 5 Web scenarios # 5 Escenaris web # 5 What's new in Zabbix 6.0.0 See [breaking changes](#breaking_changes) for this version. # 5 Què hi ha de nou al Zabbix 6.0.0 Veieu els [canvis més importants](#breaking_changes) per a aquesta versió. # 5 Zabbix agent (Windows) # 5 Zabbix agent (Windows) # 5 Zabbix internal # 5 Verificacions internes # 5 Zabbix sender protocol Please refer to the [trapper item](/manual/appendix/items/trapper) page for more information. # 5 Protocol de l'enviador Zabbix Llegiu la pàgina de l'[element trapper](/manual/appendix/items/trapper) per tindre més informació. ### 6.0.13 ### 6.0.13 ### 6.0.14 ### 6.0.14 ### 6.0.15 ### 6.0.15 ### 6.0.19 ### 6.0.19 ### 6.0.22 ### 6.0.22 ### 6.0.3 ### 6.0.3 ### 6.0.34 ### 6.0.34 ### 6.0.38 ### 6.0.38 ### 6.0.39 ### 6.0.39 ### 6.0.7 ### 6.0.7 ### 6.0.9 ### 6.0.9 ##### 64 bit Open MinGW environment (Windows command prompt) and navigate to *build/mingw* directory in the Zabbix source tree. Run: mingw32-make clean mingw32-make PCRE=c:\dev\pcre OPENSSL=c:\dev\openssl ::: noteclassic Both 32- and 64- bit versions can be built on a 64-bit platform, but only a 32-bit version can be built on a 32-bit platform. When working on the 32-bit platform, follow the same steps as for 64-bit version on 64-bit platform. ::: ##### 64 bit Obriu l'entorn MinGW (indicador d'ordres de Windows) i navegueu al directori *build/mingw* a l'arbre de fonts de Zabbix. Executeu: mingw32-neteja mingw32 -make PCRE=c:\dev\pcre OPENSSL=c:\dev\openssl :::noteclassic Tant les versions de 32 bits com les de 64 bits es poden crear en una plataforma de 64 bits, però només es pot crear una versió de 32 bits en una plataforma de 32 bits. Quan treballeu a la plataforma de 32 bits, seguiu les mateixes passes que per a la versió de 64 bits a la plataforma de 64 bits. ::: # 6 Action log # 6 Registre d'accions # 6 Administration # 6 Administració # 6 Custom LLD rules # 6 Regles LLD personalitzades # 6 Discovery # 6 Descoberta # 6 Discovery of IPMI sensors # 6 Descoberta de sensors IPMI # 6 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 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. ::: # 6 Configuració d'Elasticsearch ::: noteimportant El suport d'Elasticsearch és experimental! ::: Zabbix admet l'emmagatzematge de dades històriques amb mitjanes d'Elasticsearch amb enllaç a una base de dades. Els usuaris poden triar l'enllaç d'emmagatzematge de dades històriques entre una base de dades compatible i Elasticsearch. El procés de configuració descrit en aquesta secció s'aplica a Elasticsearch v7.X. Si s'empra una versió anterior o posterior, algunes funcions poden no funcionar pas com es desitgi. ::: notewarning Si totes les dades d'històric s'emmagatzemen a Elasticsearch, les tendències no són **pas** calculades ni emmagatzemades a la base de dades. Amb absència de tendències calculades i emmagatzemades, el període d'emmagatzematge de l'històric podria perllongar-se. ::: # 6 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. # 6 Codificació dels valors retornats El servidor Zabbix espera que cada valor de text retornable sigui codificat amb UTF8. Això té relació amb qualsevol tipus de verificacions: agent zabbix, ssh, telnet, etc. Diferents sistemes/perifèrics monitorats i diferents verificacions poden retornar caràcters no-ASCII dins el seu valor. En aquest cas, gairebé totes les claus possibles de Zabbix contenen un paràmetre de clau addicional - **<encoding>**. Aquest paràmetre de clau és opcional, però convé especificar-ho si el valor reenviat no és dins la codificació UTF8 i si conté caracters no-ASCII. Sinó, el resultat podria ésser no esperat i imprevisible. Aquí sota trobareu una descripció del comportament amb diferents motors de base de dades. # 6 Event correlation # 6 Correlació d'esdeveniments # 6 Favorite maps # 6 Mapes preferits # 6 Header # 6 Capçalera # 6 Loadable modules # 6 Mòduls carregables # 6 Log file monitoring [comment]: # (tags: logrt, logfile, log) # 6 Supervisió dels fitxers de registre [comentari]: # (etiquetes: logrt, logfile, registre) # 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 Macros # 6 Mass update # 6 Actualització massiva # 6 Mathematical functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Mathematical functions are supported with float and integer value types, unless stated otherwise. 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 `<` `>` |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**abs** (value)|<|<| |The absolute value (from 0) of a value.|**value** - value to check|For example, the absolute value of either '3' or '-3' will be '3'.<br><br>Example:<br>=> **abs**(last(/host/key))>10| |**acos** (value)|<|<| |The arccosine of a value as an angle, expressed in radians.|**value** - value to check|The value must be between -1 and 1.<br><br>For example, the arccosine of a value '0.5' will be '2.0943951'.<br><br>Example:<br>=> **acos**(last(/host/key))| |**asin** (value)|<|<| |The arcsine of a value as an angle, expressed in radians.|**value** - value to check|The value must be between -1 and 1.<br><br>For example, the arcsine of a value '0.5' will be '-0.523598776'.<br><br>Example:<br>=> **asin**(last(/host/key))| |**atan** (value)|<|<| |The arctangent of a value as an angle, expressed in radians.|**value** - value to check|For example, the arctangent of a value '1' will be '0.785398163'.<br><br>Example:<br>=> **atan**(last(/host/key))| |**atan2** (value,abscissa)|<|<| |The arctangent of the ordinate (value) and abscissa coordinates specified as an angle, expressed in radians.|**value** - value to check<br>**abscissa** - abscissa value|For example, the arctangent of the ordinate and abscissa coordinates of a value '1' will be '2.21429744'.<br><br>Example:<br>=> **atan2**(last(/host/key),2)| |**avg** (<value1>,<value2>,...)|<|<| |Average value of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **avg**(avg(/host/key),avg(/host2/key2))| |**cbrt** (value)|<|<| |Cube root of a value.|**value** - value to check|For example, the cube root of '64' will be '4', of '63' will be '3.97905721'.<br><br>Example:<br>=> **cbrt**(last(/host/key))| |**ceil (value)**|<|<| |Round the value up to the nearest greater or equal integer.|**value** - value to check|For example, '2.4' will be rounded up to '3'.<br><br>Example:<br>=> **ceil**(last(/host/key))<br><br>See also floor().| |**cos (value)**|<|<| |The cosine of a value, where the value is an angle expressed in radians.|**value** - value to check|For example, the cosine of a value '1' will be '0.54030230586'.<br><br>Example:<br>=> **cos**(last(/host/key))| |**cosh (value)**|<|<| |The hyperbolic cosine of a value.|**value** - value to check|For example, the hyperbolic cosine of a value '1' will be '1.54308063482'.<br><br>Returns value as a real number, not as scientific notation.<br><br>Example:<br>=> **cosh**(last(/host/key))| |**cot (value)**|<|<| |The cotangent of a value, where the value is an angle, expressed in radians.|**value** - value to check|For example, the cotangent of a value '1' will be '0.54030230586'.<br><br>Example:<br>=> **cot**(last(/host/key))| |**degrees (value)**|<|<| |Converts a value from radians to degrees.|**value** - value to check|For example, a value '1' converted to degrees will be '57.2957795'.<br><br>Example:<br>=> **degrees**(last(/host/key))| |**e**|<|<| |Euler's number (2.718281828459045).|<|Example:<br>=> **e**()| |**exp** (value)|<|<| |Euler's number at a power of a value.|**value** - value to check|For example, Euler's number at a power of a value '2' will be '7.38905609893065'.<br><br>Example:<br>=> **exp**(last(/host/key))| |**expm1 (value)**|<|<| |Euler's number at a power of a value minus 1.|**value** - value to check|For example, Euler's number at a power of a value '2' minus 1 will be '6.38905609893065'.<br><br>Example:<br>=> **expm1**(last(/host/key))| |**floor** (value)|<|<| |Round the value down to the nearest smaller or equal integer.|**value** - value to check|For example, '2.6' will be rounded down to '2'.<br><br>Example:<br>=> **floor**(last(/host/key))<br><br>See also ceil().| |**log** (value)|<|<| |Natural logarithm.|**value** - value to check|For example, the natural logarithm of a value '2' will be '0.69314718055994529'.<br><br>Example:<br>=> **log**(last(/host/key))| |**log10** (value)|<|<| |Decimal logarithm.|**value** - value to check|For example, the decimal logarithm of a value '5' will be '0.69897000433'.<br><br>Example:<br>=> **log10**(last(/host/key))| |**max** (<value1>,<value2>,...)|<|<| |Highest value of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **max**(avg(/host/key),avg(/host2/key2))| |**min** (<value1>,<value2>,...)|<|<| |Lowest value of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **min**(avg(/host/key),avg(/host2/key2))| |**mod** (value,denominator)|<|<| |Division remainder.|**value** - value to check<br>**denominator** - division denominator|For example, division remainder of a value '5' with division denominator '2' will be '1'.<br><br>Example:<br>=> **mod**(last(/host/key),2)| |**pi**|<|<| |Pi constant (3.14159265358979).|<|Example:<br>=> **pi**()| |**power** (value,power value)|<|<| |The power of a value.|**value** - value to check<br>**power value** - the Nth power to use|For example, the 3rd power of a value '2' will be '8'.<br><br>Example:<br>=> **power**(last(/host/key),3)| |**radians** (value)|<|<| |Convert a value from degrees to radians.|**value** - value to check|For example, a value '1' converted to radians will be '0.0174532925'.<br><br>Example:<br>=> **radians**(last(/host/key))| |**rand**|<|<| |Return a random integer value.| |A pseudo-random generated number using time as seed (enough for mathematical purposes, but not cryptography).<br><br>Example:<br>=> **rand**()| |**round** (value,decimal places)|<|<| |Round the value to decimal places.|**value** - value to check<br>**decimal places** - specify decimal places for rounding (0 is also possible)|For example, a value '2.5482' rounded to 2 decimal places will be '2.55'.<br><br>Example:<br>=> **round**(last(/host/key),2)| |**signum** (value)|<|<| |Returns '-1' if a value is negative, '0' if a value is zero, '1' if a value is positive.|**value** - value to check|Example:<br>=> **signum**(last(/host/key))| |**sin** (value)|<|<| |The sine of a value, where the value is an angle expressed in radians.|**value** - value to check|For example, the sine of a value '1' will be '0.8414709848'.<br><br>Example:<br>=> **sin**(last(/host/key))| |**sinh** (value)|<|<| |The hyperbolical sine of a value.|**value** - value to check|For example, the hyperbolical sine of a value '1' will be '1.17520119364'.<br><br>Example:<br>=> **sinh**(last(/host/key))| |**sqrt** (value)|<|<| |Square root of a value.|**value** - value to check|This function will fail with a negative value.<br><br>For example, the square root of a value '3.5' will be '1.87082869339'.<br><br>Example:<br>=> **sqrt**(last(/host/key))| |**sum** (<value1>,<value2>,...)|<|<| |Sum of the referenced item values.|**valueX** - value returned by another function that is working with item history|Example:<br>=> **sum**(avg(/host/key),avg(/host2/key2))| |**tan** (value)|<|<| |The tangent of a value.|**value** - value to check|For example, the tangent of a value '1' will be '1.55740772465'.<br><br>Example:<br>=> **tan**(last(/host/key))| |**truncate** (value,decimal places)|<|<| |Truncate the value to decimal places.|**value** - value to check<br>**decimal places** - specify decimal places for truncating (0 is also possible)|Example:<br>=> **truncate**(last(/host/key),2)| # 6 Funcions matemàtiques Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Les funcions matemàtiques són admeses amb els tipus de coma flotant i enters, si no es diu el contrari. Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - Les expressions s'accepten com a paràmetres - Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb `<` `>` |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**abs** (valor)|<|<| |El valor absolut (des de zero) d'un valor.|**valor** - valor a comprovar|Per exemple, el valor absolut de '3' o '-3' serà '3'.<br><br>Exemple:<br>=> **abs**(last(/host/key))>10| |**acos** (valor)|<|<| |L'arc cosinus d'un valor en forma d'angle, expressat en radians.|**valor** - valor a verificar|El valor ha d'ésser entre -1 i 1.<br><br>Per exemple, l'arc cosinus de '0.5' serà '2.0943951'.<br><br>Exemple:<br>=> **acos**(last(/host/key))| |**asin** (valor)|<|<| |L'arc sinus d'un valor en forma d'angle, expressat en radians.|**valor** - valor a verificar|El valor ha d'ésser entre -1 i 1.<br><br>Per exemple, l'arc sinus de '0.5' serà '-0.523598776'.<br><br>Exemple:<br>=> **asin**(last(/host/key))| |**atan** (valor)|<|<| |L'arc tangent d'un valor en forma d'angle, expressat en radians.|**valor** - valor a verificar|Per exemple, l'arc tangent de '1' serà '0.785398163'.<br><br>Exemple:<br>=> **atan**(last(/host/key))| |**atan2** (valor,abscissa)|<|<| |L'arc tangent de l'ordenada i les coordenades d'abscissa especificades en forma d'angle, expressats en radians.|**valor** - valor a verificar<br>**abscissa** - valor de l'abscissa|Per exemple, l'arc tangent de les coordenades d'ordenada i abscissa del valor '1' serà '2.21429744'.<br><br>Exemple:<br>=> **atan2**(last(/host/key),2)| |**avg** (<valor1>,<valor2>,...)|<|<| |Valor mitjà dels valors dels elements referenciats.|**valorX** - valor retornat per una altra funció que treballa amb elements d'històric|Exemple:<br>=> **avg**(avg(/host/key),avg(/host2/key2))| |**cbrt** (valor)|<|<| |Arrel cúbica d'un valor.|**valor** - valor a verificar|Per exemple, l'arrel cúbica de '64' serà '4', la de '63' serà '3.97905721'.<br><br>Exemple:<br>=> **cbrt**(last(/host/key))| |**ceil (valor)**|<|<| |Arrodonir el valor a l'enter superior o igual més proper.|**valor** - valor a verificar|Per exemple, '2.4' s'arrodonirà a '3'.<br><br>Exemple:<br>=> **ceil**(last(/host/key))<br><br>Veieu igualment floor().| |**cos (valor)**|<|<| |El cosinus d'un valor, on el valor és un angle expressat en radians.|**valor** - valor a verificar|Per exemple, el cosinus del valor '1' serà '0.54030230586'.<br><br>Exemple:<br>=> **cos**(last(/host/key))| |**cosh (valor)**|<|<| |El cosinus hiperbòlic d'un valor.|**valor** - valor a verificar|Per exemple, el cosinus hiperbòlic del valor '1' serà '1,54308063482'.<br><br>Reenvia el valor en forma de nombre real, i no en forma de notació científica.<br><br>Exemple:<br>=> **cosh**(last(/host/key))| |**cot (valor)**|<|<| |La cotangent d'un valor, on el valor és un angle, expressat en radians.|**valor** - valor a verificar|Per exemple, la cotangent del valor '1' serà '0.54030230586'.<br><br>Exemple:<br>=> **cot**(last(/host/key))| |**degrees (valor)**|<|<| |Convertir un valor de radians en graus.|**valor** - valor a verificar|Per exemple, el valor '1' convertit en graus serà '57.2957795'.<br><br>Exemple:<br>=> **degrees**(last(/host/key))| |**e**|<|<| |El nombre d'Euler (2.718281828459045).|<|Exemple:<br>=> **e**()| |**exp** (valor)|<|<| |Nombre d'Euler à la potència d'un valor.|**valor** - valor a verificar|Per exemple, el nombre d'Euler la potència '2' serà '7.38905609893065'.<br><br>Exemple:<br>=> **exp**(last(/host/key))| |**expm1 (valor)**|<|<| |Nombre d'Euler a una potència d'un valor inferior a 1.|**valor** - valor a verificar|Per exemple, el nombre d'Euler a una potència de '2' menys 1 serà '6.38905609893065'.<br><br>Exemple:<br>=> **expm1**(last(/host/key))| |**floor** (valor)|<|<| |Arrondir el valor a l'enter inferior o igual més proper.|**valor** - valor a verificar|Per exemple, '2.6' s'arrodonirà a '2'.<br><br>Exemple:<br>=> **floor**(last(/host/key))<br><br>Veieu ceil().| |**log** (valor)|<|<| |Logaritme natural.|**valor** - valor a verificar|Per exemple, el logaritme natural de '2' serà '0.69314718055994529'.<br><br>Exemple:<br>=> **log**(last(/host/key))| |**log10** (valor)|<|<| |Logaritme decimal.|**valor** - valor a verificar|Per exemple, el logaritme decimal de '5' serà '0.69897000433'.<br><br>Exemple:<br>=> **log10**(last(/host/key))| |**max** (<valor1>,<valor2>,...)|<|<| |El valor més alt dels valors referenciats.|**valorX** - valor retornat per una altra funció que treballa amb elements d'històric|Exemple:<br>=> **max**(avg(/host/key),avg(/host2/key2))| |**min** (<valor1>,<valor2>,...)|<|<| |El valor més baix dels valors referenciats.|**valorX** - valor retornat per una altra funció que treballa amb elements d'històric|Exemple:<br>=> **min**(avg(/host/key),avg(/host2/key2))| |**mod** (valor,denominador)|<|<| |Resta de divisió.|**valor** - valor a verificar<br>**denominador** - denominador de divisió|Per exemple, la resta de divisió de '5' amb denominador '2' serà '1'.<br><br>Exemple:<br>=> **mod**(last(/host/key),2)| |**pi**|<|<| |Constant Pi (3.14159265358979).|<|Exemple :<br>=> **pi**()| |**power** (valor,valor més alt)|<|<| |Potència d'un valor.|**valor** - valor a verificar<br>**valor de potència** - l'N-èssima potència a emprar|Per exemple, la 3a potència de '2' serà '8' .<br><br>Exemple:<br>=> **power**(last(/host/key),3)| |**radians** (valor)|<|<| |Convertir un valor de graus a radians.|**valor** - valor a verificar|Per exemple, '1' convertit a radians serà '0.0174532925'.<br><br>Exemple:<br>=> **radians**(last(/host/key))| |**rand**|<|<| |Retorna un valor enter a l'atzar.| |Un nombre generat de forma pseudo-aleatòria emprant el temps com a base (prou per finalitats matemàtiques, però no pas per criptogràfiques).<br><br>Exemple:<br>=> **rand**()| |**round** (valor,decimals)|<|<| |Arrodoneix el valor a decimals.|**valor** - valor a verificar<br>**decimals** - nombre de decimals (es permet 0)|Per exemple, '2.5482' arrodonit a 2 decimals serà '2.55'.<br><br>Exemple:<br>=> **round**(last(/host/key),2)| |**signum** (valor)|<|<| |Retorna '-1' si el valor és negatiu, '0' és nul, '1' si és positiu.|**valor** - valor a verificar|Exemple:<br>=> **signum**(last(/host/key))| |**sin** (valor)|<|<| |El sinus d'un valor, on el valor és un angle expressat en radians.|**valor** - valor a verificar|Per exemple, el sinus del valor '1' serà '0.8414709848'.<br><br> Exemple:<br>=> **sin**(last(/host/key))| |**sinh** (valor)|<|<| |El sinus hiperbòlic d'un valor.|**valor** - valor a verificar|Per exemple, el sinus hiperbòlic del valor '1' serà '1.17520119364'.<br><br>Exemple:<br>=> **sinh**(last(/host/key))| |**sqrt** (valor)|<|<| |Arrel quadrada d'un valor.|**valor** - valor a verificar|Aquesta funció no funcionarà pas amb un valor negatiu.<br><br>Per exemple, l'arrel quadrada de '3.5' serà '1.87082869339'. <br><br>Exemple:<br>=> **sqrt**(last(/host/key))| |**sum** (<valor1>,<valor2>,...)|<|<| |Suma dels valors dels elements referenciats.|**valorX** - valor retornat per una de les funcions d'històric|Exemple:<br>=> **sum**(avg(/host/key),avg(/host2/key2))| |**tan** (valor)|<|<| |La tangent d'un valor.|**valor** - valor a verificar|Per exemple, la tangent del valor '1' serà '1.55740772465'.<br><br>Exemple:<br>=> **tan**(last(/host/key))| |**truncate** (valor,decimals)|<|<| |Truncar el valor a decimals.|**valor** - valor a verificar<br>**decimals** - nombre de decimals (0 és permès)|Exemple:<br>=> **truncate**(last(/host/key),2)| # 6 MongoDB plugin # 6 Plugin MongoDB # 6 New template # 6 Plantilla nova # 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 the template's .yaml file first - see [Templates out-of-the-box](/manual/config/templates_out_of_the_box) section for instructions). 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%2F6.0) - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) # Operació de plantilla ODBC Passes per garantir el correcte funcionament de les plantilles que recullen mètriques mitjançant [control ODBC](/manual/config/items/itemtypes/odbc_checks): 1. Assegureu-vos que el controlador ODBC necessari sigui instal·lat al servidor o al proxy Zabbix. 2. [Enllaç](/manual/config/templates/linking#linking-a-template) la plantilla a un equip destí (si la plantilla no és disponible a la vostra instal·lació de Zabbix, primer haureu d'importar el fitxer .yaml de la plantilla; veieu la secció [Plantilles de fàbrica](/manual/config/templates_out_of_the_box) per obtindre instruccions). 3. Ajusteu els valors de les macros obligatòries segons sigui necessari. 4. Configureu la instància que es monitora per permetre compartir dades amb Zabbix. Una descripció detallada d'una plantilla, inclosa la llista completa de macros, elements i triggers, és disponible al fitxer Readme.md de la plantilla (accessible fent clic al nom de la plantilla). Les següents plantilles són disponibles: - [MSSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MySQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Oracle per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [PostgreSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) # 6 Page parameters # 6 Paràmetres de la pàgina ##### 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 Revisar i editar els arxius de configuració - editeu el fitxer de configuració de l'agent Zabbix **/usr/local/etc/zabbix\_agentd.conf** Heu de configurar aquest fitxer per a cada equip on sigui instal·lat zabbix\_agentd. Heu d'especificar l'**adreça IP** del servidor Zabbix al fitxer. Es rebutjaran les connexions d'altres equips. - Editeu el fitxer de configuració del servidor Zabbix **/usr/local/etc/zabbix\_server.conf** Heu d'especificar el nom de la base de dades, l'usuari i el mot de pas (si en feu servir). La resta de la configuració hauria d'estar bé amb els seus valors predeterminats si teniu una petita instal·lació (fins a deu equips monitorats). Tanmateix, haureu de canviar la configuració predeterminada si voleu optimitzar el rendiment del servidor Zabbix (o proxy). - Si heu instal·lat un proxy Zabbix, editeu el fitxer de configuració del proxy **/usr/local/etc/zabbix\_proxy.conf** Heu d'especificar l'adreça IP del servidor i el nom d'equip del proxy (que el servidor ha de conèixer), així com el nom de la base de dades, l'usuari i el mot de pas (si n'utilitzeu un). :::noteclassic Amb SQLite, s'ha d'especificar el camí complet al fitxer de base de dades; l'usuari i el mot de pas de la base de dades no calen. ::: ##### 6 Review component configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. ##### 6 Revisar els paràmetres de configuració dels components Assegureu-vos de revisar les [notes d'actualització](/manual/installation/upgrade_notes_600) per comprovar si cal fer cap canvi en els paràmetres de configuració. ##### 6 Review component configuration parameters Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_600) to check if any changes in the configuration parameters are required. ##### 6 Revisar els paràmetres de configuració dels components Assegureu-vos de revisar les [notes d'actualització](/manual/installation/upgrade_notes_600) per comprovar si cal fer cap canvi en els paràmetres de configuració. ##### 6 Review component configuration parameters See the upgrade notes for details on [mandatory changes](/manual/installation/upgrade_notes_600#configuration_parameters). ##### 6 Revisió dels paràmetres de configuració dels components Consulteu les notes d'actualització per obtindre més informació sobre els [canvis necessaris](/manual/installation/upgrade_notes_600#configuration_parameters) (si n'hi ha). # 6 Sender # 6 Sender ##### 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 Engegar els nous binaris de Zabbix Inicieu els nous binaris. Comproveu els fitxers de registre per veure si els binaris s'han iniciat correctament. El servidor Zabbix actualitzarà automàticament la base de dades. A l'inici, el servidor Zabbix informa de les versions de la base de dades actuals (obligatòries i opcionals) i requerides. Si la versió actual és més antiga que la necessària, el servidor Zabbix executa automàticament els pedaços d'actualització de la base de dades necessaris. El progrés (en percentatge) de l'actualització de la base de dades s'escriu al fitxer de registre del servidor Zabbix. Quan s'ha completat l'actualització, s'escriu un missatge "Actualització de la base de dades completada" al fitxer de registre. Si algun dels pegats d'actualització falla, el servidor Zabbix no s'iniciarà pas. El servidor Zabbix tampoc s'iniciarà si la versió actual de la base de dades és més recent de la necessària. El servidor Zabbix només s'inicia si la versió obligatòria actual de la base de dades coincideix amb la versió obligatòria requerida. 8673:20161117:104750.259 versió actual de la base de dades (obligatori/opcional): 03040000/03040000 8673:20161117:104750.259 versió obligatòria necessària: 03040000 Abans d'engegar el servidor: - Assegureu-vos que l'usuari de la base de dades té els permisos necessaris (crear taula, esborrar taula, crear índex, esborrar índex); - Assegureu-vos que teniu prou espai lliure al disc. # 6 Tagging # 6 Etiquetat # 6 Unstable releases # 6 Versions inestables # 6 Users # 6 Usuaris # 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 Instal·lació de la interfície Web Aquesta secció proporciona instruccions passa a passa per instal·lar la interfície web de Zabbix. El frontend de Zabbix està escrit en PHP, de manera que per executar-lo cal un servidor web compatible amb PHP. # 6 What's new in Zabbix 6.0.1 # 6 Què hi ha de nou al Zabbix 6.0.1 # 6 Zabbix agent 2 (Windows) # 6 Zabbix agent 2 (Windows) # 6. Zabbix appliance # 6. Aplicació Zabbix # 6 Zabbix trapper # 6 Zabbix trapper # 7. Configuration Please use the sidebar to access content in the Configuration section. # 7. Configuració Empreu la barra lateral per accedir al contingut de la secció Configuració. # 7 Definitions # 7. Definicions # 7 Discovery # 7 Descoberta # 7 Discovery of systemd services # 7 Descoberta de serveis systemd # 7 External check # 7 Comprovacions externes # 7 Geomap # 7 Geomapes # 7 Geomap # 7 Geomapes # 7 Get # 7 Get ##### 7 Install new Zabbix web interface The minimum required PHP version is 7.2.5. Update if needed and follow [installation instructions](/manual/installation/frontend). ##### 7 Instal·lació de la nova interfície Web de Zabbix La versió mínima requerida de PHP és la 7.2.5. Actualitzeu-la si cal i seguiu les [instruccions d'instal·lació](/manual/installation/frontend). # 7 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. Since Zabbix 2.0 support for large files has been added. This change 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#virtual-file-system-data). 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. # 7 Suport de fitxers grans El suport de fitxers grans, sovint abreujat LFS (Large File Support), és el terme que designa la possibilitat de treballar amb els arxius de més de 2Go amb sistemes d'explotació de 32 bits. A partir de la versió 2.0 de Zabbix, s'ha afegit el suport de de fitxers grans. Aquesta modificació afecta, com a mínim, el [monitoratge de l'arxiu de registre](/manual/config/items/itemtypes/zabbix_agent/log_items) i tots els [elements vfs.file.\*](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data). El suport d'arxius grans depen de la capacitat del sistema al moment de la compilació de Zabbix, però és desactivada sota Solaris 32 bits perquè és incompatible amb procfs i swapctl. # 7 Media types # 7 Tipus de suport # 7 MQTT plugin # 7 Plugin MQTT # 7 Notifications # 7 Notificacions # 7 Operator functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) Some general notes on function parameters: - Function parameters are separated by a comma - Expressions are accepted as parameters |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**between** (value,min,max)|<|<| |Check if a value belongs to the given range.|**value** - value to check<br>**min** - minimum value<br>**max** - maximum value|Supported value types: integer, float<br><br>Returns:<br>1 - in range<br>0 - otherwise<br><br>Example:<br>=> **between**(last(/host/key),**1**,**10**)=1 - trigger if the value is between 1 and 10.| |**in** (value,value1,value2,...valueN)|<|<| |Check if a value is equal to at least one of the listed values.|**value** - value to check<br>**value1,value2,...valueN** - listed values (string values must be double-quoted)|Supported value types: all<br><br>Returns:<br>1 - if equal<br>0 - otherwise<br><br>The value is compared to the listed values as numbers, if all of these values can be converted to numeric; otherwise compared as strings.<br><br>Example:<br>=> **in**(last(/host/key),**5**,**10**)=1 - trigger if the last value is equal to 5 or 10<br>=> **in**(**"text"**, last(/host/key),last(/host/key,\#2))=1 - trigger if "text" is equal to either of the last 2 values.| # 7 Funcions d'operador Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - S'accepten les expressions com a paràmetres |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**between** (valor,min,max)|<|<| |Verificar si un valor pertany al rang donat.|**valor** - valor a verificar<br>**min** - valor mínim<br>**max** - valor màxim|Tipus de valor admesos: enter, coma flotant<br><br>Retorna:<br>1 - dins el rang<br>0 - qualsevol altre valor<br><br>Exemple:<br>=> **between**(last(/host/key),**1**,**10**)=1 - trigger si el valor és entre 1 i 10.| |**in** (valor,valor1,valor2,...valorN)|<|<| |Verificar si un valor és igual a o inferior a un dels valors proporcionats.|**valor** - valor a verificar<br>**valor1,valor2,...valorN** - valors admesos (els valors de cadena han de tindre cometes dobles)|Tipus de valors admesos: tots<br><br>Retorna:<br>1 - si és igual<br>0 - si no ho és<br><br>El valor es compara amb valors admesos en forma de nombres, si tots aquests valors poden ésser convertits a numèrics; sinó compara les cadenes.<br><br>Exemple:<br>=> **in**(last(/host/key),**5**,**10**)=1 - trigger si el darrer valor és igual a 5 o 10<br>=> **in**(**"text"**, last(/host/key),last(/host/key,\#2))=1 - trigger si "text" és igual a un dels dos darrers valors.| # 7 Predictive trigger functions # 7 Funcions predictives de triggers # 7 Real-time export of events, item values, trends # 7 Exportació en temps real dels esdeveniments, dels valors dels elements, de les tendències # 7 Real-time export protocol This section presents details of the [real-time export](/manual/appendix/install/real_time_export) protocol in a newline-delimited JSON format for: - [trigger events](#trigger_events) - [item values](#item_values) - [trends](#trends) All files have a .ndjson extension. Each line of the export file is a JSON object. # 7 Protocol d'exportació en temps real Aquesta secció proporciona detalls del protocol [exportació en temps real](/manual/appendix/install/real_time_export) en format JSON delimitat de nova línia per a: - [esdeveniments de trigger](#trigger_events) - [valors d'element](#element_valors) - [tendències](#tendències) Tots els fitxers tenen l'extensió .ndjson. Cada línia del fitxer d'exportació és un objecte JSON. # 7 Standardized templates for network devices # 7 Plantilles estandarditzades per a dispositius de xarxa ##### 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 Engegar els dimonis Executeu zabbix\_server al servidor Zabbix. zabbix_server ::: noteclassic Assegureu-vos que el vostre sistema permet l'assignació de 36 Mo (o una mica més) de memòria compartida, en cas contrari, el servidor podria no iniciar-se i veureu "No s'ha pogut assignar memòria compartida per a <tipus de memòria cau>" al fitxer de registre del servidor. Això pot passar a FreeBSD, Solaris 8. ::: Executeu zabbix\_agentd a les màquines monitorades. zabbix_agentd :::noteclassic Assegureu-vos que el vostre sistema permet l'assignació de 2 Mo de memòria compartida, en cas contrari, és possible que l'agent no s'iniciï i veureu "No s'ha pogut assignar la memòria compartida per al col·lector" al fitxer de registre de l'agent. Això pot passar a Solaris 8. ::: Si heu instal·lat un proxy Zabbix, executeu zabbix\_proxy. zabbix_proxy ##### 7 Start Zabbix processes Start the updated Zabbix components. # systemctl start zabbix-server # systemctl start zabbix-proxy # systemctl start zabbix-agent # systemctl start zabbix-agent2 ##### 7 Inici dels processos de Zabbix Inicieu els components actualitzats de Zabbix. # systemctl start zabbix-server # systemctl start zabbix-proxy # systemctl start zabbix-agent # systemctl start zabbix-agent2 ##### 7 Start Zabbix processes Start the updated Zabbix components. systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ##### 7 Inici dels processos de Zabbix Inicieu els components actualitzats de Zabbix. systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ##### 7 Start Zabbix processes Start the updated Zabbix components. systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 ##### 7 Inici dels processos de Zabbix Inicieu els components actualitzats de Zabbix. systemctl start zabbix-server systemctl start zabbix-proxy systemctl start zabbix-agent systemctl start zabbix-agent2 # 7 Unit symbols # 7 Símbols d'unitats # 7 Upgrade procedure # 7 Procés d'actualització # 7 Visualization # 7 Visualització # 7 What's new in Zabbix 6.0.2 # 7 Què hi ha de nou al Zabbix 6.0.2 # 7 Windows performance counters # 7 Comptadors de rendiment de Windows # 7 Zabbix agent 2 plugins # 7 Plugins de l'agent Zabbix 2 ##### 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 Esborrar galetes i memòria cau del navegador web Després de l'actualització, és possible que hagueu d'esborrar les galetes del navegador web i la memòria cau del navegador web perquè la interfície web de Zabbix funcioni correctament. ##### 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 Esborrar galetes i memòria cau del navegador web Després de l'actualització, és possible que hagueu d'esborrar les galetes del navegador web i la memòria cau del navegador web perquè la interfície web de Zabbix funcioni correctament. ##### 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 Esborrar galetes i memòria cau del navegador web Després de l'actualització, és possible que hagueu d'esborrar les galetes del navegador web i la memòria cau del navegador web perquè la interfície web de Zabbix funcioni correctament. ##### 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 Esborrar galetes i memòria cau del navegador web Després de l'actualització, és possible que hagueu d'esborrar les galetes del navegador web i la memòria cau del navegador web perquè la interfície web de Zabbix funcioni correctament. # 8 Creating your own theme # 8 Crear el vostre propi tema # 8 Database monitor # 8 Monitoratge de base de dades # 8 Discovery of Windows services # 8 Descoberta de serveis de Windows # 8 Distribution-specific notes on setting up Nginx for Zabbix # 8 Notes específiques de la distribució sobre la configuració d'Nginx per a Zabbix # 8 Graph # 8 Gràfic # 8 Graph # 8 Gràfic # 8 JS # 8 JS # 8 Known issues See also: [Compilation issues](/manual/installation/known_issues/compilation_issues). # 8 Problemes coneguts Veieu també: [Problemes de compilació](/manual/installation/known_issues/compilation_issues). # 8 Mass update # 8 Actualització en massa # 8 MSSQL plugin # 8 MSSQL plugin # 8 Prediction functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) 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 # 8 Funcions de predicció Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb `<` `>` - Els paràmetres específics es descriuen amb cada funció - Els paràmetres `/host/key` i `(sec|#num)<:time shift>` mai han d'anar entre cometes # 8 Scripts # 8 Scripts # 8 Sensor Each sensor chip gets its own directory in the sysfs /sys/devices tree. To find all sensor chips, it is easier to follow the device symlinks from /sys/class/hwmon/hwmon\*, where \* is a real number (0,1,2,...). The sensor readings are located either in /sys/class/hwmon/hwmon\*/ directory for virtual devices, or in /sys/class/hwmon/hwmon\*/device directory for non-virtual devices. A file, called name, located inside hwmon\* or hwmon\*/device directories contains the name of the chip, which corresponds to the name of the kernel driver used by the sensor chip. There is only one sensor reading value per file. The common scheme for naming the files that contain sensor readings inside any of the directories mentioned above is: <type><number>\_<item>, where - **type** - for sensor chips is "in" (voltage), "temp" (temperature), "fan" (fan), etc., - **item** - "input" (measured value), "max" (high threshold), "min" (low threshold), etc., - **number** - always used for elements that can be present more than once (usually starts from 1, except for voltages which start from 0). If files do not refer to a specific element they have a simple name with no number. The information regarding sensors available on the host can be acquired using **sensor-detect** and **sensors** tools (lm-sensors package: <http://lm-sensors.org/>). **Sensors-detect** helps to determine which modules are necessary for available sensors. When modules are loaded the **sensors** program can be used to show the readings of all sensor chips. The labeling of sensor readings, used by this program, can be different from the common naming scheme (<type><number>\_<item> ): - if there is a file called <type><number>\_label, then the label inside this file will be used instead of <type><number><item> name; - if there is no <type><number>\_label file, then the program searches inside the /etc/sensors.conf (could be also /etc/sensors3.conf, or different) for the name substitution. This labeling allows user to determine what kind of hardware is used. If there is neither <type><number>\_label file nor label inside the configuration file the type of hardware can be determined by the name attribute (hwmon\*/device/name). The actual names of sensors, which zabbix\_agent accepts, can be obtained by running **sensors** program with -u parameter (**sensors -u**). In **sensor** program the available sensors are separated by the bus type (ISA adapter, PCI adapter, SPI adapter, Virtual device, ACPI interface, HID adapter). # 8 Sensor Cada xip de sensor té el seu propi directori a l'arbre sysfs /sys/devices. Per trobar tots els xips del sensor, és més fàcil seguir els enllaços simbòlics del dispositiu des de /sys/class/hwmon/hwmon\*, on \* és un nombre real (0,1,2,...). Les lectures del sensor es troben al directori /sys/class/hwmon/hwmon\*/ per a dispositius virtuals o al directori /sys/class/hwmon/hwmon\*/device per a dispositius no virtuals. Un fitxer anomenat nom i situat dins els directoris hwmon\* o hwmon\*/device conté el nom del xip, que correspon al nom del controlador del nucli emprat pel xip del sensor. Només hi ha un valor de lectura del sensor per fitxer. L'esquema comú per anomenar els fitxers que contenen lectures del sensor dins de qualsevol dels directoris esmentats anteriorment és: <tipus><nombre>\_<element>, on - **tipus** - per als xips de sensor és "in" (tensió), "temp" (temperatura), "fan" (ventilador), etc., - **element** - "entrada" (valor mesurat), "màx" (llindar alt), "mínim" (llindar baix), etc., - **nombre** - sempre s'empra per als elements que poden ésser presents més d'una vegada (generalment comença des de l'1, excepte les tensions que comencen des de 0). Si els fitxers no fan referència a un element específic, tenen un nom senzill sense nombre. La informació sobre els sensors disponibles a l'equip es pot obtindre mitjançant les eines **sensor-detect** i **sensors** (paquet lm-sensors: <http://lm-sensors.org/>). **Sensors-detect** ajuda a determinar quins mòduls calen per als sensors disponibles. Quan es carreguen els mòduls, el programa **sensors** es pot emprar per mostrar les lectures de tots els xips del sensor. L'etiquetatge de les lectures del sensor, emprat per aquest programa, pot ésser diferent de l'esquema de noms comú (<tipus><nombre>\_<element>): - si hi ha un fitxer anomenat <tipus><nombre>\_etiqueta, s'emprarà l'etiqueta dins d'aquest fitxer en lloc de <tipus><nombre><item> nom; - si no hi ha cap fitxer <tipus><nombre>\etiqueta, el programa cerca dins del fitxer /etc/sensors.conf (també podria ser /etc/sensors3.conf, o algun altre) per la substitució de nom. Aquest etiquetatge permet a l'usuari determinar quin tipus de maquinari s'empra. Si no hi ha ni el fitxer <tipus><nombre>\etiqueta ni l'etiqueta dins del fitxer de configuració, el tipus de maquinari es pot determinar mitjançant l'atribut name (hwmon\*/device/name). Els noms reals dels sensors que admet zabbix\_agent, es poden obtindre executant el programa **sensors** amb el paràmetre -u (**sensors -u**). Al programa **sensor**, els sensors disponibles són separats pel tipus de bus (adaptador ISA, adaptador PCI, adaptador SPI, dispositiu virtual, interfície ACPI, adaptador HID). # 8. Service monitoring # 8. Monitoratge de serveis # 8 Templates # 8 Plantilles # 8 Time period syntax # 8 Sintaxi del període de temps # 8 What's new in Zabbix 6.0.3 # 8 Què hi ha de nou al Zabbix 6.0.3 # 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.| ::: notewarning Port 10052 is not [IANA registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: # 8 Passarel·la Java Zabbix Si empreu els scripts `startup.sh` i `shutdown.sh` per engegar [la passarel·la Java Zabbix](/manual/concepts/java), llavors podeu especificar els paràmetres de configuració necessaris a l'arxiu `settings.sh`. Els scripts d'engegada i aturada extreuen el fitxer de paràmetres i tenen cura en convertir les variables shell (llistades a la primera columna) a propietats Java (llistades a la segona columna). Si engegueu manualment la passarel·la Java Zabbix executant directament `java`, indiqueu les propietats Java corresponents a la línia de comandes. |Variable|propietat|Obligatori|Rang|Per defecte|Descripció| |--------|-----------|-----------|-----|-------|-----------| |LISTEN\_IP|zabbix.listenIP|no| |0.0.0.0|Adreça IP a escoltar.| |LISTEN\_PORT|zabbix.listenPort|no|1024-32767|10052|Port a escoltar.| |PID\_FILE|zabbix.pidFile|non| |/tmp/zabbix\_java.pid|Nom de l'arxiu PID. Si no s'especifica, la passarel·la Java Zabbix s'engega com aplicació de consola.| |PROPERTIES\_FILE|zabbix.propertiesFile|no| | |Nom de l'arxiu de propietats. Es pot emprar per definir les propietats addicionals, emprant un format clau-valor de manera que no siguin pas visibles a una línia de comandes o per sobreescriure aquelles que ja hi són.<br>Per exemple: "javax.net.ssl.trustStorePassword=<password>"| |START\_POLLERS|zabbix.startPollers|no|1-1000|5|Nombre de fils de treball a engegar.| |TIMEOUT|zabbix.timeout|no|1-30|3|Quant de temps d'espera per les operacions de xarxa.| ::: notewarning El port 10052 no és pas [registrat IANA](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: # 9 Command execution Zabbix uses common functionality for external checks, user parameters, system.run items, custom alert scripts, remote commands and global scripts. # 9 Execució de comanda Zabbix empra funcionalitats comunes per les verificacions externes, paràmetres d'usuari, elements de system.run, els scripts personalitzats d'alertes, comandes remotes i scripts d'usuaris. # 9 Debug mode # 9 Mode de depuració # 9 Discovery of Windows performance counter instances # 9 Descoberta d'instàncies de comptador de rendiment de Windows # 9 Graph (classic) # 9 Gràfic (clàssic) # 9 Graph (classic) # 9 Gràfic (clàssic) # 9 HTTP agent # 9 Agent HTTP # 9 MySQL plugin [comment]: # (tags: mysql) # 9 Plugin MySQL [comentari]: # (tags: mysql) # 9 Notes on memtype parameter in proc.mem items # 9 Notes sobre el paràmetre memtype dels elements proc.mem # 9 Queue # 9 Cua # 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 Executar l'agent com a root Des de la versió **5.0.0**, l'arxiu de servei systemd de l'agent de Zabbix contingut als [paquets oficials](https://www.zabbix.com/download) Inclou explícitament directives per `User` i `Group`. Ambdós definits a `zabbix`. Això vol dir que l'antiga funcionalitat de confiugració de l'usuari amb el qui l'agent Zabbix s'executa via l'arxiu `zabbix_agentd.conf` es traspassa i l'agent s'exeuctarà sempre com l'usuari especificat a l'arxiu de servei systemd. Per executar l'agent de Zabbix com a root, haureu de fer les modificacions descrites a sota. # 9 String functions All functions listed here are supported in: - [Trigger expressions](/manual/config/triggers/expression) - [Calculated items](/manual/config/items/itemtypes/calculated) 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 `<` `>` |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**ascii** (value)|<|<| |The ASCII code of the leftmost character of the value.|**value** - value to check|Supported value types: string, text, log<br><br>For example, a value like 'Abc' will return '65' (ASCII code for 'A').<br><br>Example:<br>=> **ascii**(last(/host/key))| |**bitlength** (value)|<|<| |The length of value in bits.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bitlength**(last(/host/key))| |**bytelength** (value)|<|<| |The length of value in bytes.|**value** - value to check|Supported value types: string, text, log, integer<br><br>Example:<br>=> **bytelength**(last(/host/key))| |**char** (value)|<|<| |Return the character by interpreting the value as ASCII code.|**value** - value to check|Supported value types: integer<br><br>The value must be in the 0-255 range. For example, a value like '65' (interpreted as ASCII code) will return 'A'.<br><br>Example:<br>=> **char**(last(/host/key))| |**concat** (<value1>,<value2>,...)|<|<| |The string resulting from concatenating referenced item values or constant values. |**value** - a value returned by one of the history functions or a constant value (string, integer, or float number)|Supported value types: string, text, log, float, integer <br><br>For example, a value like 'Zab' concatenated to 'bix' (the constant string) will return 'Zabbix'. <br><br> Must contain at least two parameters. <br><br>Examples:<br>=> **concat**(last(/host/key),**"bix"**)<br>=> **concat**("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) | |**insert** (value,start,length,replacement)|<|<| |Insert specified characters or spaces into the character string beginning at the specified position in the string.|**value** - value to check<br>**start** - start position<br>**length** - positions to replace<br>**replacement** - replacement string|Supported value types: string, text, log<br><br>For example, a value like 'Zabbbix' will be replaced by 'Zabbix' if 'bb' (starting position 3, positions to replace 2) is replaced by 'b'.<br><br>Example:<br>=> **insert**(last(/host/key),**3**,**2**,**"b"**)| |**left** (value,count)|<|<| |The leftmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'Zab' from 'Zabbix' by specifying 3 leftmost characters to return.<br><br>Example:<br>=> **left**(last(/host/key),**3**) - return three leftmost characters<br><br>See also right().| |**length** (value)|<|<| |The length of value in characters.|**value** - value to check|Supported value types: str, text, log<br><br>Example:<br>=> **length**(last(/host/key)) → length of the latest value<br>=> **length**(last(/host/key,\#3)) → length of the third most recent value<br>=> **length**(last(/host/key,\#1:now-1d)) → length of the most recent value one day ago| |**ltrim** (value,<chars>)|<|<| |Remove specified characters from the beginning of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is left-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **ltrim**(last(/host/key)) - remove whitespace from the beginning of string<br>=> **ltrim**(last(/host/key),**"Z"**) - remove any 'Z' from the beginning of string<br>=> **ltrim**(last(/host/key),**" Z"**) - remove any space and 'Z' from the beginning of string<br><br>See also: rtrim(), trim()| |**mid** (value,start,length)|<|<| |Return a substring of N characters beginning at the character position specified by 'start'.|**value** - value to check<br>**start** - start position of substring<br>**length** - positions to return in substring|Supported value types: string, text, log<br><br>For example, it is possible return 'abbi' from a value like 'Zabbix' if starting position is 2, and positions to return is 4).<br><br>Example:<br>=> **mid**(last(/host/key),**2**,**4**)="abbi"| |**repeat** (value,count)|<|<| |Repeat a string.|**value** - value to check<br>**count** - number of times to repeat|Supported value types: string, text, log<br><br>Example:<br>=> **repeat**(last(/host/key),**2**) - repeat the value two times| |**replace** (value,pattern,replacement)|<|<| |Find pattern in the value and replace with replacement. All occurrences of the pattern will be replaced.|**value** - value to check<br>**pattern** - pattern to find<br>**replacement** - string to replace the pattern with|Supported value types: string, text, log<br><br>Example:<br>=> **replace**(last(/host/key),**"ibb"**,**"abb"**) - replace all 'ibb' with 'abb'| |**right** (value,count)|<|<| |The rightmost characters of the value.|**value** - value to check<br>**count** - number of characters to return|Supported value types: string, text, log<br><br>For example, you may return 'bix' from 'Zabbix' by specifying 3 rightmost characters to return.<br><br>Example:<br>=> **right**(last(/host/key),**3**) - return three rightmost characters<br><br>See also left().| |**rtrim** (value,<chars>)|<|<| |Remove specified characters from the end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is right-trimmed by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **rtrim**(last(/host/key)) - remove whitespace from the end of string<br>=> **rtrim**(last(/host/key),**"x"**) - remove any 'x' from the end of string<br>=> **rtrim**(last(/host/key),**"x "**) - remove any 'x' or space from the end of string<br><br>See also: ltrim(), trim()| |**trim** (value,<chars>)|<|<| |Remove specified characters from the beginning and end of string.|**value** - value to check<br>**chars** - (optional) specify characters to remove<br><br>Whitespace is trimmed from both sides by default (if no optional characters are specified).|Supported value types: string, text, log<br><br>Example:<br>=> **trim**(last(/host/key)) - remove whitespace from the beginning and end of string<br>=> **trim**(last(/host/key),**"\_"**) - remove '\_' from the beginning and end of string<br><br>See also: ltrim(), rtrim()| # 9 Funcions de cadenes Totes les funcions llistades aquí són admeses a: - Les [expressions de trigger](/manual/config/triggers/expression) - Els [elements calculats](/manual/config/items/itemtypes/calculated) Algunes notes generals dels paràmetres de la funció: - Els paràmetres de funció es separen amb comes - S'admeten expressions com a paràmetres - Els paràmetres de cadena han d'anar entre cometes dobles; sinó no s'interpretaran bé - Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb `<` `>` |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**ascii** (valor)|<|<| |El codi ASCII del caràcter el més a l'esquerra del valor.|**valor** - valor a verificar|Tipus de valor admesos: cadena, text, journal<br><br>Per exemple, un valor com ara 'Abc' retornarà '65 ' (code ASCII per a 'A').<br><br>Exemple:<br>=> **ascii**(last(/host/key))| |**bitlength** (valor)|<|<| |Allargada del valor, en bits.|**valor** - valor a verificar|Tipus de valor admesos: cadena, text, journal, enter<br><br>Exemple:<br>=> **bitlength**(last(/host/key))| |**bytelength** (valor)|<|<| |Allargada del valor, en octets.|**valor** - valor a verificar|Tipus de valor admesos: cadena, text, journal, enter<br><br>Exemple:<br>=> **bytelength**(last(/host/key))| |**char** (value)|<|<| |Retorna el caràcter interpretant el valor com un codi ASCII.|**valor** - valor a verificar|Tipus de valor admesos: enter<br><br>El valor ha d'estar entre 0 i 255. Per exemple, un valor com ara '65' (interpretat com a codi ASCII) retornarà 'A'.<br><br>Exemple:<br>=> **char**(last(/host/key))| |**concat** (\<valor1\>,\<valor2\>,...)|<|<| |La cadena resultant de la concatenació de valors d'elements referenciats o de valors constants. |**valor**: un valor retornat per una de les funcions d'històric o un valor constant (cadena, enter o nombre flotant)|Tipus de valor admesos: cadena, text, journal, flotant, enter <br><br>Per exemple, un valor com ara 'Zab' concatenat a 'bix' (la cadena constant) retornarà 'Zabbix'. <br><br> Ha de contindre com a mínim dos paràmetres. <br><br>Exemples:<br>=> **concat**(last(/host/key),**"bix"**)<br>=> **concat**("1 min: ",last(/host/system.cpu.load[all,avg1]),", 15 min: ",last(/host/system.cpu.load[all,avg15])) | |**insert** (valor,inici,allargada,reemplaçament)|<|<| |Insereix caràcters o els espais especificats a la cadena de caràcters, començant a la posició especificada a la cadena.|**valor** - valor a verificar<br>**inici** - posició d'inici<br>**allargada** - posicions a reemplaçar<br>**reemplaçament** - cadena de substitució|Tipus de valors admesos: cadena, text, journal<br><br>Per exemple, un valor com ara 'Zabbbix' es substituirà per 'Zabbix' si 'bb' (posició d'inici 3, posicions per reemplaçar 2) es substitueix per 'b'.<br><br>Exemple:<br>=> **insert**(last(/host/key),**3**,**2**,**"b"**)| |**left** (valor,compte)|<|<| |Els caràcters el més a l'esquerra del valor.|**valor** - valor a verificar<br>**compte** - nombre de caràcters a retornar|Tipus de valor admesos: cadena, text, journal<br><br>Per exemple, podeu retornar 'Zab' a partir de 'Zabbix' especificant 3 caràcters el més a l'esquerra a retornar.<br><br>Exemple:<br>=> **left**(last(/host/key),**3**) - retorna els tres caràcters el més a l'esquerra<br><br>Veieu també right().| |**length** (valor)|<|<| |L'allargada del valor, en caràcters.|**valor** - valor a verificar|Tipus de valor admesos: cadena, text, journal<br><br>Exemple:<br>=> **length**(last(/ host/key)) → allargada del darrer valor<br>=> **length**(last(/host/key,\#3)) → allargada del tercer valor més recent<br>=> **length **(last(/host/key,\#1:now-1d)) → allargada del valor més recent fa un dia| |**ltrim** (valor,<caràcters>)|<|<| |Esborra els caràcters especificats a l'inici de la cadena.|**valor** - valor a verificar<br>**caràcters** - (facultatiu) especifiqueu els caràcters a esborrar<br><br>Els espais en blanc són tallats a l'esquerra, per defecte (si no s'especifica pas cap caràcter facultatiu).|Tipus de valor admesos: cadena, text, journal<br><br>Exemple:<br>=> **ltrim**(last(/host/key)) - esborra els espais blans de l'inici de la cadena<br>=> **ltrim**(last(/host/key),**"Z"**) - esborra tota 'Z' de l'inici de la cadena<br>=> **ltrim* *(last(/host/key),**" Z"**) - esborra tot espai i 'Z' de l'inici de la cadena<br><br>Veieu també: rtrim(), trim()| |**mid** (valor,inici,allargada)|<|<| |Retorna una subcadena d'N caràcters, començant a la posició de caràcter especificada a 'inici'.|**valor** - valor a verificar<br>**inici** - posició d'inici de la subcadena<br>**allargada** - posicions a retornar dins la subcadena sous-chaîne|Tipus de valors admesos: cadena, text, journal).<br><br>Exemple:<br>=> **mid**(last(/host/key),**2**,**4**)="abbi"| |**repeat** (value,count)|<|<| |Repeteix una cadena.|**value** - valor a verificar<br>**count** - nombre de vegades a repetir|Tipus de valor suportats: cadena, text, log<br><br>Exemple:<br>=> **repeat**(last(/host/key),**2**) - repeteix el valor dos cops| |**replace** (valor,model,reemplaçament)|<|<| |Cerca el motiu dins el valor i els substitueix per l'indicat. Es substituiran totes les troballes del model.|**valor** - valor a verificar<br>**model** - model a cercar<br>**reemplaçament** - cadena per la que substituir el model|Tipus de valor admesos: cadena, text, journal<br><br>Exemple:<br>=> **replace**(last(/host/key),**"ibb"**,**"abb"**) - substitueix totes les 'ibb' per 'abb'| |**right** (valor,compte)|<|<| |Els caràcters el més a la dreta del valor.|**valor** - valor a verificar<br>**compte** - nombre de caràcters a retornar|Tipus de valor admesos: cadena, text, journal<br><br>Per exemple, podeu retornar 'bix' a partir de 'Zabbix' especificant 3 caràcters el més a la dreta.<br><br>Exemple:<br>=> **right**(last(/host/key),**3* *) - retorna els tres caràcters el més a la dreta<br><br>Veieu també left().| |**rtrim** (valor,<caràcters>)|<|<| |Esborra els caràcters especificats del final de cadena.|**valor** - valor a verificar<br>**caràcters** - (facultatiu) especifica els caràcters a esborrar<br><br>Els espai blancs es retallen a la dreta, per defecte (si no s'especifica pas cap caràcter facultatiu).|Tipus de valor admesos: cadena, text, journal<br><br>Exemple:<br>=> **rtrim**(last(/host/key)) - esborra els espais del final de cadena<br>=> **rtrim**(last(/host/key),**"x"**) - esborra tota 'x' del final de la cadena<br>=> **rtrim* *(last(/host/key),**"x "**) - esborra tota 'x' o espai del final de la cadena<br><br>Veieu també: ltrim(), trim()| |**trim** (valor,<caràcters>)|<|<| |Esborra els caràcters especificats de l'inici i final de la cadena.|**valor** - valor a verificar<br>**caràcters** - (facultatiu) especifiqueu els caràcters a esborrar<br><br>Els espais blancs es retallen de les dues bandes, per defecte (si no s'especifica pas cap caràcter facultatiu).|Tipus de valor admesos: cadena, text, journal<br><br>Exemple:<br>=> **trim**(last(/host/key)) - esborrar espais entre inici i fi de la cadena<br>=> **trim**(last(/host/key),**"\_"**) - esborra '\_' de l'inici i final de la cadena< br><br>Veieu també: ltrim(), rtrim()| # 9 Template changes This page lists all changes to the stock templates that are shipped with Zabbix. Note that 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); - Then, while in *Configuration* → *Templates* you can import 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). # 9 Modificacions de les plantilles Aquesta pàgina llista tots els canvis a les plantilles d'estoc que s'envien amb Zabbix. Tingueu en compte que l'actualització a la darrera versió de Zabbix no actualitzarà automàticament les plantilles emprades. Es recomana modificar les plantilles de les instal·lacions existents fent: - Descarregant les darreres plantilles del [repositori Zabbix Git] (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates); - Tot seguit, a *Configuració* → *Plantilles*, podeu importar-les manualment a Zabbix. Si ja existeixen models amb els mateixos noms, l'opció *Esborrar les que manquen* s'ha de marcar durant la importació per obtindre una importació neta. D'aquesta manera s'esborraran els elements antics que ja no es troben al model actualitzat (tingueu en compte que això significarà perdre l'historial d'aquests elements antics). # 9 Templates out of the box # 9 Plantilles de fàbrica # 9 Value mapping # 9 Mapatge de valors # 9. Web monitoring # 9. Monitoratge Web # 9 Web service # 9 Servei Web # 9 What's new in Zabbix 6.0.4 # 9 Què hi ha de nou al Zabbix 6.0.4 # 9 Zabbix web service # 9 Web service Zabbix #### 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. #### Absència de dades Per als elements amb un interval d'actualització regular, no es mostra res al gràfic si no es recullen dades d'elements. Tanmateix, per als elements trapper i els elements amb un interval d'actualització programat (i un interval d'actualització regular establert a 0), es dibuixa una línia recta que condueix al primer valor recollit i des del darrer valor recollit fins al final del gràfic; la filera es troba al nivell del primer/darrer valor respectivament. ### Access control ### Control d'accés #### Accessing host dashboards Access to host dashboards is provided: - From the [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) that is available in many frontend locations: - click on the host name and then select *Dashboards* from the drop-down menu  - When searching for a host name in [global search](/manual/web_interface/global_search): - click on the *Dashboards* link provided in search results ```{=html} <!-- --> ``` - When clicking on a host name in *Inventory* → *[Hosts](/manual/web_interface/frontend_sections/inventory/hosts)*: - click on the *Dashboards* link provided #### Accedir al tauler de control de l'equip S'ofereix accés als taulers de control de l'equip: - Des del [menú de l'equip](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) que és disponible a moltes ubicacions d'interfície: - feu clic al nom de l'equip i, a continuació, trieu *Taulers de control* al menú desplegable  - Quan cerqueu un nom d'equip a [cerca global](/manual/web_interface/global_search): - feu clic a l'enllaç *Taulers de control* que es proporciona als resultats de la cerca ```{=html} <!-- --> ``` - Quan feu clic a un nom d'equip a *Inventari* → *[Equips](/manual/web_interface/frontend_sections/inventory/hosts)*: - feu clic a l'enllaç *Taulers de control* proporcionat #### 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*. ::: #### Permisos d'accés Assegureu-vos que l'usuari "zabbix" tingui permisos d'execució per a les ordres configurades. Potser us interessa emprar **sudo** per donar accés a ordres privilegiades. Per configurar l'accés, executeu com a root: visudo Exemples de línies que es poden emprar al fitxer *sudoers*: # permet que l'usuari "zabbix" executi totes les ordres sense mot de pas. zabbix TOT=NOPASSWD: TOTS # permet que l'usuari "zabbix" reiniciï apache sense mot de pas. zabbix ALL=NOPASSWD: /etc/init.d/apache reinici ::: notetip En alguns sistemes, el fitxer *sudoers* impedirà que els usuaris no locals executin ordres. Per canviar-ho, comenta l'opció **requiretty** a */etc/sudoers*. ::: #### Accidental installation of EPEL Zabbix packages With EPEL repository installed and enabled, installing Zabbix from packages will lead to EPEL Zabbix packages being installed rather than official Zabbix packages. In this case uninstall Zabbix packages from EPEL, i.e.: dnf remove zabbix-server-mysql Block Zabbix packages from EPEL. Add the following line in the `/etc/yum.conf` file: exclude=zabbix6.0* Install Zabbix server again: dnf install zabbix-server-mysql Notice that official Zabbix packages have the word `release` in their version string: 6.0.25-release1.el8 #### Instal·lació accidental de paquets EPEL Zabbix Amb el repositori EPEL instal·lat i habilitat, la instal·lació de Zabbix des dels paquets farà que s'instal·lin els paquets EPEL Zabbix en lloc dels paquets oficials de Zabbix. En aquest cas, desinstal·leu els paquets Zabbix d'EPEL, és a dir: dnf remove zabbix-server-mysql Bloqueu els paquets Zabbix d'EPEL. Afegiu la línia següent al fitxer `/etc/yum.conf`: exclude=zabbix6.0* Torneu a instal·lar el servidor Zabbix: dnf install zabbix-server-mysql Tingueu en compte que els paquets oficials de Zabbix tenen la paraula `release`a la cadena de la versió: 6.0.25-release1.el8 #### Acknowledging an event Acknowledge a single event and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` #### Reconèixer un esdeveniment Reconèixer un esdeveniment i afegir-hi un missatge. Petició: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": "20427", "action": 6, "message": "Problem resolved." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427" ] }, "id": 1 } ``` #### action Changes:<br> [ZBX-21804](https://support.zabbix.com/browse/ZBX-21804) `action.create`, `action.get`, `action.update`, `action.delete`: removed requirement of write permissions for hosts, host groups, templates, triggers, proxy. #### action Canvis:<br> [ZBX-21804](https://support.zabbix.com/browse/ZBX-21804) `action.create`, `action.get`, `action.update`, `action.delete`: s'han tret l'obligatorietat de permisos d'escriptura per equips, grups d'equips, plantilles, triggers i proxys. #### action Changes:<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added new `conditiontype` values *(27 - Service, 28 - Service name)*.<br> [ZBXNEXT-6250](https://support.zabbix.com/browse/ZBXNEXT-6250) `action.get`, `action.create`, `action.update`: added new property `notify_if_canceled`. #### acció Canvis:<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) afegits els nous valors *(27 - Service, 28 - Service name)* de `conditiontype`.\ [ZBXNEXT-6250](https://support.zabbix.com/browse/ZBXNEXT-6250) `action.get`, `action.create`, `action.update`: afegida la nova propietat `notify_if_canceled`. #### action Changes:<br> [ZBXNEXT-6920](https://support.zabbix.com/browse/ZBXNEXT-6920) `action.create`, `action.update`: added strict validation of the methods parameters.<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.create`, `action.update`: renamed parameter `acknowledge_operations` to `update_operations`.<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.get`: renamed parameter `selectAcknowledgeOperations` to `selectUpdateOperations`. #### Acció Canvis:<br> [ZBXNEXT-6920](https://support.zabbix.com/browse/ZBXNEXT-6920) `action.create`, `action.update`: s'ha afegit una validació estricta dels paràmetres dels mètodes.\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.create`, `action.update`: s'ha reanomenat `acknowledge_operations` com a `update_operations`.\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) `action.get`: s'ha reanomenat `selectAcknowledgeOperations` com a `selectUpdateOperations`. # action.create # acció.crear # action.delete # acció.esborrar #### 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| |--|--|------| |conditionid|string|*(readonly)* ID of the action condition.| |**conditiontype**<br>(required)|integer|Type of condition.<br><br>Possible values for trigger actions:<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 for discovery actions:<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 for autoregistration actions:<br>20 - proxy;<br>22 - host name;<br>24 - host metadata.<br><br>Possible values for internal actions:<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 for service actions:<br>25 - event tag;<br>26 - event tag value;<br>27 - service;<br>28 - service name.| |**value**<br>(required)|string|Value to compare with.| |value2<br>|string|Secondary value to compare with. Required for trigger, internal and service actions when condition type is *26*.| |actionid|string|*(readonly)* ID of the action that the condition belongs to.| |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>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.| #### Condició del filtre d'acció Aquest objecte defineix una condició específica que s'ha de verificar abans d'executar les operacions d'acció |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |-------|--------------------------------------------------------|-----------| |conditionid|string|*(només lectura)* Identificador de la condició d'acció.| |**conditiontype**<br>(obligatori)|enter|Tipus de condició.<br><br>Valors possibles per les accions dels triggers:<br>0 - grup d'equips;<br>1 - equip;<br>2 - trigger;<br>3 - nom de l'esdeveniment;<br>4 - gravetat del trigger;<br>6 - període;<br>13 - model d'equip;<br>16 - problema esborrat;<br>25 - etiqueta d'esdeveniment;<br>26 - valor de l'etiqueta d'esdeveniment.<br><br>Valors possibles per les accions de descoberta:<br>7 - IP de l'equip;<br>8 - tipus de servei de descoberta;<br>9 - port del servei de descoberta;< br>10 - estat de descoberta;<br>11 - durada de disponibilitat o indisponibilitat;<br>12 - valor rebut;<br>18 - regla de descoberta;<br>19 - verificació de descoberta;<br>20 - proxy;<br >21 - objecte de descoberta.<br><br>Valors possibles per les accions d'enregistrament automàtic:<br>20 - proxy;<br>22 - nom d'equip;<br>24 - metadades de l'equip.<br><br>Valors possibles per les accions internes:<br>0 - grup d'equips;<br>1 - equip;<br>13 - model d'equip;<br>23 - tipus d'esdeveniment;<br>25 - etiqueta d'esdeveniment;<br>26 - valor de l'etiqueta d'esdeveniment.<br><br>Valors possibles per les accions de servei:<br>25 - etiqueta d'esdeveniment;<br>26 - valor de l'etiqueta d'esdeveniment;<br>27 - servei;<br >28 - nom del servei.| |**valor**<br>(obligatori)|string|Valor a comparar.| |value2<br>|string|Valor secundari a comparar. Obligatori per les accions de triggers, internes i de servei quan el tipus de condició sigui *26*.| |actionid|string|*(només lectura)* Identificador de l'acció a qui pertany la condició.| |formulaid|string|Identificador únic arbitrari emprat per referenciar la condició a partir d'una expressió personalitzada. Només pot contindre lletres majúscules. L'identificador s'ha de definir per l'usuari durant la modificació de condicions de filtre, però es generarà de nou a petició posterior.| |operador|enter|Operador de condició.<br><br>Valors possibles:<br>0 - *(per defecte)* és igual;<br>1 - no és pas igual;<br>2 - conté;<br>3 - no ho conté pas;<br>4 - entre;<br>5 - és superior o igual a;<br>6 - inferior o igual a;<br>7 - no és pas entre;<br>8 - correspon;<br >9 - no correspon pas;<br>10 - Sí;<br>11 - No.| ::: notetip Per entendre millor com emprar els filtres amb diferents tipus d'expressions, consulteu els exemples a les pàgines dels mètodes [action.get](get#retrieve_discovery_actions) i [action.create](create#using_a_custom_expression_filter). ::: Els operadors i valors següents s'admeten per cada tipus de condició. |Condició|Nom de la condició|Operadors admesos|Valor esperat| |---------|------|-----|-----|--------------| |0|Grup d'equips|igual,<br>no és igual|identificador del grup d'equips.| |1|Equip|igual,<br> no és igual|identificador d'equip.| |2|Trigger|igual,<br>no és igual|identificador de trigger.| |3|Nom de l'esdeveniment |conté,<br>no conté pas|Nom de l'esdeveniment.| |4|Gravetat del trigger|igual,<br>no és igual,<br>superior o igual,<br>inferior o igual|Gravetat del trigger. Consulteu la [propietat "trigger "severity"](/manual/api/reference/trigger/object#trigger) per obtindre una llista de gravetats de triggers admeses.| |5|Valor de trigger|igual|Valor de trigger. Consulteu la [propietat "valor" del trigger](/manual/api/reference/trigger/object#trigger) per obtindre una llista dels valors de triggers admesos.| |6|Període de temps|entre, no entre|Hora en la que l'esdeveniment s'ha disparat al [període](/manual/appendix/time_period).| |7|IP de l'equip|igual,<br>no és igual|Un o més llocs IP a verificar separats per comes. Consulteu la secció [configuració de la descoberta de xarxa](/manual/discovery/network_discovery/rule) per tindre més informació dels format admesos dels llocs IP.| |8|Tipus de servei descobert|igual,<br>no és igual|Tipus de servei descobert. El tipus de servei descobert correspon al tipus de control de descoberta emprat per detectar el servei. Consulteu la [propietat "tipus" de la verificació de descoberta](/manual/api/reference/dcheck/object#discovery_check) per obtindre la llista dels tipus admesos.| |9|Port de servei descobert|igual,<br>diferent|Un o més llocs de ports separats per comes.| |10|Estat de descoberta|igual|Estat d'un objecte descobert.<br><br>Valors possibles:<br>0 - equip o servei actiu;<br>1 - equip o servei desactivat;<br>2 - equip o servei descobert;<br>3 - equip o servei perdut.| |11|Durada de disponibilitat o indisponibilitat|superior o igual,<br>inferior o igual|Durada indicant quan de temps l'objecte descobert és a l'estat actual, en segons.| |12|Valors rebuts|iguals,<br>diferents,<br>superiors o iguals,<br>inferiors o iguals,<br>conté,<br>no conté pas|Valor retornat quan s'executa un agent Zabbix, control de descoberta SNMPv1, SNMPv2 o SNMPv3.| |13|Model d'equip|igual,<br>no és igual|ID de model vinculat.| |16|El problema s'ha esborrat|Sí, No|No cal pas cap valor: l'ús de l'operador "Sí" vol dir que el problema s'ha esborrat, "No" - no s'ha esborrat pas.| |18|Regla de descoberta|igual,<br>no és igual|ID de la regla de descoberta.| |19|Control de descoberta|igual,<br>no és igual|ID del control de descoberta.| |20|Proxy| igual,<br>no és igual|ID del proxy.| |21|Objecte de descoberta|igual|Tipus d'objecte que ha desencadenat l'esdeveniment de descoberta.<br><br>Valors possibles:<br>1 - equip descobert;<br>2 - servei descobert.| |22|Nom d'equip|conté,<br>no conté pas,<br>correspon,<br>no correspon pas|Nom d'equip.<br>L'ús d'una expressió regular s'admet per els operadors *correspon* i *no correspon pas* a les condicions d'auto-enregistrement.| |23|Tipus d'esdeveniment|igual|Esdeveniment intern específic.<br><br>Valors possibles:<br>0 - element amb estat "no admès" ;<br>1 - element amb esetat "normal";<br>2 - Regla LLD amb estat "no admesa" ;<br>3 - Regla LLD amb estat "normal" ;<br>4 - Trigger amb estat "desconegut" ;<br>5 - Trigger amb estat "normal".| |24|Metadades de l'equip|conté,<br>no conté pas,<br>correspon,<br>no correspon pas|Metadades de l'equip registrat automàticament.<br>L'ús d'una expressió regular s'admet per als operadors *correspon* et *no correspon pas*.| |25|Etiqueta|igual,<br>no és igual,<br>conté,<br>no conté pas|Etiqueta d'esdeveniment.| |26|Valor de l'etiqueta|igual,<br>no és igual,<br>conté,<br>no conté pas|Valor de l'etiqueta d'esdeveniment.| |27|Servei|igual,<br>no és igual a|ID de servei.| |28|Nom del servei|igual,<br>no és igual|Nom del servei.| ### 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**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* 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.| |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>Required for custom expression filters.| ### Filtre d'accions L'object de filtre d'acció defineix un recull de condicions que s'han d'especificar per efectuar les operacions d'acció configurades. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |-------|--------------------------------------------------------|-----------| |**condicions**<br>(obligatori)|array|Conjunt de condicions de filtre a emprar per filtrar els resultats.| |**evaltype**<br>(obligatori)|integer|Mètode d'avaluació de la condició de filtre.<br><br>Valors possibles:<br>0 - i/o ;<br>1 - i ;<br>2 - o ;<br>3 - expressió personalitzada.| |eval\_formula|string|*(només lectura)* Expressió generada que s'emprarà per avaluar les condicions de filtre. L'expressió conté els identificadors que fan referència a les condicions de filtre específiques per la seva `formulaid`. El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.| |formula|string|Expressió definida per l'usuari a emprar per avaluar les condicions dels filtres amb una expressió personalitzada. L'expressió ha de contindre els identificadors fent referència a les condicions de filtre específiques per la seva `formulaid`. Els identificadors emprats a l'expressió han de correspondre exactament als definits a les condicions de filtre: cap condició pot restar sense ús o omesa.<br><br>Obligatori per als filtres d'expressió personalitzats.| ##### 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 *Configuration → 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 to 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. ##### Acció per enregistrar automàticament un agent actiu Quan el servidor rep una petició de registre automàtic d'un agent, fa una crida d'[acció](/manual/config/notifications/action). S'ha de configurar una acció de la font d'esdeveniments "Registre automàtic" per al registre automàtic de l'agent. :::noteclassic No cal configurar la [descoberta de xarxa](/manual/discovery/network_discovery) perquè els agents actius es registrin automàticament. ::: A la interfície Zabbix, trieu *Configuració → Accions*, trieu *Accions de registre automàtic* com a font d'esdeveniment i feu clic a *Crear acció*: - A la pestanya Acció, doneu un nom a la vostra acció. - Opcionalment, especifiqueu [condicions](/manual/config/notifications/action/conditions#autoregistration_actions). Podeu fer una coincidència de subcadenes o una coincidència d'expressió regular en condicions per a les metadades del nom d'equip/equip. Si teniu previst emprar la condició "Metadades de l'equip", consulteu la secció següent. - A la pestanya Operacions, afegiu les operacions rellevants, com ara - "Afegir un equip", "Afegir al grup d'equips" (per exemple, *Equips descoberts*), "Enllaç a la plantilla", etc. ::: notetip Si els equips que s'han de registrar automàticament només haurien d'ésser compatibles amb el monitoratge actiu (com ara els equips protegits per un tallafoc del vostre servidor Zabbix), és possible que hagueu de crear una plantilla específica *Template_Linux-active* a la qual s'associï. ::: Els equips creats s'afegeixen al grup *Equips descoberts* (per defecte, configurable a *Administració* → *General* → *[Altres](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Si voleu afegir equips a un altre grup, afegiu una operació *Treure del grup d'equips* (especificant "Equips descoberts") i també afegiu una operació *Afegir al grup d'equips* (especificant un altre equip del grup), perquè un equip ha de pertànyer a un grup equip. # action.get # action.get # Action object The following objects are directly related to the `action` API. # Objecte d'acció Els següents objectes són relacionats amb l'API `action`. #### 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| |--|--|------| |opconditionid|string|*(readonly)* ID of the action operation condition| |**conditiontype**<br>(required)|integer|Type of condition.<br><br>Possible values:<br>14 - event acknowledged.| |**value**<br>(required)|string|Value to compare with.| |operationid|string|*(readonly)* ID of the operation.| |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.| #### Condició d'operació d'acció L'objecte condició d'operació d'acció defineix una condició que ha d'encaixar per executar l'operació en curs. Té les següents propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |opconditionid|string|*(només lectura)* ID de la condició d'operació d'acció| |**conditiontype**<br>(obligatori)|integer|Tipus de condició.<br><br>Valors possibles:<br>14 - esdeveniment reconegut.| |**value**<br>(obligatori)|string|Valor amb el que comparar.| |operationid|string|*(només lectura)* ID de l'operació.| |operator|integer|Operador de condició.<br><br>Valors possibles:<br>0 - *(per defecte)* =.| Els següents operadors i valors són suportats per cada tipus de condició d'operació. |Condició|Nom de la condició|Operadors admesos|Valor esperat| |---------|--------------|-------------------|--------------| |14|Esdeveniment reconegut|=|Si l'esdeveniment s'ha reconegut.<br><br>Valors possibles:<br>0 - no reconegut pas;<br>1 - reconegut.| #### Action operation message The operation message object contains data about the message that will be sent by the operation. |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|string|ID of the media type that will be used to send the message.| |message|string|Operation message text.| |subject|string|Operation message subject.| #### Missatge d'operació d'acció L'objecte de missatge d'opieració conté informació sobre el missatge que s'enviarà per l'operació. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |default\_msg|enter|Fer ús del text i/o de l'assumpte del missatge.<br><br>Valors possibles:<br>0 - fer ús de la informació de l'operació;<br>1 - *(per defecte)* fer ús de la informació del tipus de medi.| |mediatypeid|cadena|ID del tipus de medi que s'emprarà per enviar el missatge.| |missatge|cadena|Text del missatge de l'operació.| |assumpte|cadena|Assumpte del missatge de l'operació.| ### 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| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|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 to template;<br>7 - unlink from template;<br>8 - enable host;<br>9 - disable host;<br>10 - set host inventory mode.<br><br>Note that only types '0' and '1' are supported for trigger and service actions, only '0' is supported for internal actions. All types are supported for discovery and autoregistration actions.| |actionid|string|*(readonly)* ID of the action that the operation belongs to.| |esc\_period|string|Duration of an escalation step in seconds. Must be greater than 60 seconds. Accepts seconds, time unit with suffix and user macro. If set to 0 or 0s, the default action escalation period will be used.<br><br>Default: 0s.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |evaltype|integer|Operation condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|object|Object containing data on global script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_grpid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_hstid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `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>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for "add to host group" and "remove from host group" operations.| |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>Required for message operations.| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required for message operations if `opmessage_usr` is not set.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.| |optemplate|array|Templates to link the hosts to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`templateid` - *(string)* ID of the template.<br><br>Required for "link to template" and "unlink from template" operations.| |opinventory|object|Inventory mode set host to.<br><br>Object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`inventory_mode` - *(string)* Inventory mode.<br><br>Required for "Set host inventory mode" operations.| ### Operació d'acció L'objecte d'operació d'acció defineix una operació que s'executarà quan s'executi una acció. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |operationid|string|*(només lectura)* ID de l'operació d'acció.| |**operationtype**<br>(obligatori)|enter|Tipus d'operació.<br><br>Valors possibles:<br>0 - Enviar missatge;<br>1 - script global;<br>2 - afegir equip;<br>3 - esborrar equip;<br>4 - afegir a un grup d'equips;<br>5 - treure d'un grup d'equips;<br>6 - enllaçar a una plantilla;<br>7 - desenllaçar de la plantilla;<br>8 - activar equip;<br>9 - desactivar equip;<br>10 - establir el mode d'inventari de l'equip.<br><br>Veieu que els tipus '0' i '1' són suportats per accions de trigger i servei, i '0' només es suporta per accions internes. Tots els tipus són suportats per accions de descobriment i autoregistre.| |actionid|cadena|*(només lectura)* ID de l'acció a qui pertany l'operació.| |esc\_period|string|Durada de l'escalada, en segons. Ha d'ésser superior a 60 segons. Accepta segons, unitats de temps amb sufixe i macro d'usuari. Si s'estableix a 0, s'emprarà el període d'escalat de l'acció pe defecte.<br><br>Per defecte: 0s.<br><br>Veieu que l'escalat es suporta només per a triggers, accions internes i de servei, i només en operacions normals.| |esc\_step\_from|enter|Graó de partida de l'escalat.<br><br>Per defecte: 1.<br><br>Veieu que l'escalada és suportada només per triggers, accions internes i de servei, i només en operacions normals.| |esc\_step\_to|enter|Graó d'escalada destí.<br><br>Per defecte: 1.<br><br>Veieu que l'escalat és suportat només per a triggers, accions internes i de servei; i només en operacions normals.| |evaltype|enter|Mètode d'avaluació de la condició d'operació.<br><br>Valors possibles:<br>0 - *(per defecte)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|objecte|Objecte que conté informació del global script executat per l'operació.<br><br>Cada objecte té una de les següents propietats: `scriptid` - *(cadena)* ID de l'script.<br><br>Obligatori per a operacions d'escript globals.| |opcommand\_grp|matriu|Grups d'equips per executar scripts globals.<br><br>Cada objecte té les propietats següents:<br>`opcommand_grpid` - *(cadena, només lectura)* ID de l'objecte;<br>`operationid` - *(cadena, només lectura)* ID de l'operació;<br>`groupid` - *(cadena)* ID del grup d'equips.<br><br>Obligatori per a operacions d'script globals si no s'estableix `opcommand_hst`.| |opcommand\_hst|matriu|Equip que executa els scripts globals.<br><br>Cada objecte té les propietats següents:<br>`opcommand_hstid` - *(cadena, només lectura)* ID de l'objecte;<br>`operationid` - *(cadena, només lectura)* ID de l'operació;<br>`hostid` - *(cadena)* ID de l'equip; si s'estableix a 0, la comanda s'executarà a l'equip actualt.<br><br>Obligatori per a operacions d'scripts globals si no s'estableix `opcommand_grp`.| |opconditions|matriu|Condicions d'operació emprades per accions de triggers.<br><br>L'objecte de condició d'operació és [descrit en detall més avall](/manual/api/reference/action/object#action_operation_condition).| |opgroup|array|Grups d'equips on afegir equips.<br><br>Cada objecte té les propietats següents:<br>`operationid` - *(cadena, només lectura)* ID de l'operació;<br>`groupid` - *(cadena)* ID del grup d'equips.<br><br>Obligatori per les operacions d'"afegir al grup d'equips" i "treure del grup d'equips".| |opmessage|objecte|Objecte que conté la informació sobre el missatge enviat per l'operació.<br><br>L'objecte missatge de l'opieració és [detallat avall](/manual/api/reference/action/object#action_operation_message).<br><br>Obligatori per operacions de missatges.| |opmessage\_grp|matriu|Grups d'usuaris als qui enviar missatges.<br><br>Cada objecte té les propietats següents::<br>`operationid` - *(cadena, només lectura)* ID de l'operació;<br>`usrgrpid` - *(cadena)* ID del grup d'usuaris.<br><br>Obligatori per a operacions de missatge, si no s'ha pas definit `opmessage_usr`.| |opmessage\_usr|matriu|Usuaris als qui enviar missatges.<br><br>Cada objecte té les propietats següents:<br>`operationid` - *(cadena, només lectura)* ID of the operation;<br>`userid` - *(cadena)* ID de l'usuari.<br><br>Obligatori per a operacions de missatge si no hi s'ha pas definit `opmessage_grp`.| |optemplate|matriu|Plantilles a les que vincular-hi equips.<br><br>Cada objecte té les propietats següents:<br>`operationid` - *(cadena, només lectura)* ID de l'operació;<br>`templateid` - *(cadena)* ID de la plantilla.<br><br>Obligatori per a les operacions "enllaçar a plantilla" i "desenllaçar de plantilla".| |opinventory|objecte|Mode d'inventari definit com equip.<br><br>L'objecte té les propietats següents:<br>`operationid` - *(cadena, només lectura)* ID de l'opieració;<br>`inventory_mode` - *(cadena)* Mode d'inventari.<br><br>Obligatori per a operacions "Establir mode d'inventari d'equips".| ### Action recovery operation The action recovery operation object defines an operation that will be performed when a problem is resolved. Recovery operations are possible for trigger, internal and service actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values for trigger and service actions:<br>0 - send message;<br>1 - global script;<br>11 - notify all involved.<br><br>Possible values for internal actions:<br>0 - send message;<br>11 - notify all involved.| |actionid|string|*(readonly)* ID of the action that the recovery operation belongs to.| |opcommand|object|Object containing data on global action type script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the action type script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_grpid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`opcommand_hstid` - *(string, readonly)* ID of the object;<br>`operationid` - *(string, readonly)* ID of the operation;<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `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>Required for message operations.| |opmessage\_grp|array|User groups to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required for message operations if `opmessage_usr` is not set.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`operationid` - *(string, readonly)* ID of the operation;<br>`userid` - *(string)* ID of the user.<br><br>Required for message operations if `opmessage_grp` is not set.| ### Operació de recuperació d'acció L'objecte d'operació de recuperació d'acció defineix una operació que s'efectuarà quan un problema sigui resolt. Les operacions de recuperació són possibles per els triggers i accions internes i de servei. Té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |operationid|string|*(només lectura)* ID de l'operació d'acció.| |**operationtype**<br>(obligatori)|integer|Tipus d'operació.<br><br>Valors possibles per al trigger i accions de servei:<br>0 - enviar missatge;<br>1 - script global;<br>11 - notificar a tots els implicats.<br><br>Valors possibles per les accions internes:<br>0 - enviar missatge;<br>11 - notificar a tots els implicats.| |actionid|string|*(només lectura)* ID de l'acció a qui pertany l'operació de recuperació.| |opcommand|object|Objecte que conté informació de l'script del tipus d'acció global que executa l'operació.<br><br>Cada objecte té una de les següents propietats: `scriptid` - *(string)* ID de l'escript del tipus d'acció.<br><br>Obligatori per a operacions d'script globals.| |opcommand\_grp|array|Grups d'equips on s'executaran els scripts globals.<br><br>Cada objecte té les propietats següents:<br>`opcommand_grpid` - *(string, només lectura)* ID de l'objecte;<br>`operationid` - *(string, només lectura)* ID de l'operació;<br>`groupid` - *(string)* ID del grup d'equips.<br><br>Obligatori per les operacions d'scripts globals si no s'ha establert `opcommand_hst`.| |opcommand\_hst|array|Equip on correran els scripts globals.<br><br>Cada objecte té les propietats següents:<br>`opcommand_hstid` - *(string, només lectura)* ID de l'objecte;<br>`operationid` - *(string, només lectura)* ID de l'operació;<br>`hostid` - *(string)* ID de l'equip; si s'estableix a 0, la comanda s'executarà a l'equip actual.<br><br>Obligatori per les operacions d'scripts globals si no s'ha establert `opcommand_grp`.| |opmessage|object|Objecte que conté la informació sobre el missatge que s'ha enviat per l'operació de recuperació.<br><br>L'objecte missatge de l'operació es [descriu en detall més amunt](/manual/api/reference/action/object#action_operation_message).<br><br>Obligatori per a operacions de missatges.| |opmessage\_grp|array|Grups d'usuaris als qui enviar els missatges.<br><br>Cada objecte té les propietats següents:<br>`operationid` - *(string, només lectura)* ID de l'operació;<br>`usrgrpid` - *(string)* ID del grup d'usuaris.<br><br>Obligatori per les operacions de missatges si no s'ha establert `opmessage_usr`.| |opmessage\_usr|array|Usuaris a qui enviar els missatges.<br><br>Cada objecte té les propietats següents:<br>`operationid` - *(string, només lectura)* ID de l'operació;<br>`userid` - *(string)* ID de l'usuari.<br><br>Obligatori per les operacions de missatges si no s'ha establert `opmessage_grp`.| #### 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) #### Accions i alertes Definir les accions i les operacions per informar als usuaris de determinats esdeveniments o executar automàticament comandes a distància. Accediu a les informacions de les alertes generades i dels seus destinataris. [API Acció](/manual/api/reference/action) | [API Alerta](/manual/api/reference/alert) #### Actions disabled due to deleted objects 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 to avoid incorrect execution of the action. The action can be re-enabled by the user. This behavior takes place when deleting: - host groups ("host group" condition, "remote command" operation on a specific host group); - hosts ("host" condition, "remote command" operation on a specific host); - templates ("template" condition, "link to template" and "unlink from template" operations); - triggers ("trigger" condition); - discovery rules (when using "discovery rule" and "discovery check" conditions). *Note*: If a remote command has many target hosts, and we delete one of them, only this host will be removed from the target list, the operation itself will remain. But, if it's the only host, the operation will be removed, too. The same goes for "link to template" and "unlink from template" operations. Actions are not disabled when deleting a user or user group used in a "send message" operation. #### Accions desactivades per objectes esborrats Si s'esborra un determinat objecte (equip, model, trigger, etc.) emprat en una condició/operació d'acció, s'esborrarà la condició/operació i l'acció es desactivarà per evitar una execució incorrecta de l'acció. L'acció pot ésser reactivada per l'usuari. Aquest comportament es produeix en esborrar: - grups d'equips ("condició de grup d'equips", operació de "control remot" en un grup específic d'equips); - equips ("condició d'equip", operació de "control remot" en un equip específic); - models (condició "model", operacions "Enllaçar al model" i "Desenllaçar del model"); - triggers (condició "trigger"); - regles de descoberta (quan s'empren les condicions de "regla de descoberta" i "verificació de descoberta"). *Nota*: Si una comanda remota té diversos equips de destinació i n'esborrem un, només s'esborrarà aquest equip de la llista de destí, l'operació en si es mantindrà. Però, si és l'únic equip, l'operació també s'esborrarà. El mateix passa amb les operacions "enllaç al model" i "desenllaç del model". Les accions no es desactiven en esborrar un usuari o grup d'usuaris emprat en una operació d'"enviament de missatge". #### 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 - Linking hosts to/unlinking from a template - 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 a discovered host to templates 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. ::: #### Accions Els esdeveniments de descoberta poden ésser la base per a [accions](/manual/config/notifications/action) rellevants, com ara: - Enviament de notificacions - Afegir/esborrar equips - Activar/desactivar equips - Afegir equips a un grup - Esborrar d'equips d'un grup - Enllaçar (o desenllaçar) equips a un model - Execució remota d'scripts Aquestes accions es poden configurar en funció del tipus de dispositiu, adreça IP, estat, amunt/avall, etc. Per obtindre més informació sobre la configuració d'accions per a esdeveniments basats en descoberta de xarxa, consulteu les pàgines dels termes [operació](/manual/config/notifications/action/operation) i [condicions](/manual/config/notifications/action). Com que les accions de descoberta de xarxa es basen en esdeveniments, s'activaran tant bon punt un equip descobert sigui en línia com quan sigui fora de línia. És molt recomanable afegir una [condició](/manual/config/notifications/action/conditions) *Estat de descoberta: actiu* acció per evitar que s'activin accions com ara *Afegeix equip* en esdeveniments com *Servei perdut*/*Servei caigut*. En cas contrari, si s'esborra manualment un equip descobert, encara generarà esdeveniments *Servei perdut*/*Servei caigut* i es tornarà a crear al següent cicle de descoberta. :::noteclassic L'enllaç d'un equip descobert a plantilles fallarà col·lectivament si una de les plantilles vinculables té una entitat única (per exemple, clau d'element) que és idèntica a una altra entitat única (per exemple, clau d'element) que ja existeix a l'equip o en un altre dels models enllaçables. ::: #### 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. #### Accions a emprendre si la comunicació entre l'agent i el servidor falla Cada línia coincident de l'element `log[]` i `logrt[]` i el resultat de cada `log.count[]` i `logrt.count[]` requereix un espai lliure a l'àrea designada del 50% a buffer que envia l'agent. Els elements de memòria intermèdia s'envien regularment al servidor (o al proxy) i els espais de memòria de memòria intermèdia tornen a ésser lliures. Tot i que hi ha espais lliures a l'àrea de fitxer de registre designada a la memòria intermèdia d'enviament de l'agent i la comunicació entre l'agent i el servidor (o el proxy), els registres de resultats de la supervisió de fitxers s'acumulen a la memòria intermèdia d'enviament. Això ajuda a esmorteir els errors de comunicació puntuals. Durant errors de comunicació més llargs, totes les ubicacions de registre són ocupades i es duen a terme les accions següents: - Les comprovacions dels elements `log[]` i `logrt[]` són aturades. Quan es restableix la comunicació i s'alliberen els espais a la memòria intermèdia, les comprovacions es reprenen des de la posició anterior. No es perd cap filera coincident, només es trasllada. - Les comprovacions `log.count[]` i `logrt.count[]` s'aturen si `maxdelay = 0` (per defecte). El comportament és similar als elements `log[]` i `logrt[]` descrits anteriorment. Tingueu en compte que això pot afectar els resultats de `log.count[]` i `logrt.count[]`: per exemple, una comprovació compta 100 línies coincidents en un fitxer de registre, però com que no hi ha espai lliure a la memòria intermèdia, el control s'atura. Quan es restableix la comunicació, l'agent compta les mateixes 100 línies coincidents i 70 noves línies coincidents. L'agent ara envia counter=170 com si es trobés en una validació. - Les comprovacions `log.count[]` i `logrt.count[]` amb `maxdelay > 0`: si no hi ha hagut cap "salt" durant la comprovació, el comportament és similar al descrit anteriorment. Si s'ha produït un "salt" per sobre de les línies del fitxer de registre, es conserva la posició després del "salt" i es descarta el resultat comptat. Per tant, l'agent intenta mantindre's al dia amb un fitxer de registre en expansió, fins i tot quan la comunicació falla. #### 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| #### Accions Dins les [accions](/manual/config/notifications/action), les macros d'usuari poden emprar-se als camps següents: |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Notificacions i comandes basades en triggers|<|sí| |Notificacions internes basades en triggers|<|sí| |Notificacions d'actualització de problema|<|sí| |Notificacions i comandes basades en serveis|<|sí| |Notificacions d'actualització dels serveis|<|sí| |Condició de període de temps|<|no| |*Operacions*|<|<| | |Durada de l'etapa d'operació per defecte|no| |^|Durada de l'etapa|no| ##### Actions The module will have control over frontend actions defined within the *actions* object in the manifest.json file. This way new actions are defined. In the same way you may redefine existing actions. Each key of actions should represent the action name and the corresponding value should contain `class` and optionally `layout` and `view` keys. One action is defined by four counterparts: name, controller, view and layout. Data validation and preparation is typically done in the controller, output formatting is done in the view or partials, and the layout is responsible for decorating the page with elements such as menu, header, footer and others. Module actions must be defined in the manifest.json file as *actions* object: |Parameter|Required|Type|Default|Description| |---------|---|----|--|-------------------| |key|Yes|String|\-|Action name, in lowercase \[a-z\], separating words with dot.| |class|Yes|String|\-|Action class name, including subdirectory path (if used) within the `actions` directory.| |layout|No|String|"layout.htmlpage"|Action layout.| |view|No|String|null|Action view.| There are several predefined layouts, like `layout.json` or `layout.xml`. These are intended for actions which produce different result than an HTML. You may explore predefined layouts in the app/views/ directory or even create your own. Sometimes it is necessary to only redefine the view part of some action leaving the controller intact. In such case just place the necessary view and/or partial files inside the `views` directory of the module. For reference, please see an example action controller file in the [Reference](#reference) section. Please do not hesitate to explore current actions of Zabbix source code, located in the app/ directory. **Module.php** This optional PHP file is responsible for module initialization as well as event handling. Class 'Module' is expected to be defined in this file, extending base class `\Core\CModule`. The Module class must be defined within the namespace specified in the manifest.json file. ``` {.php} <?php namespace Modules\Example; use Core\CModule as BaseModule; class Module extends BaseModule { ... } ``` For reference, please see an example of Module.php in the [Reference](#reference) section. ##### Accions El mòdul tindrà control sobre les accions frontals definides a l'objecte *accions* del fitxer manifest.json. D'aquesta manera, es defineixen noves accions. De la mateixa manera, podeu redefinir les accions existents. Cada clau d'acció ha de representar el nom de l'acció i el valor corresponent ha de contindre les claus `classe' i, opcionalment, les tecles `disseny' i `visualitza`. Una acció és definida per quatre homòlegs: nom, controlador, vista i disseny. La validació i preparació de dades es fa normalment al controlador, el format de sortida es fa a la vista o parcials, i el disseny de la pàgina s'encarrega de decorar la pàgina amb coses com el menú, l'encapçalament, el peu de pàgina i altres. Les accions del mòdul s'han de definir al fitxer manifest.json com a objecte *accions*: |Paràmetre|Obligatori|Tipus|Predeterminat|Descripció| |---------|---|----|--|-----| |clau|Sí|Cadena|\-|Nom de l'acció, en minúscula \[a-z\], separant les paraules amb un punt.| |classe|Sí|Cadena|\-|Nom de la classe d'acció, inclosa la ruta del subdirectori (si n'hi ha) al directori `actions`.| |layout|No|Cadena|"layout.htmlpage"|Disposició de l'acció.| |vista|No|Cadena|null|Vista d'accions.| Hi ha diversos dissenys predefinits, com ara `layout.json` o `layout.xml`. Són per a accions que produeixen un resultat diferent de l'HTML. Podeu explorar els dissenys predefinits al directori app/views/ o fins i tot crear els vostres. De vegades cal redefinir només la part vista d'una acció deixant el controlador intacte. En aquest cas, només cal col·locar la vista necessària i/o els fitxers parcials al directori `views` del mòdul. Per a referència, consulteu un exemple de fitxer de controlador d'acció a la secció [Referència](#reference). No dubteu a explorar les accions habituals del codi font de Zabbix, que es troba al directori app/. **Module.php** Aquest fitxer PHP opcional és responsable de la inicialització del mòdul i de la gestió d'esdeveniments. La classe 'Mòdul' s'hauria de definir en aquest fitxer, ampliant la classe base '\Core\CModule'. La classe del mòdul s'ha de definir a l'espai de noms especificat al fitxer manifest.json. ``` {.php} <?php namespace Modules\Example; use Core\CModule as BaseModule; class Module extends BaseModule { ... } ``` Per a referència, consulteu un exemple de Module.php a la secció [Referència](#reference). ### Action The action object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionid|string|*(readonly)* ID of the action.| |**esc\_period**<br>(required)|string|Default operation step duration. Must be at least 60 seconds. Accepts seconds, time unit with suffix and user macro.<br><br>Note that escalations are supported only for trigger, internal and service actions, and only in normal operations.| |**eventsource**<br>(required)|integer|*(constant)* 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.| |**name**<br>(required)|string|Name of the action.| |status|integer|Whether the action is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |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>Note that this parameter is valid for trigger actions only.| |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>Note that this parameter is valid for trigger actions only.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Acció L'objecte acció té aquestes propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |actionid|string|*(nomes lectura)* ID de l'acció.| |**esc\_period**<br>(obligatori)|string|Durada per defecte de l'etapa d'operació. Com a mínim, ha de tindre 60 segons. Accepta segons, unitat de temps com a sufixe i macro d'usuari.<br><br>Veieu que l'escalat és suportat només per a triggers, accions internes i de servei; i només en operacions normals.| |**eventsource**<br>(obligatori)|enter|*(constant)* Tipus d'esdeveniments que l'acció manipularà.<br><br>Consulteu la propietat [event "source" property](/manual/api/reference/event/object#event) per obtindre una llista de tipus d'esdeveniments suportats.| |**name**<br>(obligatori)|string|Nom de l'acció.| |status|enter|Si l'acció és habilitada o no ho és pas.<br><br>Valors possibles:<br>0 - *(per defecte)* actiu;<br>1 - desactivat.| |pause\_suppressed|enter|Si aturar o no l'escalament durant els períodes de manteniment.<br><br>Valors possibles:<br>0 - No aturar l'escalament;<br>1 - *(per defecte)* Aturar-lo.<br><br>Veieu que aquest paràmetre només és vàlid per a accions de triggers.| |notify\_if\_canceled|enter|Si hem de notificar quan l'escalada és cancel·lada.<br><br>Valors possibles:<br>0 - No notificar la cancel·lació de l'escalada;<br>1 - *(per defecte)* Notificar-ne la cancel·lació.<br><br>Veieu que aquest paràmetre és vàlid només per a accions de triggers.| Veieu també que, per a alguns dels mètodes (com ara actualitzar i esborrar) la combinació de paràmetre requerit o opcional és diferent. ### Action The action object has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the action.<br><br>Possible values for users of any type:<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>`close_problems` - Close problems;<br>`execute_scripts` - Execute scripts;<br>`manage_api_tokens` - Manage API tokens.<br><br>Possible values only for users of *Admin* and *Super admin* user types:<br>`edit_maintenance` - Create and edit maintenances;<br>`manage_scheduled_reports` - Manage scheduled reports.| |status|integer|Whether access to perform the action is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| ### Acció L'objecte té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**name**<br>(obligatori)|string|Nom de l'acció.<br><br>Valors possibles per a usuaris de tot tipus:<br>`edit_dashboards` - Crear i editar taulers de control ;<br> `edit_maps` - Crear i editar mapes;<br>`add_problem_comments` - Afegeix comentaris de problemes;<br>`change_severity` - Canvia la gravetat del problema;<br>`acknowledge_problems` - Reconeix els problemes dels problemes;<br>`close_problems` - Tanca problemes; <br>`execute_scripts`: executa scripts;<br>`manage_api_tokens`: gestiona els testimonis de l'API.<br><br>Els valors només són possibles per als usuaris dels tipus d'usuari *Admin* i *Super admin* :<br>` edit_maintenance` - Crear i editar manteniments;<br>`manage_scheduled_reports` - Gestionar informes programats.| |status|integer|Indica si l'accés per dur a terme l'acció és habilitat.<br><br>Valors possibles:<br>0 - Desactivat;<br>1 - *(per defecte)* Activat.| # Action This class is designed to work with actions. Object references: - [Action](/manual/api/reference/action/object#action) - [Action condition](/manual/api/reference/action/object#action_condition) - [Action operation](/manual/api/reference/action/object#action_operation) 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 # Acció Aquesta classe és dissenyada per treballar amb accions. Referències d'objectes: - [Action](/manual/api/reference/action/object#action) - [Action condition](/manual/api/reference/action/object#action_condition) - [Action operation](/manual/api/reference/action/object#action_operation) Mètodes disponibles: - [action.create](/manual/api/reference/action/create) - crear accions noves - [action.delete](/manual/api/reference/action/delete) - esborrar accions - [action.get](/manual/api/reference/action/get) -recuperar accions - [action.update](/manual/api/reference/action/update) - actualitzar accions # 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 for trigger and service actions. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationid|string|*(readonly)* ID of the action operation.| |**operationtype**<br>(required)|integer|Type of operation.<br><br>Possible values for trigger and service actions:<br>0 - send message;<br>1 - global script;<br>12 - notify all involved.| |opcommand|object|Object containing data on global action type script run by the operation.<br><br>Each object has one following property: `scriptid` - *(string)* ID of the action type script.<br><br>Required for global script operations.| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>Each object has the following properties:<br>`groupid` - *(string)* ID of the host group.<br><br>Required for global script operations if `opcommand_hst` is not set.| |opcommand\_hst|array|Host to run global scripts on.<br><br>Each object has the following properties:<br>`hostid` - *(string)* ID of the host; if set to 0 the command will be run on the current host.<br><br>Required for global script operations if `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>Each object has the following properties:<br>`usrgrpid` - *(string)* ID of the user group.<br><br>Required only for `send message` operations if `opmessage_usr` is not set.<br>Is ignored for `send update message` operations.| |opmessage\_usr|array|Users to send messages to.<br><br>Each object has the following properties:<br>`userid` - *(string)* ID of the user.<br><br>Required only for `send message` operations if `opmessage_grp` is not set.<br>Is ignored for `send update message` operations.| ### Operació d'actualització de l'acció L'objecte d'operació d'actualització de l'acció defineix una operació que s'efectuarà quan s'actualitzi un problema (comentat, reconegut, gravetat modificada o tancat manualment). Les operacions d'actualització són possibles per les accions de triggers i de serveis. Tenen les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |-------|--------------------------------------------------------|-----------| |operationid|string|*(només lectura)* identificador de l'operació d'acció.| |**operationtype**<br>(obligatori)|integer|Tipus d'operació.<br><br>Valors possibles per les accions de trigger i de servei:<br>0 - enviar un missatge;<br>1 - script global;<br>12 - informar a totes les persones implicades.| |opcommand|object|Object que conté les dades de l'script del tipus d'acció global executada per l'operació.<br><br>Cada objecte té la propietat següent: `scriptid` - *(string)* identificador de l'script de tipus d'acció.<br> <br>Obligatori per les operacions d'script global.| |opcommand\_grp|array|Grups d'equips on executar els scripts globals.<br><br>Cada objecte té les propietats següents:<br>`groupid` - *(string)* identificador del grup d'equips.<br>< br>Obligatori per les operacions d'script global si no s'ha definit `opcommand_hst`.| |opcommand\_hst|array|Equip on executar els scripts globals.<br><br>Cada objecte té les propietats següents:<br>`hostid` - *(string)* identificador de l'equip; si es defineix a 0, la comanda s'executarà a l'equip actual.<br><br>Obligatori per les operacions d'script global si no s'ha definit `opcommand_grp`.| |opmessage|object|Object que conté les dades del missatge enviat per l'operació d'actualització.<br><br>L'objecte de missage d'operació es [descriu en detall aquí](/manual/api/reference/action/object#action_operation_message). | |opmessage\_grp|array|Groups d'usuaris als qui enviar els missatges.<br><br>Cada objecte té les propietats següents:<br>`usrgrpid` - *(string)* identificador del grup d'usuaris.<br><br> >Obligatori només per les operacions `send message` si no s'ha definit `opmessage_usr`.<br>Ignorat per les operacions `send update message`.| |opmessage\_usr|array|Usuaris als qui enviar els missatges.<br><br>Cada objecte té les propietats següents:<br>`userid` - *(string)* identificador de l'usuari.<br><br>Obligatori només per les operacions `send message` si no s'ha definit pas `opmessage_grp`.<br>Ignorat per les operacions #### 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. #### Esdeveniments de registre automàtic de l'agent actiu El registre automàtic d'agents actius crea esdeveniments a Zabbix. Si és configurat, es crea un esdeveniment de registre automàtic de l'agent actiu quan un agent actiu desconegut anteriorment demana comprovacions o si les metadades de l'equip han canviat. El servidor afegeix un nou equip registrat automàticament, emprant l'adreça IP i el port rebuts de l'agent. Per obtindre més informació, consulteu la pàgina del [registre automàtic de l'agent actiu](/manual/discovery/auto_registration). #### Active checks Active checks require more complex processing. The agent must first retrieve from the server(s) a list of items for independent processing. The servers to get the active checks from are listed in the 'ServerActive' parameter of the agent [configuration file](/manual/appendix/config/zabbix_agentd). 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. The agent then periodically sends the new values to the server(s). ::: notetip If an agent is behind the firewall you might consider using only Active checks because in this case you wouldn't need to modify the firewall to allow initial incoming connections. ::: #### Verificacions actives Les verificacions actives tenen un tractament més complexe. L'agent primer ha de recuperar dels servidors una llista d'elements per un tractament independent. Els servidors des d'on obtenim les verificacions actives són llistats al paràmetre 'ServerActive' de l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd) de l'agent. La freqüència de les peticions per les verificacions es defineix amb el paràmetre 'RefreshActiveChecks' del mateix arxiu de configuració. Tanmateix, si el refresc de les verificacions actives falla, es tornarà a provar després de 60 segons. L'agent envia llavors periòdicament els nous valors al(s) servidor(s). ::: notetip Si un agent és darrere un tallafocs, considereu a emprar només les verificacions actives doncs, en aquest cas, no tindreu pas necessitat de modificar el tallafocs per permetre connexions entrants inicials. ::: ### Active checks 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* intervals. | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active checks` | | host | _string_ | yes | Host name. | | version | _string_ | yes | The agent version: \<major>.\<minor>. | | 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. | Example: ```json { "request": "active checks", "host": "Zabbix server", "version": "6.0", "host_metadata": "mysql,nginx", "hostinterface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` ### Peticions de verificacions actives La petició de verificacions actives s'empra per obtindre les verificacions actives a tractar per l'agent. Aquesta petició s'envia per l'agent a l'iniciar-se, cada interval *RefreshActiveChecks*. | Camp | Tipus | Obligatori | Valor | |-|-|-|--------| | request | _string_ | yes | `verificacions actives` | | host | _string_ | yes | Nom d'equip. | | version | _string_ | yes | Versió de l'agent: \<major>.\<minor>. | | host_metadata | _string_ | no | El paràmetre de configuració HostMetadata o el valor mètric HostMetadataItem. | | interface | _string_ | no | El paràmetre de configuració HostInterface o el valor mètric HostInterfaceItem. | | ip | _string_ | no | La primera IP del paràmetre de configuració si s'ha definit ListenIP. | | port | _number_ | no | El valor del paràmetre de configuració ListenPort si s'ha definit i no el port d'escolta per defecte de l'agent. | Exemple: ```json { "request": "active checks", "host": "Zabbix server", "version": "6.0", "host_metadata": "mysql,nginx", "hostinterface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` ### Active checks response The active checks response is sent by the server back to agent after processing active checks request. | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | info |<| _string_ | no | Error information in the case of failure. | | data |<| _array of objects_ | no | Active check items. | | | key | _string_ | no | Item key with expanded macros. | |^| itemid | _number_ | no | Item identifier. | |^| delay | _string_ | no | Item update interval. | |^| lastlogsize | _number_ | no | Item lastlogsize. | |^| mtime | _number_ | no | Item mtime. | | 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. | Example: ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": "30s", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "itemid": 5678, "delay": "10m", "lastlogsize": 0, "mtime": 0 } ] } ``` ### resposta de verificacions actives El servidor retorna la resposta de comprovacions actives a l'agent després de processar la petició de comprovacions actives. | Camp |<| Tipus | Obligatori | Valor | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `èxit` \| `fallit` | | info |<| _string_ | no |Informació d'error en cas de fallada. | | data |<| _array of objects_ | no | Elements de verificació actiu. | | | key | _string_ | no | Clau d'element amb macros ampliades. | |^| itemid | _number_ | no | Identificador d'element. | |^| delay | _string_ | no | Interval d'actualització de l'element. | |^| lastlogsize | _number_ | no | Darrera mida de l'element. | |^| mtime | _number_ | no | Element mtime. | | regexp |<| _array of objects_ | no | Expressions regular globals. | | | name | _string_ | no | Nom de l'expressió regular global. | |^| expression | _string_ | no | Expressió regular global. | |^| expression_type | _number_ | no | Tipus d'expressió regular global. | |^| exp_delimiter | _string_ | no | Delimitador global d'expressions regulars. | |^| case_sensitive | _number_ | no | Configuració global de distinció entre majúscules i minúscules d'expressió regular. | Exemple: ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": "30s", "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "itemid": 5678, "delay": "10m", "lastlogsize": 0, "mtime": 0 } ] } ``` #### Active proxy #### Proxy actiu #### Add a trigger dependency Make trigger "14092" dependent on trigger "13565." Request: ```json { "jsonrpc": "2.0", "method": "trigger.adddependencies", "params": { "triggerid": "14092", "dependsOnTriggerid": "13565" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "14092" ] }, "id": 1 } ``` #### Afegir una dependència d'un trigger Fer que el trigger "14092" depengui del trigger "13565." Petició: ```json { "jsonrpc": "2.0", "method": "trigger.adddependencies", "params": { "triggerid": "14092", "dependsOnTriggerid": "13565" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "14092" ] }, "id": 1 } ``` #### 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: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#FSTYPE}", "value": "@File systems for discovery" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Afegir un filtre a una regla de descoberta de baix nivell (LLD) Afegir un filtre per tal que el contingut de la macro *{\#FSTYPE}* coincideixi amb l'expressió regular *@File systems for discovery*. Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "filter": { "evaltype": 1, "conditions": [ { "macro": "{#FSTYPE}", "value": "@File systems for discovery" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Adding a scheduled downtime Add a downtime for service with ID "4" scheduled weekly from Monday 22:00 till Tuesday 10:00. Request: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "serviceid": "4", "times": [ { "type": "1", "ts_from": "165600", "ts_to": "201600" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4" ] }, "id": 1 } ``` #### Afegir un temps d'aturada planificat Afegir un temps d'aturada per al servei amb l'ID "4", programat cada setmana de dilluns a les 10 del vespre a dimarts a les 10 del matí. Petició: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "serviceid": "4", "times": [ { "type": "1", "ts_from": "165600", "ts_to": "201600" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4" ] }, "id": 1 } ``` #### Adding dashboards To add dashboards to a template in *Configuration → Templates*, do the following: - Click on *Dashboards* in the row of the template - Configure a dashboard following the guidelines of [configuring dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard) ::: noteimportant The widgets that can be included in a template dashboard are: *Clock*, *Graph (classic)*, *Graph prototype*, *Item value*, *Plain text*, *URL*. ::: ::: notetip For details on accessing host dashboards that are created from template dashboards, see the [host dashboard](/manual/config/visualization/host_screens#accessing_host_dashboards) section. ::: #### Afegint taulers Per afegir taulers a una plantilla a *Configuració → Plantilles*, seguiu aquestes passes: - Feu clic a *Taulers de control* a la filera de la plantilla - Configureu un tauler seguint les directrius de la [configuració de taulers](/manual/web_interface/frontend_sections/monitoring/dashboard) ::: noteimportant Els ginys que es poden incloure en una plantilla de tauler són: *Rellotge*, *Gràfic clàssic*, *prototip de gràfic*, *valor d'element*, *text sense format*, *URL*. ::: ::: notetip Per obtindre més informació sobre com accedir als taulers de control de l'equip creats a partir de plantilles de taulers, consulteu [tauler de control de l'equip](/manual/config/visualization/host_screens#accessing_host_dashboards). ::: #### 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 construction and view modes.<br>In construction 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 can be set for the element. 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. ::: #### Afegir elements Per afegir un element, feu clic a *Afegir* al costat d'`Element del mapa`. El nou element apareixerà a la cantonada superior esquerra del mapa. Arrossegueu-lo i deixeu-lo anar allà on vulgueu. Tingueu en compte que amb l'opció de quadrícula "Activada", els elements sempre s'ajustaran a la quadrícula (podeu triar diferents mides de quadrícula a la llista desplegable, així com amagar/mostrar la quadrícula). Si voleu posar elements a qualsevol lloc sense alineació, activeu l'opció "Desactivat". (A continuació, els elements aleatoris es poden alinear de nou a la quadrícula amb el botó *Alinea els elements del mapa*). Ara que teniu elements al seu lloc, potser voldreu començar a diferenciar-los donant-los noms, etc. Fent clic a l'element, es mostra un formulari i es pot definir el tipus d'element, donar un nom, triar una altra icona, etc. . {width="600"} Atributs de l'element del mapa: |Paràmetre|Descripció| |--|---------| |*Tipus*|Tipus d'element:<br>**Equip** - icona que representa l'estat de tots els triggers de l'equip triat<br>**Mapa** - icona que representa l'estat de tots els elements del mapa<br> **Trigger** - icona que representa l'estat d'un o més triggers<br>**[Grup d'equips](/manual/config/visualization/maps/host_groups)** - icona que representa l'estat de tots els triggers de tots els equips que pertanyen al grup triat<br>**Imatge** - una icona, no enllaçada a un recurs| |*Etiqueta*|Etiqueta d'icona, qualsevol cadena.<br>Es poden emprar macros i cadenes de diverses línies.<br>Les expressions [macros](/manual/appendix/macros/supported_by_location) s'admeten en aquest camp, però només amb `avg`, `last`, `min` i `max`, amb el temps com a paràmetre (per exemple, `{?avg(/host/key,1h)}`).<br>Per obtindre una llista completa de macros compatibles, veieu [macros compatibles](/manual/appendix/macros/supported_by_location) i cerqueu 'etiquetes d'elements de mapa'.| |*Ubicació de l'etiqueta*|Ubicació de l'etiqueta en relació a la icona:<br>**Predeterminat** - ubicació de l'etiqueta predeterminada del mapa<br>**A sota** - a sota de la icona<br>**Esquerra** - a l'esquerra< br>**Dreta** - a la dreta<br>**A sobre** - a sobre de la icona| |*Equip*|Introduïu l'equip si el tipus d'element és 'Equip'. Aquest camp s'emplena automàticament, de manera que començar a escriure un nom d'equip oferirà una llista desplegable d'equips coincidents. Desplaceu-vos cap avall per triar. Feu clic a 'x' per esborrar la selecció.| |*Mapa*|Trieu el mapa, si el tipus d'element és 'Mapa'.<br>Aquest cap s'auto-emplena, així que començant a escriure el nom d'un mapa oferirà una selecció de mapes. Baixeu per triar-ne, i cliqueu la 'x' per esborrar el triat.| |*Triggers*|Si el tipus d'element és "Trigger", trieu un o més triggers al camp *Triggers nous* de sota i feu clic a *Afegeix*.<br>L'ordre dels triggers triats es pot canviar, però només en el mateix gravetat dels desencadenants. La selecció de diversos triggers també afecta la resolució de la macro {HOST.\*} tant en el mode de compilació com en el de visualització.<br>// 1 En el mode de compilació // les primeres macros {HOST.\*} que es mostren es resoldran en funció del primer trigger de la llista (segons la gravetat del trigger).<br>// 2 El mode de visualització// depèn de la configuració [Mostra els problemes] (/manual/config/visualization/maps/ map#creating_a_map) a la configuració general atributs del mapa.<br> \* Si es tria el mode *Detall únic problema*, les primeres macros {HOST.\*} que es mostren es resoldran en funció del darrer trigger detectat (independentment de la gravetat) o el primer trigger de la llista (si no es detecta cap problema);<br>\* Si es tria el mode *Nombre de problemes i detall més crític*, les primeres macros que es mostren {HOST. \*} es resoldran en funció de la gravetat del trigger.< br>| |*Grup d'equips*|Introduïu el grup d'equips si el tipus d'element és "Grup d'equips". Aquest camp s'emplena automàticament, de manera que començar a escriure un nom de grup oferirà una llista desplegable de grups coincidents. Desplaceu-vos cap avall per triar. Feu clic a 'x' per esborrar la selecció.| |*Etiquetes*|Especifiqueu etiquetes per limitar el nombre de problemes que es mostren al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms i valors d'etiquetes especificats ​​(distingeix entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats on els valors de les etiquetes contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br >**No existeix** - exclou els valors especificats noms d'etiquetes<br>**No és igual** - exclosos els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta continguin la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br> Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per la condició O<br> **O** - suficient si es compleix una condició<br>Aquest camp és disponible per als tipus d'elements d'equip i de grups d'equip.| |*Selecció automàtica d'icones*|En aquest cas, s'emprarà un mapa d'icones per determinar quina icona es mostrarà.| |*Icones*|Podeu escollir mostrar diferents icones per a l'element en aquests casos: predeterminat, problema, manteniment, desactivat.| |*Coordenada X*|Coordenada X de l'element del mapa.| |*Coordenada Y*|Coordenada Y de l'element del mapa.| |*URLs*|Es poden definir URL específics per a l'element. Aquests es mostraran com a enllaços quan un usuari faci clic a l'element en mode de visualització de mapa. Si l'element té les seves pròpies URLs i hi ha URLs a nivell de mapa per al seu tipus definit, es combinaran al mateix menú.<br>Les macros es poden emprar en els noms dels elements i els valors del mapa. Per obtindre una llista completa, veieu [macros compatibles](/manual/appendix/macros/supported_by_location) i cerqueu 'noms i valors d'URL del mapa'.| ::: noteimportant Els elements afegits no es desaran automàticament. Si us allunyeu de la pàgina, és possible que es perdin tots els canvis. Per tant, és una bona idea fer clic al botó **Actualitzar** a la cantonada superior dreta. Un cop fet clic, els canvis es desaran independentment del que trieu a la següent finestra emergent. Les opcions de quadrícula triades també es desen amb cada mapa. ::: ##### 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, versions of Zabbix prior to 1.8 would add another host with the same name. Zabbix 1.8.1 and later adds **\_N** to the hostname, where **N** is increasing number, starting with 2. ::: ##### Afegir un equip Els equips s'afegeixen durant el procés de descoberta, tan aviat com es descobreix un equip, i no al final del procés de descoberta. ::: notetip Com que la descoberta de la xarxa pot trigar una mica a causa del temps d'espera de molts equips/serveis no disponibles, és recomanable emprar intervals d'IP raonables. ::: Quan s'afegeix un equip, el seu nom ve determinat per la funció estàndard **gethostbyname**. Si es pot resoldre l'equip, s'empra el nom resolt. En cas contrari, s'empra l'adreça IP. A més, si l'adreça IPv6 s'ha d'emprar per a un nom d'equip, tots els ":" (dos punts) es substituiran per "\_" (guió baix), ja que els dos punts no es permeten als noms d'equip. ::: noteimportant Si la descoberta la fa un proxy, la cerca del nom d'equip sempre es fa al servidor Zabbix. ::: ::: noteimportant Si un equip ja existeix a la configuració de Zabbix i té el mateix nom que el descobert recentment, les versions de Zabbix anteriors a la 1.8 afegirien un altre equip amb el mateix nom. Zabbix 1.8.1 i posterior afegeix **\_N** al nom d'equip, on **N** és un nombre creixent, començant per 2. ::: #### Adding host Information about configured hosts in Zabbix is available in *Configuration → Hosts* as well as *Monitoring* → *Hosts*. 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. ***Groups*** - Select one or several existing groups by clicking *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 '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) can be left at 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. You have defined a Zabbix agent interface, so you can use the agent availability icon (with "ZBX" on it) to understand the host 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. #### Afegir un equip La informació sobre els equips configurats a Zabbix és disponible a *Configuració → Equips*, així com *Monitoratge* → *Equips*. Ja hi ha un equip predefinit, anomenat "servidor Zabbix", però volem aprendre a afegir-ne un altre. Per afegir un nou equip, feu clic a *Crear equip*. Això ens presentarà un formulari de configuració de l'equip.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. El mínim imprescindible per entrar aquí és: ***Nom de l'equip*** - Introduïu un nom d'equip. Es permeten caràcters alfanumèrics, espais, punts, guions i guions baixos. ***Grups*** - Trieu un o diversos grups existents fent clic al botó *Triar* o introduïu un nom de grup que no existeixi per crear-e un de nou. ::: noteclassic Tots els permisos d'accés s'assignen a grups d'equip, no a equips individuals. És per això que un equip ha de pertànyer a almenys un grup. ::: ***Interfícies: adreça IP*** - Encara que tècnicament no és un camp obligatori, és possible que vulgueu introduir l'adreça IP de l'equip. Tingueu en compte que si aquesta és l'adreça IP del servidor Zabbix, s'ha d'especificar a la directiva 'Servidor' del fitxer de configuració de l'agent Zabbix. - S'admeten diversos tipus d'interfície d'equip per a un host: Agent, SNMP, JMX i IPMI. Consulteu [Configuració de l'equip](/manual/config/hosts/host#configuration) per obtindre més detalls. Les [altres opcions](/manual/config/hosts/host#configuration) es poden deixar per defecte de moment. Quan hagueu acabat, feu clic a *Afegir*. El vostre nou equip hauria de ser visible a la llista d'equips. {width="600"} La columna Disponibilitat conté indicadors de disponibilitat de l'equip per a cada interfície. Heu definit una interfície d'agent de Zabbix, de manera que podeu emprar la icona de disponibilitat de l'agent (amb "ZBX") per entendre la disponibilitat de l'equip: -  - l'estat de l'equip no s'ha establert; encara no s'ha fet cap comprovació mètrica -  - l'equip és disponible, una comprovació de mètriques ha estat correcta -  - l'equip no és disponible, una comprovació de mètriques ha fallat (mogueu el cursor del ratolí sobre la icona per veure el missatge d'error). Pot haver-hi algun error amb la comunicació, potser degut a credencials incorrectes de la interfície. Comproveu que el servidor Zabbix s'és executant i proveu també d'actualitzar la pàgina més tard. #### Adding hosts to host groups Add two hosts to host groups with IDs 5 and 6. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Afegir equips a grups Afegeix dos equips als grups d'equips amb IDs 5 i 6. Petició: ```json { "jsonrpc": "2.0", "method": "hostgroup.massadd", "params": { "groups": [ { "groupid": "5" }, { "groupid": "6" } ], "hosts": [ { "hostid": "30050" }, { "hostid": "30001" } ] }, "auth": "f223adf833b2bf2ff38574a67bba6372", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "5", "6" ] }, "id": 1 } ``` #### Adding item All items are grouped around hosts. That is why to configure a sample item we go to *Configuration → 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.  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.  #### Afegir un element Tots els elements s'agrupen al voltant dels equips. Per tant, per configurar un element d'exemple, anem a *Configuració → Equips* i trobem el 'Nou equip' que hem creat. Feu clic a l'enllaç *Elements* a la filera "Nou equip" i, a continuació, feu clic a *Crear element*. Això ens presentarà un formulari de definició d'element.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Per al nostre element d'exemple, la informació essencial a introduir és: ***Nom*** - Escriviu *Càrrega de CPU* com a valor. Aquest serà el nom visible de l'element a les llistes i altres llocs. ***Clau*** - Introduïu manualment *system.cpu.load* com a valor. Aquest és el nom tècnic d'un element que identifica el tipus d'informació que es recopilarà. La clau en particular és només una de les [claus predefinides](/manual/config/items/itemtypes/zabbix_agent) proporcionades amb l'agent Zabbix. ***Tipus d'informació*** - Aquest atribut defineix el format de les dades esperades. Per a la clau *system.cpu.load*, aquest camp s'establirà automàticament en *Numèric (flotant)*. - :::noteclassic També podeu reduir el nombre de dies per conservar l'[historial d'elements](/manual/config/items/history_and_trends) a 7 o 14. Aquesta és una bona pràctica per evitar que la base de dades conservi massa valors històrics. ::: [Les altres opcions](/manual/config/items/item#configuration) vindran amb els seus valors per defecte de moment. Quan hagueu acabat, feu clic a *Afegir*. El nou element hauria d'aparèixer a la llista d'elements, i veureu un missatge d'aprovació.  #### Adding items, triggers, graphs There are two ways to add items to the template: 1. To create new items, follow the guidelines for [Creating an item](/manual/config/items/item). 2. To add existing items to the template: - Go to *Configuration → Hosts* (or *Templates*). - Click on *Items* in the row of the required host/template. - Mark the checkboxes of items you want to add to the template. - Click on *Copy* below the item list. - Select the template (or group of templates) the items should be copied to and click on *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. #### Afegir elements, triggers i gràfics Hi ha dues maneres d'afegir elements a la plantilla: 1. Per crear nous elements, seguiu les instruccions de [Crear un element](/manual/config/items/item). 2. Per afegir elements a la plantilla, seguiu aquestes passes: - Aneu a *Configuració → Equips* (o *Plantilles*). - Feu clic a *Elements* a la filera d'equip/model requerida. - Marqueu les caselles dels elements que voleu afegir a la plantilla. - Feu clic a *Copiar* sota la llista d'elements. - Trieu el model (o grup de models) en què s'han de copiar els elements i feu clic a *Copiar*.<br> Tots els elements triats s'han de copiar al model. L'addició de triggers i gràfics es fa de la mateixa manera (a partir de la llista de triggers i gràfics respectivament), de nou tenint en compte que només es poden afegir si primer s'afegeixen els elements necessaris. #### Adding item to template To add an item to the template, go to the item list for 'New host'. In *Configuration → Hosts* click on *Items* next to 'New host'. Then: - mark the checkbox of the 'CPU Load' item in the list - click on *Copy* below the list - select the template to copy item to  All mandatory input fields are marked with a red asterisk. - click on *Copy* If you now go to *Configuration → Templates*, 'New template' should have one new item in it. We will stop at one item only for now, but similarly you can add any other items, triggers or other entities to the template until it's a fairly complete set of entities for given purpose (monitoring OS, monitoring single application). #### Afegir un model a l'element Per afegir un element a la plantilla, aneu a la llista d'elements per a "Equip nou". A *Configuració → Equips*, feu clic a *Elements* al costat de "Nou equip". Després: - marqueu la casella de l'element "Càrrega de CPU" a la llista - feu clic a *Copia* sota la llista - trieu el model que copiar l'element  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. - feu clic a *Copiar* Si ara aneu a *Configuració → Plantilles*, "Plantilla nova" hauria de contindre un element nou. Ens aturarem només en un element de moment, però de la mateixa manera podeu afegir altres elements, triggers o altres entitats al model fins que sigui un conjunt d'entitats bastant complet per a un propòsit determinat (monitoratge del sistema operatiu, monitoratge d'una sola aplicació). ##### 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"]`.  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>Since Zabbix 3.4, 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>This field is supported since 3.4.0. {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name, if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password, 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. ##### Afegint un element d'agent JMX Per cada comptador JMX en que siguem interessats, hem d'afegir l'element **JMX agent**, a aquella interfície. La clau dins la captura de pantalla d'aquí sota diu `jmx["java.lang:type=Memory","HeapMemoryUsage.used"]`.  Tots els camps obligatoris són marcats amb un asterisc vermell. Els camps que necessiten informació específica per als elements JMX són: | | | |--|--------| |*Tipus*|Definiu **JMX agent** aquí.| |*Clau*|La clau de l'element `jmx[]` conté tres paràmetres:<br>**object name** - el nom de l'objecte d'un MBean<br>**attribute name** - el nom de l'atribut MBean amb els noms dels camps de dades compostes separades per punts.<br>**unique short description** - una descripció única que permet més elements JMX amb el mateix nom d'objecte i el mateix nom d'atribut de l'equip (opcional)<br>Veieu aquí sota més detalls de les claus d'elements JMX.<br>Des de la versió Zabbix 3.4, podeu descobrir els atributs MBeans i MBean emprant l'element de [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/jmx) `jmx.discovery[]`.| |*JMX endpoint*|Podeu especificar un punt de tancament JMX personalitzat. Assegureu-vos que els paràmetres de connexió del node final JMX corresponen a la interfície JMX. Això es pot fer emprant les macros {HOST.\*} com al punt de tancament JMX per defecte.<br>Aquest camp es suporta des de la versió 3.4.0. Són admeses les [macros](/manual/appendix/macros/supported_by_location) i{HOST.\*} i les macros d'usuari.| |*Nom d'usuari*|Especifiqueu el nom d'usuari, si heu configurat l'autenticació a la vostra aplicació Java.<br>Es permeten les macros d'usuari.| |*Paraula de pas*|Especifiqueu el mot de pas, si heu configurat l'autenticació a la vostra aplicació Java.<br>Es permeten les macros d'usuari.| Si voleu monitorar un comptador booleà que sigui "cert" o "fals", especifiqueu el tipus d'informació "Numèrica (no signada)" i trieu l'etapa "Booleà a decimal" dins la pestanya de preprocessament. El servidor emmagatzemarà els valors booleans com 1 o 0, respectivament. #### 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"} #### Afegir línies A més de les formes, també s'hi poden afegir línies. Les línies es poden emprar per connectar elements o formes en un mapa. Per afegir una línia, feu clic a *Afegir* al costat de Forma. Apareixerà una forma nova a la cantonada superior esquerra del mapa. Trieu-la i feu clic a *Línia* al formulari d'edició per canviar el formulari a línia. Tot seguit, ajusteu les propietats de la línia, com ara el tipus de línia, l'amplada, el color, etc. {width="600"} #### Adding LLD macro paths Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Afegir camils de macro LLD Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "22450", "lld_macro_paths": [ { "lld_macro": "{#MACRO1}", "path": "$.json.path" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22450" ] }, "id": 1 } ``` #### Adding macros Add two new macros to two hosts. Request: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10160", "10167" ] }, "id": 1 } ``` #### Afegir macros Afegir dues macros noves a dos equips. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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_and_editing_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. #### Afegir pàgines Per afegir una pàgina nova a un tauler: - Assegureu-vos que el tauler és en [mode d'edició](#viewing_and_editing_a_dashboard) - Feu clic a la fletxa al costat del botó *Afegir* i trieu l'opció *Afegir pàgina*  - Ompliu la configuració general de la pàgina i feu clic a *Aplicar*. Si deixeu el nom en blanc, la pàgina s'afegirà amb el nom "Pàgina N" on "N" és el nombre de pàgina incremental. El període de visualització de la pàgina us permet personalitzar quant de temps es mostra una pàgina en una presentació de diapositives.  S'afegirà una pàgina nova, indicada per una nova pestanya (*Pàgina 2*).  Les pàgines es poden reordenar arrossegant i deixant anar les pestanyes de la pàgina. La reorganització conserva el nom de la pàgina original. Encara és possible accedir a cada pàgina fent clic a la seva pestanya. Quan s'afegeix una pàgina nova, és buida. Podeu afegir-hi ginys tal com es descriu anteriorment. ##### Adding permissions By default, a new user has no permissions to access hosts. 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 *Permissions* tab. {width="600"} This user is to have read-only access to *Linux servers* group, so click on *Select* next to the host group selection field.  In this popup, mark the checkbox next to 'Linux servers', then click *Select*. *Linux servers* should be displayed in the selection field. Click the 'Read' button to set the permission level and then *Add* to add the group to the list of permissions. In the user group properties form, click *Update*. ::: noteimportant In Zabbix, access rights to hosts 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. ##### Afegir permisos Per defecte, un usuari nou no té permisos per accedir als equips. Per concedir els drets d'usuari, feu clic al grup de l'usuari a la columna *Grups* (en aquest cas, "Administradors Zabbix"). Al formulari de propietats del grup, aneu a la pestanya *Permisos*. {width="600"} Aquest usuari ha de tindre accés només de lectura al grup *Servidors Linux*, així que feu clic a *Triar* al costat del camp de selecció del grup d'equips.  En aquesta finestra emergent, marqueu la casella de selecció al costat de "Servidors Linux" i feu clic a *Triar*. Els *Servidors Linux* s'han de mostrar al camp de selecció. Feu clic al botó "Llegir" per establir el nivell de permís i després *Afegir* per afegir el grup a la llista de permisos. Al formulari de propietats del grup d'usuaris, feu clic a *Actualitzar*. ::: noteimportant A Zabbix, els drets d'accés als equips s'assignen a [grups d'usuaris](/manual/config/users_and_usergroups/usergroup), no pas a usuaris individuals. ::: Fet! Podeu provar d'iniciar sessió amb les credencials del nou usuari. ##### 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 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.<br>This option is supported since Zabbix 4.0.0.| |*Interface*|<|Enter interface details for the passive proxy.<br>This field is only available if a passive proxy is selected in the *Proxy mode* field.| | |*IP address*|IP address of the passive proxy (optional).| |^|*DNS name*|DNS name of the passive proxy (optional).| |^|*Connect to*|Clicking the respective button will tell Zabbix server what to use to retrieve data from proxy:<br>**IP** - Connect to the proxy IP address (recommended)<br>**DNS** - Connect to the proxy DNS name| |^|*Port*|TCP port number of the passive proxy (10051 by default).| |*Description*|<|Enter the proxy description.| The **Encryption** tab allows you to require encrypted connections 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| ##### Afegir proxys Per configurar un proxy a la interfície de Zabbix: - Aneu a: *Administració → Proxys* - Feu clic a *Crear un proxy* {width="600"} |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom del proxy*|<|Introduïu el nom del proxy. Aquest ha d'ésser el mateix nom que al paràmetre *Hostname* del fitxer de configuració del proxy.| |*Mode del proxy*|<|Trieu el mode proxy.<br>**Actiu** - el proxy es connectarà al servidor Zabbix i demanarà dades de configuració<br>**Passiu** - el servidor Zabbix es connectarà al proxy<br>*Tingueu en compte* que sense comunicacions xifrades (sensibles), les dades de configuració del proxy poden estar disponibles per a les persones amb accés al port de captura del servidor Zabbix quan s'empra un proxy actiu. Això és possible perquè qualsevol persona pot simular ésser un proxy actiu i demanar dades de configuració si l'autenticació no es fa o si les adreces del proxy no són restringides al camp *Adreça del proxy*.| |*Adreça del proxy*|<|Si s'especifica, les peticions de proxy actiu només s'accepten d'aquesta llista d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de proxy actiu de Zabbix.<br>Aquest camp només és disponible si hi ha un proxy actiu, triatal camp *Mode proxy*. Les macros no són compatibles.<br>Aquesta opció és compatible des de Zabbix 4.0.0.| |*Interfície*|<|Introduïu els detalls de la interfície per al proxy passiu.<br>Aquest camp només és disponible si es tria un proxy passiu al camp *Mode proxy*.| | |*Adreça IP*|Adreça IP de proxy passiu (opcional).| |^|*Nom DNS*|Nom DNS del proxy passiu (opcional).| |^|*Connectar a*|Fer clic al botó corresponent indicarà al servidor Zabbix què s'ha d'emprar per obtindre dades proxy:<br>**IP** - Connecta't a l'adreça IP del proxy (recomanat)<br>**DNS** - Connecteu-vos al nom DNS del proxy | |^|*Port*|Nombre de port TCP/UDP del proxy passiu (10051 per defecte).| |*Descripció*|<|Introduïu la descripció del proxy.| La pestanya **Xifrat** us permet requerir connexions xifrades amb el proxy. |Paràmetre|Descripció| |--|---------| |*Connexions del proxy*|Com es connecta el servidor al proxy passiu: sense xifrat (per defecte), emprant PSK (clau prèviament compartida) o certificat.| |*Connexions des del proxy*|Trieu el tipus de connexions permeses des del proxy actiu. Es poden triar diversos tipus de connexió al mateix temps (útil per provar i canviar a un altre tipus de connexió). El valor predeterminat és "Sense xifrat".| |*Emès per*|Emissor autoritzat del certificat. El certificat es valida primer amb la CA (Certificate Authority). Si és vàlid, signat per l'AC, el camp *Emissor* es pot emprar per restringir encara més l'AC autoritzada. Aquest camp és opcional i és pensat per ser emprat si la vostra instal·lació de Zabbix empra certificats de diverses CA.| |*Assumpte*|Subjecte autoritzat del certificat. El certificat es valida primer amb CA. Si és vàlid, signat per l'AC, el camp *Assumpte* es pot emprar per permetre només un valor de cadena *Assumpte*. Si aquest camp és en blanc, s'accepta qualsevol certificat vàlid signat per la CA configurada.| |*Identitat PSK*|Cadena d'identitat de clau prèviament compartida.<br>No introduïu informació sensible a la identitat PSK, es transmet sense xifrar per la xarxa per informar al receptor quina PSK ha d'emprar.| |*PSK*|Clau precompartida (cadena hexadecimal). Longitud màxima: 512 dígits hexadecimals (PSK de 256 octets) si Zabbix empra la biblioteca GnuTLS o OpenSSL, 64 dígits hexadecimals (PSK de 32 octets) si Zabbix empra la biblioteca Mbed TLS (PolarSSL). Exemple: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| #### 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 (constructor page) or clipped (other pages with maps). #### Afegir formes A més dels elements del mapa, també és possible afegir formes. Les formes no són elements del mapa; només són una representació visual. Per exemple, una forma rectangular es pot emprar com a fons per agrupar alguns equips. Es poden afegir formes rectangulars i el·lipses. Per afegir una forma, feu clic a *Afegir* al costat de Forma. La nova forma apareixerà a la cantonada superior esquerra del mapa. Arrossegueu-la i deixeu-la anar allà on vulgueu. S'afegeix una nova forma amb els colors predeterminats. En fer clic a la forma, es mostra un formulari i es pot personalitzar l'aspecte d'una forma, afegir text, etc. {width="600"} Per triar formes, marqueu-ne una i, a continuació, manteniu premuda la tecla *Ctrl* per triar les altres. Amb diverses formes triades, les propietats comunes es poden actualitzar massivament, de manera similar als elements. El text es pot afegir en formes. Les [macros](/manual/appendix/macros/supported_by_location) s'admeten al text, però només amb les funcions `avg`, `last`, `min` i `max`, amb el temps com a paràmetre (p. ex., `{?avg (/host/key,1h)}`). Per veure només text, la forma es pot fer invisible traient la vora de la forma (Trieu "Cap" al camp *Marge*). Per exemple, tingueu en compte que la macro {MAP.NAME}, visible a la captura de pantalla anterior, és en realitat una forma rectangular amb text, que es pot veure fent clic a la macro:  {MAP.NAME} es resol amb el nom del mapa configurat quan es mostra el mapa. Si s'empren hiperenllaços al text, es pot fer clic quan es visualitza el mapa. L'ajustament de paraules per al text sempre és "activat" a les formes. Tanmateix, en una el·lipse, les línies s'emboliquen com si l'el·lipse fos un rectangle. No s'implementa l'ajustament de paraules, de manera que les paraules llargues (paraules que no coincideixen amb la forma) no s'emboliquen, sinó que s'emmascaren (generador de pàgines) o es trunquen (altres pàgines amb mapes). #### Adding template To start working with templates, we must first create one. To do that, in *Configuration → Templates* click on *Create template*. This will present us with a template configuration form.  All mandatory input fields are marked with a red asterisk. The required parameters to enter here are: ***Template name*** - Enter a template name. Alpha-numericals, spaces and underscores are allowed. ***Groups*** - Select one or several groups by clicking *Select* button. The template must belong to a group. When done, click *Add*. Your new template should be visible in the list of templates. {width="600"} As you may see, the template is there, but it holds nothing in it - no items, triggers or other entities. #### Afegir una plantilla Per començar a treballar amb plantilles, primer hem de crear-ne una. Per fer-ho, a *Configuració → Plantilles* feu clic a *Crear una plantilla*. Això presentarà un formulari de configuració de plantilla.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els paràmetres necessaris per introduir aquí són: ***Nom del model*** - Introduïu el nom de model. Es permeten caràcters alfanumèrics, espais i guions baixos. ***Grups*** - Trieu un o més grups fent clic al botó *Triar*. El model ha de pertànyer a un grup. Quan hagueu acabat, fes clic a *Afegir*. La vostra nova plantilla hauria de ser visible al llistat de plantilles. {width="600"} Com podeu veure, el model hi és, però no conté res, ni elements, triggers ni altres entitats. #### Adding trigger To configure a trigger for our item, go to *Configuration → Hosts*. Click on the *Triggers* link in the row of 'New host', and then click on *Create trigger*. This will present us with a trigger configuration form.  For our trigger, the essential information to enter here is: *Name* - Enter *CPU load too high on 'New host' for 3 minutes* as the value. This will be the trigger name displayed in lists and elsewhere. *Expression* - Enter: avg(/New host/system.cpu.load,3m)>2 This is the trigger expression. Make sure that the expression is entered right, down to the last symbol. The item key here (system.cpu.load) is used to refer to the item. This particular expression basically says that the problem threshold is exceeded when the CPU load average value for 3 minutes is over 2. You can learn more about the [syntax of trigger expressions](/manual/config/triggers/expression). When done, click *Add*. The new trigger should appear in the trigger list. #### Afegir un trigger Per configurar un trigger al nostre element, aneu a *Configuració → Equips*, cerqueu "Equip nou" i feu clic a *Triggers* a la mateixa línia i després a *Creat trigger*. Això ens presenta una forma de definició de trigger.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Per al nostre trigger, la informació essencial a proporcionar és: *Nom* - Introduïu: *Càrrega de CPU massa alta a "Nou equip" durant 3 minuts* com a valor. Aquest serà el nom del trigger que es mostra a les llistes i en qualsevol altre lloc. *Expressió* - Introduïu: avg(/New host/system.cpu.load,3m)>2 Aquesta és l'expressió trigger. Assegureu-vos que l'expressió s'emplena correctament, fins al darrer símbol. La clau d'element aquí (system.cpu.load) s'empra per fer referència a l'element. Aquesta expressió en particular indica bàsicament que es supera el llindar del problema quan el valor mitjà de càrrega de la CPU durant 3 minuts és superior a 2. Podeu obtindre més informació sobre la [sintaxi de les expressions trigger](/manual/config/triggers/expression). Quan hàgiu acabat, feu clic a *Afegir*. El nou trigger hauria d'aparèixer a la llista de triggers. #### Adding user To view information about users, go to *Administration → 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"} #### Afegir un usuari Per veure informació sobre usuaris, aneu a *Administració → Usuaris*. {width="600"} Per afegir un usuari nou, feu clic a *Crear usuari*. Al formulari d'usuari nou, assegureu-vos d'afegir el vostre usuari en un dels [grups d'usuaris](/manual/config/users_and_usergroups/usergroup) existents, per exemple, "administradors Zabbix".  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. De manera predeterminada, els usuaris nous no tenen cap suport (mètodes de lliurament de notificacions) definit per a ells. Per crear-ne un, aneu a la pestanya 'Suports' i feu clic a *Afegir*.  En aquesta finestra, introduïu una adreça de correu electrònic per a aquest usuari. Podeu especificar un període durant el qual el suport serà actiu (veieu la pàgina [Especificació de period](/manual/appendix/time_period) per a la descripció del format), per defecte un suport sempre és actiu. També podeu personalitzar els nivells de [gravetat del trigger](/manual/config/triggers/severity) per als quals el suport serà actiu, però deixeu-los tots activats de moment. Feu clic a *Afegir* per desar el suport i, a continuació, aneu a la pestanya Permisos. La pestanya Permisos té un camp *Rol* obligatori. El rol determina quines interfícies pot veure l'usuari i quines accions té permesese. Premeu Triar i trieu un dels rols de la llista. Per exemple, trieu *Rol d'administrador* per permetre l'accés a totes les seccions de la interfície Zabbix excepte l'administració. Més endavant podeu canviar els permisos o crear més rols d'usuari. En triar un rol, els permisos apareixeran a la mateixa pestanya: {width="600"} Feu clic a *Afegir* al formulari de propietats de l'usuari per desar l'usuari. El nou usuari apareix a la llista d'usuaris. {width="600"} #### Adding web scenarios To add web scenarios to a template in *Configuration → Templates*, do the following: - Click on *Web* in the row of the template - Configure a web scenario following the usual method of [configuring web scenarios](/manual/web_monitoring#configuring_a_web_scenario) #### Afegir escenaris Web Per afegir escenaris web a una plantilla a *Configuració → Plantilles*, feu el següent: - Feu clic a *Web* a la filera de la plantilla - Configureu un escenari web seguint el mètode habitual de [configuració d'escenaris web](/manual/web_monitoring#configuring_a_web_scenario) #### Adding widgets To add a widget to a dashboard: - Click on the  button or the *Add widget* option in the action menu that can be opened by clicking on the arrow. Fill the widget configuration form. The widget will be created in its default size and placed after the existing widgets (if any); Or - Move your mouse to the desired empty spot for the new widget. Notice how a placeholder appears, on mouseover, on any empty slot on the dashboard. Then click to open the widget configuration form. After filling the form the widget will be created in its default size or, if its default size is bigger than is available, take up the available space. Alternatively, you may click and drag the placeholder to the desired widget size, then release, and then fill the widget configuration form. (Note that when there is a widget copied onto the clipboard, you will be first prompted to select between *Add widget* and *Paste widget* options to create a widget.)   In the widget configuration form: - Select the *Type* of widget - Enter widget parameters - Click on *Add*  #### Widgets A wide variety of [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) (e.g. [Clock](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock), [Host availability](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/host_availability) or [Trigger overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview)) can be added to a dashboard: these can be resized and moved around the dashboard in dashboard editing mode by clicking on the widget title bar and dragging it to a new location. Also, you can click on the following buttons in the top-right corner of the widget to: -  - edit a widget; -  - access the [widget menu](#widget_menu) Click on *Save changes* for the dashboard to make any changes to the widgets permanent. #### Afegir ginys Per afegir un giny a un tauler: - Feu clic al botó  o a l'opció *Afegeix un giny* al menú d'acció que s'obre fent clic a la fletxa. Ompliu el formulari de configuració del giny. El giny es crearà amb la mida predeterminada i es col·locarà després dels estris existents (si n'hi ha); Feu clic a O - Moveu el ratolí a la ubicació buida desitjada per al nou giny. Apareix un marcador de posició, al passar el ratolí, sobre qualsevol espai buit del tauler. A continuació, feu clic per obrir el formulari de configuració del giny. Després d'omplir el formulari, el giny es crearà amb la seva mida predeterminada o, si la seva mida per defecte és més gran que la disponible, ocuparà l'espai disponible. Alternativament, podeu fer clic i arrossegar el marcador de posició fins a la mida desitjada, deixar anar i completar el formulari de configuració del giny. (Tingueu en compte que quan es copia un giny al porta-retalls, primer se us demanarà que trieu entre les opcions *Afegir giny* i *Enganxar giny* per crear el giny.)   Al formulari de configuració del giny: - Trieu el *Tipus* de giny - Introduïu la configuració del giny - Feu clic a *Afegir*  #### Ginys Una àmplia varietat de [ginys](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) (p. ex., [Rellotge](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock), [Disponibilitat de l'equip](/manual /web_interface/frontend_sections/monitoring/dashboard/widgets/host_availability) o [vista general de trigger](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview)) es poden afegir a un tauler: es poden redimensionar i moure per tauler en mode d'edició del tauler fent clic a la barra de títol del giny i arrossegant-lo a una ubicació nova. A més, podeu fer clic als botons següents a l'extrem superior dret del giny per: -  - edita un giny; -  - accediu al [menú de ginys](#widget_menu) Feu clic a *Desar canvis* al tauler per fer canvis permanents als ginys. ### Adding Zabbix repository Install the repository configuration package. This package contains yum (software package manager) configuration files. SLES 15: rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/zabbix-release-latest.sles15.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' SLES 12: rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/12/x86_64/zabbix-release-latest.sles12.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' Please note that Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Afegir el repositori de Zabbix Instal·leu el paquet de configuració del repositori. Aquest paquet conté els fitxers de configuració yum (gestor de paquets de programari). SLES 15 : rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/zabbix-release-latest.sles15.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' SLES 12 : rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/6.0/sles/12/x86_64/zabbix-release-latest.sles12.noarch.rpm zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository' Tingueu en compte que el procés del servei web de Zabbix, que s'empra per [generar informes programats](/manual/web_interface/frontend_sections/reports/scheduled), requereix el navegador Google Chrome. El navegador no és pas inclòs als paquets i s'ha d'instal·lar a banda. #### Additional information #### Informació addicional ##### Additional parameters A third optional parameter is supported by the *bucket\_rate\_foreach* function: 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'. See [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) for more details and examples on using foreach functions. ##### Paràmetres addicionals Un tercer paràmetre opcional és compatible amb la funció *bucket\_rate\_foreach*: bucket_rate_foreach(filtre d'elements, període de temps, <nombre de paràmetre>) on el <nombre de paràmetre> és la posició del valor del "cub" a la clau de l'element. Per exemple, si el valor del "cub" a myItem\[aaa,0.2\] és '0,2', aleshores la seva posició és 2. El valor per defecte del <nombre de paràmetre> és '1'. Veieu [càlculs agregats](/manual/config/items/itemtypes/calculated/aggregate) per a més detalls i exemples sobre com emprar les funcions foreach. #### Additional ssh.run options The **ssh.run[]** item has been updated and now allows passing additional SSH options as a part of the item key. These options are supported only using libssh of version 0.9.0 and higher or libssh2. Supported option keys and values depend on the SSH library. See [SSH checks](/manual/config/items/itemtypes/ssh_checks) for details. #### Opcions addicionals d'ssh.run L'element **ssh.run[]** s'ha actualitzat i ara permet passar opcions SSH addicionals com a part de la clau de l'element. Aquestes opcions només s'admeten amb libssh versió 0.9.0 i superior o libssh2. Les claus d'opció i els valors admesos depenen de la biblioteca SSH. Consulteu les [comprovacions SSH](/manual/config/items/itemtypes/ssh_checks) per obtindre més informació. ### Administration With the Zabbix API you can change administration settings of your monitoring system. ### Administració Amb l'API Zabbix, podem modificar els paràmetres d'administració del nostre sistema de monitoratge. #### Advanced configuration Advanced configuration options become available if the *Advanced configuration* checkbox is marked (see screenshot) 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.  | | | |--|--------| |_**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 prioritised; 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* |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**_ |Time is the 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. | *Note* that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed. #### Configuració avançada Les opcions de configuració avançada són disponibles si la casella *Configuració avançada* és marcada (veieu la captura de pantalla) i només per als elements seleccionats al camp *Mostra* (vegeu més amunt). A més, la configuració avançada permet canviar el color de fons de tot el giny.  | | | |--|--------| |__**Descripció**_ |Introduïu la descripció de l'element. Aquesta descripció pot substituir el nom de l'element predeterminat. S'admeten descripcions de diverses línies. És possible una combinació de text i macros admeses.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} i macros d'usuari són compatibles. | |*Posició horitzontal* |Trieu la posició horitzontal de la descripció de l'element: esquerra, dreta o centre. | |*Posició vertical* |Trieu la posició vertical de la descripció de l'element: superior, inferior o mig. | |*Mida* |Introduïu l'alçada de la mida de la lletra per a la descripció de l'element (com a percentatge de l'alçada total del giny). | |*Negreta* |Marqueu la casella per mostrar la descripció de l'element en negreta. | |*Color* |Trieu el color de la descripció de l'element des del selector de colors.<br>`D` representa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Predeterminat* al selector de colors. | |_**Valor**_ | | |*Nombre de decimals* |Trieu quants decimals es mostraran amb el valor. Aquest valor només afectarà els elements flotants. Per als elements amb unitats configurades en "s", si aquest valor és superior a 0 (el valor predeterminat és 2), el giny arrodoneix la unitat de temps més significativa i mostra un valor numèric (per exemple, "10,43 m") en lloc de convertir el valor en una cadena de temps complet. Quan s'estableix en 0, els segons es converteixen en una cadena de temps llegible (per exemple, "4h 56m 30s"). | |*Mida* |Introduïu l'alçada de la mida de la lletra per a decimals (com a percentatge de l'alçada total del giny). | |*Posició horitzontal* |Trieu la posició horitzontal del valor de l'element: esquerra, dreta o centre. | |*Posició vertical* |Trieu la posició vertical del valor de l'element: superior, inferior o mig. | |*Mida* |Introduïu l'alçada de la mida de la lletra per al valor de l'element (com a percentatge de l'alçada total del giny).<br>*Tingueu en compte* que la mida del valor de l'element té prioritat; altres elements han de fer espai al valor. Amb l'indicador de canvi, però, si el valor és massa gran, es truncarà per mostrar l'indicador de canvi. | |*Negreta* |Marqueu la casella per mostrar el valor de l'element en negreta. | |*Color* |Trieu el color del valor de l'element des del selector de color.<br>`D` representa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Predeterminat* al selector de colors. | |*Unitats* |Marqueu la casella per mostrar les unitats amb el valor de l'element. Si introduïu un nom d'unitat, anul·larà la unitat de configuració de l'element. | |*Posició* |Trieu la posició de la unitat d'element - a sobre, a sota, abans o després del valor. | |*Mida* |Introduïu l'alçada de la mida de la font per a la unitat d'element (com a percentatge de l'alçada total del giny). | |*Negreta* |Marqueu la casella per mostrar la unitat de l'element en negreta. | |*Color* |Trieu el color de la unitat d'element des del selector de colors.<br>`D` representa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Predeterminat* al selector de colors. | |_**Hora**_ |L'hora és el valor del rellotge de l'historial d'elements. | |*Posició horitzontal* |Trieu la posició horitzontal de l'hora: esquerra, dreta o centre. | |*Posició vertical* |Trieu la posició vertical de l'hora: superior, inferior o mitjana. | |*Mida* |Introduïu l'alçada de la mida de la lletra per a l'hora (com a percentatge de l'alçada total del giny). | |*Negreta* |Marqueu la casella per mostrar l'hora en negreta. | |*Color* |Trieu el color de l'hora al selector de colors.<br>`D` és el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Predeterminat* al selector de colors. | |_**Indicador de canvi**_ |Trieu el color dels indicadors de canvi des del selector de color. Els indicadors de canvi són:<br>**↑** - el valor de l'element augmenta (per a elements numèrics)<br>**↓** - el valor de l'element està disminuint (per a elements numèrics)<br>**↕** - el valor de l'element ha canviat (per a elements de cadena i elements amb mapeig de valors)<br>`D` representa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Valor predeterminat* al selector de colors.<br>La mida vertical de l'indicador de canvi és igual a la mida del valor (part entera del valor per als elements numèrics).<br> *Tingueu en compte* que els indicadors alt i baix no es mostren amb un sol valor. | |_**Color de fons**_ |Trieu el color de fons per a tot el giny des del selector de colors.<br>`D` representa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Valor per defecte* al selector de colors. | *Tingueu en compte* que diversos elements no poden ocupar el mateix espai; si es col·loquen al mateix espai, es veurà un missatge d'error. #### Advanced configuration {width=600} |Parameter|Description| |--|--------| |_**Additional rules**_|Click on *Add* to define 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. ::: #### Configuració avançada {width=600} |Paràmetre|Descripció| |--|---------| |_**Regles addicionals**_|Feu clic a *Afegir* per definir regles addicionals de càlcul d'estat.| |*Establir l'estat a*|Estableix l'estat del servei a *D'acord* (per defecte), *Sense classificar*, *Informació*, *Avís*, *Mitjà*, *Alt* o *Desastre* en cas de coincidència de condicions.| |*Condició*|Seleccioneu la condició per als serveis fill directes:<br>**si almenys (N) serveis fill tenen un estat (estat) o superior**<br>**si almenys (N%) dels serveis per als nens tenen l'estat (estat) o superior**<br>**si és inferior a (N) els serveis per a nens tenen l'estat (estat) o inferior**<br>**si són inferiors a (N%) els serveis tenen un estat (estat) o inferior** <br>**si el pes dels serveis fill en estat (estat) o superior és com a mínim (W)**<br>** si el pes dels serveis per als fills en estat (estat) o superior és com a mínim (N%)* *<br>**si el pes dels serveis per als fills en estat (Estat) o inferior és inferior a (W)**<br>**si el pes de serveis per als fills en estat (Estat) o inferior és inferior a (N%)** <br><br> Si s'especifica més d'una condició i la situació correspon a més d'una condició, s'establirà la gravetat més alta. | |*N (W)*|Estableix el valor de N o W (1-100000) o N% (1-100) a la condició.| |*Estat|Seleccioneu el valor d'*Estat* a la condició: *D'acord* (per defecte), *Sense classificar*, *Informació*, *Avís*, *Mitjà*, *Alt* o *Desastre*.| |_**Regla de propagació de l'estat**_|Regla per propagar l'estat del servei al servei principal:<br>**Tal com és** - l'estat es propaga sense canvis<br>**Augmenta des de** - podeu augmentar la propagació estat d'1 a 5 nivells de gravetat<br >**Disminueix** - podeu reduir l'estat propagat d'1 a 5 nivells de gravetat<br>**Ignorar aquest servei** - l'estat no es propaga en absolut al servei principal< br>**Estat fix** - l'estat es propaga estàticament, és a dir, sempre el mateix| |_**Pes**_|Pes del servei (nombre enter entre 0 (per defecte) i 1.000.000).| :::noteclassic Les regles addicionals de càlcul d'estat només es poden emprar per pujar el nivell de gravetat a partir del nivell calculat segons la configuració principal *Regla de càlcul de l'estat*. Si segons regles addicionals l'estat hauria de ser Avís, però d'acord amb la *regla de càlcul de l'estat*, l'estat és Desastre, el servei tindrà estat de Desastre. ::: #### Advanced configuration The following parameters are supported if *Advanced configuration* is set to "Enabled". |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).| #### Configuració avançada Els paràmetres següents s'admeten si la *Configuració avançada* és establerta a "Habilitada". |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Color de fons*|<|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buida).| ##### 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', // ... ], // ... ]; ``` ##### Configuració avançada Es poden configurar paràmetres SAML addicionals al fitxer de configuració de la interfície Zabbix (*zabbix.conf.php*): - $SSO\['SP\_KEY'\] = '\<camí al fitxer de clau privada SP\>'; - $SSO\['SP\_CERT'\] = '\<camí al fitxer de certificat SP\>'; - $SSO\['IDP\_CERT'\] = '\<Camí del fitxer del certificat IDP\>'; - $SSO\['CONFIGURACIÓ'\] :::noteclassic Zabbix empra la biblioteca del [conjunt d'eines SAML PHP de OneLogin](https://github.com/onelogin/php-saml/tree/3.4.1) (versió 3.4.1). L'estructura de la secció $SSO\['SETTINGS'\] hauria de ser similar a l'estructura emprada per la biblioteca. Per obtindre una descripció de les opcions de configuració, veieu la biblioteca oficial [documentació](https://github.com/onelogin/php-saml/tree/3.4.1/#user-content-settings). ::: Només es poden definir les opcions següents com a part de $SSO\['SETTINGS'\]: - *strict* - *baseurl* - *compress* - *contactPerson* - *organization* - *sp* (només les opcions especificades en aquest llistat) - *attributeConsumingService* - *x509certNew* - *idp* (només les opcions especificades en aquest llistat) - *singleLogoutService* (només una opció) - *responseUrl* - *certFingerprint* - *certFingerprintAlgorithm* - *x509certMulti* - *security* (només les opcions especificades en aquest llistat) - *signMetadata* - *wantNameId* - *requestedAuthnContext* - *requestedAuthnContextComparison* - *wantXMLValidation* - *relaxDestinationValidation* - *destinationStrictlyMatches* - *rejectUnsolicitedResponsesWithInResponseTo* - *signatureAlgorithm* - *digestAlgorithm* - *lowercaseUrlencoding* Totes les altres opcions es recuperaran de la base de dades i no es podran substituir. L'opció *debug* serà ignorada. A més, si la interfície d'usuari de Zabbix està darrere d'un proxy o d'un equilibrador de càrrega, es pot emprar l'opció personalitzada *use\_proxy\_headers*: - *fals* (per defecte) - ignora l'opció; - *cert* - empreu les capçaleres HTTP X-Forwarded-\* per a la creació d'URL base. Si empreu un equilibrador de càrrega per connectar-vos a la instància de Zabbix, on l'equilibrador de càrrega empra TLS/SSL i no Zabbix, heu de proporcionar els paràmetres "baseurl", "strict" i "use_proxy_headers" de la manera següent: ```php $SSO['SETTINGS'] = [ 'strict' => false, 'baseurl' => 'https://zabbix.example.com/zabbix/', 'use_proxy_headers' => true ]; ``` **Exemple de configuració:** ```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. ::: Després de rebre una llista de comprovacions actives, l'agent marca els fitxers persistents obsolets per esborrar-los. Un fitxer persistent queda obsolet si: 1) l'element de registre corresponent ja no es monitora, 2) un element de registre es torna a configurar amb una ubicació **persistent\_dir** diferent a la d'abans. L'esborrat es fa amb un retard de 24 hores perquè els fitxers de registre en estat NO ADMÈS no s'inclouen a la llista de comprovacions actives, però poden ser ADMESOS més tard i els seus fitxers persistents seran útils. Si l'agent s'atura abans de la caducitat de les 24 hores, els fitxers obsolets no s'esborraran pas perquè l'agent Zabbix ja no rep informació sobre la seva ubicació del servidor Zabbix. ::: notewarning Torneu a configurar el **persistent\_dir** d'un element de registre a l'antiga ubicació **persistent\_dir** mentre l'agent és inactiu, sense esborrar l'antic fitxer persistent per part de l'usuari; missatges perduts o alertes falses. ::: #### Agent 2 package support for RHEL 6 dropped Since Zabbix 6.0.35, 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. #### S'ha tret el suport del paquet de l'Agent 2 per a RHEL 6 Des de Zabbix 6.0.35, els paquets de l'agent 2 de Zabbix ja no són pas disponibles per a [RHEL 6](https://repo.zabbix.com/zabbix/6.0/rhel/6/x86_64/) perquè Go 1.22 (i més recent) són incompatibles amb GCC 4.4.7 proporcionat per RHEL 6, el que provoca errors de compilació. Tingueu en compte, però, que els [paquets d'agent Zabbix](/manual/installation/install_from_packages/rhel) encara són compatibles. #### Agent 2 plugins ##### MySQL The correct master host is now returned if specified in the `mysql.replication.get_slave_status[]` [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql) "masterHost" parameter. Previously the "masterHost" parameter was ignored and always the first master host was returned. If this parameter is not specified, all hosts are returned. #### Plugins de l'agent 2 ##### MySQL Retorna l'equip mestre correcte si s'especifica al fitxer `mysql.replication.get_slave_status[]` [element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql) paràmetre "masterHost". Abans, el paràmetre "masterHost" s'ignorava i sempre retornava el primer equip mestre. Si no s'especifica aquest paràmetre, es retornen tots els equips. ##### Agent 2 |Requirement|Mandatory status|Description| |--|-|-------| |*Go*|Yes|Required to build Zabbix agent 2 and its plugins from source.<br>Go 1.25 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%2F6.0)<br>- [Plugin support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.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 (from Zabbix 6.0.0) 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.| ##### Agent 2 Si s'indica com a obligatori, el programari/biblioteca requerit és estrictament necessari. Calen opcions addicionals per donar suport a alguna funció específica. |Requisit|Estat obligatori|Descripció| |--|-|-------| |*Go*|Sí|Cal compilar l'agent 2 de Zabbix i els seus complements des del codi font.<br>S'admet Go 1.25 o posterior. Vegeu [go.dev](https://go.dev/doc/install) per obtenir instruccions d'instal·lació.<br>Les biblioteques Go que utilitza Zabbix agent 2 i els seus complements es llisten al repositori Zabbix Git (les biblioteques marcades com a "indirectes" al repositori són dependències d'altres biblioteques necessàries):<br>- [Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Compatibilitat amb complements](https://git.zabbix.com/projects/AP/repos/plugin-support/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)<br>- [Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse/go.mod?at=refs%2Fheads%2Frelease%2F6.0)| |*libpcre/libpcre2*|Cal una de les biblioteques PCRE/PCRE2 per al suport d'[expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>El nom pot ser diferent. depenent de la distribució GNU/Linux, per exemple 'libpcre3' o 'libpcre1'. S'admeten PCRE v8.x i PCRE2 v10.x (de Zabbix 6.0.0).<br>Cal per al monitoratge del registre. També cal a Windows.| |*libopenssl*|No|Cal quan s'empra el xifrat.<br>OpenSSL 1.0.1 o posterior és necessari a les plataformes UNIX.<br>La biblioteca OpenSSL ha de tindre el suport PSK activat. LibreSSL no és compatible.<br>Als sistemes Microsoft Windows cal OpenSSL 1.1.1 o posterior.| **Agent configuration** Add the next line to the agent configuration file: 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. ***Step 2*** It is possible to add additional monitoring for an already registered host. **Configuració de l'agent** Afegiu la línia següent al fitxer de configuració de l'agent: HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae on "Linux" és una plataforma i la resta de la cadena és un text secret difícil d'endevinar. Recordeu reiniciar l'agent després de fer canvis al fitxer de configuració. ***2a passa*** Es pot afegir monitoratge addicional per a un equip ja registrat. ##### 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 ``` ##### Configuració de l'agent Els nodes de clúster HA (servidors) s'han d'enumerar a la configuració de l'agent Zabbix o de l'agent Zabbix 2.  Per activar les comprovacions passives, els noms dels nodes han d'ésser llistats al [paràmetre](/manual/appendix/config/zabbix_agentd) del servidor, separats per una **coma**. ``` Servidor=zabbix-node-01,zabbix-node-02 ``` Per activar les comprovacions actives, els noms dels nodes han d'ésser llistats al [paràmetre](/manual/appendix/config/zabbix_agentd) ServerActive. Tingueu en compte que per a les comprovacions actives, els nodes s'han de separar per comes de qualsevol altre servidor, mentre que els nodes s'han de separar amb un **punt i coma**, per exemple: ``` ActiveServer=zabbix-node-01;zabbix-node-02 ``` **Agent configuration** Now you need to configure the agents. Add the next line to the agent configuration files: 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: 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. ##### Configuració de l'agent Ara heu de configurar els agents. Afegiu la línia següent als fitxers de configuració de l'agent: HostMetadataItem=system.uname Això garanteix que les metadades de l'equip contindran "Linux" o "Windows" en funció de l'equip on s'executa l'agent. Un exemple de metadades de l'equip en aquest cas: 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 Recordeu reiniciar l'agent després de fer canvis al fitxer de configuració. **Agent configuration** Update the next line in the agent configuration file: HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae Do not forget to restart the agent after making any changes to the configuration file. **Configuració de l'agent** Actualitzeu la següent línia a l'arxiu de configuració de l'agent: HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae No oblideu pas reiniciar l'agent després de fer canvis a l'arxiu de configuració. ### Agent data request The agent data request contains the gathered item values. | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | request |<| _string_ | yes | `agent data` | | host |<| _string_ | yes | Host name. | | version |<| _string_ | yes | The agent version: \<major>.\<minor>. | | session |<| _string_ | yes | Unique session identifier generated each time when agent is started. | | data |<| _array of objects_ | yes | Item values. | | | id | _number_ | yes | The value identifier (incremental counter used for checking duplicated values in the case of network problems). | |^| itemid | _number_ | yes | Item identifier. | |^| value | _string_ | no | The item value. | |^| lastlogsize | _number_ | no | The item lastlogsize. | |^| mtime | _number_ | no | The item mtime. | |^| state | _number_ | no | The item state. | |^| source | _string_ | no | The value event log source. | |^| eventid | _number_ | no | The value event log eventid. | |^| severity | _number_ | no | The value event log severity. | |^| timestamp | _number_ | no | The value event log timestamp. | |^| clock | _number_ | yes | The value timestamp (seconds since Epoch). | |^| ns | _number_ | yes | The value timestamp nanoseconds. | Example: ```json { "request": "agent data", "data": [ { "id": 1, "itemid": 5678, "value": "2.4.0", "clock": 1400675595, "ns": 76808644 }, { "id": 2, "itemid": 1234, "lastlogsize": 112, "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).", "clock": 1400675595, "ns": 77053975 } ], "host": "Zabbix server", "version": "6.0", "session": "1234456akdsjhfoui" } ``` ### Petició de dades de l'agent La petició de dades de l'agent conté els valors recollits dels elements. | Camp |<| Tipus | Obligatori | Valor | |-|------|--|-|-----------------------| | request |<| _string_ | yes | `agent data` | | host |<| _string_ | yes | Nom de l'equip. | | version |<| _string_ | yes | Versió de l'agent: \<major>.\<menor>. | | session |<| _string_ | yes | ID de sessió única general a cada inici de l'agent. | | data |<| _array of objects_ | yes | Valor dels elements. | | | id | _number_ | yes | ID del valor (comptador incremental emprat per verificar els valors duplicats en cas de problemes de xarxa). | |^| itemid | _number_ | yes | ID de l'element. | |^| value | _string_ | no | Valor de de l'element. | |^| lastlogsize | _number_ | no | El lastlogsize de l'element. | |^| mtime | _number_ | no | L'mtime de l'element. | |^| state | _number_ | no | Estat de l'element. | |^| source | _string_ | no | El valor de la font del registre d'esdeveniments. | |^| eventid | _number_ | no | Id de l'esdeveniment del registre d'esdeveniments. | |^| severity | _number_ | no | El valor de la gravetat del registre d'esdeveniments. | |^| timestamp | _number_ | no | El valor d'horari del registre d'esdeveniments. | |^| clock | _number_ | yes | L'horari de la marca de temps (segons des de l'Època). | |^| ns | _number_ | yes | El valor de la marca de temps, en nanosegons. | Exemple: ```json { "request": "agent data", "data": [ { "id": 1, "itemid": 5678, "value": "2.4.0", "clock": 1400675595, "ns": 76808644 }, { "id": 2, "itemid": 1234, "lastlogsize": 112, "value": " 19845:20140621:141708.521 Starting Zabbix Agent [<hostname>]. Zabbix 2.4.0 (revision 50000).", "clock": 1400675595, "ns": 77053975 } ], "host": "Zabbix server", "version": "6.0", "session": "1234456akdsjhfoui" } ``` ### Agent data response The agent data response is sent by the server back to agent after processing the agent data request. | Field | Type | Mandatory | Value | |-|-|-|--------| | response | _string_ | yes | `success` \| `failed` | | info | _string_ | yes | Item processing results. | Example: ```json { "response": "success", "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534" } ``` ### Resposta de les dades de l'agent La resposta de dades de l'agent s'envia per el servidor a l'agent després del tractament de la petició de dades de l'agent. | Camp | Tipus | Obligatori | Valor | |-|-|-|--------| | response | _string_ | sí | `success` \| `failed` | | info | _string_ | sí | Resultats del processat dels elements. | Exemple: ```json { · "response": "success", · "info": "processed: 2; failed: 0; total: 2; seconds spent: 0.003534" } ``` #### Agent items Several **new** items have been added to Zabbix agent/agent 2: - **agent.hostmetadata** - return host metadata - **kernel.openfiles** - return the number of open file descriptors - **net.tcp.socket.count\[\]** - return the number of TCP sockets that match parameters - **net.udp.socket.count\[\]** - return the number of UDP sockets that match parameters - **vfs.dir.get\[\]** - return list of directory files as JSON - **vfs.file.get\[\]** - return information about a file as JSON - **vfs.file.owner\[\]** - return the ownership of a file - **vfs.file.permissions\[\]** - return a 4-digit string containing octal number with Unix permissions Additionally: - **vfs.file.cksum\[\]** now supports a second `mode` parameter (*crc32*, *md5*, *sha256*) - **vfs.file.size\[\]** now supports a second `mode` parameter (*bytes* or *lines*) - **vfs.fs.discovery** and **vfs.fs.get** now return an {\#FSLABEL} macro on Windows (with volume names) For more details see [agent items](/manual/config/items/itemtypes/zabbix_agent). ##### Elements nous i actualitzats S'han afegit diversos elements nous a l'agent/agent 2 de Zabbix: - **agent.hostmetadata** - retorna les metadades de l'equip - **kernel.openfiles** - retorna el nombre de descriptors de fitxers oberts - **net.tcp.socket.count\[\]** - retorna el nombre de sockets TCP que coincideixen amb el paràmetre - **net.udp.socket.count\[\]** - retorna el nombre de sockets UDP que coincideixen amb el paràmetre - **vfs.dir.get\[\]** - retorna la llista de fitxers del directori en format JSON - **vfs.file.get\[\]** - retorna informació sobre un fitxer en format JSON - **vfs.file.owner\[\]** - retorna el propietari d'un fitxer - **vfs.file.permissions\[\]** - retorna una cadena de 4 dígits que conté el nombre octal dels permisos Unix A més de: - **vfs.file.cksum\[\]** admet un segon paràmetre `mode` (*crc32*, *md5*, *sha256*) - **vfs.file.size\[\]** admet un segon paràmetre `mode` (*bytes* o *lines*) - **vfs.fs.discovery** i **vfs.fs.get** retornen la macro {\#FSLABEL} a Windows (amb etiquetes de volum) Per obtindre més informació, veieu [elements d'agent](/manual/config/items/itemtypes/zabbix_agent). #### Agent on UNIX-like systems Zabbix agent on UNIX-like systems is run on the host being monitored. #### Agent a sistemes Unix L’agent Zabbix a sistemes Unix s'executa a un equip monitorat. #### Agent on Windows systems Zabbix agent on Windows runs as a Windows service. #### Agent als sistemes Windows L'agent Zabbix sota Windows s'executa com a servei de Windows. ##### 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. ##### Funcionament de l'agent amb fitxer persistent A l'inici, l'agent Zabbix no sap res dels fitxers persistents. Només després de rebre una llista de comprovacions actives del \(proxy\) o servidor Zabbix, l'agent entén que alguns elements de registre han de fer una còpia de seguretat mitjançant fitxers persistents als directoris especificats. Mentre l'agent s'executa, els fitxers persistents s'obren per escriure (amb fopen(nom de fitxer, "w")) i es sobreescriuen amb les dades més recents. El risc de perdre dades de fitxers persistents si la rèplica del sistema de fitxers sobreescriu i es divideix al mateix temps és molt baix, no cal cap tractament especial. L'escriptura en un fitxer persistent NO és seguida d'una sincronització forçada amb el suport d'emmagatzematge \(fsync\(\) no s'anomena\). La sobreescriptura amb les dades més recents es fa després d'informar amb èxit del registre o metadades del fitxer de registre corresponent (mida del registre processat i temps de modificació) al servidor Zabbix. Això pot passar tan sovint com cada element comprova si el fitxer de registre continua canviant. No cal pas cap acció especial en aturar l'agent. #### Agent process types - `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 6.0.43, the agent log file is created with read-write permissions only for the file owner. Additionally the file is readable by the owner group. All other permissions are denied. #### Tipus de processos Agent - `​active checks`​ - processos que fan verificacions actives - `​collector`​ - processos per recollir dades - `​listener`​ - processos que escolten les verificacions passives L'arxiu de registre de l'agent es pot emprar per observar aquests tipus de processos. Des de Zabbix 6.0.43, el fitxer d'exportació es crea amb permisos de lectura i escriptura només per al propietari del fitxer. A més, el fitxer és llegible pel grup propietari. Tots els altres permisos es deneguen. ##### 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 (from Zabbix 6.0.0) 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 `web.page.*` Zabbix agent [items](/manual/config/items/itemtypes/zabbix_agent). Not supported on Windows.<br>Version 7.28.0 or higher is recommended.| |*libmodbus*|^|Only required if Modbus monitoring is used.<br>Version 3.0 or higher.| ::: noteclassic Starting from version 5.0.3, Zabbix agent will not work on AIX platforms below versions 6.1 TL07 / AIX 7.1 TL01. ::: ##### Agent |Requisits previs|Obligació|Descripció| |--|-|-------| |*libpcre/libpcre2*|Una de les biblioteques |PCRE/PCRE2 és necessària per al suport d'[expressions regular compatibles amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>El nom pot ser difereixen segons la distribució GNU/Linux, per exemple 'libpcre3' o 'libpcre1'. S'admeten PCRE v8.x i PCRE2 v10.x (de Zabbix 6.0.0).<br>Cal per al monitoratge del registre. També es requereix a Windows.| |*libpthread*|Sí|Cal per al suport de blocatge de mutex i lectura-escriptura (pot ser part de libc). No cal a Windows.| |*libresolv*|^|Cal per a la resolució DNS (pot ser part de libc). No cal a Windows.| |*libiconv*|^|Cal per a la codificació de text/conversió de format a UTF-8 en elements de registre, contingut del fitxer, expressió regular del fitxer i elements de concordança de regles (pot ser part de la libc). No cal a Windows.| |*libgnutls* o *libopenssl*|No|Cal si utilitzeu [encryption](/manual/encryption#compiling_zabbix_with_encryption_support).<br>Versions mínimes: *libgnutls* - 3.1.18, *libopenssl* - 1.0.1 <br >A Microsoft Windows, cal OpenSSL 1.1.1 o posterior.| |*libldap*|^|Cal si s'empra LDAP. No és compatible amb Windows.| |*libcurl*|^|Cal per als elements de l'agent Zabbix [`web.page.*`](/manual/config/items/itemtypes/zabbix_agent). No és compatible amb Windows.<br>Es recomana la versió 7.28.0 o superior.| |*libmodbus*|^|Només cal si s'empra el monitoratge de modbus.<br>Versió 3.0 o superior.| :::noteclassic A partir de la versió 5.0.3, l'agent Zabbix no funcionarà a les plataformes AIX anteriors a les versions 6.1 TL07 / AIX 7.1 TL01. ::: #### 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. #### Procés d'actualització de l'agent ::: noteimportant L'actualització dels agents no és pas obligatòria. Només els hauríeu d'actualitzar si cal per accedir a la nova funcionalitat. ::: El procediment d'actualització descrit en aquesta secció es pot emprar per actualitzar tant l'agent Zabbix com l'agent Zabbix 2. ##### 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). ##### Agent Els Agents Zabbix es despleguen en objectius de monitoratge per monitorar activament els recursos i aplicacions locals i enviar les dades recollides al servidor Zabbix. Des de Zabbix 4.4, hi ha dos tipus d'agents disponibles: [Zabbix Agent](/manual/concepts/agent) (lleuger, compatible amb moltes plataformes, escrit en C) i [Zabbix Agent 2](/manual/concepts/agent2) (extra-flexible, fàcilment ampliable amb complements, escrit en Go). #### Aggregate functions |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**avg** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Average value of an item within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Examples:<br>=> **avg**(/host/key,**1h**) → average value for the last hour until [now](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**1h:now-1d**) → average value for an hour from 25 hours ago to 24 hours ago from [now](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key,**\#5**) → average value of the five latest values<br>=> **avg**(/host/key,**\#5:now-1d**) → average value of the five latest values excluding the values received in the last 24 hours<br><br>Time shift is useful when there is a need to compare the current average value with the average value some time ago.| |**bucket\_percentile** (item filter,time period,percentage)|<|<| |Calculates the percentile from the buckets of a histogram.|**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)|Supported only in calculated items.<br><br>This function is an alias for `histogram_quantile(percentage/100, bucket_rate_foreach(item filter, time period, 1))`| |**count** (func\_foreach(item filter,<time period>))|<|<| |Count of values in an array returned by a foreach function.|**func\_foreach** - foreach function for which the number of returned values should be counted (with supported arguments). See [foreach functions](/manual/appendix/functions/aggregate/foreach) for details.|Supported value type: int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Example:<br>=> **count**(max\_foreach(/\*/net.if.in\[\*\],1h)) → number of net.if.in items that received data in the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>Note that 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.| |**histogram\_quantile** (quantile,bucket1,value1,bucket2,value2,...)|<|<| |Calculates the φ-quantile from the buckets of a histogram.|**quantile** - 0 ≤ φ ≤ 1<br>**bucketN, valueN** - manually entered pairs (>=2) of parameters or response of [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)|Supported only in calculated items.<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): bucket_rate_foreach<br><br>Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' of PromQL.<br><br> Returns -1 if values of the last 'Infinity' bucket (*"+inf"*) are equal to 0. <br><br>Examples:<br>=> **histogram\_quantile**(0.75,1.0,last(/host/rate\_bucket\[1.0\]),"+Inf",last(/host/rate\_bucket\[Inf\])<br>=> **histogram\_quantile**(0.5,bucket\_rate\_foreach(//item\_key,30s))| |**item\_count** (item filter)|<|<| |Count of existing items in configuration that match filter criteria.|**item filter** - criteria for item selection, allows referencing by host group, host, item key, and tags. Wildcards are supported. See [item filter](/manual/appendix/functions/aggregate/foreach#item_filter_syntax) for more details.|Supported only in calculated items.<br><br>Supported value type: int<br><br>Works as an alias for the *count(exists\_foreach(item\_filter))* function.<br><br>Example:<br>=> **item\_count**(/\*/agent.ping?\[group="Host group 1"\]) → number of hosts with the *agent.ping* item in the "Host group 1"| |**kurtosis** (/host/key,(sec\|\#num)<:time shift>)|<|<| |"Tailedness" of the probability distribution in collected values within the defined evaluation period.<br><br>See also: [Kurtosis](https://en.wikipedia.org/wiki/Kurtosis)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Example:<br>=> **kurtosis**(/host/key,**1h**) → kurtosis for the last hour until [now](/manual/config/triggers#evaluation_period)| |**mad** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Median absolute deviation in collected values within the defined evaluation period.<br><br>See also: [Median absolute deviation](https://en.wikipedia.org/wiki/Median_absolute_deviation)|See [common-parameters](#common parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Example:<br>=> **mad**(/host/key,**1h**) → median absolute deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**max** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Highest value of an item within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Example:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → calculate the difference between the maximum and minimum values within the last hour until [now](/manual/config/triggers#evaluation_period) (delta of values)| |**min** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Lowest value of an item within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Example:<br>=> **max**(/host/key,**1h**) - **min**(/host/key,**1h**) → calculate the difference between the maximum and minimum values within the last hour until [now](/manual/config/triggers#evaluation_period) (delta of values)| |**skewness** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Asymmetry of the probability distribution in collected values within the defined evaluation period.<br><br>See also: [Skewness](https://en.wikipedia.org/wiki/Skewness)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Example:<br>=> **skewness**(/host/key,**1h**) → skewness for the last hour until [now](/manual/config/triggers#evaluation_period)| |**stddevpop** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Population standard deviation in collected values within the defined evaluation period.<br><br>See also: [Standard deviation](https://en.wikipedia.org/wiki/Standard_deviation)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Example:<br>=> **stddevpop**(/host/key,**1h**) → population standard deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**stddevsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Sample standard deviation in collected values within the defined evaluation period.<br><br>See also: [Standard deviation](https://en.wikipedia.org/wiki/Standard_deviation)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>At least two data values are required for this function to work.<br><br>Example:<br>=> **stddevsamp**(/host/key,**1h**) → sample standard deviation for the last hour until [now](/manual/config/triggers#evaluation_period)| |**sum** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Sum of collected values within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): avg_foreach, count_foreach, exists_foreach, last_foreach, max_foreach, min_foreach, sum_foreach<br><br>Example:<br>=> **sum**(/host/key,**1h**) → sum of values for the last hour until [now](/manual/config/triggers#evaluation_period)| |**sumofsquares** (/host/key,(sec\|\#num)<:time shift>)|<|<| |The sum of squares in collected values within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Example:<br>=> **sumofsquares**(/host/key,**1h**) → sum of squares for the last hour until [now](/manual/config/triggers#evaluation_period)| |**varpop** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Population variance of collected values within the defined evaluation period.<br><br>See also: [Variance](https://en.wikipedia.org/wiki/Variance)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>Example:<br>=> **varpop**(/host/key,**1h**) → population variance for the last hour until [now](/manual/config/triggers#evaluation_period)| |**varsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Sample variance of collected values within the defined evaluation period.<br><br>See also: [Variance](https://en.wikipedia.org/wiki/Variance)|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): last_foreach<br><br>At least two data values are required for this function to work.<br><br>Example:<br>=> **varsamp**(/host/key,**1h**) → sample variance for the last hour until [now](/manual/config/triggers#evaluation_period)| #### Funcions d'agregat |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**avg** (/host/key,(seg\|\#num)<:time shift>)|<|<| |Valor mitjà d'un element dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Exemples:<br>=> **avg**(/host/key,**1h**) → valor mitjà de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **avg**(/host/key, **1h:now-1d**) → valor mitjà d'una hora des de fa 25 hores fins a fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)<br>=> **avg**(/ host/key,**\#5**) → valor mitjà dels cinc valors més recents<br>=> **avg**(/host/key,**\#5:now-1d**) → mitjana valor dels cinc valors més recents excloent els valors rebuts a les darreres 24 hores<br><br>El canvi de temps és útil quan cal comparar el valor mitjà actual amb el valor mitjà de temps enrere.| |**bucket\_percentile** (filtre d'elements, període de temps, percentatge)|<|<| |Calcula el percentil a partir dels dipòsits d'un histograma.|**item filter** - veieu [filtre d'elements](/manual/appendix/functions/aggregate/foreach#item_filter_syntax)<br>**time period** - veieu [ període de temps](/manual/appendix/functions/aggregate/foreach#time_period)<br>**percentage** - percentatge (0-100)|Només s'admet a elements calculats.<br><br>Aquesta funció és un àlies per a `histogram_quantile(percentage/100, bucket_rate_foreach(filtre d'elements, període de temps, 1))`| |**count** (func\_foreach(filtre d'elements,<període de temps>))|<|<| |Recompte de valors d'una matriu retornats per una funció foreach.|**func\_foreach** - funció foreach per a la qual s'ha de comptar el nombre de valors retornats (amb arguments compatibles). Consulteu [funcions foreach](/manual/appendix/functions/aggregate/foreach) per obtindre més informació.|Tipus de valor admès: int<br><br>Exemple:<br>=> **count**(max\_foreach(/ \*/net.if.in\[\*\],1h))) → nombre d'elements net.if.in que han rebut dades durant la darrera hora hora fins a [ara](/manual/config/triggers#evaluation_period)<br ><br>Tingueu en compte que l'ús de **count()** amb una funció foreach relacionada amb l'historial (max\_foreach, avg\_foreach, etc.) pot comportar implicacions de rendiment, mentre que emprar **exists\_foreach()**, que només funciona amb dades de configuració, no tindrà aquest efecte.| |**histogram\_quantile** (quantil, cub1, valor1, cub2, valor2,...)|<|<| |Calcula el φ-quantil a partir dels dipòsits d'un histograma.|**quantile** - 0 ≤ φ ≤ 1<br>**bucketN, valueN** - parells introduïts manualment (>=2) de paràmetres o resposta de [bucket\_rate\_foreach](/manual/appendix/functions/aggregate/foreach)|Només s'admet a elements calculats.<br><br>Correspon funcionalment a '[histogram\_quantile](https://prometheus.io/docs /prometheus/latest/querying/functions/#histogram_quantile)' de PromQL.<br><br> Retorna -1 si els valors del darrer dipòsit "Infinity" (*"+inf"*) són iguals a 0. <br> <br>Exemple:<br>=> **histograma\_quantil**(0.75,1.0,last(/host/rate\_bucket\[1.0\]),"+Inf", last(/host/rate\_bucket \[Inf\])<br>=> **histogram\_quantile**(0,5,bucket\_rate\_foreach(//item\_key,30s))| |**item\_count** (filtre d'elements)|<|<| |Recompte d'elements existents a la configuració que coincideixen amb els criteris de filtre.|**item filter**: criteris per a la selecció d'elements, permet fer referència per grup d'equips, equip, clau d'element i etiquetes. S'admeten els comodins. Consulteu [filtre d'elements](/manual/appendix/functions/aggregate/foreach#item_filter_syntax) per obtindre més detalls.|Només s'admet a elements calculats.<br><br>Tipus de valor admès: int<br><br>Funciona com a àlies per a la funció *count(exists\_foreach(item\_filter))*.<br><br>Exemple:<br>=> **item\_count**(/\*/agent.ping?\[group ="Grup d'equips 1"\]) → nombre d'equips amb l'element *agent.ping* al "Grup d'equips 1"| |**kurtosis** (/host/key,(sec\|\#num)<:time shift>)|<|<| |"Curtosi" de la distribució de probabilitat en valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Curtosi](https://ca.wikipedia.org/wiki/Curtosi|Veieu [paràmetres comuns] (#common-parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **kurtosis**(/host/key,**1h**) → curtosi de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**mad** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Desviació absoluta mitjana dels valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Desviació absoluta mitjana](https://en.wikipedia.org/wiki/Median_absolute_deviation)|Veieu els [paràmetres comuns](#paràmetres comuns).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **mad**(/host/key,**1h**) → desviació absoluta mitjana de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**max** (/host/key,(seg\|\#num)<:time shift>)|<|<| |Valor més alt d'un element dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **max* *(/host/key,**1h**) - **min**(/host/key,**1h**) → calcula la diferència entre els valors màxim i mínim durant la darrera hora fins a [ara](/manual/config/triggers#evaluation_period) (delta de valors)| |**min** (/host/key,(seg\|\#num)<:canvi de temps>)|<|<| |El valor més baix d'un element dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **max* *(/host/key,**1h**) - **min**(/host/key,**1h**) → calcula la diferència entre els valors màxim i mínim durant la darrera hora fins a [ara](/manual/config/triggers#evaluation_period) (delta de valors)| |**skewness** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Asimetria de la distribució de probabilitat en valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Skewness](https://en.wikipedia.org/wiki/Skewness)|Veieu [paràmetres comuns](# common-parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **skewness**(/host/key,**1h**) → skewness durant la darrera hora fins [ara](/manual/config/triggers#evaluation_period)| |**stddevpop** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Desviació tipus de la població en els valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Desviació tipus](https://ca.wikipedia.org/wiki/Desviaci%C3%B3_tipus)|Veieu [paràmetres comuns](#common -parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **stddevpop**(/host/key,**1h**) → desviació tipus de població de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**stddevsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Mostra de desviació tipus dels valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Desviació tipus](https://ca.wikipedia.org/wiki/Desviaci%C3%B3_tipus)|Veieu [paràmetres comuns](#common -parameters).|Tipus de valors admesos: float, int<br><br>Per que aquesta funció funcioni, calen almenys dos valors de dades.<br><br>Exemple:<br>=> **stddevsamp**( /host/key,**1h**) → mostra la desviació tipus de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**sum** (/host/key,(seg\|\#num)<:time shift>)|<|<| |Suma dels valors recollits dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **sum** (/host/key,**1h**) → suma de valors de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**sumofsquares** (/host/key,(sec\|\#num)<:time shift>)|<|<| |La suma de quadrats dels valors recollits dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> ** sumofsquares**(/host/key,**1h**) → suma de quadrats de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**varpop** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Variància de la població dels valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Variància](https://ca.wikipedia.org/wiki/Vari%C3%A0ncia)|Veieu [paràmetres comuns](#common-parameters ).|Tipus de valors admesos: float, int<br><br>Exemple:<br>=> **varpop**(/host/key,**1h**) → variació de població durant la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| |**varsamp** (/host/key,(sec\|\#num)<:time shift>)|<|<| |Mostra de la variància dels valors recollits dins del període d'avaluació definit.<br><br>Veieu també: [Variància](https://ca.wikipedia.org/wiki/Vari%C3%A0ncia)|Veieu [common-parameters](#common-parameters) ).|Tipus de valors admesos: float, int<br><br>Per que aquesta funció funcioni, calen almenys dos valors de dades.<br><br>Exemple:<br>=> **varsamp**(/host /key,**1h**) → variació de mostra de la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)| ### Aggregate functions The **count_foreach** function now returns '0' for a matching item in the array, if no data are present for the item or the data do not match the filter. Previously such items would be ignored (no data added to the aggregation). ### Funcions d'afegit La funció **count_foreach** ara retorna '0' per a un element que coincideixi a la taula, si no hi ha informació present per l'element o la informació no coincideix amb el filtre. Els elements previs s'ignoraran (no s'afegirà pas informació). ### Aggregate functions The **count_foreach** function now returns '0' for a matching item in the array, if no data are present for the item or the data do not match the filter. Previously such items would be ignored (no data added to the aggregation). ### Funcions d'afegit La funció **count_foreach** ara retorna '0' per a un element que coincideixi a la taula, si no hi ha informació present per l'element o la informació no coincideix amb el filtre. Els elements previs s'ignoraran (no s'afegirà pas informació). #### Aggregate functions The **last_foreach** function is now also supported in the following [aggregate functions](/manual/appendix/functions/aggregate): kurtosis, mad, skewness, stddevpop, stddevsamp, sumofsquares, varpop, and varsamp. #### Funcions agregades La funció **last_foreach** ara també s'admet a les [funcions agregades](/manual/appendix/functions/aggregate): kurtosis, mad, skewness, stddevpop, stddevsamp, sumofsquares, varpop i varsamp. ##### AIX, HP-UX If `watch` command is not available, one can try while [ 1 ]; do ps -fu zabbix; sleep 1; clear; done ##### AIX, HP-UX Si la comanda `watch` no és disponible, podeu provar while [ 1 ]; do ps -fu zabbix; sleep 1; clear; done #### 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 En aquesta taula hi trobareu els valors admesos per el paràmetre 'memtype' sota AIX. |Valor admès|Descripció|Font a l'estructura procentry64|Intents per ésser compatible| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Mida de la memòria virtual|pi\_size| | |pmem|Percentatge de memòria real|pi\_prm|ps -o pmem| |rss|Mida del conjunt de residents|pi\_trss + pi\_drss|ps -o rssize| |size|Mida dels processos (codi + dades)|pi\_dvm|"ps gvw" SIZE column| |dsize|Mida de dades|pi\_dsize|<| |tsize|Mida del text (codi)|pi\_tsize|"ps gvw" Colonne TSIZ| |sdsize|Mida de les dades de la biblioteca compartida|pi\_sdsize|<| |drss|Mida del conjunt de residents de dades|pi\_drss| | |trss|Mida del conjunt de residents de text|pi\_trss| | #### alert Changes:<br> [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. #### alerta Canvis:<br> [ZBX-26023](https://support.zabbix.com/browse/ZBX-26023) `alert.get`: els usuaris de tipus *Administrador* i *Usuari* ara poden recuperar dades d'alerta de tipus "missatge" (0) sobre els usuaris del seu grup d'usuaris. #### alert Changes:<br> [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. #### alerta Canvis:<br> [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `alert.get`: el paràmetre `selectUsers` ara retorna dades basades en les restriccions afegides al mètode `user.get`.\ [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `alert.get`: els usuaris de tipus *Administrador* i *Usuari* ara poden recuperar dades d'alerta de tipus "missatge" (0) només sobre el seu propi usuari. #### 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. #### Fallida del procés Alerter amb RHEL 7 S'han trobat bloquejos de les instàncies del procés d'alerta del servidor Zabbix a RHEL 7. Consulteu [ZBX-10461](https://support.zabbix.com/browse/ZBX-10461) per obtindre més informació. # alert.get # alert.get **Alerting on service status change** It is now possible to receive automated alerts about service status changes, similar to the alerts about trigger status changes. A new [service action](/manual/it_services/service_actions) functionality has been added, similar to other actions in Zabbix. Service actions may include steps for problem, recovery, and update operations related to services. It is possible to configure two types of actions: sending a message to the specified recipients and executing a remote command on Zabbix server. Similarly to trigger actions, service actions support problem [escalation](/manual/config/notifications/action/escalations) scenarios. New message templates *Service*, *Service recovery*, and *Service update* have been added to [media types](/manual/config/notifications/media#common_parameters) and should be defined to enable correct sending of notifications for service actions. **Avisos de canvi d'estat del servei** Ara és possible rebre alertes automatitzades sobre canvis d'estat del servei, de manera similar a les alertes sobre canvis d'estat de triggers. S'ha afegit una nova característica [acció de servei](/manual/it_services/service_actions), similar a altres accions a Zabbix. Les accions de servei poden incloure passes per a operacions de problemes relacionats amb el servei, recuperació i actualització. És possible configurar dos tipus d'accions: enviar un missatge als destinataris especificats i executar una comanda remota al servidor Zabbix. De manera semblant a les accions de trigger, les accions de servei admeten escenaris de problemes d'[escalada](/manual/config/notifications/action/escalations). Les noves plantilles de missatge *Servei*, *Recuperació de servei* i *Actualització de* s'han afegit a [tipus de suport](/manual/config/notifications/media#common_parameters) i s'han de definir per permetre l'enviament correcte de notificacions d'accions de servei. ### Alert ::: noteclassic Alerts are created by the 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|string|ID of the alert.| |actionid|string|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|string|ID of the event that triggered the action.| |mediatypeid|string|ID of the media type that was used to send the message.| |message|text|Message text. Used for message alerts.| |retries|integer|Number of times Zabbix tried to send the message.| |sendto|string|Address, user name or other identifier of the recipient. Used for message alerts.| |status|integer|Status indicating whether the action operation has been executed successfully.<br><br>Possible values for message alerts:<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 for command alerts:<br>0 - command not run.<br>1 - command run.<br>2 - tried to run the command on the Zabbix agent but it was unavailable.| |subject|string|Message subject. Used for message alerts.| |userid|string|ID of the user that the message was sent to.| |p\_eventid|string|ID of problem event, which generated the alert.| |acknowledgeid|string|ID of acknowledgment, which generated the alert.| ### Alerta ::: noteclassic Les alertes es creen pel servidor de Zabbix i no es poden modificar per mitjà de l'API. ::: L'objecte alerta conté informació sobre en quines condicions certes accions s'han executat correctament. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |alertid|string|ID de l'alerta.| |actionid|string|ID de l'acció que ja generat l'alerta.| |alerttype|integer|Tipus d'alerta.<br><br>Valors possibles:<br>0 - missatge;<br>1 - comanda remota.| |clock|timestamp|Moment en que es va generar l'alerta.| |error|string|text d'error si hi ha problemes enviant un missatge o executant una comanda.| |esc\_step|integer|Passa d'escalada de l'acció on es va generar l'alerta.| |eventid|string|ID de l'esdeveniment que ha disparat el trigger de l'acció.| |mediatypeid|string|ID del tipus de mitjà que s'ha emprat per enviar el missatge.| |message|text|Missatge de text. Emprat per missatges d'alerta.| |retries|integer|Nombre de vegades que el Zabbix ha provat d'enviar el missatge.| |sendto|string|Adreça, nom d'usuari o algun altre identificador del destinatari. Emprat per els missatges d'alerta.| |status|integer|Estat que indica si l'operació d'acció s'ha executat correctament..<br><br>Els valors possibles dels missatges d'alerta són:<br>0 - missatge no enviat.<br>1 - missatge enviat.<br>2 - ha fallat després de provar-ho diversos cops.<br>3 - la nova alerta encara no ha estat processada pel gestor d'alertes.<br><br>Valors possibles per les comandes d'alertes:<br>0 - comanda no executada.<br>1 - comanda executada.<br>2 - s'ha provat d'executar la comanda a l'agent de Zabbix, però aquest no era pas disponible.| |subject|string|Assumpte del missatge. Emprat per les alertes de missatges..| |userid|string|ID de l'usuari on s'ha enviat el missatge.| |p\_eventid|string|ID de l'esdeveniment del problema, qui ha generat l'alerta.| |acknowledgeid|string|ID de reconeixement, qui ha generat l'alerta.| # Alert object The following objects are directly related to the `alert` API. # Objecte alerta Els següents objectes són relacionats amb l'API `alert`. # 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 # Alertes Aquesta classe és dissenyada per treballar amb alertes. Referències d'objecte: - [Alert](/manual/api/reference/alert/object#alert) Mètodes disponibles: - [alert.get](/manual/api/reference/alert/get) - recuperar alertes ##### Aligning time zones for proxies and agent 2 Note that Zabbix proxies and agent 2 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 2 active items, it is recommended to set the time zone of the respective proxies or agent 2 the same as Zabbix server, otherwise the [queue](/manual/config/items/queue) may report item delays incorrectly. Custom intervals for active checks are supported by Zabbix agent 2 only. Ensure you are using Zabbix agent 2 if you intend to configure custom intervals for active checks. The time zone for Zabbix proxy or agent 2 can be set using the environment variable `TZ` in the `systemd` unit file: [Service] ... Environment="TZ=Europe/Amsterdam" ##### Alineació de zones horàries per als proxys i l'agent 2 Tingueu en compte que els proxys de Zabbix i l'agent 2 empren les seves zones horàries locals quan processen els intervals de programació. Per aquest motiu, quan s'apliquen intervals de programació als elements monitorats pel proxy de Zabbix o els elements actius de l'agent 2, es recomana establir la zona horària dels proxys respectius o l'agent 2 igual que el servidor Zabbix, en cas contrari, la [cua](/manual/config/items/queue) pot informar erròniament d'endarreriments. Els intervals personalitzats per a comprovacions actives només són compatibles amb l'agent 2 de Zabbix. Assegureu-vos que feu servir l'agent Zabbix 2 si teniu intenció de configurar intervals personalitzats per a comprovacions actives. La zona horària per al proxy Zabbix o l'agent 2 es pot establir mitjançant la variable d'entorn `TZ` al fitxer `systemd`: [Service] ... Environment="TZ=Europe/Amsterdam" All of these parameters can be changed in *Administration* → *General* → *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`. ::: Tots aquests paràmetres es poden modificar des d'*Administració* → *General* → *Neteja* després de la instal·lació. ::: notetip Podeu executar la utilitat timescaledb-tune, proveïda per TimescaleDB, per optimitzar els paràmetres de configuració de PostgreSQL a l'arxiu `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. ``` #### Ordre de regles de permís/denegació Podeu especificar un nombre il·limitat de regles `AllowKey` o `DenyKey`, tot i que el seu ordre és important. - Les regles s'avaluen una per una, de dalt a baix. - Quan una clau d'element coincideix amb una regla, es permet o es denega, i l'avaluació de la regla s'atura. Per exemple, en avaluar `vfs.file.contents[/etc/passwd]`, les regles es processen de la manera següent: ```default AllowKey=vfs.file.contents[/tmp/app.log] # El patró de la clau d'element no coincideix, l'agent procedeix a la regla següent. AllowKey=vfs.file.contents[/etc/passwd] # El patró de la clau d'element coincideix; l'agent permet la comprovació de l'element i atura l'avaluació de la regla. DenyKey=vfs.file.*[*] # L'agent ignora la regla, ja que l'avaluació s'ha aturat. ``` L'ordre de regles següent denegarà la comprovació d'elements: ```default DenyKey=vfs.file.*[*] # El patró de clau d'element coincideix; l'agent denega la comprovació d'elements i atura l'avaluació de la regla. AllowKey=vfs.file.contents[/etc/passwd] # L'agent ignora la regla, ja que l'avaluació s'ha aturat. AllowKey=vfs.file.contents[/tmp/app.log] # L'agent ignora la regla, ja que l'avaluació s'ha aturat. ``` ##### Allowing scripts Allow Zabbix agent to execute scripts on hosts via all available methods: - [Global scripts](/manual/web_interface/frontend_sections/administration/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-data) 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] ``` ##### Permetre scripts Permetre que l'agent Zabbix executi scripts a equips mitjançant tots els mètodes disponibles: - [Scripts globals](/manual/web_interface/frontend_sections/administration/scripts) que es poden executar al frontend o mitjançant l'API (aquest mètode sempre utilitza la clau `system.run[myscript.sh]`) - Comandes remotes des de [action operations](/manual/config/notifications/action/operation#operation-details) (aquest mètode sempre utilitza la clau `system.run[myscript.sh,nowait]`) - [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) Elements de l'agent Zabbix amb l'script, per exemple: - `system.run[myscript.sh]` - `system.run[myscript.sh,wait]` - `system.run[myscript.sh,nowait]` ```default AllowKey=system.run[myscript.sh,*] ``` Per controlar el paràmetre `wait`/`nowait`, heu de definir una regla diferent. Per exemple, només podeu permetre els elements `system.run[myscript.sh,wait]`, excloent així altres mètodes: ```default AllowKey=system.run[myscript.sh,wait] ``` ##### Allowing specific checks and commands Allow only two [`vfs.file`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data) item checks and two [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) 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. ::: ##### Permetre comprovacions i comandes específiques Permeteu només dues comprovacions d'elements [`vfs.file`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data) i dues ordres [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data): ```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 Establir `DenyKey=system.run[*]` no és necessari, perquè totes les altres ordres `system.run` es deneguen per defecte. ::: ##### Allow specific check, deny others - Whitelist specific checks with AllowKey parameters, deny others with `DenyKey=*` For example: # Allow reading logs: AllowKey=vfs.file.*[/var/log/*] # Allow localtime checks AllowKey=system.localtime[*] # Deny all other keys DenyKey=* ##### Permetre una verificació concreta, i refusar totes les altres - Afegir a la llista blanca de comprovacions específiques amb paràmetres AllowKey, denegar altres amb `DenyKey=*` Per exemple: # Permetre llegir registres: AllowKey=vfs.file.*[/var/log/*] # Permetre comprovacions de l'hora local AllowKey=system.localtime[*] # Denegar totes les altres claus DenyKey=* ### AND/OR evaluation in LLD filters The evaluation of AND/OR expressions in the low-level discovery filters/overrides may fail in this version. Fixed in Zabbix 6.0.12. ### Evaluació I/O als filtres LLD L'avaluació de les expressions I/O als filtres/substitucions de descoberta de baix nivell pot fallar en aquesta versió. S'ha corregit a Zabbix 6.0.12. #### Anomaly detection Zabbix 5.2 introduced new trend functions useful for baseline monitoring. However, they still require defining relative thresholds (e.g. check that web traffic in September, 2021 is less than 2x higher compared to September, 2020). There are use cases when such thresholds are hard to define. For instance, the web traffic of a new but highly popular web site can organically grow many times over a year but the growth rate is unknown. Yet, a sudden traffic spike due to DDOS attack must generate an alert regardless of organic traffic growth. Anomaly detection algorithms do exactly this - find data that doesn't look normal (outliers) in a context of other values. New [trend function](/manual/appendix/functions/trends) **trendstl()** has been added which uses 'decomposition' method to calculate the anomaly rate. It splits a single time series sequence into three other sequences: - trend sequence that only contains big changes in the original data (e.g. website traffic shows growth) - season sequence that only contains seasonal changes (e.g. less website traffic in summer, more in autumn) - remainder sequence that only contains residual values that can not be interpreted as parts of trend or season  Anomaly detection works with remainder sequence and checks if there are values that are too far from the majority of remainder values. "Far" means that the absolute value from the remainder sequence is N times greater than the standard or mean deviation. ##### Detecció d'anomalies Zabbix 5.2 va introduir noves funcions de tendència útils per al seguiment de la línia de base. Tanmateix, encara requereixen definir llindars relatius (p. ex., comproveu que el trànsit web al setembre de 2021 sigui menys de dues vegades superior en comparació amb el de setembre de 2020). Hi ha casos d'ús en què aquests llindars són difícils de definir. Per exemple, el trànsit web d'un lloc web nou però molt popular pot créixer orgànicament moltes vegades durant un any, però la taxa de creixement es desconeix. Tanmateix, un augment sobtat de trànsit a causa d'un atac DDOS ha de generar una alerta independentment del creixement orgànic del trànsit. Els algorismes de detecció d'anomalies fan exactament això: trobar dades que no semblen normals (outliers) en un context d'altres valors. S'ha afegit una nova [funció de tendència](/manual/appendix/functions/trends) **trendstl()** que empra el mètode de "descomposició" per calcular la taxa d'anomalia. Divideix una única seqüència de sèrie temporal en altres tres seqüències: - seqüència de tendències que només conté grans canvis de les dades originals (p. ex., el trànsit del lloc web mostra un creixement) - seqüència de temporada que només conté canvis estacionals (per exemple, menys trànsit del lloc web a l'estiu, més a la tardor) - seqüència de residus que només conté valors residuals que no es poden interpretar com a parts de tendència o temporada  La detecció d'anomalies funciona amb la seqüència de residus i comprova si hi ha valors que són massa allunyats de la majoria dels valors restants. "Lluny" vol dir que el valor absolut de la seqüència restant és N vegades més gran que la desviació estàndard o mitjana. ##### 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: (?<=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). ::: ##### Un altre exemple amb un modificador d'expressió regular en línia Ús de l'expressió regular següent, inclosos diversos modificadors en línia per fer coincidir caràcters després d'una línia específica: (?<=match (?i)tot(?-i) després d'aquesta línia\n)(?sx).*# afegim el modificador s per permetre . per fer coincidir els caràcters de nova línia  Tipus d'expressió triada: "El resultat és CERT". Els caràcters després d'una línia específica coincideixen. ::: noteimportant El modificador **g** no es pot especificar en línia. La llista de modificadors disponibles es pot trobar a [pcresyntax man page](https://www.pcre.org/original/doc/html/pcresyntax.html#SEC16). Per obtindre més informació sobre la sintaxi de PCRE, consulteu la [documentació HTML PCRE](https://www.pcre.org/original/doc/html/pcrepattern.html). ::: ##### API changes See the list of [API changes](/manual/api/changes_5.4_-_6.0) in Zabbix 6.0.0. ##### Modificacions de l'API Veieu el llistat de [modificacions d'API](/manual/api/changes_5.4_-_6.0) a Zabbix 6.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) ### Informació de l'API Recuperar la versió de l'API Zabbix per tal que l'aplicació pugui emprar funcionalitats específiques a la versió. [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) - retrieving the version of the Zabbix API # Informació de l'API Aquesta classe fou dissenyada per recuperar metainformació sobre l'API. Mètodes disponibles: - [apiinfo.version](/manual/api/reference/apiinfo/version) - recuperant la versió de l'API de Zabbix # apiinfo.version # apiinfo.version #### API login A large number of open user sessions can be created when using custom scripts with the `user.login` [method](/manual/api/reference/user/login) without a following `user.logout`. #### Connexió a l'API Es poden crear un gran nombre de sessions d'usuari obertes quan s'empren scripts personalitzats amb el [mètode](/manual/api/reference/user/login) `user.login` sense `user.logout` després. #### API tokens API tokens section allows to view tokens assigned to the user, edit token details and [create new tokens](/manual/web_interface/frontend_sections/administration/general#api_tokens). This section is only available to a user if *Manage API tokens* action is allowed in the [user role](/manual/web_interface/frontend_sections/administration/user_roles) settings. {width="600"} You may 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 may also mass enable/disable tokens by selecting them in the list and then clicking on the Enable/Disable buttons below the list. ::: noteimportant Users cannot view *Auth token* value of the tokens assigned to them in Zabbix. *Auth token* value is displayed only once - immediately after creating a token. If it has been lost, the token has to be regenerated. ::: #### Tokens d'API La secció de tokens de l'API s'empra per veure els tokens assignats a l'usuari, editar els detalls dels tokens i [crear nous tokens](/manual/web_interface/frontend_sections/administration/general#api_tokens). Aquesta secció només és disponible per a un usuari si l'acció *Gestiona els tokens de l'API* és permesa a la configuració de [rol d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). {width="600"} Podeu filtrar els tokens de l'API per nom, data de caducitat o estat (activat/desactivat). Feu clic a l'estat del token a la llista per activar/desactivar ràpidament un token. També podeu activar/desactivar fitxes massives triant-les de la llista i fent clic als botons Habilita/Desactiva a sota de la llista. ::: noteimportant Els usuaris no poden veure el valor del *Token d'autenticació* dels tokens assignats a Zabbix. El valor del *Token d'autenticació* només es mostra una vegada, immediatament després de crear el token. Si es perd, la fitxa s'ha de regenerar. ::: #### API Tokens Manage authorization tokens. [Token API](/manual/api/reference/token) #### Tokens d'API Gestionar els tokens d'autenticació. [API Token](/manual/api/reference/token) #### API tokens This section allows to create and manage API tokens. {width="600"} You may filter API tokens by name, users to whom the tokens are assigned, expiry date, users that created tokens, or status (enabled/disabled). Click on the token status in the list to quickly enable/disable a token. You may also mass enable/disable tokens by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list. To create a new token, press *Create API token* button at the top right corner, then fill out the required fields in the token configuration screen:  |Parameter|Description| |--|--------| |Name|Token's visible name.| |User|User the token should be assigned to. To quickly select a user, start typing the username, first or last name, then select the required user from the auto-complete list. Alternatively, you can press the Select button and select a user from the full user list. A token can be assigned only to one user.| |Description|Optional token description.| |Set expiration date and time|Unmark this checkbox if a token should not have an expiry date.| |Expiry date|Click on the calendar icon to select token expiry date or enter the date manually in a format YYYY-MM-DD hh:mm:ss| |Enabled|Unmark this checkbox if you need to create a token in a disabled state.| Press Add to create a token. On the next screen, copy and save in a safe place *Auth token* value **before closing the page**, then press Close. The token will appear in the list. ::: notewarning *Auth token* value cannot be viewed again later. It is only available immediately after creating a token. If you lose a saved token you will have to regenerate it and doing so will create a new authorization string. ::: Click on the token name to edit the name, description, expiry date settings, or token status. Note that it is not possible to change to which user the token is assigned. Press *Update* button to save changes. If a token has been lost or exposed, you may press *Regenerate* button to generate new token value. A confirmation dialog box will appear, asking you to confirm this operation since after proceeding the previously generated token will become invalid. Users without access to the *Administration* menu section can see and modify details of tokens assigned to them in the *User profile → API tokens* [section](/manual/web_interface/user_profile#api_tokens) only if *Manage API tokens* is allowed in their [user role](/manual/web_interface/frontend_sections/administration/user_roles) permissions. #### Tokens de l'API Aquesta secció us permet crear i gestionar tokens d'API. {width="600"} Podeu filtrar els tokens de l'API pel nom, els tokens dels usuaris als quals s'assignen, la data de caducitat, els usuaris que han creat els tokens o l'estat (activat/desactivat). Feu clic a l'estat del token a la llista per activar/desactivar ràpidament un token. També podeu activar/desactivar tokens massivament triant-los de la llista i fent clic als botons *Activar/Desactivar* a sota de la llista. Per crear un token nou, premeu el botó *Crea un token d'API* a l'extrem superior dret i, a continuació, ompliu els camps obligatoris a la pantalla de configuració del token:  |Paràmetre|Descripció| |--|---------| |Nom|Nom visible del token.| |Usuari|Usuari a qui s'ha d'assignar el token. Per triar ràpidament un usuari, comenceu a escriure el nom d'usuari, el nom o el cognom i, a continuació, trieu l'usuari requerit a la llista d'emplenament automàtic. També podeu prémer el botó Triar i triar un usuari de la llista completa d'usuaris. Cada token només es pot assignar a un usuari.| |Descripció|Descripció opcional del token.| |Definir una data i una hora de caducitat|Desmarqueu aquesta casella si el token no ha de tindre data de caducitat.| |Data de caducitat|Feu clic a la icona del calendari per triar la data de caducitat del token o introduïu la data manualment en format AAAA-MM-DD hh:mm:ss| |Activat|Desmarqueu aquesta casella si heu de crear un token en estat desactivat.| Premeu Afegir per crear el token. A la pantalla següent, copieu i deseu en un lloc segur el valor del *Token d'autenticació* **abans de tancar la pàgina** i, tot seguit, premeu Tancar. El token apareixerà a la llista. ::: notewarning El valor del *Token d'autenticació* no es pot veure més tard. Només serà disponible just després de crear el token. Si perdeu un token desat, haureu de regenerar-lo i això crearà una nova cadena d'autorització. ::: Feu clic al nom del token per editar el nom, la descripció, la configuració de la data de caducitat o l'estat del token. Tingueu en compte que no és possible canviar l'usuari a qui s'ha assignat el token. Premeu el botó *Actualitzar* per desar els canvis. Si un token s'ha perdut o s'ha exposat, podeu prémer el botó *Regenerar* per generar un valor de token nou. Apareixerà un quadre de diàleg de confirmació que us demanarà que confirmeu aquesta operació perquè després de continuar, el token generat anteriorment no serà vàlid. Els usuaris sense accés a la secció del menú *Administració* poden veure i editar els detalls dels tokens assignats a la [secció](/manual/web_interface/user_profile#api_tokens) *Perfil d'usuari → Tokens API* només si *Gestionar tokens API * és permès als permisos del [rol d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ### 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're working with. This can be useful for adjusting your application to use version-specific features. We guarantee feature backward compatibility inside of a major version. When making backward incompatible changes between major releases, we usually leave the old features as deprecated in the next release, and only remove them in the release after that. Occasionally, we 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 of the changes made to the API in the [API changelog](/manual/api/changes_5.4_-_6.0). ::: ### Versions de l'API Per simplificar la gestió de versions de l'API, des de la versió de Zabbix 2.0.4 l'API té la mateixa versió que Zabbix. Podeu emprar el mètode [apiinfo.version](/manual/api/reference/apiinfo/version) per esbrinar la versió de l'API amb la qual treballeu. Això pot ésser útil per refinar la vostra aplicació per emprar funcions específiques de la versió. Garantim la compatibilitat enrere de les funcions dins d'una versió important. Quan fem canvis incompatibles entre versions principals, normalment deixem les funcions antigues com a obsoletes a la versió següent i després les suprimim una segona versió més enllà. De vegades és possible que traiem la funcionalitat entre les versions principals sense proporcionar compatibilitat amb versions anteriors. És important que mai confieu en funcions obsoletes i migreu cap a noves tan bon punt us sigui possible. ::: notetip Podeu fer un seguiment de tots els canvis de l'API al [registre de canvis de l'API](/manual/api/changes_5.4_-_6.0). ::: # Appendix 1. Reference commentary # Apèndix 1. Comentari de referència # Appendix 2. Changes from 5.4 to 6.0 # Apèndix 2. Canvis de 5.4 a 6.0 #### Architecture Zabbix consists of several major software components. Their responsibilities are outlined below. #### Arquitectura Zabbix es composa de molts components majors de programari. Les seves responsabilitats són descrites aquí. #### 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 #### Escenari real En aquest exemple, ens cal configurar la descoberta de xarxa per a la xarxa local amb un rang d'adreces IP: 192.168.1.1-192.168.1.254. Al nostre escenari, volem: - descobrir els equips on s'executa l'agent Zabbix - llançar la descoberta cada 10 minuts - afegir l'equip per veure si el temps d'activitat de l'equip és superior a 1 hora - esborrar els equips si el temps d'inactivitat de l'equip és superior a 24 hores - afegir equips Linux al grup "Servidors Linux". - afegir equips Windows al grup "Servidors Windows". - emprar *Plantilla OS Linux* per als equips Linux - emprar *Plantilla OS Windows* per als equips de Windows ##### AS/400 IBM AS/400 platform can be monitored using SNMP. More information is available at <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>. ##### AS/400 La plataforma IBM AS/400 es pot monitorar via SNMP. Trobareu més informació a <http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/sg244504.html?Open>. #### Assigning different hosts Replace the hosts currently assigned to maintenance with two different ones. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.update", "params": { "maintenanceid": "3", "hosts": [ {"hostid": "10085"}, {"hostid": "10084"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Assignar diferents equips Reemplaçar els equips actualment afectats pel manteniment amb dos equips diferents. Petició: ```json { "jsonrpc": "2.0", "method": "maintenance.update", "params": { "maintenanceid": "3", "hosts": [ {"hostid": "10085"}, {"hostid": "10084"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Attempting to use Zabbix sender compiled with TLS support to send data to Zabbix server/proxy compiled without TLS #### Provant d'emprar el remitent Zabbix compilat amb suport TLS per enviar dades al servidor/proxy Zabbix compilat sense 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] ##### Atributs que retornen dades compostes Es complica més quan el vostre atribut retorna dades compostes. Per exemple: el nom del vostre atribut és "poma" i retorna un hash que representa els seus paràmetres, com ara "pes", "color", etc. La teva clau podria assemblar-se a: jmx[com.example:Type=Hello,apple.weight] Així és com es separen un nom d'atribut i una clau hash, emprant el símbol de punt. De la mateixa manera, si un atribut retorna dades compostes imbricades, les parts es separen per un punt: 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" } ] ``` ##### Atributs que retornen informació tabulada Els atributs de dades tabulars consisteixen en un o més atributs compostos. Si aquest atribut s'especifica al paràmetre de nom d'atribut, aquest valor d'element retornarà l'estructura completa de l'atribut en format JSON. Els valors dels elements individuals dins de l'atribut de dades tabulars es poden recuperar mitjançant el preprocessament. Exemple d'atribut de dades tabulars: jmx[com.example:type=Hello,foodinfo] Valor de l'element: ``` {.javascript} [ { "a": "apple", "b": "banana", "c": "cherry" }, { "a": "potato", "b": "lettuce", "c": "onion" } ] ``` #### Audit log ### Registre d'auditoria #### auditlog Changes:<br> [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of property `note`.<br> [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of `resourcetype` values *(2 - Configuration of Zabbix, 7 - Graph element)*.<br> [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) dropped support of `action` values *(5 - Enable, 6 - Disable)*.<br> [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) dropped support of `action` value *(3 - Login)*.<br> [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: dropped support of parameter `selectDetails`. #### Registre d'auditoria Canvis:<br> [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) discontinuat el suport de la propietat `nota`.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) discontinuat el suport de la propietat `resourcetype`, valors *(2 - Configuració de Zabbix, 7 - Element gràfic)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) discontinuat el suport de la propietat `action`, valors *(5 - Activar, 6 - Desactivar)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) discontinuat el suport de la propietat `action`, valors *(3 - Login)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) `auditlog.get`: discontinuat el suport del paràmetre `selectDetails`. #### auditlog Changes:<br> [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new `resourcetype` *(48 - SLA)*.<br> [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) added new `resourcetype` *(47 - High availability node)*.<br> [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) added support of `action` values *(8 - Login, 9 - Failed login, 10 - History clear)*.<br> [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) added support of properties: `username`, `recordsetid`, `details`. #### auditlog Canvis:<br> [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) afegit un nou `resourcetype` *(48 - SLA)*.\ [ZBXNEXT-6923](https://support.zabbix.com/browse/ZBXNEXT-6923) afegit un nou `resourcetype` *(47 - High availability node)*.\ [ZBXNEXT-6718](https://support.zabbix.com/browse/ZBXNEXT-6718) afegit el suport dels valors d'`action` *(8 - Login, 9 - Failed login, 10 - History clear)*.\ [ZBXNEXT-6715](https://support.zabbix.com/browse/ZBXNEXT-6715) afegit suport de les porpietats: `username`, `recordsetid`, `details`. ### Audit log filter Multiple actions now can be selected in the audit log filter in *Reports* -> *[Audit](/manual/web_interface/frontend_sections/reports/audit)*: {width="600"} This is useful to see all related actions (for example, successful and failed logins into the frontend) in the audit list. ### Filtre de registre d'auditoria Ara es poden triar diverses accions al filtre de registre d'auditoria a *Informes* -> *[Auditoria](/manual/web_interface/frontend_sections/reports/audit)*: {width="600"} Això és útil per veure totes les accions relacionades (per exemple, inicis de sessió correctes i fallits a la interfície) a la llista d'auditoria. # auditlog.get # auditlog.get #### Audit log In order to implement the changes in [audit log functionality](#audit-log), the previously existing database structure had to be reworked. During the upgrade `auditlog` and `auditlog_details` DB tables will be replaced by the new table `auditlog` with a different format. **Existing audit log records will be deleted.** ### Registre d'auditoria Per tal d'implementar els canvis a la [funcionalitat del registre d'auditoria](#audit-log), s'havia de reelaborar l'estructura de la base de dades existent. Durant l'actualització, les taules `auditlog` i `auditlog_details` de la base de dades seran substituïdes per la nova taula `auditlog` amb un format diferent. **Els registres del registre d'auditoria existents s'esborraran.** ##### Audit log In order to improve audit logging in Zabbix and make the Audit log complete and reliable, the previously existing database structure had to be reworked. During an upgrade DB tables `auditlog` and `auditlog_details` will be replaced by the new table `auditlog` with a different format. **Old audit records will not be preserved.** New [section](/manual/web_interface/frontend_sections/administration/general#audit_log) *Audit log* has been added to the *Administration→General* menu allowing to enable (default) or disable audit logging. Housekeeping settings for audit, previously located under the *Housekeeper* menu section, have also been moved to the new *Audit log* section. Existing housekeeping settings will be saved. ##### Registre d'auditoria Per tal de millorar el registre d'auditoria a Zabbix i fer que aquest sigui complet i fiable, s'ha hagut de reelaborar l'estructura de la base de dades existent. Durant una actualització, les taules de la base de dades `auditlog` i `auditlog_details` han estat substituïdes per la nova taula `auditlog` amb un format diferent. **No es conserven els registres d'auditoria antics.** S'ha afegit una nova [secció](/manual/web_interface/frontend_sections/administration/general#audit_log) *Registre d'auditoria* al menú *Administració→General* per habilitar (per defecte) o desactivar el registre d'auditoria. La configuració de neteja per a l'auditoria, que abans es trobava a la secció del menú *Neteja*, també s'ha mogut a la nova secció *Registre d'auditoria*. La configuració de neteja existent es desarà. # Audit log object The following objects are directly related to the `auditlog` API. # Objecte de registre d'auditoria Els objectes següents tenen relació directa amb l'API `auditlog`. ### 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|string|*(readonly)* ID of audit log entry. Generated using CUID algorithm.| |userid|string|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 are:<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.| |resourcetype|integer|Audit log entry resource type.<br><br>Possible values are:<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.| |resourceid|string|Audit log entry resource identifier.| |resourcename|string|Audit log entry resource human readable name.| |recordsetid|string|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 JSON object where each property name is a path to property or nested object in which change occurred, and each value contain the data about the change of this property in array format.<br><br>Possible value formats are:<br>\["add"\] - Nested object has been added;<br>\["add", "<value>"\] - The property of added object contain <value>;<br>\["update"\] - Nested object has been updated;<br>\["update", "<new value>", "<old value>"\] - The value of property of updated object was changed from <old value> to <new value>;<br>\["delete"\] - Nested object has been deleted.| ### Registre d'auditoria El registre d'auditoria conté informació sobre les accions d'usuaris, i té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |auditid|string|*(només lectura)* ID de l'entrada de registre d'auditoria. Es genera amb un algoritme CUID.| |userid|string|ID d'usuari de l'autor de l'entrada del registre d'auditoria.| |username|string|Nom d'usuari de l'autor de l'entrada del registre d'auditoria.| |clock|timestamp|hora de la creació del registre d'auditoria.| |ip|string|IP de l'autor de l'entrada del registre d'auditoria.| |action|integer|Acció d'entrada al registre d'auditoria.<br><br>Valors possibles:<br>0 - Afegir;<br>1 - Actualizar;<br>2 - esborrar;<br>4 - Sortir;<br>7 - Executar;<br>8 - Entrar;<br>9 - Entrada fallida;<br>10 - Netejar historial.| |resourcetype|integer|Tipus de recurs de l'entrada del registre d'auditoria.<br><br>Valors possibles:<br>0 - Usuari;<br>3 - Tipus de mitjà;<br>4 - Equip;<br>5 - Acció;<br>6 - Gràfic;<br>11 - Grup d'usuaris;<br>13 - Trigger;<br>14 - Grup d'equips;<br>15 - Element;<br>16 - Imatge;<br>17 - Mapa de valors;<br>18 - Servei;<br>19 - Mapa;<br>22 - Escenari Web;<br>23 - Regla de descobriment;<br>25 - Script;<br>26 - Proxy;<br>27 - Manteniment;<br>28 - Expressió regular;<br>29 - Macro;<br>30 - Plantilla;<br>31 - Prototip de trigger;<br>32 - Mapatge d'icones;<br>33 - Tauler;<br>34 - Correlació d'events;<br>35 - Prototip de gràfic;<br>36 - Prototip d'element;<br>37 - Prototip d'equip;<br>38 - Autoregistre;<br>39 - Mòdul;<br>40 - Configuració;<br>41 - Manteniment;<br>42 - Autenticació;<br>43 - Tauler de plantilla;<br>44 - Rol d'usuari;<br>45 - Token d'autenticació;<br>46 - Informe programat;<br>47 - Mode d'alta disponibilitat;<br>48 - SLA.| |resourceid|string|Identificador del recurs d'entrada del registre d'auditoria.| |resourcename|string|Nom (llegible per humans) del recurs d'entrada del registre d'auditoria.| |recordsetid|string|ID de l'entrada de registres d'auditoria. Els registre d'auditoria creats durant la mateixa operació han de tindre el mateix ID de registre. Es generen amb l'algoritme CUID.| |details|text|Detalls de l'entrada de registre d'auditoria. Els detalls s'emmagatzemen en un objecte JSON on cada nom de propietat és el camí cap a la propietat o l'objecte niuat on ha de succeir el canvi, i cada valor conté la informació del canvi d'aquesta propietat (en format matriu).<br><br>Els formats de valor possibles són:<br>\["add"\] - Objectes niuats afegits;<br>\["add", "<valor>"\] - La propietat dels objectes afegits contenen <valor>;<br>\["update"\] - L'objecte fill s'ha actualitzat;<br>\["update", "<valor nou>", "<valor antic>"\] - El valor de la propietat de l'objecte actualitzat s'ha canviat, de <valor antic> a <valor nou>;<br>\["delete"\] - L'objecte niuat s'ha esborrat.| # Audit log This class is designed to work with audit log. Object references: - [Audit log object](/manual/api/reference/auditlog/object) Available methods: - [auditlog.get](/manual/api/reference/auditlog/get) - retrieve audit log records # Registre d'auditoria Aquesta classe és dissenyada per treballar amb registres d'auditories. Referències d'objecte: - [Alert](/manual/api/reference/auditlog/object) Mètodes disponibles: - [alert.get](/manual/api/reference/auditlog/get) - recuperar registres d'auditories. #### Audit log This section allows configuring audit log settings.  The following parameters are available: |Parameter|Description| |--|--------| |Enable audit logging|Enable/disable audit logging. Marked by default.| |Enable internal housekeeping|Enable/disable internal housekeeping for audit. Marked by default.| |Data storage period|Amount of days audit records should be kept for before being removed by the housekeeper. Mandatory if housekeeping is enabled. Default: 365 days.| #### Registre d'auditoria Aquesta secció us permet configurar el registre d'auditoria.  Els paràmetres següents són disponibles: |Paràmetre|Descripció| |--|---------| |Activar el registre d'auditoria|Activar/desactivar el registre d'auditoria. Marcat per defecte.| |Activar la neteja interna|Activar/desactivar la neteja interna per a l'auditoria. Marcat per defecte.| |Període d'emmagatzematge de dades|Nombre de dies que s'han de conservar els registres d'auditoria abans d'esborrar-se per la neteja interna. Cal si la neteja interna és activada. Per defecte: 365 dies.| **Audit settings** New [section](/manual/web_interface/frontend_sections/administration/general#audit_log) *Audit log* has been added to the *Administration→General* menu allowing to enable or disable audit logging. Housekeeping settings for audit, previously located under the *Housekeeper* section, have also been moved to the new *Audit log* section. **Paràmetres d'auditoria** S'ha afegit la nova [secció](/manual/web_interface/frontend_sections/administration/general#audit_log) *Registre d'auditoria* al menú *Administració→General* per habilitar o desactivar el registre d'auditoria. La configuració de neteja per a l'auditoria, que abans es trobava a la secció *Neteja*, també s'ha mogut a la nova secció *Registre d'auditoria*. #### Authenticating a user Authenticate a user. Request: ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Autenticar un usuari Autenticar un usuari. Petició: ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` #### Authentication Change authentication configuration options. [Authentication API](/manual/api/reference/authentication) #### Autenticació Modificar les opcions de configuració de l'autenticació. [API Autenticació](/manual/api/reference/authentication) #### authentication Changes:<br> [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) added new password policy fields `passwd_min_length` and `passwd_check_rules`. #### autenticació Canvis:<br> [ZBXNEXT-4029](https://support.zabbix.com/browse/ZBXNEXT-4029) afegits dos nous camps (`passwd_min_length` i `passwd_check_rules`) sobre l'estratègia de paraules de pas. # authentication.get # authentication.get # Authentication object The following objects are directly related to the `authentication` API. # Objecte d'autenticació Els objectes següents són relacionats amb l'API `authentication`. #### 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'; ``` #### Signatura de peticions d'autenticació És possible configurar l'ID d'Entra per [validar la signatura](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/howto-enforce-signed-saml-authentication) de les peticions d'autenticació signades. Perquè això funcioni, creeu claus públiques/privades: ```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 ``` Assigneu permisos: ```bash chown apache /usr/share/zabbix/conf/certs/request-sign.key chmod 400 /usr/share/zabbix/conf/certs/request-sign.key ``` Actualitzeu la configuració de la interfície de Zabbix afegint: ```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|Enable HTTP authentication.<br><br>Possible values:<br>0 - *(default)* Disable;<br>1 - Enable.| |http\_login\_form|integer|Default login form.<br><br>Possible values:<br>0 - *(default)* Zabbix login form;<br>1 - HTTP login form.| |http\_strip\_domains|string|Remove domain name.| |http\_case\_sensitive|integer|HTTP case-sensitive login.<br><br>Possible values:<br>0 - Off;<br>1 - *(default)* On.| |ldap\_configured|integer|Enable LDAP authentication.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |ldap\_host|string|LDAP host.| |ldap\_port|integer|LDAP port.| |ldap\_base\_dn|string|LDAP base DN.| |ldap\_search\_attribute|string|LDAP search attribute.| |ldap\_bind\_dn|string|LDAP bind DN.| |ldap\_case\_sensitive|integer|LDAP case-sensitive login.<br><br>Possible values:<br>0 - Off;<br>1 - *(default)* On.| |ldap\_bind\_password|string|LDAP bind password.| |saml\_auth\_enabled|integer|Enable SAML authentication.<br><br>Possible values:<br>0 - *(default)* Disable;<br>1 - Enable.| |saml\_idp\_entityid|string|SAML IdP entity ID.| |saml\_sso\_url|string|SAML SSO service URL.| |saml\_slo\_url|string|SAML SLO service URL.| |saml\_username\_attribute|string|SAML username attribute.| |saml\_sp\_entityid|string|SAML SP entity ID.| |saml\_nameid\_format|string|SAML SP name ID format.| |saml\_sign\_messages|integer|SAML sign messages.<br><br>Possible values:<br>0 - *(default)* Do not sign messages;<br>1 - Sign messages.| |saml\_sign\_assertions|integer|SAML sign assertions.<br><br>Possible values:<br>0 - *(default)* Do not sign assertions;<br>1 - Sign assertions.| |saml\_sign\_authn\_requests|integer|SAML sign AuthN requests.<br><br>Possible values:<br>0 - *(default)* Do not sign AuthN requests;<br>1 - Sign AuthN requests.| |saml\_sign\_logout\_requests|integer|SAML sign logout requests.<br><br>Possible values:<br>0 - *(default)* Do not sign logout requests;<br>1 - Sign logout requests.| |saml\_sign\_logout\_responses|integer|SAML sign logout responses.<br><br>Possible values:<br>0 - *(default)* Do not sign logout responses;<br>1 - Sign logout responses.| |saml\_encrypt\_nameid|integer|SAML encrypt name ID.<br><br>Possible values:<br>0 - *(default)* Do not encrypt name ID;<br>1 - Encrypt name ID.| |saml\_encrypt\_assertions|integer|SAML encrypt assertions.<br><br>Possible values:<br>0 - *(default)* Do not encrypt assertions;<br>1 - Encrypt assertions.| |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 range of values: 1-70<br>8 - *default*| |passwd\_check\_rules|integer|Password checking rules.<br><br>Possible bitmap values are:<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).| ### Autenticació L'objecte d'autenticació té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |autentication\_type|enter|Autenticació per defecte.<br><br>Valors possibles:<br>0 - *(per defecte)* Intern;<br>1 - LDAP.| |http\_auth\_enabled|enter|Activar l'autenticació HTTP.<br><br>Valors possibles:<br>0 - *(per defecte)* Desactivar;<br>1 - Activar.| |http\_login\_form|enter|Formulari d'entrada per defecte.<br><br>Valors possibles:<br>0 - *(per defecte)* Formulari d'entrada al Zabbix ;<br>1 - Formulari d'entrada HTTP.| |http\_strip\_domains|cadena|Esborrar el nom de domini.| |http\_case\_sensitive|enter|Login HTTP sensible a majúscules i minúscules.<br><br>Valors possibles:<br>0 - Desactivat;<br>1 - *(per defecte)* Actiu.| |ldap\_configured|enter|Activar l'antenticació LDAP.<br><br>Valors possibles:<br>0 - Desactivar;<br>1 - *(per defecte)* Activar.| |ldap\_host|cadena|equip LDAP.| |ldap\_port|enter|port LDAP.| |ldap\_base\_dn|cadena|DN base LDAP.| |ldap\_search\_attribute|cadena|atribut de cerca LDAP.| |ldap\_bind\_dn|cadena|DN de connexió LDAP.| |ldap\_case\_sensitive|enter|login LDAP amb distinció de majúscules i minúscules.<br><br>Valors possibles:<br>0 - Desactivat;<br>1 - *(per defecte)* Actiu.| |ldap\_bind\_password|cadena|paraula de pas de la connexió LDAP.| |saml\_auth\_enabled|enter|Activar l'autenticació SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* Desactivat;<br>1 - Actiu.| |saml\_idp\_entityid|cadena|ID d'entitat SAML IdP.| |saml\_sso\_url|cadena|URL del servei SAML SSO.| |saml\_slo\_url|cadena|URL del servei SAML SLO.| |saml\_username\_attribute|cadena|atribut d'usuari SAML.| |saml\_sp\_entityid|cadena|ID d'entitat SAML SP.| |saml\_nameid\_format|cadena|Format del nom ID de SAML SP.| |saml\_sign\_messages|enter|Signatura de missatges SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* ;<br>1 - Signar missatges.| |saml\_sign\_assertions|enter|Assercions de signatura SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No signar;<br>1 - Signar.| |saml\_sign\_authn\_requests|enter|Peticions de signatura AuthNde SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No signar les peticions;<br>1 - Signar-les.| |saml\_sign\_logout\_requests|enter|Peticions de tancar sessió de les signatures SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No signar les peticions;<br>1 - Signar-les.| |saml\_sign\_logout\_responses|enter|Signar les peticions de sortida de SAML .<br><br>Valors possibles:<br>0 - *(per defecte)* No signar-les;<br>1 - Signar-les.| |saml\_encrypt\_nameid|enter|ID de nom de xifrat SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No xifrar pas l'ID del nom;<br>1 - Xifrar-lo.| |saml\_encrypt\_assertions|enter|Xifrar les assercions SAML.<br><br>Valors possibles:<br>0 - *(per defecte)* No xifrar-les pas;<br>1 - Xifrar-les.| |saml\_case\_sensitive|enter|Inici de sessió SAML diferenciant majúscules i minúscules.<br><br>Valors possibles:<br>0 - Desactivat;<br>1 - *(per defecte)* Actiu.| |passwd\_min\_length|enter|Requerir longitud mínima de paraula de pas.<br><br>Valors possibles: 1-70<br>8 - *per defecte*| |passwd\_check\_rules|enter|Regles de comprovació de paraules de pas.<br><br>Els valors possibles són:<br>0 - Comprovar la longitud;<br>1 - Comprovar si es fa ús de majúscules i minúscules;<br>2 - Comprovar si s'empren dígits;<br>4 - Comprovar si s'empren caràcters especials;<br>8 - *(per defecte)* Comprovar si no és a la llista de les paraules de pas més comunes i no conté pas variacions de la paraula "Zabbix" o el nom o cognom de l'usuari.<br><br>És un camp de màscara de bit; s'admet qualsevol suma de possibles valors de mapa de bits (per exemple, 15 per comprovar totes les regles).| # 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 - [authentication.update](/manual/api/reference/authentication/update) - update authentication # Autenticació Aquesta classe s'ha disssenyat per a treballar amb paràmetres d'autenticació. Objectes de referència: - [Autenticació](/manual/api/reference/authentication/object#authentication) Mètodes disponibles: - [authentication.get](/manual/api/reference/authentication/get) - recuperar l'autenticació - [authentication.update](/manual/api/reference/authentication/update) - actualitzar l'autenticació #### Authentication To access any data in Zabbix, you need to either: - use an existing [API token](/manual/web_interface/frontend_sections/administration/general#api-tokens) (created in Zabbix frontend or 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: ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1, "auth": null } ``` Let's take a closer look at the request object. It has the following properties: - `jsonrpc` - the version of the JSON-RPC protocol used by the API; the Zabbix API implements JSON-RPC version 2.0; - `method` - the API method being called; - `params` - parameters that will be passed to the API method; - `id` - an arbitrary identifier of the request; if omitted, the API treats the request as a [notification](https://www.jsonrpc.org/specification#notification); - `auth` - a user authentication token; since we don't have one yet, it's set to `null`. If you provided the credentials correctly, the response returned by the API will contain the user authentication token: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` The response object in turn contains the following properties: - `jsonrpc` - again, the version of the JSON-RPC protocol; - `result` - the data returned by the method; - `id` - identifier of the corresponding request. #### Autenticació Per accedir a dades de Zabbix, heu de: - Emprar un [token API] existent (/manual/web_interface/frontend_sections/administration/general#api-tokens) (creat a la interfície Zabbix o emprant l'[API Token](/manual/api/reference/token)); - Emprar un token d'autenticació obtingut amb el mètode [user.login](/manual/api/reference/user/login). Per exemple, si voleu obtindre un token d'autenticació nou iniciant la sessió com a usuari *Admin* estàndard, la petició JSON seria així: ```json { "jsonrpc": "2.0", "method": "user.login", "params": { "username": "Admin", "password": "zabbix" }, "id": 1, "auth": null } ``` Fem una ullada detallada a l'objecte de la petició. Té les propietats següents: - `jsonrpc` - la versió del protocol JSON-RPC emprat per l'API; l'API Zabbix implementa JSON-RPC versió 2.0; - `method` - el mètode API al que es crida; - `params` - paràmetres que es passaran a l'API; - `id` - un identificador arbitrari de la petició; Si s'omet, l'API tracta la petició com una [notificació](https://www.jsonrpc.org/specification#notification); - `auth` - un token d'autenticació d'usuari; des que no en tenim cap, s'estableix a `null`. Si proporcioneu les credencials correctes, la resposta de l'API contindrà el token d'autenticació de l'usuari: ```json { "jsonrpc": "2.0", "result": "0424bd59b807674191e7d77572075f33", "id": 1 } ``` L'objecte de resposta contindrà les següents propietats: - `jsonrpc` - altre cop la versió del protocol JSON-RPC; - `result` - les dades retornades per el mètode; - `id` - identificador de la petició corresponent. # authentication.update # authentication.update ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Alexei Vladishev <<alex@zabbix.com>> ------------------------------------------------------------------------ [ ]{#index} ##### 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.| ##### Autorització |Paràmetre|Descripció| |--|---------| |*Intents d'inici de sessió*|Nombre d'intents d'inici de sessió fallits abans que es bloquegi la possibilitat d'iniciar sessió.| |*Interval de blocatge de connexió*|Període durant el qual es prohibirà la connexió quan se superi el límit d'*intents de connexió*.| ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTHOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} ## AUTOR Zabbix LLC ------------------------------------------------------------------------ [ ]{#index} #### Automated type selection Item configuration form now automatically suggests the matching type of information, if selected item key returns data only of the specific type (for example, **log\[\]** item requires *Type of information: Log*). *Type of information* parameter is now located under the *Key* parameter on the primary *Item* tab and is duplicated on the *Preprocessing* tab if at least one preprocessing step is specified. If Zabbix detects a possible mismatch of the selected type of information and key, a warning icon will be displayed next to the *Type of information* field. ##### Selecció automàtica del tipus El formulari de configuració de l'element ara suggereix automàticament el tipus d'informació, si la clau de l'element seleccionat només retorna dades del tipus específic (per exemple, l'element **registre\[\]** requereix *Informació del tipus: registre*). El paràmetre *Tipus d'informació* es troba ara sota el paràmetre *Clau* a la pestanya principal *Element* i es duplica a la pestanya *Preprocessament* si s'especifica almenys una passa de preprocessament. Si Zabbix detecta una possible incompatibilitat entre el tipus d'informació seleccionada i la clau, es mostrarà una icona d'avís al costat del camp *Tipus d'informació*. ##### Automatic mode A host's inventory can also be populated automatically. For that to work, when configuring the host's inventory mode in the *Inventory* tab, it 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\] ##### Mode automàtic L'inventari d'un equip també es pot omplir automàticament. Perquè això funcioni, en configurar el mode d'inventari de l'equip a la pestanya *Inventari*, s'ha d'establir a *Automàtic*. A continuació, podeu [configurar els elements de l'equip](/manual/config/items/item) emplenant qualsevol camp d'inventari de l'equip amb el seu valor, indicant el camp de destinació amb l'atribut corresponent (anomenat *L'element omplirà el camp d'inventari de l'equip*) a la configuració de l'element. Els elements que són especialment útils per a la col·lecció de dades d'inventari automatitzades són: - system.hw.chassis\[full|type|vendor|model|serial\] - per defecte és \[full\], calen permisos de root - system.hw.cpu\[all|cpunum,full|maxfreq|vendor|model|curfreq\] - per defecte és \[all,full\] - system.hw.devices\[pci|usb\] - per defecte és \[pci\] - system.hw.macaddr\[interface,short|full\] - per defecte és \[all,full\], la interfície és regexp - system.sw.arch - system.sw.os\[name|short|full\] - per defecte és \[name\] - system.sw.packages\[regexp,manager,short|full\] - per defecte és \[all,all,full\] #### 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.| #### Accions d'autoregistre Les condicions següents es poden emprar en accions basades en el registre automàtic de l'agent actiu: |Tipus de condició|Operadors admesos|Descripció| |--|--|------| |*Metadades de l'equip*|conté<br>no conté<br>coincideix<br>no coincideix|Especifiqueu metadades de l'equip o metadades de l'equip per excloure.<br>**conté** - les metadades de l'equip conté la cadena.<br >**no conté** - les metadades de l'equip no contenen la cadena.<br>Les metadades de l'equip es poden especificar en un [fitxer de configuració de l'agent](/manual/appendix/config/zabbix_agentd).<br>**coincideixen** - les metadades de l'equip coincideixen amb l'expressió regular.<br>**no coincideixen** - les metadades de l'equip no coincideixen amb l'expressió regular.| |*El nom de l'equip*|conté<br>no conté<br>coincideix<br>no coincideix|Especifiqueu un nom d'equip o un nom d'equip per excloure.<br>**conté** - el nom de l'equip conté la cadena.<br>**no conté** - el nom de l'equip no conté la cadena.<br>**concorda** - el nom de l'equip coincideix amb l'expressió regular.<br>**no coincideix** - el nom de l'equip no coincideix amb l'expressió regular.| |*Proxy*|igual<br>no és igual|Especifiqueu un proxy a excloure.<br>**igual** - emprant aquest proxy.<br>**no és igual** - empra un altre proxy diferent d'aquest. | # 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) #### Enregistrament automàtic En aquesta secció, podeu configurar el nivell de xifrat per al registre automàtic de l'agent actiu.  Els paràmetres marcats amb un asterisc són obligatoris. Paràmetres de configuració: |Paràmetre|Descripció| |--|---------| |*Nivell de xifrat*|Trieu una o ambdues opcions per al nivell de xifrat:<br>**Sense xifrat**: Es permeten connexions sense xifrar<br>**PSK**: Es permeten connexions xifrades TLS amb una clau prèviament compartida | |*Identitat PSK*|Introduïu la cadena d'identitat de la clau prèviament compartida.<br>Aquest camp només serà disponible si s'ha triat "PSK" com a *Nivell d'encriptació*.<br>No introduïu cap informació sensible a la identitat PSK, es transmet sense xifrar per la xarxa per informar al receptor quina PSK ha d'emprar.| |*PSK*|Introduïu la clau prèviament compartida (un nombre parell de caràcters hexadecimals).<br>Llargada màxima: 512 dígits hexadecimals (PSK de 256 octets) si Zabbix empra la biblioteca GnuTLS o OpenSSL, 64 dígits hexadecimals (PSK de 32 octets) si Zabbix empra la biblioteca TLS mbed (PolarSSL).<br>Exemple: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952<br>només és disponible com a nivell de xifrat *PSK<br>Thi*| Veieu també: [Registre automàtic segur](/manual/discovery/auto_registration#secure_autoregistration) # Autoregistration object The following objects are directly related to the `autoregistration` API. # Objecte d'autoregistre Els objectes següents són relacionats amb l'API `autoregistration`. #### Autoregistration table cleared from orphaned records Previously the `autoreg_host` table was never cleared. Now orphaned records that reference neither an autoregistration event nor an existing host will be removed by the Housekeeper. #### S'ha netejat la taula d'autoregistre dels registres orfes Abans, la taula `autoreg_host` mai es netejava. Ara els registres orfes que no fan referència a un esdeveniment d'autoregistre ni a un equip existent s'esborraran per el procés de neteja. ### 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|*(write-only)* 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>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.| |tls\_psk|string|*(write-only)* Pre-shared key (PSK); must be at least 32 hex digits.| ### Autoregistre L'objecte d'autoregistre té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tls\_accept|integer|Tipus de connexions entrants autoritzades per autoregistrar.<br><br>Valors possibles:<br>1 - permetre connexions no xifrades;<br>2 - permetre TLS amb PSK.<br>3 permetre ambdúes: connexions no xifrades i TLS amb PSK.| |tls\_psk\_identity|string|*(només escriptura)* Identitat PSK; s'ha d'aparellar només amb un PSK (a través de [registre automàtic](/manual/api/reference/autoregistration/object), [equips](/manual/api/reference/host/object) i [proxys](/manual/api/reference/proxy/object)).<br>No inclogueu informació sensible a la identitat PSK, ja que s'envia sense xifrar a través de la xarxa per informar al receptor quina PSK ha d'emprar.| |tls\_psk|string|*(només escriptura)* Clau precompartida (PSK); ha de tindre almenys 32 dígits hexadecimals.| # 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 # Autoregistre Aquesta classe s'ha dissenyat per a treballar amb autoregistre. Objectes de referència: - [Autoregistre](/manual/api/reference/autoregistration/object#autoregistration) Mètodes disponibles: - [autoregistration.get](/manual/api/reference/autoregistration/get) - recuperar autoregistre - [autoregistration.update](/manual/api/reference/autoregistration/update) - actualitzar autoregistre # 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. #### Estructura Tots els components de Zabbix són disponibles als següents repositoris Docker: - Dispositiu Zabbix amb suport de bases de dades MySQL i servidor web Nginx - [zabbix/zabbix-appliance](https://hub.docker.com/r/zabbix/zabbix-appliance/) - Agent Zabbix - [zabbix/zabbix-agent](https://hub.docker.com/r/zabbix/zabbix-agent/) - Servidor Zabbix - Servidor Zabbix amb suport de bases de dades MySQL - [zabbix/zabbix-server-mysql](https://hub.docker.com/r/zabbix/zabbix-server-mysql/) - Servidor Zabbix amb suport de bases de dades PostgreSQL - [zabbix/zabbix-server-pgsql](https://hub.docker.com/r/zabbix/zabbix-server-pgsql/) - Interfície web Zabbix - Interfície web Zabbix basada en el servidor web Apache2 amb suport de bases de dades MySQL - [zabbix/zabbix-web-apache-mysql](https://hub.docker.com/r/zabbix/zabbix-web-apache-mysql/) - Interfície web de Zabbix basada en el servidor web Apache2 amb suport de bases de dades PostgreSQL - [zabbix/zabbix-web-apache-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-apache-pgsql/) - Interfície web Zabbix basada en el servidor web Nginx amb suport de bases de dades MySQL - [zabbix/zabbix-web-nginx-mysql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-mysql/) - Interfície web Zabbix basada en el servidor web Nginx amb suport de bases de dades PostgreSQL - [zabbix/zabbix-web-nginx-pgsql](https://hub.docker.com/r/zabbix/zabbix-web-nginx-pgsql/) - Proxy Zabbix - Proxy Zabbix amb suport de bases de dades SQLite3 - [zabbix/zabbix-proxy-sqlite3](https://hub.docker.com/r/zabbix/zabbix-proxy-sqlite3/) - Proxy Zabbix amb suport de bases de dades MySQL - [zabbix/zabbix-proxy-mysql](https://hub.docker.com/r/zabbix/zabbix-proxy-mysql/) - Zabbix Java Gateway - [zabbix/zabbix-java-gateway](https://hub.docker.com/r/zabbix/zabbix-java-gateway/) A més, hi ha suport per a trampes SNMP. Es proporciona com a repositori addicional ([zabbix/zabbix-snmptraps](https://hub.docker.com/r/zabbix/zabbix-snmptraps/)) basat només en Ubuntu Trusty. Es pot enllaçar al servidor Zabbix i al proxy Zabbix. ##### Average request count to Nginx server View the average request count per second per day to the Nginx server: - add the request count per second item to the data set - select the aggregate function `avg` and specify interval `1d` - a bar graph is displayed, where each bar represents the average number of requests per second per day ##### Promig de peticions al servidor Nginx: Mostrar el nombre mitjà de peticions per segon i dia al servidor Nginx: - afegiu el nombre de peticions per segon al conjunt de dades - trieu la funció d'agregació `avg` i especifiqueu l'interval `1d` - Es mostra un gràfic de barres, on cada barra representa el nombre mitjà de peticions per segon i dia #### 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 available if *Y-axis* (in *Data set* configuration) is set to "Left".| |*Right Y*|0|righty|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>Parameter available if *Y-axis* (in *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.| #### Eixos S'admeten els paràmetres següents per configurar els *Eixos*. |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Left Y*|0|lefty|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.<br><br>Paràmetre disponible si l'*eix Y* (a la configuració del *Conjunt de dades*) s'ha establert a "Esquerra".| |*Right Y*|0|righty|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>Paràmetre disponible si s'estableix *Eix Y* (a la configuració del *Conjunt de dades*) a "Dreta".| |*Min*|1|lefty_min|Qualsevol valor numèric.<br><br>Per defecte: `""` (buit).| |^|^|righty_min|^| |*Max*|1|lefty_max|Qualsevol valor numèric.<br><br>Per defecte: `""` (buit).| |^|^|righty_max|^| |*Units* (tipus)|0|unitats_esquerra|0 - *(per defecte)* Automàtic;<br>1 - Estàtic.| |^|^|unitats_dretes|^| |*Units* (valor)|1|lefty_static_units|Qualsevol valor de cadena.<br><br>Per defecte: `""` (buida).| |^|^|unitats_estàtiques_dretes|^| |*X-Axis*|0|xaxis|0 - Inhabilitat;<br>1 - *(per defecte)* Habilitat.| ### Backward incompatible changes ### Canvis incompatibles amb versions anteriors ::: 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 6.0](/manual/introduction/whatsnew600){.button} ::: ::: banner{.banner-main-top} # Benvinguts a la documentació de Zabbix El vostre recurs de referència per treballar amb el monitoratge de Zabbix, des de configuracions bàsiques fins a configuracions avançades. Aquest manual cobreix tot el necessari per instal·lar, configurar i treballar amb Zabbix. [Novetats de Zabbix 6.0](/manual/introduction/whatsnew600){.button} ::: #### Baseline monitoring Set of available baseline monitoring options has been extended with the two new functions **baselinedev** and **baselinewma**. - **baselinedev** - compares the last data period with the same data periods in preceding seasons and returns the number of deviations; - **baselinewma** - calculates the baseline by averaging data from the same timeframe in multiple equal time periods ('seasons') using the weighted moving average algorithm. In context of these functions, the term 'season' refers to a configurable timeframe, which could be hours, days, weeks, months or years. The length of a season and the number of seasons to analyse is set in function parameters. See [history functions](/manual/appendix/functions/history) for more info. ##### Monitoratge de referència S'ha ampliat el conjunt d'opcions de seguiment de la línia de base disponibles a les dues noves funcions **baselinedev** i **baselinewma**. - **baselinedev** - compara el darrer període de dades amb els mateixos períodes de dades de temporades anteriors i retorna el nombre de buits; - **baselinewma** - calcula la línia de base fent la mitjana de les dades del mateix període durant diversos períodes de temps iguals ('temporades') mitjançant l'algorisme de mitjana mòbil ponderada. En el context d'aquestes funcions, el terme 'estació' fa referència a un període configurable, que pot ser hores, dies, setmanes, mesos o anys. La durada d'una temporada i el nombre de temporades a analitzar es defineixen als paràmetres de la funció. Consulteu les [funcions de l'historial](/manual/appendix/functions/history) per obtindre més informació. #### 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](#post-migration) to drop the old tables. #### Migració amb Batch de les taules d'històric * Prepareu els directoris per Data Pump. Data Pump ha de tindre permisos de lectura i escriptura a aquests directoris. Exemple: ``` {.bash} mkdir -pv /export/history chown -R oracle:oracle /export ``` * Creeu un objecte directori i doneu-hi permisos de lectura i escriptura a l'usuari d'autenticació de Zabbix ('zabbix', a l'exemple de més avall). Amb el rol *sysdba*, executeu: ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; ``` * Exporteu les taules. Substituïu N amb el comptador que vulgueu. ``` {.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 ``` * Importeu les taules. Substituïu N amb el comptador que vulgueu. ``` {.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 ``` * Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues. #### 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. #### Comportament depenent de la disponibilitat La taula següent ensenya com es comporta cada funció en cas de disponibilitat limitada de l'equip/element i històric. |Funció|Equip deshabilitat|Equip no disponible amb informació|Equip no disponible sense informació|Element deshabilitat|Element no admès|Error SQL de recuperació d'informació| |--|--|--|--|--|--|--| |*avg_foreach*|ignorar|retorna avg|ignorar|ignorar|ignorar|ignorar| |*bucket_rate_foreach*|ignorar|retorna bucket rate|ignorar|ignorar|ignorar|ignorar| |*count_foreach*|ignorar|retorna count|0|ignorar|ignorar|ignorar| |*exists_foreach*|ignorar|1|1|ignorar|1|n/a| |*last_foreach*|ignorar|retorna last|ignorar|ignorar|ignorar|ignorar| |*max_foreach*|ignorar|retorna max|ignorar|ignorar|ignorar|ignorar| |*min_foreach*|ignorar|retorna min|ignorar|ignorar|ignorar|ignorar| |*sum_foreach*|ignorar|retorna sum|ignorar|ignorar|ignorar|ignorar| Si l'element s'ha *ignorat*, no s'afegirà pas res. #### Better navigation between item configuration and latest data A new context menu for items has been introduced in *[Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data)* allowing to access the item configuration and available graphs:  Conversely, a new context menu has been introduced in the [item list](/manual/web_interface/frontend_sections/configuration/hosts/items) in configuration menu allowing to access the latest data for the item and other useful options:  This menu replaces the wizard option in previous versions. A similar menu has also been introduced for [template items](/manual/web_interface/frontend_sections/configuration/templates/items) and [item prototypes](/manual/discovery/low_level_discovery/item_prototypes). ##### Millor navegació entre la configuració de l'element i les dades més recents S'ha afegit un nou menú contextual per als elements *[Darreres dades](/manual/web_interface/frontend_sections/monitoring/latest_data)* que permet accedir a la configuració de l'element i gràfics disponibles:  Per contra, s'ha afegit un nou menú contextual al menú de [llistat d'elements](/manual/web_interface/frontend_sections/configuration/hosts/items) al menú de configuració que permet accedir a les darreres dades de l'element i altres opcions útils:  Aquest menú substitueix l'opció de l'assistent en versions anteriors. També s'ha afegit un menú similar per a [elements de plantilla](/manual/web_interface/frontend_sections/configuration/templates/items) i [prototips d'elements](/manual/discovery/low_level_discovery/item_prototypes). ## Breaking changes ## Canvis importants ## Breaking changes ## Canvis importants ## Breaking changes ## Canvis importants ## Breaking changes ## Canvis importants ## Breaking changes ## Canvis importants ## Breaking changes ## Canvis importants ## Breaking changes ## Canvis importants ### Breaking changes #### Loadable plugin versioning [Loadable plugins](/manual/config/items/plugins#loadable) for Zabbix agent 2 now use the same versioning system as Zabbix itself. The following version changes have been made: - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13 These plugins are supported for any minor version of Zabbix 6.0. Note that source code repository for each plugin now contains a dedicated *release/6.0* branch (previously, there was only *master* branch). ### Canvis majors #### Gestió de versions dels plugins carregables Els [connectors carregables](/manual/config/items/plugins#chargeable) per a l'agent Zabbix 2 ara empren el mateix sistema de control de versions que el mateix Zabbix. S'han fet els següents canvis de versió: - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13 Aquests connectors són compatibles amb qualsevol versió menor de Zabbix 6.0. Tingueu en compte que el dipòsit de codi font de cada connector ara conté una branca dedicada *release/6.0* (abans només hi havia una branca *master*). ### Breaking changes #### Loadable plugin versioning [Loadable plugins](/manual/config/items/plugins#loadable) for Zabbix agent 2 now use the same versioning system as Zabbix itself. The following version changes have been made: - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13 These plugins are supported for any minor version of Zabbix 6.0. Note that source code repository for each plugin now contains a dedicated *release/6.0* branch (previously, there was only *master* branch). ### Canvis majors #### Gestió de versions dels plugins carregables Els [connectors carregables](/manual/config/items/plugins#chargeable) per a l'agent Zabbix 2 ara empren el mateix sistema de control de versions que el mateix Zabbix. S'han fet els següents canvis de versió: - MongoDB 1.2.0 -> MongoDB 6.0.13 - PostgreSQL 1.2.1 -> PostgreSQL 6.0.13 Aquests connectors són compatibles amb qualsevol versió menor de Zabbix 6.0. Tingueu en compte que el dipòsit de codi font de cada connector ara conté una branca dedicada *release/6.0* (abans només hi havia una branca *master*). ##### BSD systems If `watch` command is not installed, a similar effect can be achieved with while [ 1 ]; do ps x; sleep 0.2; clear; done ##### Sistemes BSD Si la comanda `watch` no és instal·lada, es pot aconseguir un efecte semblant amb while [ 1 ]; do ps x; sleep 0.2; clear; done ##### Build 32bit PCRE 1\. Run: mingw32-make clean 2\. Delete *CMakeCache.txt*: del CMakeCache.txt rmdir /q /s CMakeFiles 3\. Run cmake: cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-m32 -O2 -g" -DCMAKE_CXX_FLAGS="-m32 -O2 -g" -DCMAKE_EXE_LINKER_FLAGS="-Wl,-mi386pe" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre32 4\. Next, run: mingw32-make install ##### Construir PCRE 32 bits 1\. Executar: mingw32-make clean 2\. Esborrar *CMakeCache.txt*: del CMakeCache.txt rmdir /q /s CMakeFiles 3\. Executar cmake: cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-m32 -O2 -g" -DCMAKE_CXX_FLAGS="-m32 -O2 -g" -DCMAKE_EXE_LINKER_FLAGS="-Wl,-mi386pe" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre32 4\. Tot seguit, executar: mingw32-make install ##### Build 64bit PCRE 1\. Delete old configuration/cache if exists: del CMakeCache.txt rmdir /q /s CMakeFiles 2\. Run cmake (CMake can be installed from <https://cmake.org/download/>): cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-O2 -g" -DCMAKE_CXX_FLAGS="-O2 -g" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre 3\. Next, run: mingw32-make clean mingw32-make install ##### Construir PCRE 64 bits 1\. Esborrar la configuració antiga i la cau, si existeix: del CMakeCache.txt rmdir /q /s CMakeFiles 2\. Executarcmake (CMake es pot instal·lar des de <https://cmake.org/download/>) : cmake -G "MinGW Makefiles" -DCMAKE_C_COMPILER=gcc -DCMAKE_C_FLAGS="-O2 -g" -DCMAKE_CXX_FLAGS="-O2 -g" -DCMAKE_INSTALL_PREFIX=c:\dev\pcre 3\. Tot seguit, executar: mingw32-make clean mingw32-make install #### 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 #### Construir binaris d'agent amb les biblioteques compartides Instal·leu PCRE2 (canvieu *pcre2* per *pcre* a les comandes d'aquí sota, si cal): brew install pcre2 Quan es compili amb TLS, instal·leu OpenSSL i/o GnuTLS: brew install openssl brew install gnutls Descarregueu les fonts de Zabbix : git clone https://git.zabbix.com/scm/zbx/zabbix.git Compileu l'agent sense TLS : cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 make make install Compileu l'agent amb OpenSSL : cd zabbix ./bootstrap.sh ./configure --sysconfdir=/usr/local/etc/zabbix --enable-agent --enable-ipv6 --with-openssl=/usr/local/opt/openssl make make install compileu l'agent amb 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 #### Creeu binaris d'agent amb biblioteques estàtiques amb GnuTLS GnuTLS depèn del backend de xifrat de Nettle i de la biblioteca aritmètica GMP. En lloc d'emprar la biblioteca GMP completa, aquesta guia emprarà mini-gmp que s'inclou amb Nettle. Quan es construeix GnuTLS i Nettle, es recomana executar `make check` després d'una compilació correcta. Fins i tot si la compilació és correcta, les proves de vegades fallen. Si és així, els problemes s'han d'investigar i resoldre abans de continuar. Suposem que les biblioteques estàtiques PCRE, Nettle i GnuTLS s'instal·laran a `$HOME/static-libs`. Farem anar PCRE2 10.39, Nettle 3.4.1 i 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" Copiem les biblioteques estàtiques a `static-libs-source` : mkdir static-libs-source cd static-libs-source Descarregueu i compileu 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 .. Téléchargez et compilez 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 .. Descarregueu les fonts de Zabbix i compileu l'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 #### 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 #### Compilar els binaris de l'agent amb les biblioteques estàtiques emprant OpenSSL Quan es construeix OpenSSL, es recomana executar "make test" després d'una compilació correcta. Fins i tot si la compilació és correcta, les proves de vegades fallen. Si és així, els problemes s'han d'investigar i resoldre abans de continuar. Suposem que les biblioteques estàtiques PCRE i OpenSSL s'instal·laran a `$HOME/static-libs`. Farem servir PCRE2 10.39 i OpenSSL 1.1.1a. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" OPENSSL_PREFIX="$HOME/static-libs/openssl-1.1.1a" Poseu les biblioteques estàtiques a `static-libs-source` : mkdir static-libs-source cd static-libs-source Descarregueu i creeu PCRE amb les propietats admeses d'Unicode: 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 .. Descarregueu i creeu 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 .. Descarregueu les fonts Zabbix i compileu l'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 #### 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 #### Compilar els binaris d'agent amb biblioteques estàtiques sense TLS Suposem que les biblioteques estàtiques PCRE siguin installades a `$HOME/static-libs`. Emprarem PCRE2 10.39. PCRE_PREFIX="$HOME/static-libs/pcre2-10.39" Descarregueu i creeu PCRE amb el suport de les propietats d'Unicode: 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 Descarregueu les fonts Zabbix i compileu l'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 #### Building inventory #### Construcció de l'inventari ##### 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/log.h**, which defines **zabbix\_log()** function, which can be used for logging and debugging purposes. ##### Construcció de mòduls Actualment, els mòduls són pensats per ésser construïts a l'arbre de fonts de Zabbix, ja que el mòdul API depèn d'algunes estructures de dades definides a les capçaleres de Zabbix. La capçalera més important per als mòduls carregables és **include/module.h**, que defineix aquestes estructures de dades. Una altra capçalera útil és **include/sysinc.h**, que realitza la inclusió de les capçaleres necessàries del sistema, permetent que include/module.h funcioni correctament. Perquè s'incloguin include/module.h i include/sysinc.h, primer s'ha d'executar l'ordre **./configure** (sense arguments) a l'arrel de l'arbre font de Zabbix. Això crearà el fitxer **include/config.h**, que es basa en **include/sysinc.h**. (Si teniu el codi font Zabbix d'un dipòsit de git, l'script ./configure encara no existeix i l'ordre **./bootstrap.sh** s'ha d'executar primer per generar-lo.) Tinguent en compte aquesta informació, tot és a punt per construir el mòdul. El mòdul ha d'incloure **sysinc.h** i **module.h**, i l'script de compilació ha de garantir que aquests dos fitxers siguin al camí d'inclusió. Veieu l'exemple de "mòdul fictici" a continuació per obtindre més detalls. Una altra capçalera útil és **include/log.h**, que defineix la funció **zabbix\_log()**, que es pot emprar amb finalitats de registre i depuració. ### Built-in objects ### Objectes integrats #### Built-in The following plugins for Zabbix agent 2 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%2F6.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%2F6.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/README.md?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.0)|Receives published values of MQTT topics.|mqtt.get|To configure encrypted connection to the MQTT broker, specify the TLS parameters in the agent configuration file as [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%2F6.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 encrypted connection to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters. Currently, TLS parameters cannot be passed as item key parameters.<br><br>`mysql.custom.query` item key is supported since Zabbix 6.0.21.| |[NetIf](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/netif?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.0)|Redis server monitoring.|redis.config, redis.info, redis.ping, redis.slowlog.count| | |[Smart](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/smart?at=refs%2Fheads%2Frelease%2F6.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)| |[Swap](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/swap?at=refs%2Fheads%2Frelease%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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%2F6.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).| #### Per defecte Els connectors següents per a l'agent Zabbix 2 són disponibles de manera immediata. Feu clic al nom del connector per accedir al repositori de connectors amb informació addicional. |Nom del connector|Descripció|[Claus dels elements compatibles](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2)|Comentaris| |--|--|--|----| |Agent|Mètrica de l'agent Zabbix emprat.|agent.hostname, agent.ping, agent.version|Les claus admeses tenen els mateixos paràmetres que [keys](/manual/config/items/itemtypes/zabbix_agent) de l'agent Zabbix.| |[Ceph](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/ceph/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge de Ceph.|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%2F6.0)|Monitoratge del processador del sistema (nombre de processadors/nuclis de processador, processadors descoberts, percentatge d'ús).|system.cpu.discovery, system.cpu.num, system.cpu.util|Les claus admeses tenen els mateixos paràmetres que [keys](/manual/config/items/itemtypes /zabbix_agent) de l'agent Zabbix. | |[Docker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/docker/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge de contenidors Docker.|docker.container\_info, docker.container\_stats, docker.containers, docker.containers.discovery,<br>docker.data\_usage, docker.images, docker.images.discovery, docker.info, docker.ping|Veieu també:<br>[Paràmetres de configuració](/manual/appendix/config/zabbix_agent2_plugins/d_plugin)| |Fitxer|Recolliu mètriques de fitxers.|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|Les claus admeses tenen la mateixa configuració que les [keys](/manual/config/items/itemtypes/zabbix_agent) de l'agent Zabbix.| |[Nucli](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/kernel?at=refs%2Fheads%2Frelease%2F6.0)|Suport del nucli.|kernel.maxfiles, kernel.maxproc|Les claus preses tenen suport la mateixa configuració que [keys](/manual/config/items/itemtypes/zabbix_agent) de l'agent Zabbix.| |[Registre](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/log?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge de fitxers de registre.|log, log.count, logrt, logrt.count |Les claus admeses tenen els mateixos paràmetres que [keys](/manual/config/items/itemtypes/zabbix_agent) de l'agent Zabbix.<br><br>Veieu també:<br>Connexió de paràmetres de configuració ([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%2F6.0)|Monitoratge del servidor Memcached.|memcached.ping, memcached.statistics | | |[Modbus](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/modbus/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Llegeix dades de Modbus.|modbus.get|Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [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%2F6.0)|Obté els valors publicats dels temes MQTT.|mqtt.get | | |[MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitorització de MySQL i les seves bifurcacions.|mysql.db.discovery , mysql.db.size, mysql.get\_status\_variables,<br>mysql.ping, mysql.replication.discovery, mysql.replication.get\_slave\_status, mysql.version|Per configurar una connexió xifrada a la base de dades, empreu [sessions anomenades](#named-sessions) i especifiqueu els paràmetres TLS per a la sessió anomenada al fitxer de configuració de l'agent. Actualment, els paràmetres TLS no es poden passar com a paràmetres clau d'element.| |[NetIf](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/net/netif?at=refs%2Fheads%2Frelease%2F6.0)|Monitorització d'interfícies de xarxa.|net.if.collisions, net.if.discovery, net.if.in, net.if.out, net.if.total|Les claus admeses tenen els mateixos paràmetres que [keys](/manual/config/items/itemtypes/zabbix_agent) Agent Zabbix.| |[Oracle](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge de bases de dades Oracle.|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|Instal·la l'[Oracle Instant Client] (https://www.oracle.com/database/technologies/instant-client/downloads.html) abans d'emprar el connector.| |[Proc](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/proc?at=refs%2Fheads%2Frelease%2F6.0)|Percentatge d'ús de la CPU del procés.|proc.cpu.util|Les claus admeses tenen la mateixa configuració que [keys](/manual/config/items/itemtypes /zabbix_agent) de l'agent Zabbix. | |[Redis](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/redis/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge del servidor Redis.|redis.config, redis.info, redis.ping, redis.slowlog.count| | |[Smart](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/smart?at=refs%2Fheads%2Frelease%2F6.0)| Monitorització S.M.A.R.T.|smart.attribute.discovery, smart.disk.discovery, smart.disk.get|La versió mínima necessària de smartctl és la 7.1. <br> Els drets d'accés sudo/root a smartctl són necessaris per a l'usuari que executi l'agent Zabbix 2. El plugin empra només les següents comandes: <br> ``/usr/sbin/smartctl -a *``<br> ``/usr/sbin/smartctl --scan *`` <br> ``/usr/sbin/smartctl -j -V``<br><br> Les [claus](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) admeses només es poden emprar amb l'agent Zabbix 2 a Linux/Windows, tant com a comprovació passiva com activa.<br>Veieu també:<br>[Paràmetres de onfiguració](/manual/appendix/config/zabbix_agent2_plugins/smart_plugin)| |[Swap](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/system/swap?at=refs%2Fheads%2Frelease%2F6.0)|Intercanvi de la mida de l'espai en octets/percentatge.| system.swap.size |Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [keys](/manual/config/items/itemtypes/zabbix_agent).| |SystemRun|Executa l'ordre especificada.|system.run|Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [keys](/manual/config/items/itemtypes/zabbix_agent).<br><br>Veieu també:<br> Paràmetres de configuració del connector ([Unix](/manual/appendix/config/zabbix_agent2)/[Windows](/manual/appendix/config/zabbix_agent2_win))| |Systemd|Monitoratge de serveis de systemd.|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%2F6.0)|Comprovació de la disponibilitat de connexió TCP.|port net.tcp.|Claus admeses tenen la mateixa configuració que l'agent Zabbix [keys](/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%2F6.0)|Monitoratge de la disponibilitat i el rendiment dels serveis UDP.|net.udp.service, net.udp.service.perf|Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [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%2F6.0)|Obtenció d'informació del sistema.|system.hostname, system.sw.arch, system.uname|Les claus admeses tenen la mateixa configuració que l'agent Zabbix [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%2F6.0)|Recuperació d'informació sobre la recopilació de mètriques de temps d'activitat del sistema.|system.uptime|Admet les claus tenen la mateixa configuració que l'agent Zabbix [keys](/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%2F6.0)|Recollida de mètriques VFS.|vfs.dev.discovery, vfs.dev.read, vfs.dev.write|Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [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%2F6.0)|Monitoratge del certificat del lloc web TLS/SSL.|web.certificate.get| | |[Pàgina web](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/web/page?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge de pàgines web.|web.page.get, web.page.perf, web.page.regexp|Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [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%2F6.0)|Recollida de mètriques asíncrones.|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|Les claus admeses tenen els mateixos paràmetres que [keys](/manual/config/items/itemtypes/zabbix_agent) de l'agent Zabbix.| |[ZabbixStats](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/zabbix/stats?at=refs%2Fheads%2Frelease%2F6.0)|Mètrica interna del servidor Zabbix/proxy o nombre d'elements retardats en una cua .|zabbix.stats|Les claus admeses tenen els mateixos paràmetres que l'agent Zabbix [claus](/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%2F6.0)|Recollida de mètriques síncrones.|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 ##### Bulk processing Bulk processing is supported for dependent items. To enable caching and indexing, the *Prometheus pattern* preprocessing must be the **first** preprocessing step. When *Prometheus pattern* is first preprocessing step then the parsed Prometheus data is cached and indexed by the first `<label>==<value>` condition in the *Prometheus pattern* preprocessing step. This cache is reused when processing other dependent items in this batch. For optimal performance, the first label should be the one with most different values. If there is other preprocessing to be done before the first step, it should be moved either to the master item or to a new dependent item which would be used as the master item for the dependent items. ##### Tractament massiu El processament massiu és compatible amb els elements dependents. Per habilitar la memòria cau i la indexació, el preprocessament *Patró Prometheus* ha d'ésser la **primera** passa de preprocessament. Quan el *Patró Prometheus* és la primera passa de preprocessament, les dades de Prometheus analitzades s'emmagatzemen a la memòria cau i s'indexen mitjançant la primera condició `<etiqueta>==<valor>` a la passa de preprocessament del *Patró Prometheus*. Aquesta memòria cau es reutilitza quan es processen altres elements dependents d'aquest lot. Per a un rendiment òptim, la primera etiqueta hauria d'ésser la que tingui més valors diferents. Si s'ha de fer un altre preprocessament abans de la primera passa, s'hauria de moure a l'element principal o a un nou element dependent que s'empraria com a element principal per als elements dependents. ##### Bulk processing Bulk processing is supported for dependent items. To enable caching and indexing, the *Prometheus pattern* preprocessing must be the **first** preprocessing step. When *Prometheus pattern* is first preprocessing step then the parsed Prometheus data is cached and indexed by the first `<label>==<value>` condition in the *Prometheus pattern* preprocessing step. This cache is reused when processing other dependent items in this batch. For optimal performance, the first label should be the one with most different values. If there is other preprocessing to be done before the first step, it should be moved either to the master item or to a new dependent item which would be used as the master item for the dependent items. ##### Tractament massiu El processament massiu és compatible amb els elements dependents. Per habilitar la memòria cau i la indexació, el preprocessament *Patró Prometheus* ha d'ésser la **primera** passa de preprocessament. Quan el *Patró Prometheus* és la primera passa de preprocessament, les dades de Prometheus analitzades s'emmagatzemen a la memòria cau i s'indexen mitjançant la primera condició `<etiqueta>==<valor>` a la passa de preprocessament del *Patró Prometheus*. Aquesta memòria cau es reutilitza quan es processen altres elements dependents d'aquest lot. Per a un rendiment òptim, la primera etiqueta hauria d'ésser la que tingui més valors diferents. Si s'ha de fer un altre preprocessament abans de la primera passa, s'hauria de moure a l'element principal o a un nou element dependent que s'empraria com a element principal per als elements dependents. ##### Bulk processing for Prometheus metrics As bulk processing of dependent items has been introduced in the preprocessing queue for Prometheus metrics, dependent items will no longer be processed in parallel and that may have an affect on how fast they are processed. ##### Processament massiu de mètriques de Prometheus Com que s'ha introduït el processament massiu d'elements dependents a la cua de preprocessament per a mètriques de Prometheus, els elements dependents ja no es processaran en paral·lel, cosa que pot afectar la velocitat a la qual es processen. #### Bulk processing for Prometheus metrics Bulk processing of dependent items has been introduced in the preprocessing queue to improve the performance of retrieving Prometheus metrics. See [Prometheus checks](/manual/config/items/itemtypes/http/prometheus#bulk-processing) for more details. ### Tractament massiu de mètriques Prometheus S'ha introduït el processament massiu d'elements dependents a la cua de preprocessament per millorar el rendiment de la recuperació de mètriques de Prometheus. Consulteu les [comprovacions de Prometheus](/manual/config/items/itemtypes/http/prometheus#bulk-processing) per obtindre més informació. ##### Buttons Buttons to the right offer the following options: | | | |--|--------| ||Go to map constructor to edit the map content.| ||Add map to the favorites widget in the [Dashboard](dashboard).| ||The map is in the favorites widget in the [Dashboard](dashboard). 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. ##### Botons Els botons de la dreta ofereixen les opcions següents: | | | |--|---------| ||Aneu al constructor de mapes per editar el contingut del mapa.| ||Afegiu un mapa als ginys preferits al [Tauler](tauler). | ||El mapa es troba als ginys preferits del [tauler]. Feu clic per esborrar el mapa dels ginys preferits.| Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina [Monitoratge](/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. ##### Botons *Crear equip* crea un [equip nou](/manual/config/hosts/host). Aquest botó només és disponible per a usuaris administradors i superadministradors. Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina [Monitoratge](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons). ##### 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. ##### Botons El botó de la dreta ofereix la següent opció: | | | |--|---------| ||Exporta el contingut de totes les pàgines a un fitxer CSV.| Els botons del mode de visualització, comuns a totes les seccions, es descriuen a la pàgina [Monitoratge](/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. ##### Botons Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina de [monitoratge](/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. ##### Botons Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina de [monitoratge](/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. ##### Botons Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina de [monitoratge](/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. ##### Botons Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina de [monitoratge](/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. ##### Botons Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina de [monitoratge](/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. ##### Botons Els botons del mode de visualització comuns a totes les seccions es descriuen a la pàgina de [monitoratge](/manual/web_interface/frontend_sections/monitoring#view_mode_buttons). By default, the widget displays all enabled hosts with valid geographical coordinates defined in the host configuration. 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) Per defecte, el giny mostra tots els equips activats amb coordenades geogràfiques vàlides definides a la configuració de l'equip. El filtrat de l'equip es pot configurar a la configuració del widget. Els detalls vàlids de l'equip són: - Latitud: -90 a 90 (pot ser un nombre enter o flotant) - Longitud: de -180 a 180 (pot ser un nombre enter o un flotant) #### Cache mode parameter for PostgreSQL plugin New parameters for controlling the cache mode by default or on session name level have been added to the PostgreSQL plugin [configuration](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters): - `Plugins.PostgreSQL.Default.CacheMode` - `Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode` The cache mode parameter may have one of two allowed values: *prepare* (default) or *describe*. Note that "describe" is primarily useful when the environment does not allow prepared statements such as when running a connection pooler like PgBouncer. #### Paràmetre de mode de memòria cau per al connector PostgreSQL S'han afegit nous paràmetres per controlar el mode de memòria cau de manera predeterminada o a nivell de nom de sessió al plugin PostgreSQL [configuració](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters): - `Plugins.PostgreSQL.Default.CacheMode` - `Plugins.PostgreSQL.Sessions.<SessionName>.CacheMode` El paràmetre del mode de memòria cau pot tindre un dels dos valors permesos: *preparar* (predeterminat) o *descriure*. Tingueu en compte que "descriure" és principalment útil quan l'entorn no permet declaracions preparades, com ara quan s'executa un agrupador de connexions com PgBouncer. #### Calculated items Calculated items now support not only numeric, but also **text**, **log**, and **character** types of information. ##### Tipus de dades d'element calculats Els elements calculats ara admeten no només informació numèrica, sinó també informació de **text**, **registre** i tipus de **caràcter**. #### Calculating SLI 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: ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "5", "serviceids": [ 50, 60, 70 ], "periods": 3, "period_from": "1635724800" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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 } ``` #### Càlcul de l'SLI Retorna l'SLI dels serveis amb IDs "50", "60" i "70", vinculats a un SLA amb ID de "5". Retorna la data per 3 períodes a partir de "1635724800" (1er de Novembre de 2021 00:00:00 UTC). Des que el [període de l'informe](/manual/it_services/sla) de l'SLA és mensual, la informació SLI es recupera per als tres mesos següents: -Des de "1635724800" (Nov 01 2021 00:00:00 UTC) fins a "1638316800" (Dec 01 2021 00:00:00 UTC) -Des de "1638316800" (Dec 01 2021 00:00:00 UTC) fins a "1640995200" (Jan 01 2022 00:00:00 UTC) -Des de "1640995200" (Jan 01 2022 00:00:00 UTC) fins a "1643673600" (Feb 01 2022 00:00:00 UTC) Petició: ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "5", "serviceids": [ 50, 60, 70 ], "periods": 3, "period_from": "1635724800" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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 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() functions are used in the expression. [Date and time](/manual/appendix/functions/time) and/or 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). #### Temps de càlcul Un trigger es torna a calcular cada vegada que el servidor Zabbix rep un valor nou que forma part de l'expressió. Quan es rep un valor nou, es torna a calcular cada funció inclosa a l'expressió (no només la que ha rebut el valor nou). A més, un trigger es torna a calcular cada vegada que es rep un valor nou **i** cada 30 segons si s'empren funcions basades en [data i hora](/manual/appendix/functions/time). Les funcions de [data i hora](/manual/appendix/functions/time) es tornen a calcular cada 30 segons pel procés de sincronització de l'historial de Zabbix. Els triggers que fan referència a funcions de tendència **només** s'avaluen una vegada per període més curt de l'expressió. Veieu també [funcions de tendència](/manual/appendix/functions/trends). ::: 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} ::: ::: tarja #### Vídeos instructius Una videoteca amb demostracions, debats i consells per ajudar-vos a aprofitar al màxim Zabbix. [](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} ::: ::: tarja #### Instal·lació Instruccions pas a pas per instal·lar Zabbix a la vostra plataforma preferida, que cobreixen diversos sistemes operatius i configuracions de bases de dades. [](/manual/installation/getting_zabbix){.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/login){.card-link} ::: ::: tarja #### Guies d'inici ràpid Instruccions pràctiques concises i orientades a tasques que us guiaran pels conceptes bàsics, des de les primeres passes de configuració fins a rebre la primera alerta de problema. [](/manual/quickstart/login){.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} ::: ::: tarja #### Requeriments Un llistat de plataformes compatibles i requisits previs de programari per ajudar-vos a preparar el vostre entorn per a una implementació correcta de Zabbix. [](/manual/installation/requirements){.card-link} ::: ::: card #### Zabbix Blog News, tutorials, and case studies curated by the Zabbix team and community contributors. [](https://blog.zabbix.com/){.card-link} ::: ::: tarja #### Blog de Zabbix Notícies, tutorials i casos pràctics triats per l'equip de Zabbix i els col·laboradors de la comunitat. [](https://blog.zabbix.com/){.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} ::: ::: tarja #### Fòrums de Zabbix Un espai per bescanviar ideies, trobar solucions i compartir experiències a tots els nivells d'expertesa de Zabbix. [](https://www.zabbix.com/forum/){.card-link} ::: ### Ceph |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |ceph.df.details\[connString,<user>,<apikey>\]|<|<|<| |Cluster’s data usage and distribution among pools.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.osd.stats\[connString,<user>,<apikey>\]|<|<|<| |Aggregated and per OSD statistics.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.osd.discovery\[connString,<user>,<apikey>\]|<|<|<| |List of discovered OSDs. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.osd.dump\[connString,<user>,<apikey>\]|<|<|<| |Usage thresholds and statuses of OSDs.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.ping\[connString,<user>,<apikey>\]|<|<|<| |Tests whether a connection to Ceph can be established.|0 - connection is broken (if there is any error presented including AUTH and configuration issues)<br><br>1 - connection is successful.|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.pool.discovery\[connString,<user>,<apikey>\]|<|<|<| |List of discovered pools. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | |ceph.status\[connString,<user>,<apikey>\]|<|<|<| |Overall cluster's status.|JSON object|**connString** - URI or session name.<br>**user, apikey** - the user name and API key for connecting to Ceph.| | ### Ceph |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |ceph.df.details \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Ús i distribució de dades de clúster entre grups.|Objecte JSON|**connString** - URI o nom de sessió.<br>**nom d'usuari, mot de pas** - credencials d'inici de sessió Ceph.| | |ceph.osd.stats \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Estadístiques afegides i per OSD.|objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió Ceph.| | |ceph.osd.discovery \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Llista d'OSD descoberts. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - Connexió de credencials Ceph.| | |ceph.osd.dump \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Llindars i estats d'ús de l'OSD.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió Ceph.| | |ceph.ping \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Prova si es pot establir una connexió amb Ceph.|0 - la connexió s'avorta (si hi ha errors, inclosos problemes d'autenticació i configuració)<br>1 - la connexió és correcta.|**connString ** - URI o nom de sessió. <br>**usuari, mot de pas** - credencials d'inici de sessió Ceph.| | |ceph.pool.discovery \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Llista de pools descobertes. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - Connexió de credencials Ceph.| | |ceph.status \[connString, \<usuari\>, \<apikey\>\]|<|<|<| |Estat del clúster global.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió Ceph.| | #### 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#create-user-account) by setting appropriate access rights.| |*TLSServerCertIssuer*|no|Allowed server certificate issuer.| |*TLSServerCertSubject*|no|Allowed server certificate subject.| #### Paràmetres de configuració del certificat |Paràmetre|Obligatori|Descripció| |--|-|--------| |*TLSCAFile*|sí|Camí complet a un fitxer que conté els certificats de nivell superior de CA per a la verificació de certificats entre iguals.<br>En cas d'una cadena de certificats amb diversos membres, s'han d'ordenar: primer els certificats de CA de nivell inferior, seguits de certificats de nivell superior.<br>Els certificats de diverses CA es poden incloure en un sol fitxer.| |*TLSCRLFile*|no|Camí complet a un fitxer que conté llistes de revocació de certificats. Veieu [Llistes de revocació de certificats (CRL)](/manual/encryption/using_certificates#certificate_revocation_lists_crl).| |*TLSCertFile*|yes|Camí complet d'un fitxer que conté un certificat (cadena de certificats).<br>En el cas d'una cadena de certificats amb diversos membres, s'han d'ordenar: primer certificat de servidor, certificat de proxy o agent, seguit de certificats d'inferior nivell i després certificats de CA de nivell superior.| |*TLSKeyFile*|yes|Camí complet d'un fitxer que conté una clau privada. Estableix els drets d'accés a aquest fitxer: només hauria de ser llegible per l'usuari de Zabbix.| |*TLSServerCertIssuer*|no|Emissor del certificat del servidor es permet.| |*TLSServerCertSubject*|no|Titular autoritzat del certificat del servidor.| #### 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`. ::: #### Llistes de revocació de certificats (CRL) Si un certificat és compromès, l'autoritat de certificació pot revocar-lo incloent-lo a la llista de revocació de certificats. Els CRL es poden configurar al fitxer de configuració del servidor, el proxy i l'agent mitjançant el paràmetre `TLSCRLFile`. Per exemple: TLSCRLFile=/home/zabbix/zabbix_crl_file on `zabbix_crl_file` pot contindre llistes de revocació de certificats de diverses autoritats de certificació i assemblar-se a: -----BEGIN X509 CRL----- MIIB/DCB5QIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixkARkWA2Nv ... treZeUPjb7LSmZ3K2hpbZN7SoOZcAoHQ3GWd9npuctg= -----END X509 CRL----- -----BEGIN X509 CRL----- MIIB+TCB4gIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQBGRYDY29t ... CAEebS2CND3ShBedZ8YSil59O6JvaDP61lR5lNs= -----END X509 CRL----- El fitxer CRL només es carrega a l'inici de Zabbix. L'actualització de la llista de revocació de certificats requereix un reinici. ::: noteimportant Si el component Zabbix es compila amb *OpenSSL* i s'empren llistes de revocació de certificats, cada CA de nivell superior i mitjà de les cadenes de certificats ha de tindre una llista de revocació de certificats (pot ésser buida) a "TLSCRLFile". ::: #### Change count A new [history function](/manual/appendix/functions/history) **changecount()** has been added allowing to count the number of changes between adjacent values. The function supports three different modes for counting all changes, only decreases, or only increases. As an example, it can be used to track changes in the number of users or the number of system uptime decreases. ##### Recompte de canvis S'ha afegit una nova [funció d'historial](/manual/appendix/functions/history) **changecount()** per comptar el nombre de canvis entre valors adjacents. La funció admet tres modes diferents per comptar tots els canvis, només les disminucions o només els augments. Per exemple, es pot emprar per fer un seguiment dels canvis en el nombre d'usuaris o la disminució de la disponibilitat del sistema. #### Change dashboard owner Available only for admins and super admins. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### Canviar el propietari del tauler Disponible només per a admins i super admins. Petició: ```json { "jsonrpc": "2.0", "method": "dashboard.update", "params": { "dashboardid": "2", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 2 } ``` #### Change hosts monitored by a proxy Update the proxy to monitor the two given hosts. Request: ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "hosts": [ { "hostid": "10294" }, { "hostid": "10295" }, ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### Canviar els equips monitorats per un proxy Actualitzar el proxy per monitorar dos equips donats. Petició: ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "hosts": [ { "hostid": "10294" }, { "hostid": "10295" }, ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` ##### Change indicator The following parameters are supported if *Advanced configuration* is set to "Enabled", and *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).| ##### Indicador de canvi Els paràmetres següents s'admeten si la *Configuració avançada* és establerta a "Habilitada" i *Veure* és establert a "Indicador de canvi". |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Indicador de canvi ↑ color*|1|up_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Indicador de canvi ↓ color*|1|down_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Indicador de canvi ↕ color*|1|updown_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| #### Change map owner Available only for admins and super admins. Request: ```json { "jsonrpc": "2.0", "method": "map.update", "params": { "sysmapid": "9", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 2 } ``` #### Canviar el propietari d'un mapa Disponible només per a administradors i superadministradors. Petició: ```json { "jsonrpc": "2.0", "method": "map.update", "params": { "sysmapid": "9", "userid": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 2 } ``` #### Change proxy status Change the proxy to an active proxy and rename it to "Active proxy". Request: ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "host": "Active proxy", "status": "5" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### Canviar l'estat del proxy Canviar el proxy com a proxy actiu i reanomenar-lo com a "Active proxy". Petició: ```json { "jsonrpc": "2.0", "method": "proxy.update", "params": { "proxyid": "10293", "host": "Active proxy", "status": "5" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10293" ] }, "id": 1 } ``` #### Change script command Change the command of the script to "/bin/ping -c 10 {HOST.CONN} 2>&1". Request: ```json { "jsonrpc": "2.0", "method": "script.update", "params": { "scriptid": "1", "command": "/bin/ping -c 10 {HOST.CONN} 2>&1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "1" ] }, "id": 1 } ``` #### Canviar la comanda d'un script Canviar la comanda d'un script a "/bin/ping -c 10 {HOST.CONN} 2>&1". Petició: ```json { "jsonrpc": "2.0", "method": "script.update", "params": { "scriptid": "1", "command": "/bin/ping -c 10 {HOST.CONN} 2>&1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "1" ] }, "id": 1 } ``` #### CHANGES IN 6.0.0 #### CANVIS A 6.0.0 #### CHANGES IN 6.0.13 New templates are available: - AWS EC2 by HTTP - AWS by HTTP - AWS RDS instance by HTTP - AWS S3 bucket by HTTP - Azure by HTTP - Control-M server by HTTP - Control-M enterprise manager by HTTP - Veeam Backup Enterprise Manager by HTTP - Veeam Backup and Replication by HTTP See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). #### CANVIS A LA VERSIÓ 6.0.13 Hi ha disponibles noves plantilles: - AWS EC2 per HTTP - AWS per HTTP - AWS RDS instance per HTTP - AWS S3 bucket per HTTP - Azure by HTTP - Control-M server per HTTP - Control-M enterprise manager per HTTP - Veeam Backup Enterprise Manager per HTTP - Veeam Backup and Replication per HTTP Veieu les instruccions setup instructions de les [plantilles HTTP](/manual/config/templates_out_of_the_box/http). #### CHANGES IN 6.0.18 #### CANVIS A 6.0.18 #### CHANGES IN 6.0.20 New templates are available: - [AWS ECS Cluster by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_http?at=refs%2Fheads%2Frelease%2F6.0) (along with its [Serverless Cluster version](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_serverless_http?at=refs%2Fheads%2Frelease%2F6.0)) - [Cisco SD-WAN by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http?at=refs%2Fheads%2Frelease%2F6.0) - [OpenStack by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack?at=refs%2Fheads%2Frelease%2F6.0), which includes *OpenStack Nova by HTTP* template for monitoring OpenStack Nova service - [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc?at=refs%2Fheads%2Frelease%2F6.0) #### CANVIS A 6.0.20 Hi ha noves plantilles disponibles: - [AWS ECS Cluster per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_http?at=refs%2Fheads%2Frelease%2F6.0) (conjuntament amb la seva [versió Serverless Cluster](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_ecs_serverless_http?at=refs%2Fheads%2Frelease%2F6.0)) - [Cisco SD-WAN per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/cisco/cisco_sdwan_http?at=refs%2Fheads%2Frelease%2F6.0) - [OpenStack per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/openstack?at=refs%2Fheads%2Frelease%2F6.0), que inclou la plantilla *OpenStack Nova per HTTP* per monitar el servei OpenStack Nova - [PostgreSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.21 New template is available: - [AWS Cost Explorer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_cost_http?at=release%2F6.0) #### CANVIS A 6.0.21 La nova plantilla és disponible: - [AWS Cost Explorer per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_cost_http?at=release%2F6.0) #### CHANGES IN 6.0.22 New templates are available: - [Acronis Cyber Protect Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad?at=refs%2Fheads%2Frelease%2F6.0) - [MantisBT by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt?at=refs%2Fheads%2Frelease%2F6.0) #### CANVIS A 6.0.22 Hi ha disponibles noves plantilles: -[Acronis Cyber Protect Cloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/acronis?at=refs%2Fheads%2Frelease%2F6.0) - [HashiCorp Nomad by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nomad?at=refs%2Fheads%2Frelease%2F6.0) - [MantisBT per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/mantisbt?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.23 **New templates** New templates are available: - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) #### CANVIS A 6.0.23 **Plantilles noves** Hi ha noves plantilles disponibles: - [FortiGate per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Netxtcloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) #### CHANGES IN 6.0.24 **New templates** New template is available: - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) **Updated templates** Integration with OpenShift has been added to [Kubernetes cluster state by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http?at=refs%2Fheads%2Frelease%2F6.0) template. #### CANVIS A 6.0.24 **Noves plantilles** Noves plantilles disponibles: - [HPE iLO per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) **Plantilles actualitzades** S'ha afegit la integració amb OpenShift a la plantilla [estat del clúster de Kubernetes per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kubernetes_http/kubernetes_state_http?at=refs%2Fheads%2Frelease%2F6.0). #### CHANGES IN 6.0.26 **New templates** The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure Cost Management by HTTP template. **Updated templates** [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0) template has been updated for working with AlwaysOn features such as Failover Cluster Instances (FCI) and Availability Groups (AG). It is now possible to use the template for monitoring a host in cluster, standalone host and host by cluster name. A macro for instance name is no longer used; when the master is switched, it is not required to change any macros: - new LLD rules and metrics for quorum and quorum members have been added; - the type of the LLD rules has been changed from “Database monitor” to “Dependent item”; - items with `db.odbc.discovery` key have been turned into items dependent on the `db.odbc.get` item - new item has been added - MSSQL DB '{#DBNAME}': Recovery model, which returns the database recovery model under the database discovery; - new macros, namely, {$MSSQL.BACKUP_FULL.USED}, {$MSSQL.BACKUP_DIFF.USED}, {$MSSQL.BACKUP_LOG.USED}, have been added - those can be used for disabling backup age triggers for a certain database. #### CANVIS A la versió 6.0.26 **Plantilles actualitzades** La plantilla [MSSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0) s'ha actualitat per funcionar amb funcions l'AlwaysOn, com ara Failover Cluster Instances (FCI) i Grups de Disponibilitat (AG). Ara és possible emprar la plantilla per monitorar un equip en clúster, equip autònom o equip per nom de clúster. Una macro com a nom d'instància ja no s'empra; quan es canvia el màster, no cal canviar cap macro: - afegides noves regles de LLD de quòrum i per a la descoberta de membres de quòrum; - canviades el tipus de regles LLD, de "Monitoratge de base de dades" a "Element dependent"; - els elements amb clau `db.odbc.discovery` s'han convertit a elements dependents de l'element `db.odbc.get`; - afegit un nou element - MSSQL DB '{#DBNAME}': model de recuperació, que retorna el model de recuperació de la base de dades sota la descoberta de la base de dades; - afegides noves macros, anomenades, {$MSSQL.BACKUP_FULL.USED}, {$MSSQL.BACKUP_DIFF.USED}, {$MSSQL.BACKUP_LOG.USED}; es poden emprar per desactivar els triggers d'edat de còpia de seguretat per a una determinada base de dades. #### CHANGES IN 6.0.27 **New templates** A new template is available: - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), which includes the *YugabyteDB Cluster by HTTP* template for monitoring each YugabyteDB cluster. #### CANVIS A LA VERSIÓ 6.0.27 **Plantilles noves** Hi ha disponible una nova plantilla: - [YugabyteDB per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), que inclou la *Plantilla YugabyteDB Cluster per HTTP* per monitorar cada clúster YugabyteDB. #### CHANGES IN 6.0.28 **New templates** New templates are available: - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) #### CANVIS A 6.0.28 **Plantilles noves** Hi ha noves plantilles disponibles: - [AWS ELB Application Load Balancer per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL per agent 2 de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) **Plantilles actualitzades** - La plantilla [FortiGate per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb mètriques sobre VPN, alta disponibilitat (HA), punts de terminació sense fil (WTP), comprovacions d'estat SD-WAN i sensors HW. #### CHANGES IN 6.0.29 **New templates** A new template is available: - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), a master template that discovers various Oracle Cloud Infrastructure (OCI) services and resources. **Updated templates** - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) template has been supplemented with metrics regarding VPN, high availability (HA), wireless termination points (WTPs), SD-WAN health checks, and HW sensors. - [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) template has been supplemented with the items "MySQL: Get database" and "MySQL: Get replication". The LLD rules "Database discovery" and "Replication discovery" have been changed to the "Dependent item" type. - [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) template has been supplemented with the items "Oracle: Get archive log", "Oracle: Get ASM disk groups", "Oracle: Get database", "Oracle: Get PDB", and "Oracle: Get tablespace". The LLD rules "Archive log discovery", "ASM disk groups discovery", "Database discovery", "PDB discovery", and "Tablespace discovery" have been changed to the "Dependent item" type. - The VMware Hypervisor template within the [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.0) and [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=release%2F6.0) template sets has been supplemented with a new LLD rule, "Sensor discovery". #### CANVIS A LA 6.0.29 **Plantilles noves** Hi ha una nova plantilla: - [Oracle Cloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), una plantilla mestra de descoberta de diversos serveis i recursos d'Oracle Cloud Infrastructure (OCI). **Plantilles actualitzades** - La plantilla [FortiGate per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb mètriques sobre VPN, alta disponibilitat (HA), punts de terminació sense fil (WTP), comprovacions d'estat SD-WAN i sensors HW. - La plantilla [MySQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb els elements "MySQL: Get database" i "MySQL: Get replication". Les regles LLD "Database discovery" i "Replication discovery" han canviat a tipus "Element dependent". - La plantilla [Oracle per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb els elements "Oracle: Get archive log", "Oracle: Get ASM disk groups", "Oracle: Get database", "Oracle: Get PDB", i "Oracle: Get tablespace". Les regles LLD "Archive log discovery", "ASM disk groups discovery", "Database discovery", "PDB discovery", i "Tablespace discovery" han canviat a tipus "Element dependent". - La plantilla de VMware Hypervisor continguda a les plantilles [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware?at=refs%2Fheads%2Frelease%2F6.0) i [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn?at=release%2F6.0) s'ha complementat amb la nova regla LLD "Descoberta de sensors". #### CHANGES IN 6.0.2 The template *Generic Java JMX* now contains two discovery rules: - Garbage collector discovery - Memory pool discovery #### CANVIS A LA VERSIÓ 6.0.2 La plantilla *Generic Java JMX* ara té dues regles de descoberta: - Descoberta d'escombraries - Descoberta de l'agrupació de memòria #### CHANGES IN 6.0.30 **New templates** The AWS ELB template set has been supplemented with the template [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0). **Updated templates** The [OS templates](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os?at=refs%2Fheads%2Frelease%2F6.0) (agent, SNMP, and Prometheus-based) have been given a mounted filesystem update. In mounted filesystem discovery, the "Space is low" and "Space is critically low" triggers no longer have the absolute threshold and burst condition. #### CANVIS A 6.0.30 **Plantilles noves** La plantilla ELB d'AWS s'ha complementat amb la plantilla [AWS ELB Network Load Balancer per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0). **Plantilles actualitzades** Les [plantilles del sistema operatiu](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/os?at=refs%2Fheads%2Frelease%2F6.0) (agent, SNMP i basades en Prometheus) han rebut una actualització del sistema de fitxers. A la descoberta del sistema de fitxers muntat, els triggers "Espai en disc baix" i "Espai en disc críticament baix" ja no tenen el llindar absolut i la condició d'explosió. #### CHANGES IN 6.0.31 **New templates** A new template is available: - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Jira Data Center health. #### CANVIS A 6.0.31 **Plantilles noves** Hi ha disponible una nova plantilla: - [Jira Data Center per JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar l'estat de salut de Jira Data Center. #### CHANGES IN 6.0.32 **New templates** A new template is available: The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure VM Scale Set by HTTP template. **Updated templates** The templates [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0), [Remote Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server_remote?at=refs%2Fheads%2Frelease%2F6.0), [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0), and [Remote Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy_remote?at=refs%2Fheads%2Frelease%2F6.0) have been updated for improved data visualization in item graphs by regrouping the displayed metrics. #### CANVIS A 6.0.32 **Plantilles noves** Hi ha disponible una nova plantilla: El conjunt de plantilles [Azure per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) ha estat complementat amb la plantilla Azure VM Scale Set per HTTP. **Plantilles actualitzades** Les plantilles [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0), [Remote Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server_remote?at=refs%2Fheads%2Frelease%2F6.0), [estat del proxy Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) i [estat del proxy Zabbix remot](https:// git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy_remote?at=refs%2Fheads%2Frelease%2F6.0) s'han actualitzat per millorar la visualització de dades als gràfics d'elements reagrupant les mètriques mostrades. #### CHANGES IN 6.0.33 **New templates** A new template is available: - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring AWS Lambda metrics. #### CANVIS A 6.0.33 **Plantilles noves** Hi ha disponible una nova plantilla: - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http/README.md?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar mètriques de Lambda AWS. #### CHANGES IN 6.0.34 **New templates** New templates are available: - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring GitHub repositories. - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Microsoft 365 services. #### CANVIS A 6.0.34 **Plantilles noves** Hi ha disponible una nova plantilla: - [GitHub repository per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar l'estat de salut dels repositoris de GitHub. - [Microsoft 365 reports per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar els serveis de Microsoft 365. #### CHANGES IN 6.0.35 **New templates** A new template is available: - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp/README.md?at=release%2F6.0), a template for monitoring SAN Huawei OceanStor V6. **Updated templates** - In all [APC templates](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/power/apc?at=refs%2Fheads%2Frelease%2F6.0), the discovery rule for external defective battery packs has been supplemented with a filter to avoid creating unsupported items. - In the templates [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) and [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0), a timeout has been added and certain item keys have been adjusted to increase monitoring stability. #### CANVIS A 6.0.35 **Plantilles noves** Hi ha una nova plantilla disponible: - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp/README.md?at=release%2F6.0), a template for monitoring SAN Huawei OceanStor V6. **Plantilles actualitzades** - A totes les [plantilles APC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/power/apc?at=refs%2Fheads%2Frelease%2F6.0), la regla de descoberta per als paquets de bateries defectuosos externs s'ha complementat amb un filtre per evitar la creació d'elements no compatibles. - A les plantilles [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) i [MSSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0), s'hi ha afegit un temps d'espera i certes tecles d'element s'han ajustat per augmentar l'estabilitat del monitoratge. #### CHANGES IN 6.0.36 **New templates** A new template is available: - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=release%2F6.0), a template set that also includes the templates *Nutanix Cluster Prism Element by HTTP* and *Nutanix Host Prism Element by HTTP*. **Updated templates** - The template *VMware Hypervisor* within the [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware/README.md?at=release%2F6.0) and [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn/README.md?at=release%2F6.0) template sets has been updated with the option to be used as a standalone template. - [Proxmox VE by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) has been updated with new items and trigger prototypes for disk space usage in LXC containers. - In the template [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0), the performance counter query has been updated to improve data retrieval. Both *MSSQL by ODBC* and [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) template documentation has been reviewed and updated. #### CANVIS A 6.0.36 **Plantilles noves** Hi ha disponible una nova plantilla: - [Nutanix Prism Element per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=release%2F6.0), una plantilla conjunt que també inclou les plantilles *Nutanix Cluster Prism Element per HTTP* i *Nutanix Host Prism Element per HTTP*. **Plantilles actualitzades** - La plantilla *VMware Hypervisor* dins de [VMware](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware/README.md?at=release%2F6.0) i [VMware FQDN](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/vmware_fqdn/README.md?at=release%2F6.0) s'han actualitzat amb l'opció per emprar-la com a plantilla independent. - La plantilla [Proxmox VE per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/proxmox/README.md?at=refs%2Fheads%2Frelease%2F6.0) s'ha actualitzat amb nous elements i prototips de triggers per a l'ús d'espai en disc als contenidors LXC. - A la plantilla [MSSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0), la consulta del comptador de rendiment s'ha actualitzat per millorar la recuperació d'informació. La documentació de les plantilles *MSSQL per ODBC* i [MSSQL per Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) s'ha revisat i actualitzat. #### CHANGES IN 6.0.39 **New templates** A new template is available: - The [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) template set has been supplemented with the template *Azure SQL Managed Instance by HTTP*. **Updated templates** - All [Dell HTTP and SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell?at=refs%2Fheads%2Frelease%2F6.0) templates have been updated with improvements, including fixes for items, macros, and scripts. - The templates [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0) and [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) have been updated with filters to include or exclude discovered quorum members by name as well as a service filter that allows filtering by cluster name to exclude empty clusters. Please see [Breaking changes](/manual/installation/upgrade_notes_6039#mssql-zabbix-agent-2-plugin-update) for additional information on *MSSQL by Zabbix agent 2*. #### CANVIS A 6.0.39 **Plantilles noves** Hi ha una plantilla nova: - El conjunt de plantilles [Azure per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) ha estat complementat amb la plantilla *Azure SQL Managed Instance per HTTP*. **Plantilles actualitzades** - Totes les plantilles [Dell HTTP i SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/dell?at=refs%2Fheads%2Frelease%2F6.0) s'han actualitzat amb millores, incloent correccions d'elements, macros i scripts. - Les plantilles [MSSQL per ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc?at=refs%2Fheads%2Frelease%2F6.0) i [MSSQL per l'agent Zabbix 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) s'han actualitzat amb filtres per incloure o excloure membres de quòrum trobats pel nom que permeti excloure un servei de filtre per clúster de clúster per nom. Veieu [Canvis importants](/manual/installation/upgrade_notes_6039#mssql-zabbix-agent-2-plugin-update) per obtindre informació addicional sobre *MSSQL de l'agent Zabbix 2*. #### CHANGES IN 6.0.3 A new template *OpenWeatherMap by HTTP* is available. The following changes have been made in the existing templates: - In the templates *Windows services by Zabbix agent*, *Windows services by Zabbix agent active*, *Windows by Zabbix agent*, *Windows by Zabbix agent active* {$SERVICE.NAME.NOT_MATCHES} macro value has been updated to filter out an extended list of services. - The template *PostgreSQL by Zabbix agent 2* now will check the number of slow queries and generate a problem if the amount exceeds a threshold. #### CANVIS A LA VERSIÓ 6.0.3 Hi ha disponible una nova plantilla *OpenWeatherMap per HTTP*. S'han fet els canvis següents a les plantilles existents: - A les plantilles *Serveis de Windows per l'agent Zabbix*, *Serveis de Windows per l'agent Zabbix actiu*, *Agent Zabbix de Windows*, *El valor de la macro de Windows per Zabbix actiu* s'ha actualitzat per filtrar un valor de macro {$SERVICE.NAME.NOT_MATCHES} de serveis. - La plantilla *PostgreSQL by Zabbix agent 2* ara comprovarà el nombre de consultes lentes i generarà un problema si el nombre supera un llindar. #### CHANGES IN 6.0.40 **New templates** A new template is available: - The template set [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0) has been supplemented with the templates *Zabbix server health by Zabbix agent*, *Zabbix server health by Zabbix agent active*, and [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) - with *Zabbix proxy health by Zabbix agent* and *Zabbix proxy health by Zabbix agent active*, enabling the monitoring of internal Zabbix metrics via Zabbix agent. #### CANVIS A 6.0.40 **Plantilles noves** Hi ha disponible una nova plantilla: - El conjunt de plantilles [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb les plantilles *Zabbix server health per l'agent Zabbix* i *Zabbix server health per l'agent Zabbix actiu*, i [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) - amb *Zabbix proxy health per l'agent Zabbix* i *Zabbix proxy health per l'agent de Zabbix actiu*, activant el monitoratge de mètriques internes de de Zabbix mitjançant l'agent Zabbix. #### CHANGES IN 6.0.4 New templates are available: - *TrueNAS SNMP* - monitoring of TrueNAS storage OS by SNMP - *Proxmox VE by HTTP* - see setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http) The templates *SMART by Zabbix agent 2* and *SMART by Zabbix agent 2 (active)* have been updated: - the *Attribute discovery* LLD rule has been deleted, whereas the *Disk discovery* LLD rule will now discover disks based on the pre-defined vendor-specific set of attributes; - **smart.disk.get** item can now return information about a specific disk only, instead of all disks. New macros allowing to define warning and critical thresholds of the filesystem utilization for virtual file system monitoring have been added to the templates *HOST-RESOURCES-MIB storage SNMP*, *Linux by Prom*, *Linux filesystems SNMP*, *Linux filesystems by Zabbix agent active*, *Linux filesystems by Zabbix agent*, *Mellanox SNMP*, *PFSense SNMP*, *Windows filesystems by Zabbix agent active*, *Windows filesystems by Zabbix agent*. Filesystem utilization triggers have been updated to use these macros. #### CANVIS A LA VERSIÓ 6.0.4 Noves plantilles disponibles: - *TrueNAS SNMP*: monitoratge del sistema operatiu d'emmagatzematge TrueNAS per SNMP - *Proxmox VE per HTTP*: consulteu les instruccions de configuració per a [plantilles HTTP](/manual/config/templates_out_of_the_box/http) S'han actualitzat les plantilles *SMART de Zabbix agent 2* i *SMART de Zabbix agent 2 (actiu)*: - S'ha esborrat la regla LLD *Descoberta d'atributs*, mentre que la regla LLD *Descoberta de discs* ara descobrirà discs basats en el conjunt d'atributs específics del proveïdor predefinit; - L'element **smart.disk.get** ara només pot retornar informació sobre un disc específic, en lloc de tots els discs. S'han afegit a les plantilles noves macros que permeten definir avisos i llindars crítics de l'ús del sistema de fitxers per al monitoratge del sistema de fitxers virtual. *HOST-RECURSOS-MIB d'emmagatzematge SNMP*, *Linux per Prom*, *Sistema de fitxers Linux SNMP*, *Els sistemes de fitxers Linux de l'agent Zabbix actius*, *Sistemes de fitxers Linux per agent Zabbix *, *Mellanox SNMP*, *PFSense SNMP*, *Els sistemes de fitxers de Windows per l'agent Zabbix actius*, *Sistemes de fitxers de Windows per l'agent Zabbix*. Els triggers d'ús del sistema de fitxers s'han actualitzat per emprar aquestes macros. #### CHANGES IN 6.0.5 New templates are available: - CockroachDB by HTTP - Envoy Proxy by HTTP - HashiCorp Consul Cluster by HTTP - HashiCorp Consul Node by HTTP See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). #### CANVIS A LA VERSIÓ 6.0.5 Hi ha disponibles noves plantilles: - CockroachDB per HTTP - Envoy Proxy per HTTP - HashiCorp Consul Cluster per HTTP - HashiCorp Consul Node per HTTP Veieu les instruccions de configuració dels [models HTTP](/manual/config/templates_out_of_the_box/http). #### CHANGES IN 6.0.6 New templates are available: - HPE MSA 2040 Storage by HTTP - HPE MSA 2060 Storage by HTTP - HPE Primera by HTTP See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). #### CANVIS A LA VERSIÓ 6.0.6 Noves plantilles són disponibles: - HPE MSA 2040 Storage per HTTP - HPE MSA 2060 Storage per HTTP - HPE Primera per HTTP Veieu les instruccions de configuració dels [models HTTP](/manual/config/templates_out_of_the_box/http). #### CHANGES IN 6.0.7 A new [template](/manual/config/templates_out_of_the_box/http) *HPE Synergy by HTTP* is available. The templates *HashiCorp Consul Node by HTTP* and *HashiCorp Consul Cluster by HTTP* now support Consul namespaces. #### CANVIS A LA VERSIÓ 6.0.7 Hi ha disponible una nova [plantilla](/manual/config/templates_out_of_the_box/http) *HPE Synergy by HTTP*. Les plantilles *HashiCorp Consul Node per HTTP* i *HashiCorp Consul Cluster per HTTP* ara admeten Consul namespaces. #### CHANGES IN 6.0.8 A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/opnsense_snmp?at=refs%2Fheads%2Frelease%2F6.0) *OPNsense by SNMP* is available. #### CANVIS A LA VERSIÓ 6.0.8 Hi ha una nova [plantilla](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/opnsense_snmp?at=refs%2Fheads%2Frelease%2F6.0) disponible: *OPNsense per SNMP*. ##### Changes in templates - The {\#FSLABEL} macro has been added to the corresponding item names and descriptions in *Windows by Zabbix agent* and *Windows by Zabbix agent active* templates - The vfs.file.cksum\[/etc/passwd\] agent item has been changed to vfs.file.cksum\[/etc/passwd,sha256\] - A new check zabbix\[process,odbc poller,avg,busy\] has been added to *Zabbix server*, *Zabbix proxy*, *Remote Zabbix server* and *Remote Zabbix proxy* templates. The metric is used for monitoring the average time for which ODBC processes have been busy during the last minute (in percentage). ##### Modificació de les plantilles - S'ha afegit la macro {\#FSLABEL} als noms i descripcions dels elements corresponents a les plantilles *Agent Zabbix de Windows* i *Agent actiu Zabbix de Windows* - L'element de l'agent vfs.file.cksum\[/etc/passwd\] ha canviat a vfs.file.cksum\[/etc/passwd,sha256\] - S'ha afegit una nova comprovació zabbix\[procés, odbc poller,avg,busy\] a les plantilles *Servidor Zabbix*, *Proxy Zabbix*, *Servidor Zabbix remot* i *Proxy Zabbix remot*. La mètrica s'empra per controlar el temps mitjà que els processos ODBC han estat ocupats durant el darrer minut (en percentatge). #### Changes to AlmaLinux 8 configuration The appliance is based on AlmaLinux 8. There are some changes applied to the base AlmaLinux configuration. #### Canvis de configuració d'AlmaLinux 8 L'aplicació es basa en AlmaLinux 8. algunes modificacions s'han aplicat a la configuració base d'AlmaLinux. ##### Changes to Zabbix configuration - Frontend timezone is set to Europe/Riga (this can be modified in **/etc/php-fpm.d/zabbix.conf**); ##### Modificacions de la configuració de Zabbix - El fus horari de la interfície Web és definida a Europe/Riga (pot modificar-se a **/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: ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Canviar el rang IP d'una regla de descoberta Canvia el rang IP de la regla de descoberta cap a "192.168.2.1-255". Petició: ```json { "jsonrpc": "2.0", "method": "drule.update", "params": { "druleid": "6", "iprange": "192.168.2.1-255" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Changing a host interface port Change the port of a host interface. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` #### Canviar un port d'una interfície d'equip Canviar un port d'una interfície d'equip. Petició: ```json { "jsonrpc": "2.0", "method": "hostinterface.update", "params": { "interfaceid": "30048", "port": "30050" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30048" ] }, "id": 1 } ``` ##### Changing dependency for inherited triggers disabled The possibility to change dependencies for triggers inherited from a template is now disabled. The reason is that upon updating the dependencies of a template trigger, the dependencies of inherited triggers are overwritten. Thus it is more reliable always to set trigger dependencies only on the root template level. ##### S'ha desactivat el canvi de dependència dels triggers heretats La possibilitat d'editar les dependències dels triggers heretats d'una plantilla ara és desactivada. El motiu és que quan s'actualitzen les dependències d'un model de trigger, es sobreescriuen les dependències dels triggers heretats. Per tant, sempre és més fiable definir dependències del trigger només a nivell del model arrel. #### Changing event's severity Change severity for multiple events and leave a message. Request: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### Canviar la gravetat d'un esdeveniment Canviar la gravetat de múltiples esdeveniments i afegir-hi un missatge. Petició: ```json { "jsonrpc": "2.0", "method": "event.acknowledge", "params": { "eventids": ["20427", "20428"], "action": 12, "message": "Maintenance required to fix it.", "severity": 4 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "eventids": [ "20427", "20428" ] }, "id": 1 } ``` #### Changing mappings for one value map. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Canviar les correspondències per un mapa de valors. Petició: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "mappings": [ { "type": "0", "value": "0", "newvalue": "Online" }, { "type": "0", "value": "1", "newvalue": "Offline" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Changing proxy setting The hosts discovered by different proxies are always treated as different hosts. While this allows to perform discovery on matching IP ranges used by different subnets, changing proxy for an already monitored subnet is complicated because the proxy changes must be also applied to all discovered hosts. 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 5. enable discovery rule #### Modificació dels paràmetres de proxy Els equips descoberts per diferents proxys sempre es tracten com a equips diferents. Tot i que això permet descobrir els intervals d'adreces IP coincidents emprats per diferents subxarxes, canviar el proxy d'una subxarxa ja monitorada és complicat perquè els canvis de proxy també s'han d'aplicar a tots els equips descoberts. Per exemple, aquí teniu les passes per anul·lar el proxy en una regla de descoberta: 1. desactiveu la regla de descoberta 2. sincronitzeu la configuració del proxy 3. substituïu el proxy a la regla de descoberta 4. substituïu el proxy per a tots els equips descoberts per aquesta regla 5. habiliteu la regla de descoberta #### 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: ```json { "jsonrpc": "2.0", "method": "service.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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### Canviar el temps d'aturada exclosos per un SLA Afegir un temps d'aturada d'actualització de la RAM programat de 4 hores el 6 d'Abril de 2022, tot i conservant (s'ha de definir de nou) una actualització del programari existent previst per al 4 de Juliol per l'SLA amb ID "5". Petició: ```json { "jsonrpc": "2.0", "method": "service.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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27428" ] }, "id": 1 } ``` #### Canviar la interfície d'un prototip d'element Canviar la interfície d'equip que s'emprarà per als elements descoberts. Petició: ```json { "jsonrpc": "2.0", "method": "itemprototype.update", "params": { "itemid": "27428", "interfaceid": "132" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "schedule": [] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "5" ] }, "id": 1 } ``` #### Canviar la planificació d'un SLA Canviar l'SLA amb ID "5" cap a una programació 24x7. Petició: ```json { "jsonrpc": "2.0", "method": "service.update", "params": { "slaid": "5", "schedule": [] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "439" ] }, "id": 1 } ``` #### Canviar la mida d'un prototip de gràfic Canviar la mida d'un prototip de gràfic de 1100 a 400 píxels. Petició: ```json { "jsonrpc": "2.0", "method": "graphprototype.update", "params": { "graphid": "439", "width": 1100, "height": 400 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### Canviar les propietats de la plantilla estàndard Canvi del nom tècnic de la plantilla a "Linux by Zabbix agent Custom", el nom visible a "My template" i actualització la descripció de la plantilla. Petició: ```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." }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "1" ] }, "id": 1 } ``` #### Canviar el valor d'una macro global Estableix el valor de la macro global a "public". Petició: ```json { "jsonrpc": "2.0", "method": "usermacro.updateglobal", "params": { "globalmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "1" ] }, "id": 1 } ``` #### canvia el valor d'una macro d'equip Estableix el valor d'una macro d'equip a "public". Petició: ```json { "jsonrpc": "2.0", "method": "usermacro.update", "params": { "hostmacroid": "1", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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 ##### Canvi del fus horari Per defecte, l'appliance empra UTC per al rellotge del sistema. Per modificar el fus horari, copieu l'arxiu pertinent des de */usr/share/zoneinfo* cap a */etc/localtime*, per exemple: cp /usr/share/zoneinfo/Europe/Riga /etc/localtime #### Changing user role Change a role of a user. Request: ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Canvia el rol d'usuari canvia el rol d'un usuari. Petició: ```json { "jsonrpc": "2.0", "method": "user.update", "params": { "userid": "12", "roleid": "6" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Changing value map name Change value map name to "Device status". Request: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Device status" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Canvia el nom del mapa de valors Estableix el nom del mapa de valors a "Estat del dispositiu". Petició: ```json { "jsonrpc": "2.0", "method": "valuemap.update", "params": { "valuemapid": "2", "name": "Estat del dispositiu" }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "2" ] }, "id": 1 } ``` #### Checking for not supported value This example uses the [Check for not supported value](/manual/config/items/preprocessing#configuration) 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) - 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. 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. #### Comprovació de valors no compatibles Aquest exemple utilitza la passa de preprocessament [Comprovació de valors no compatibles](/manual/config/items/preprocessing#configuration) per comprovar si no s'ha pogut recuperar el valor de l'element. Quan un procés de sondeig de servidor/proxy Zabbix intenta recopilar un valor d'element, pot: - Retornar un resultat vàlid. - Retornar un resultat que inicialment sembla vàlid però que pot deixar de ser compatible més endavant (per exemple, a causa d'una discrepància del tipus de valor després del preprocessament). - Retornar un error de recopilació del valor, cosa que fa que l'element deixi de ser compatible. Les causes comunes inclouen: - Clau d'element desconeguda (per a l'agent Zabbix, la comprovació simple o els elements interns de Zabbix) - OID desconegut (agent SNMP), sensor desconegut (agent IPMI) o cap mètrica JMX (agent JMX) - No es pot llegir el fitxer de trap (trap SNMP) - No s'ha trobat l'script (comprovació externa) - No hi ha aquesta URL (agent HTTP) - Error d'inici de sessió (agent SSH, agent TELNET) - Sintaxi de fórmula no vàlida (calculada), error de sintaxi de JavaScript (script) o SQL no vàlid (monitor de base de dades) Per detectar i gestionar errors de recopilació de valors d'elements, podeu utilitzar la passa de preprocessament "Comprova si hi ha valors no compatibles". Tingueu en compte que aquesta passa sempre s'executa primer i només detecta errors que es produeixen abans que comenci el preprocessament. A la pestanya *Preprocessament* d'un element, trieu la passa de preprocessament "Comprovar si hi ha valors no compatibles". A continuació, utilitzeu l'opció *Personalitzat en cas d'error* per descartar el valor (en aquest cas, l'error), definir un valor personalitzat o retornar un missatge d'error personalitzat. Tingueu en compte que els valors [descartats](/manual/config/items/preprocessing#discardunchanged) no s'emmagatzemen a la base de dades; per tant, els triggers no s'avaluen i no es generen dades de tendència. #### Checking retrieved value type This example uses the [Custom multiplier](/manual/config/items/preprocessing#configuration) 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 set the following parameter: ```bash # Multiplies the retrieved value by 1: number: 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#configuration) values are not stored in the database; as a result, triggers are not evaluated and trend data is not generated. ::: #### Comprovant el tipus de valor recuperat Aquest exemple empra la passa de preprocessament [Multiplicador personalitzat](/manual/config/items/preprocessing#configuration) per comprovar si el tipus de valor de l'element recuperat és numèric. A la pestanya *Preprocessament* d'un element, seleccioneu la passa de preprocessament "Multiplicador personalitzat" i configureu el paràmetre següent: ```bash # Multiplica el valor recuperat per 1: number: 1 ``` ::: nota important Si el preprocessament falla (p. ex., l'entrada no és numèrica), l'element no s'admet amb un missatge d'error corresponent. Per evitar-ho, marqueu la casella de selecció "Personalitzat en cas d'error" i seleccioneu una opció, com ara descartar el valor o establir-ne un de personalitzat. Tingueu en compte que els valors [descartats](/manual/config/items/preprocessing#configuration) no s'emmagatzemen a la base de dades; com a resultat, els triggers no s'avaluen i no es generen dades de tendència. ::: ### 'Check now' request object The 'Check now' task request object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|ID of item and low-level discovery rules.| ### Objecte de consulta 'Verificar ara' L'objecte de consulta de tasca 'Verificar ara' té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|string|ID de l'element i les regles de descoberta de baix nivell.| #### Check of pre-requisites Make sure that all software prerequisites are met. {width="550"} |Pre-requisite|Minimum value|Description| |--|--|------| |*PHP version*|7.2.5| | |*PHP memory\_limit option*|128MB|In php.ini:<br>memory\_limit = 128M| |*PHP post\_max\_size option*|16MB|In php.ini:<br>post\_max\_size = 16M| |*PHP upload\_max\_filesize option*|2MB|In php.ini:<br>upload\_max\_filesize = 2M| |*PHP max\_execution\_time option*|300 seconds (values 0 and -1 are allowed)|In php.ini:<br>max\_execution\_time = 300| |*PHP max\_input\_time option*|300 seconds (values 0 and -1 are allowed)|In php.ini:<br>max\_input\_time = 300| |*PHP session.auto\_start option*|must be disabled|In php.ini:<br>session.auto\_start = 0| |*Database support*|One of: MySQL, Oracle, PostgreSQL.|One of the following modules must be installed:<br>mysql, oci8, pgsql| |*bcmath*| |php-bcmath| |*mbstring*| |php-mbstring| |*PHP mbstring.func\_overload option*|must be disabled|In php.ini:<br>mbstring.func\_overload = 0| |*sockets*| |php-net-socket. Required for user script support.| |*gd*|2.0.28|php-gd. PHP GD extension must support PNG images (*--with-png-dir*), JPEG (*--with-jpeg-dir*) images and FreeType 2 (*--with-freetype-dir*).| |*libxml*|2.6.15|php-xml| |*xmlwriter*| |php-xmlwriter| |*xmlreader*| |php-xmlreader| |*ctype*| |php-ctype| |*session*| |php-session| |*gettext*| |php-gettext<br>Since Zabbix 2.2.1, the PHP gettext extension is not a mandatory requirement for installing Zabbix. If gettext is not installed, the frontend will work as usual, however, the translations will not be available.| Optional pre-requisites may also be present in the list. A failed optional prerequisite is displayed in orange and has a *Warning* status. With a failed optional pre-requisite, the setup may continue. ::: noteimportant If there is a need to change the Apache user or user group, permissions to the session folder must be verified. Otherwise Zabbix setup may be unable to continue. ::: #### Verificació dels pre-requisits Assegureu-vos que es compleixin tots els requisits previs del programari. {width="550"} |Requisit|Valor mínim|Descripció| |--|--|------| |*Versió PHP*|7.2.5| | |*Memòria d'opció PHP\_limit*|128Mo|A php.ini:<br>memory\_limit = 128M| |*opció PHP post\_max\_size*|16Mo|A php.ini:<br>post\_max\_size = 16M| |*Càrrega de l'opció PHP\_max\_filesize*|2Mo|A php.ini:<br>upload\_max\_filesize = 2M| |*opció PHP max\_execution\_time*|300 segons (es permeten valors 0 i -1)|A php.ini:<br>max\_execution\_time = 300| |*opció PHP max\_input\_time*|300 segons (es permeten valors 0 i -1)|A php.ini:<br>max\_input\_time = 300| |*opció PHP session.auto\_start*|s'ha de desactivar|A php.ini:<br>session.auto\_start = 0| |*Base de dades*|Una de: MySQL, Oracle, PostgreSQL.|S'ha d'instal·lar un dels següents:<br>mysql, oci8, pgsql| |*bcmath*| |php-bcmath| |*mbstring*| |php-mbstring| |*opció PHP mbstring.func\_overload*|s'ha de desactivar|A php.ini:<br>mbstring.func\_overload = 0| |*endolls*| |php-net-socket. Necessari per al suport de script d'usuari.| |*gd*|2.0.28|php-gd. L'extensió PHP GD ha de suportar imatges PNG (*--with-png-dir*), JPEG (*--with-jpeg-dir*) i FreeType 2 (*--with-freetype-dir*). |*libxml*|2.6.15|php-xml| |*xmlwriter*| |php-xmlwriter| |*xmlreader*| |php-xmlreader| |*ctype*| |php-ctype| |*sessió*| |php-sessió| |*gettext*| |php-gettext<br>A partir de Zabbix 2.2.1, l'extensió PHP gettext ja no és necessària per a la instal·lació de Zabbix. Si gettext no és instal·lat, la interfície funcionarà com de costum, però les traduccions no seran pas disponibles.| Els requisits previs opcionals també poden ésser presents a la llista. Un prerequisit opcional fallit es mostra en carbassa i té un estat *Avís*. Si falla un requisit previ opcional, la configuració pot continuar. ::: noteimportant Si cal canviar l'usuari o el grup d'usuaris d'Apache, s'han de comprovar els permisos d'accés a la carpeta de sessió. En cas contrari, és possible que la instal·lació de Zabbix no pugui continuar. ::: #### Check status of nodes at specific IP addresses Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` #### Verificar l'estat dels nodes d'adreces IP específiques Petició: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["name", "status"], "filter": { "address": ["192.168.1.7", "192.168.1.13"] } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": [ { "name": "node3", "status": "0" }, { "name": "node-active", "status": "3" } ], "id": 1 } ``` #### 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: 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 per al servei web Zabbix a Ubuntu 20 Tot i que en la majoria dels casos el servei web Zabbix pot funcionar amb Chromium, a Ubuntu 20.04 amb Chromium provoca el següent error: No es poden recuperar les dades: no s'ha pogut iniciar Chrome:cmd_run.go:994: AVÍS: no es pot crear el directori de dades d'usuari: no es pot crear "/var/lib/zabbix/snap/chromium/1564": mkdir /var/lib/zabbix: permís denegat Ho sentim, els directoris d'inici fora de /home actualment no són compatibles. Consulteu https://forum.snapcraft.io/t/11209 per obtindre més informació. Aquest error es produeix perquè `/var/lib/zabbix` s'empra com a directori inicial de l'usuari 'zabbix'. #### Ciphersuites Ciphersuites by default are configured internally during Zabbix startup and, before Zabbix 4.0.19, 4.4.7, are not user-configurable. Since Zabbix 4.0.19, 4.4.7 also user-configured ciphersuites are supported for GnuTLS and OpenSSL. Users may [configure](#user-configured_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| #### Suite de xifrat Les suites de xifrat per defecte es configuren internament quan s'inicia Zabbix i abans de Zabbix 4.0.19, 4.4.7 no es poden configurar per l'usuari. Des de Zabbix 4.0.19, les suites de xifrat configurades per l'usuari 4.4.7 també són compatibles amb GnuTLS i OpenSSL. Els usuaris poden [configurar](#user-configured_ciphersuites) suites de xifrat segons les seves polítiques de seguretat. L'ús d'aquesta característica és opcional (les suites de xifrat predeterminades integrades encara funcionen). Per a les biblioteques de xifrat compilades amb la configuració predeterminada, les regles integrades de Zabbix solen donar lloc a les següents suites de xifrat (en ordre de major a menor precedència): |Biblioteca|Certificate Cipher Suite|PSK Cipher Suite| |-------|-------------------|-------------------| |*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| ### Cleaner configuration export  YAML files generated during Zabbix entity configuration export no longer contain empty lines between entities in an array, which makes such files shorter and more convenient to work with. See [Configuration export/import](/manual/xml_export_import) section for updated export examples. ### Exportació de la configuració de neteja Els arxius YAML generats durant l'exportació de la configuració de l'entitat de Zabbix ja no poden contindre línies buides entre línies en una taula, cosa que fa els arxius més curts i més fàcil de treballar amb ells. Veieu la secció [configuració d'exportació/importació](/manual/xml_export_import) per veure exemples d'exportació actualitzats. #### Clear history Request: ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10325", "13205" ] }, "id": 1 } ``` #### Netejar l'historial Petició: ```json { "jsonrpc": "2.0", "method": "history.clear", "params": [ "10325", "13205" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "templates_clear": [ { "templateid": "10087" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10086" ] }, "id": 1 } ``` #### Neteja de les plantilles enllaçades amb plantilles Desenllaça i neteja la plantilla donada d'una plantilla enllaçada específica. Petició: ```json { "jsonrpc": "2.0", "method": "template.update", "params": { "templateid": "10086", "templates_clear": [ { "templateid": "10087" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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*. ##### Clonar un informe Per clonar ràpidament un informe existent, premeu el botó *Clonar* a la part inferior del formulari de configuració d'un informe existent. Quan es clona un informe creat per un altre usuari, l'usuari actual es converteix en el propietari del nou informe. La configuració de l'informe es copiarà al formulari de configuració de l'informe nou pel que fa als permisos d'usuari: - Si l'usuari qui clona un informe no té permisos al tauler, el camp *Tauler* s'esborrarà. - Si l'usuari qui clona un informe no té permisos per a determinats usuaris o grups d'usuaris a la llista de *Subscripcions*, no es clonaran els destinataris inaccessibles. - La configuració de *Generat per* s'actualitzarà per ensenyar l'usuari actual (tret que *Generar informe per* estigui definit al destinatari). Editeu els paràmetres necessaris i el nom de l'informe i, a continuació, piqueu *Afegir*. ### Code |Type|Size|Comments| |-----|-----|----------| |Byte| 4 |Payload type, currently only JSON is supported.| ### Codi |Tipus|Mida|Comentaris| |-----|-----|----------| |Octet| 4 |Tipus de càrrega útil, actualment només s'admet 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. ##### Menú reduït Quan el menú es redueix només a icones, reapareix un menú complet tan bon punt es col·loca el cursor del ratolí sobre ell. Tingueu en compte que reapareix al contingut de la pàgina; per moure el contingut de la pàgina cap a la dreta, heu de fer clic al botó d'ampliar. Si el cursor del ratolí es torna a col·locar fora del menú complet, el menú es col·lapsarà de nou al cap de dos segons. També podeu fer que un menú replegat torni a aparèixer completament prement la tecla Tab. Si premeu la tecla Tab diverses vegades, es centrarà al següent element del menú. ##### Column configuration {width="600"} ##### Configuració de columnes {width="600"} #### 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.name.0) references a column for which the parameter is configured. ::: #### Columnes Les columnes tenen paràmetres comuns i paràmetres addicionals en funció de la configuració del paràmetre *Data*. ::: noteclassic Per a tots els paràmetres relacionats amb les columnes, el nombre del nom de la propietat (p. ex. columns.name.0) fa referència a una columna per a la qual és configurat el paràmetre. ::: #### Command-line based installation #### Instal·lació des de la línia de comandes #### 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. #### Resultat de la comanda El valor de retorn de l'ordre és una sortida estàndard amb error estàndard. ::: noteimportant Un element de text (caràcter, registre o informació semblant a un text) no serà compatible amb un error estàndard. ::: El valor de retorn és limita a 16Mo (incloent els espais en blanc truncats al final); també s'apliquen [Límits de la base de dades](/manual/config/items/item#text_data_limits). Els paràmetres d'usuari que retornen text (informació de caràcter, registre o text) poden retornar espais. Si es retorna incorrectament, l'article no s'admetrà. [comment]: # attributes: noaside # 11 Recipes for monitoring [comentari]: # atributs: noaside # 11 Receptes de monitoratge [comment]: # attributes: noaside # 12 Performance tuning ::: noteimportant This is a work in progress. ::: # 12 Optimització de rendiment ::: noteimportant Això és una feina en curs. ::: [comment]: # (tags: proxy) # 4 Proxy [comentari]: # (tags: proxy) # 4 Proxy #### 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.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| #### Elements d'agent comuns admesos sota Windows |Clau de l'element|Grup d'usuaris|<| |--------|----------|-| | |Recomanat|Mínim tècnicament acceptable (funcionalitat limitada)| |agent.hostname|Convidats|Convidats| |agent.ping|Convidats|Convidats| |agent.variant|Convidats|Convidats| |agent.version|Convidats|Convidats| |log|Administradors|Convidats| |log.count|Administradors|Convidats| |logrt|Administradors|Convidats| |logrt.count|Administradors|Convidats| |net.dns|Convidats|Convidats| |net.dns.record|Convidats|Convidats| |net.if.discovery|Convidats|Convidats| |net.if.in|Convidats|Convidats| |net.if.out|Convidats|Convidats| |net.if.total|Convidats|Convidats| |net.tcp.listen|Convidats|Convidats| |net.tcp.port|Convidats|Convidats| |net.tcp.service|Convidats|Convidats| |net.tcp.service.perf|Convidats|Convidats| |net.udp.service|Convidats|Convidats| |net.udp.service.perf|Convidats|Convidats| |proc.num|Administradors|Convidats| |system.cpu.discovery|Usuaris del monitor de rendiment|Usuaris del monitor de rendiment| |system.cpu.load|Usuaris del monitor de rendiment|Usuaris del monitor de rendiment| |system.cpu.num|Convidats|Convidats| |system.cpu.util|Usuaris del monitor de rendiment|Usuaris del monitor de rendiment| |system.hostname|Convidats|Convidats| |system.localtime|Convidats|Convidats| |system.run|Administradors|Convidats| |system.sw.arch|Convidats|Convidats| |system.swap.size|Convidats|Convidats| |system.uname|Convidats|Convidats| |system.uptime|Usuaris del monitor de rendiment|Usuaris del monitor de rendiment| |vfs.dir.count|Administradors|Convidats| |vfs.dir.get|Administradors|Convidats| |vfs.dir.size|Administradors|Convidats| |vfs.file.cksum|Administradors|Convidats| |vfs.file.contents|Administradors|Convidats| |vfs.file.exists|Administradors|Convidats| |vfs.file.md5sum|Administradors|Convidats| |vfs.file.regexp|Administradors|Convidats| |vfs.file.regmatch|Administradors|Convidats| |vfs.file.size|Administradors|Convidats| |vfs.file.time|Administradors|Convidats| |vfs.fs.discovery|Administradors|Convidats| |vfs.fs.get|Administradors|Convidats| |vfs.fs.size|Administradors|Convidats| |vm.memory.size|Convidats|Convidats| |web.page.get|Convidats|Convidats| |web.page.perf|Convidats|Convidats| |web.page.regexp|Convidats|Convidats| |zabbix.stats|Convidats|Convidats| 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** - host name of the item specified in the *Item value* column<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".| Paràmetres comuns de la columna: | | | |--|---------| |*Nom*|Nom de la columna.| |*Dades*|Tipus de dades per mostrar a la columna:<br>**Valor de l'element** - valor de l'element especificat<br>**Nom d'equip** - nom d'equip de l'element especificat a la columna *valor de l'element*<br> **Text** - cadena de text estàtic| |*Color base*|Color de fons de la columna; color de farciment si les dades del *Valor de l'element* es mostren com a barres/indicadors.<br>Per a les dades del *Valor de l'element*, el color predeterminat es pot canviar a un color personalitzat, si el valor de l'element és superior a un dels "llindars" especificats.| ### 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>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 are:<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`.| ### Paràmetres comuns del mètode "get" Es suporten per tots els mètodes `get` els paràmetres següents: |Paràmetre|[Tipus](#data_types)|Descripció| |-|-|------| |countOutput|boolean|Torna el nombre de registres al resultat, enlloc de les dades reals.| |editable|boolean|Si s'estableix a `true`, només retorna els objectes per als quals l'usuari té permisos d'escriptura.<br><br>Per defecte: `false`.| |excludeSearch|boolean|Retorna els resultats que no corresponen pas als criteris proveïts al paràmetre `search`.| |filter|object|Retorna només aquells resultats que coincideixen exactament amb el filtre donat.<br><br>Accepta un objecte, on les claus són noms de propietat (p. ex., propietats de l'objecte de l'equip a `host.get', propietats de l'objecte de l'element a `item.get', etc.), i els valors són un valor únic o una matriu de valors amb els quals coincideix.<br><br><br> type](#data-types).<br><br>Tingueu en compte que alguns mètodes tenen una funcionalitat específica per a aquest paràmetre, que es descriu a la pàgina del mètode (per exemple, el paràmetre `filter` a [host.get](/manual/api/reference/host/get) també admet propietats de la interfície de l'equip).| |output|query|Propietats de l'objecte que es retornaran.<br><br>Per defecte: `extend`.| |preservekeys|boolean|Empra els IDs com a claus de la matriu resultant.| |search|object|Retorn resultats que coincideixen amb el patró donat (no distingeix entre majúscules i minúscules).<br><br>Accepta un objecte, on les claus són noms de propietat (p. ex., propietats de l'objecte equip a `host.get`, propietats de l'objecte element a `item.get', etc.) i els valors són cadenes per cercar. Si no es donen opcions addicionals, es realitzarà una cerca `COM "%...%"`.<br><br>Només admet propietats de `string` i `text` [tipus de dades](#data-types).<br><br>Tingueu en compte que alguns mètodes tenen una funcionalitat específica per a aquest paràmetre, que es descriu a la pàgina del mètode (p. també admet propietats de la interfície de l'equip).| |searchWildcardsEnabled|boolean|Si s'estableix a `true`, permet l'us de "\*" com a comodí al paràmetre `search`.<br><br>Per defecte: `false`.| |sortfield|string/array|Ordena el resultat per les propietats donades. Consulteu una descripció específica del mètode get de l'API per obtindre una llista de propietats que es poden emprar per la classificació. Les macros no són pas ampliades abans d'ordenar.<br><br>Si n os'especifiquen valors, la informació es retorna sense ordenar.| |sortorder|string/array|Ordre de classificació. Si es passa una matriu, cada valor correspondrà amb la propietat donada al paràmetre `sortfield`.<br><br>Els valors possibles són:<br>`ASC` - *(per defecte)* ascendent;<br>`DESC` - descendent.| |startSearch|boolean|El paràmetre `search` es compara amb el principi dels camps; és a dir, es farà una cerca `LIKE "…%"`.<br><br>S'ignorarà si el `searchWildcardsEnabled` és establert a `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. ##### Paràmetres comuns - `/host/key` és un paràmetre comú obligatori per les funcions sobre l'històric de l'element d'equip - `(sec|#num)<:time shift>` és un segon paràmetre habitual per funcions referents a l'històric de l'element d'equip, on: - **sec** - [període d'avaluació](/manual/config/triggers#evaluation_period) màxim en segons (es poden emprar els [sufixes](/manual/appendix/suffixes)), o - **\#num** - [període d'avaluació](/manual/config/triggers#evaluation_period) màxim en nombre de valors recollits (si van precedits per el símbol de la graella) - **canvi horari** (facultatiu) permet canviar el punt d'avaluació en el temps. Veieu [més detalls](/manual/config/triggers/expression#time_shift) sobre la especificació del canvi horari. ##### 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. ##### Paràmetres comuns - `/host/key` és un paràmetre comú obligatori per les funcions sobre l'històric de l'element d'equip - `(sec|#num)<:time shift>` és un segon paràmetre habitual per funcions referents a l'històric de l'element d'equip, on: - **sec** - [període d'avaluació](/manual/config/triggers#evaluation_period) màxim en segons (es poden emprar els [sufixes](/manual/appendix/suffixes)), o - **\#num** - [període d'avaluació](/manual/config/triggers#evaluation_period) màxim en nombre de valors recollits (si van precedits per el símbol de la graella) - **canvi horari** (facultatiu) permet canviar el punt d'avaluació en el temps. Veieu [més detalls](/manual/config/triggers/expression#time_shift) sobre la especificació del canvi horari. ##### 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. ##### Paràmetres comuns - `/host/key` és un paràmetre comú obligatori per les funcions sobre l'històric de l'element d'equip - `(sec|#num)<:time shift>` és un segon paràmetre habitual per funcions referents a l'històric de l'element d'equip, on: - **sec** - [període d'avaluació](/manual/config/triggers#evaluation_period) màxim en segons (es poden emprar els [sufixes](/manual/appendix/suffixes)), o - **\#num** - [període d'avaluació](/manual/config/triggers#evaluation_period) màxim en nombre de valors recollits (si van precedits per el símbol de la graella) - **canvi horari** (facultatiu) permet canviar el punt d'avaluació en el temps. Veieu [més detalls](/manual/config/triggers/expression#time_shift) sobre la especificació del canvi horari. ##### 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 (see function examples) ##### Paràmetres comuns - `/host/key` és un primer paràmetre obligatori comú - `time period:time shift` és un segon paràmetre comú, on: - **time period** - el perí de temps (mínim '1h'), definit com a \<N>\<unitat de temps> o `N` - el nombre d'unitats de temps, `unitat de temps` - h (hora), d (dia), w (setmana), M (mes) o y (any). - **time shift** - retards horaris (veieu exemples de funcions) #### Common parameters Some parameters are common for all media types.  In the **Media type** tab the common general attributes are: |Parameter|Description| |--|--------| |*Name*|Name of the media type.| |*Type*|Select the type of media.| |*Description*|Enter a description.| |*Enabled*|Mark the checkbox to enable the media type.| See the individual pages of media types for media-specific parameters. The **Message templates** tab allows to set default notification messages for all or some of the following event types: - Problem - Problem recovery - Problem update - Service - Service recovery - Service update - Discovery - Autoregistration - Internal problem - Internal problem recovery  To customize message templates: - In the *Message templates* tab click on : a *Message template* popup window will open. - Select required *Message type* and edit *Subject* and *Message* texts. - Click on *Add* to save the message template  Message template parameters: |Parameter|Description| |--|-----------| |*Message type*|Type of an event for which the default message should be used.<br>Only one default message can be defined for each event type.<br>| |*Subject*|Subject of the default message. The subject may contain macros. It is limited to 255 characters.<br>Subject is not available for SMS media type.| |*Message*|The default message. It is limited to certain amount of characters depending on the database type (see [Sending messages](/manual/config/notifications/action/operation/message/) for more information).<br>The message may contain supported [macros](/manual/appendix/macros/supported_by_location).<br>In problem and problem update messages, expression macros are supported (for example, `{?avg(/host/key,1h)}`).| To make changes to an existing message template: In the *Actions* column click on  to edit the template or click on  to delete the message template. It is possible to define a custom message template for a specific action (see [action operations](/manual/config/notifications/action/operation#operation_details) for details). Custom messages defined in the action configuration will override default media type message template. ::: notewarning Defining message templates is mandatory for all media types, including webhooks or custom alert scripts that do not use default messages for notifications. For example, an action "Send message to Pushover webhook" will fail to send problem notifications, if the Problem message for the Pushover webhook is not defined. ::: The **Options** tab contains alert processing settings. The same set of options is configurable for each media type. All media types are processed in parallel. While the maximum number of concurrent sessions is configurable per media type, the total number of alerter processes on the server can only be limited by the StartAlerters [parameter](/manual/appendix/config/zabbix_server). Alerts generated by one trigger are processed sequentially. So multiple notifications may be processed simultaneously only if they are generated by multiple triggers.  |Parameter|Description| |--|--------| |*Concurrent sessions*|Select the number of parallel alerter sessions for the media type:<br>**One** - one session<br>**Unlimited** - unlimited number of sessions<br>**Custom** - select a custom number of sessions<br>Unlimited/high values mean more parallel sessions and increased capacity for sending notifications. Unlimited/high values should be used in large environments where lots of notifications may need to be sent simultaneously.<br>If more notifications need to be sent than there are concurrent sessions, the remaining notifications will be queued; they will not be lost.| |*Attempts*|Number of attempts for trying to send a notification. Up to 100 attempts can be specified; the default value is '3'. If '1' is specified Zabbix will send the notification only once and will not retry if the sending fails.| |*Attempt interval*|Frequency of trying to resend a notification in case the sending failed, in seconds (0-3600). If '0' is specified, Zabbix will retry immediately.<br>Time suffixes are supported, e.g. 5s, 3m, 1h.| #### Paràmetres comuns Alguns paràmetres són comuns a tots els tipus de suport.  A la pestanya **Tipus de suport**, els atributs generals comuns són: |Paràmetre|Descripció| |--|---------| |*Nom*|Nom del tipus de suport.| |*Tipus*|Tipus de suport.| |*Descripció*|Descripció.| |*Actiu|Casella per activar el tipus de suport.| Consulteu les pàgines individuals de tipus de suport per a la configuració específica dels suports. La pestanya **Plantilles de missatges** us permet definir missatges de notificació predeterminats per a tots o alguns dels tipus d'esdeveniments següents: - Assumpte - Recuperació de problemes - Actualització del problema - Servei - Reinici del servei - Actualització del servei - Descoberta - Enregistrament automàtic - Problema intern - Recuperació de problemes interns  Per personalitzar les plantilles de missatges: - A la pestanya *Plantilles de missatge* feu clic a : s'obrirà la finestra emergent *Plantilla de missatge*. - Trieu el *Tipus de missatge* necessari i editeu els textos *Assumpte* i *Missatge*. - Feu clic a *Afegir* per desar la plantilla del missatge  Configuració de la plantilla de missatge: |Paràmetre|Descripció| |--|------------| |*Tipus de missatge*|Tipus d'esdeveniment per al qual s'ha d'emprar el missatge predeterminat.<br>Només es pot definir un missatge per defecte per a cada tipus d'esdeveniment.<br>| |*Assumpte*|Assumpte per defecte del missatge. El tema pot contindre macros. És limitat a 255 caràcters.<br>L'assumpte no és pas disponible per al tipus de suport SMS.| |*Missatge*|El missatge predeterminat. És limitat a un nombre determinat de caràcters en funció del tipus de base de dades (veieu [enviament de missatges](/manual/config/notifications/action/operation/message/) per obtindre més informació).<br>El missatge pot contindre [macros compatibles](/manual/appendix/macros/supported_by_location).<br>En els missatges de problemes i d'actualització de problemes, s'admeten macros d'expressió (per exemple, `{?avg(/host/key,1h)}`).| Per fer canvis a una plantilla de missatge existent: a la columna *Accions*, feu clic a  per editar el model o feu clic a  per esborrar la plantilla del missatge. És possible definir una plantilla de missatge personalitzada per a una acció específica (veieu [operacions d'acció](/manual/config/notifications/action/operation#operation_details) per a més detalls). Els missatges personalitzats definits a la configuració de l'acció substituiran la plantilla de missatge de tipus de suport predeterminada. ::: notewarning La definició de plantilles de missatge és necessària per a tots els tipus de mitjans, inclosos els webhooks o els scripts d'alertes personalitzats que no empren missatges predeterminats per a les notificacions. Per exemple, una acció "Enviar missatge a webhook pushover" no pot pas enviar notificacions de problemes, si el missatge de problema per a webhook pushover no és pas configurat. ::: La pestanya **Opcions** conté la configuració per gestionar les alertes. El mateix conjunt d'opcions es pot configurar per a cada tipus de suport. Tots els tipus de suports es processen en paral·lel. Tot i que el nombre màxim de sessions concurrents es pot configurar per tipus de suport, el nombre total de processos d'alerta al servidor només es pot limitar pel [paràmetre](/manual/appendix/config/zabbix_server) StartAlerters. Les alertes generades per un trigger es processen seqüencialment. Així, només es poden processar múltiples notificacions simultàniament si són generades per diversos triggers.  |Paràmetre|Descripció| |--|---------| |*Sessions concurrents*|Trieu el nombre de sessions d'alerta paral·leles per al tipus de suport:<br>**Un** - una sessió<br>**Il·limitat** - sessions il·limitades<br>**Personalitzat** - trieu un nombre personalitzat de sessions<br>Els valors il·limitats/alts signifiquen més sessions paral·leles i una major capacitat d'enviar notificacions. Els valors il·limitats/alts s'han d'emprar en entorns grans on és possible que s'hagin d'enviar moltes notificacions simultàniament.<br> Si s'han d'enviar més notificacions que sessions concurrents, les notificacions restants es posaran a la cua a l'espera; no es perdran.| |*Intents*|Nombre d'intents d'enviar una notificació. Es poden especificar fins a 100 intents; el valor per defecte és '3'. Si s'especifica '1', Zabbix només enviarà la notificació una vegada i no ho tornarà a provar si l'enviament falla.| |*Interval de reintents*|Freqüència dels intents en tornar a enviar una notificació d'un enviament fallit, en segons (0-3600). Si s'especifica '0', Zabbix tornarà a provar-ho immediatament.<br>S'admeten sufixos de temps, p. 5s, 3m, 1h.| ##### 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. ##### Casos comuns d'usos de macros globals i d'equips - empreu una macro global a diversos llocs; tot seguit, canvieu el valor de la macro i apliqueu els canvis de configuració a totes les ubicacions amb un sol clic - Aprofiteu els patrons amb atributs específics de l'equip: mots de pas, nombres de port, noms de fitxers, expressions regulars, etc. ##### Communication with Zabbix server |Parameter|Description| |--|--------| |*Network timeout*|How many seconds to wait before closing an idle socket (if a connection to Zabbix server has been established earlier, but frontend can not finish read/send data operation during this time, the connection will be dropped). Allowed range: 1 - 300s (default: 3s).| |*Connection timeout*|How many seconds to wait before stopping an attempt to connect to Zabbix server. Allowed range: 1 - 30s (default: 3s).| |*Network timeout for media type test*|How many seconds to wait for a response when testing a media type. Allowed range: 1 - 300s (default: 65s).| |*Network timeout for script execution*|How many seconds to wait for a response when executing a script. Allowed range: 1 - 300s (default: 60s).| |*Network timeout for item test*|How many seconds to wait for returned data when testing an item. Allowed range: 1 - 300s (default: 60s).| |*Network timeout for scheduled report test*|How many seconds to wait for returned data when testing a scheduled report. Allowed range: 1 - 300s (default: 60s).| ##### Comunicació amb el servidor Zabbix |Paràmetre|Descripció| |--|---------| |*Temps d'espera de la xarxa*|Quants segons cal esperar abans de tancar un sòcol inactiu (si es va establir una connexió amb el servidor Zabbix abans, però la interfície no pot completar les dades d'operació de lectura/enviament durant aquest temps, la connexió s'interromprà). Interval permès: 1 - 300 s (per defecte: 3 s).| |*Temps d'espera de connexió*|Quants segons cal esperar abans d'aturar un intent de connexió al servidor Zabbix. Interval permès: 1 - 30 s (per defecte: 3 s).| |*Temps d'espera de la xarxa per provar el tipus de suport*|Quants segons cal esperar una resposta quan es prova un tipus de suport. Interval permès: 1 - 300 s (per defecte: 65 s).| |*Temps d'espera de la xarxa per a l'execució de l'script*|Quants segons cal esperar una resposta quan s'executa un script. Interval permès: 1 - 300 s (per defecte: 60 s).| |*Temps d'espera de la xarxa per provar un element*|Quants segons cal esperar a les dades retornades quan es prova un element. Interval permès: 1 - 300 s (per defecte: 60 s).| |*Temps d'espera de la xarxa per a la prova d'informe programat*|Quants segons cal esperar a les dades retornades quan es prova un informe programat. Interval permès: 1 - 300 s (per defecte: 60 s).| ## Community & other resources ## Comunitat i altres recursos #### 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: ```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 }, "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>6.0</version><date>2023-01-01T12:30:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templates": { "updated": [ { "before": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "after": { "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", "template": "New template", "name": "New template" }, "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 } ``` #### Comparar la importació d'un model Compara el model contingut a la cadena XML dels elements de sistema actuals, i ensenya el que canviarà si s'importa aquest model. Petició: ```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 · }, · "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>6.0</version><date>2023-01-01T12:30:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></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><dt>Server uptime: (.*)</dt></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)>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" · }, · "auth": "038e1d7b1735c6a5436ee9eae095879e", · "id": 1 } ``` Resposta: ```json { · "jsonrpc": "2.0", · "result": { · "templates": { · "updated": [ · { · "before": { · "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", · "template": "New template", · "name": "New template" · }, · "after": { · "uuid": "5aef0444a82a4d8cb7a95dc4c0c85330", · "template": "New template", · "name": "New template" · }, · "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 } ``` #### Compiling OpenSSL The following steps will help you to compile OpenSSL from sources on MS Windows 10 (64-bit). 1. For compiling OpenSSL you will need on Windows machine: 1. C compiler (e.g. VS 2017 RC), 2. NASM (<https://www.nasm.us/>), 3. Perl (e.g. Strawberry Perl from <http://strawberryperl.com/>), 4. Perl module Text::Template (cpan Text::Template). 2. Get OpenSSL sources from <https://www.openssl.org/>. OpenSSL 1.1.1 is used here. 3. Unpack OpenSSL sources, for example, in E:\\openssl-1.1.1. 4. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 RC. 5. Go to the OpenSSL source directory, e.g. E:\\openssl-1.1.1. 1. Verify that NASM can be found:`e:\openssl-1.1.1> nasm --version NASM version 2.13.01 compiled on May 1 2017 ` 6. Configure OpenSSL, for example:`e:\openssl-1.1.1> perl E:\openssl-1.1.1\Configure VC-WIN64A no-shared no-capieng no-srp no-gost no-dgram no-dtls1-method no-dtls1_2-method --api=1.1.0 --prefix=C:\OpenSSL-Win64-111-static --openssldir=C:\OpenSSL-Win64-111-static ` ::: noteimportant Make sure to revoke write access from non-administrator users to the OpenSSL install directory (`C:\OpenSSL-Win64-111-static`). Otherwise, Zabbix agent will load SSL settings from a path that can be modified by unprivileged users, resulting in a potential security vulnerability. ::: - Note the option 'no-shared': if 'no-shared' is used then the OpenSSL static libraries libcrypto.lib and libssl.lib will be 'self-sufficient' and resulting Zabbix binaries will include OpenSSL in themselves, no need for external OpenSSL DLLs. Advantage: Zabbix binaries can be copied to other Windows machines without OpenSSL libraries. Disadvantage: when a new OpenSSL bugfix version is released, Zabbix agent needs to recompiled and reinstalled. - If 'no-shared' is not used, then the static libraries libcrypto.lib and libssl.lib will be using OpenSSL DLLs at runtime. Advantage: when a new OpenSSL bugfix version is released, probably you can upgrade only OpenSSL DLLs, without recompiling Zabbix agent. Disadvantage: copying Zabbix agent to another machine requires copying OpenSSL DLLs, too. 7. Compile OpenSSL, run tests, install:`e:\openssl-1.1.1> nmake e:\openssl-1.1.1> nmake test ... All tests successful. Files=152, Tests=1152, 501 wallclock secs ( 0.67 usr + 0.61 sys = 1.28 CPU) Result: PASS e:\openssl-1.1.1> nmake install_sw `'install\_sw' installs only software components (i.e. libraries, header files, but no documentation). If you want everything, use "nmake install". #### Compilar OpenSSL Les passes següents us ajudaran a compilar OpenSSL des de la font a MS Windows 10 (64 bits). 1. Per compilar OpenSSL, haureu de menester a una màquina Windows: 1. compilació C (p. ex. VS 2017 RC), 2. NASM (<https://www.nasm.us/>), 3. Perl (per exemple, Strawberry Perl de <http://strawberryperl.com/>), 4. Mòdul Perl Text::Template (cpan Text::Template). 2. Obtingueu fonts OpenSSL de <https://www.openssl.org/>. Aquí s'empra OpenSSL 1.1.1. 3. Descomprimiu les fonts OpenSSL, per exemple, a E:\\openssl-1.1.1. 4. Obriu una finestra de línia de comandes, per exemple Native Tools x64 Command Prompt per a VS 2017 RC. 5. Navegueu al directori font d'OpenSSL, per exemple E:\\openssl-1.1.1. 1. Verifiqueu que es pot trobar NASM:`e:\openssl-1.1.1> nasm --version NASM versió 2.13.01 compilada l'1 de maig de 2017 ` 6. Configura OpenSSL, per exemple:`e:\openssl-1.1.1> perl E:\openssl-1.1.1\Configura VC-WIN64A no-shared no-capieng no-srp no-gost no-dgram no-dtls1 -method no-dtls1_2-method --api=1.1.0 --prefix=C:\OpenSSL-Win64-111-static --openssldir=C:\OpenSSL-Win64-111-static ` ::: noteimportant Assegureu-vos de revocar l'accés d'escriptura dels usuaris que no són administradors al directori d'instal·lació d'OpenSSL (`C:\OpenSSL-Win64-111-static`).En cas contrari, l'agent 2 de Zabbix carregarà la configuració SSL des d'una ruta que poden modificar usuaris sense privilegis, cosa que pot donar lloc a una vulnerabilitat de seguretat. ::: - Tingueu en compte l'opció "no-shared": si s'empra "no-shared", les biblioteques estàtiques d'OpenSSL libcrypto.lib i libssl.lib seran "autosuficients" i els binaris Zabbix resultants inclouran OpenSSL, no cal per a "DLL externa OpenSSL". Avantatge: els binaris Zabbix es poden copiar a altres màquines Windows sense biblioteques OpenSSL. Desavantatge: quan es publica una nova versió de correcció d'errors d'OpenSSL, cal recompilar i tornar a instal·lar l'agent Zabbix. - Si no s'empra "no-shared", les biblioteques estàtiques libcrypto.lib i libssl.lib empraran DLL OpenSSL quan s'executen. Avantatge: quan es publica una nova versió de correcció d'errors d'OpenSSL, probablement només podreu actualitzar les DLL d'OpenSSL, sense recompilar l'agent Zabbix. Desavantatge: per copiar l'agent Zabbix a una altra màquina també cal copiar les DLL d'OpenSSL. 7. Compileu OpenSSL, executeu la prova, instal·leu:`e:\openssl-1.1.1> nmake e:\openssl-1.1.1> test nmake ... All tests successful. Fitxers=152, proves=1152, 501 segons de rellotge de paret (0,67 usr + 0,61 sys = 1,28 CPU) Resultat: PASS e:\openssl-1.1.1> nmake install_sw ` 'install\_sw' només instal·la components de programari (és a dir, biblioteques, fitxers de capçalera, però sense documentació). Si ho voleu tot, empreu "nmake install". #### Compiling PCRE 1. Download PCRE or PCRE2 (supported since Zabbix 6.0) library from pcre.org repository: (<https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.zip>) 2. Extract to directory *E:\\pcre2-10.39* 3. Install CMake from <https://cmake.org/download/>, during install select: and ensure that cmake\\bin is on your path (tested version 3.9.4). 4. Create a new, empty build directory, preferably a subdirectory of the source dir. For example, *E:\\pcre2-10.39\\build*. 5. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 and from that shell environment run cmake-gui. Do not try to start Cmake from the Windows Start menu, as this can lead to errors. 6. Enter *E:\\pcre2-10.39* and *E:\\pcre2-10.39\\build* for the source and build directories, respectively. 7. Hit the "Configure" button. 8. When specifying the generator for this project select "NMake Makefiles". 9. Create a new, empty install directory. For example, *E:\\pcre2-10.39-install*. 10. The GUI will then list several configuration options. Make sure the following options are selected: - **PCRE\_SUPPORT\_UNICODE\_PROPERTIES** ON - **PCRE\_SUPPORT\_UTF** ON - **CMAKE\_INSTALL\_PREFIX** *E:\\pcre2-10.39-install* 11. Hit "Configure" again. The adjacent "Generate" button should now be active. 12. Hit "Generate". 13. In the event that errors occur, it is recommended that you delete the CMake cache before attempting to repeat the CMake build process. In the CMake GUI, the cache can be deleted by selecting "File > Delete Cache". 14. The build directory should now contain a usable build system - *Makefile*. 15. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 and navigate to the *Makefile* mentioned above. 16. Run NMake command: `E:\pcre2-10.39\build> nmake install ` #### Compilar PCRE 1. Baixeu la biblioteca PCRE o PCRE2 (admesa des de Zabbix 6.0) des del repositori pcre.org: (<https://github.com/PhilipHazel/pcre2/releases/download/pcre2-10.39/pcre2-10.39.zip>) 2. Extraieu-lo al directori *E:\\pcre2-10.39* 3. Instal·leu CMake des de <https://cmake.org/download/>, en instal·lar seleccioneu i assegureu-vos que cmake\\bin estigui al vostre camí (versió provada 3.9.4). 4. Creeu un nou directori de compilació buit, preferiblement un subdirectori del directori font. Per exemple, *E:\\pcre2-10.39\\build*. 5. Obriu una finestra de línia d'ordres, p. Native Tools x64 Command Prompt per a VS 2017 i des d'aquest entorn de shell executeu cmake-gui. No intenteu iniciar Cmake des del menú Inici de Windows, ja que això pot provocar errors. 6. Introduïu *E:\\pcre2-10.39* i *E:\\pcre2-10.39\\build* per als directoris font i compilació, respectivament. 7. Premeu el botó "Configura". 8. Quan especifiqueu el generador per a aquest projecte, seleccioneu "NMake Makefiles". 9. Creeu un nou directori d'instal·lació buit. Per exemple, *E:\\pcre2-10.39-install*. 10. A continuació, la GUI mostrarà diverses opcions de configuració. Assegureu-vos que les opcions següents són triades: - **PCRE\_SUPPORT\_UNICODE\_PROPERTIES** ON - **PCRE\_SUPPORT\_UTF** ON - **CMAKE\_INSTALL\_PREFIX** *E:\\pcre2-10.39-install* 11. Premeu "Configura" de nou. El botó "Genera" adjacent ara hauria d'ésser actiu. 12. Premeu "Generar". 13. En cas d'error, es recomana esborrar la memòria cau de CMake abans d'intentar repetir el procés de creació de CMake. A la GUI de CMake, la memòria cau es pot esborrar seleccionant "Fitxer > Esborrar la memòria cau". 14. El directori de compilació ara hauria de contindre un sistema de compilació utilitzable - *Makefile*. 15. Obriu una finestra de línia d'ordres, p. Native Tools x64 Command Prompt per a VS 2017 i navegueu al *Makefile* esmentat anteriorment. 16. Executeu l'ordre NMake: `E:\pcre2-10.39\build> nmake install` #### Compiling PCRE development libraries The following instructions will compile and install 64-bit PCRE libraries in *c:\\dev\\pcre* and 32-bit libraries in *c:\\dev\\pcre32*: 1\. Download the PCRE or PCRE2 (supported since Zabbix 6.0) library (<https://pcre.org/>) and extract\ 2\. Open *cmd* and navigate to the extracted sources #### Compilació de les biblioteques de desenvolupament PCRE Les instruccions següents compilaran i instal·laran les biblioteques PCRE de 64 bits a *c:\\dev\\pcre* i les biblioteques de 32 bits a *c:\\dev\\pcre32*: 1\. Baixeu la biblioteca PCRE o PCRE2 (suportada des de Zabbix 6.0) des de pcre.org (<https://pcre.org/>) i extraieu les fonts\ 2\. Obriu *cmd* i navegueu a les fonts extretes #### Compiling Zabbix agent 2 #### Compilació de l'agent Zabbix 2 #### Compiling Zabbix agent on HP-UX If you install the PCRE library from a popular HP-UX package site <http://hpux.connect.org.uk>, for example from file `pcre-8.42-ia64_64-11.31.depot`, you get only the 64-bit version of the library installed in the /usr/local/lib/hpux64 directory. In this case, for successful agent compilation customized options need to be used for the "configure" script, e.g.: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### Compilació de l'agent Zabbix sota HP-UX Si instal·leu la biblioteca PCRE des d'un lloc popular de paquets d'HP-UX <http://hpux.connect.org.uk>, per exemple, des del fitxer `pcre-8.42-ia64_64-11.31.depot`, només obtindreu la versió de 64 bits de la biblioteca instal·lada al directori /usr/local/lib/hpux64. En aquest cas, per a una compilació correcta de l'agent, s'han d'emprar opcions personalitzades amb l'script "configure", per exemple: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### 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 #### Compilació de l'agent Zabbix sota HP-UX Si instal·leu la biblioteca PCRE des d'un lloc popular de paquets d'HP-UX <http://hpux.connect.org.uk> (per exemple, des del fitxer `pcre-8.42-ia64_64-11.31.depot`), només s'instal·larà la versió de 64 bits de la biblioteca al directori `/usr/local/lib/hpux64`. En aquest cas, per a una compilació correcta de l'agent, s'han d'emprar opcions personalitzades amb l'script `configure`, per exemple: CFLAGS="+DD64" ./configure --enable-agent --with-libpcre-include=/usr/local/include --with-libpcre-lib=/usr/local/lib/hpux64 #### Compiling Zabbix The following steps will help you to compile Zabbix from sources on MS Windows 10 (64-bit). When compiling Zabbix with/without TLS support the only significant difference is in step 4. 1. On a Linux machine check out the source from git:`` $ git clone https://git.zabbix.com/scm/zbx/zabbix.git $ cd zabbix $ ./bootstrap.sh $ ./configure --enable-agent --enable-ipv6 --prefix=`pwd` $ make dbschema $ make dist `` 2. Copy and unpack the archive, e.g. zabbix-4.4.0.tar.gz, on a Windows machine. 3. Let's assume that sources are in e:\\zabbix-4.4.0. Open a commandline window e.g. the x64 Native Tools Command Prompt for VS 2017 RC. Go to E:\\zabbix-4.4.0\\build\\win32\\project. 4. Compile zabbix\_get, zabbix\_sender and zabbix\_agent. - without TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` - with TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_get TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_sender TLS=openssl TLSINCDIR="C:\OpenSSL-Win64-111-static\include TLSLIBDIR="C:\OpenSSL-Win64-111-static\lib" PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_agent TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` 5. New binaries are located in e:\\zabbix-4.4.0\\bin\\win64. Since OpenSSL was compiled with 'no-shared' option, Zabbix binaries contain OpenSSL within themselves and can be copied to other machines that do not have OpenSSL. #### Compilació de Zabbix Les passes següents us ajudaran a compilar Zabbix des de la font a MS Windows 10 (64 bits). Quan es compila Zabbix amb/sense suport TLS, l'única diferència significativa es troba a la passa 4. 1. A una màquina Linux, comproveu la font des de git: `` $ git clone https://git.zabbix.com/scm/zbx/zabbix.git $ cd zabbix $ ./bootstrap.sh $ ./configure --enable-agent --enable-ipv6 --prefix=`pwd` $ faire dbschema $ faire dist `` 2. Copieu i descomprimiu l'arxiu, p. zabbix-4.4.0.tar.gz, a una màquina Windows. 3. Suposem que les fonts són a e:\\zabbix-4.4.0. Obriu una finestra de línia de comandes, com ara l'indicador d'ordres natiu de les eines x64 per a VS RC 2017. Aneu a E:\\zabbix-4.4.0\\build\\win32\\project. 4. Compileu zabbix\_get, zabbix\_sender i zabbix\_agent. - sense TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` - amb TLS: `E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_get TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_sender TLS=openssl TLSINCDIR="C:\OpenSSL-Win64-111-static\include TLSLIBDIR="C:\OpenSSL-Win64-111-static\lib" PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib E:\zabbix-4.4.0\build\win32\project> nmake /K -f Makefile_agent TLS=openssl TLSINCDIR=C:\OpenSSL-Win64-111-static\include TLSLIBDIR=C:\OpenSSL-Win64-111-static\lib PCREINCDIR=E:\pcre2-10.39-install\include PCRELIBDIR=E:\pcre2-10.39-install\lib ` 5. Els nous binaris es troben a e:\\zabbix-4.4.0\\bin\\win64. Com que OpenSSL es va compilar amb l'opció "no compartit", els binaris de Zabbix contenen OpenSSL en si mateixos i es poden copiar a altres màquines que no tinguin OpenSSL. #### 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. Note that 3.0.x is supported since Zabbix 6.0.4. - 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/installation/requirements/best_practices). ::: 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. ::: #### CompilarZabbix amb suport de xifrat Per donar suport al xifrat, Zabbix s'ha de compilar i enllaçar amb una de les biblioteques de xifrat admeses: - GnuTLS - a partir de la versió 3.1.18 - OpenSSL - versions 1.0.1, 1.0.2, 1.1.0, 1.1.1, 3.0.x. Tingueu en compte que 3.0.x és compatible des de Zabbix 6.0.4. - LibreSSL - provat amb les versions 2.7.4, 2.8.2: - LibreSSL 2.6.x no és compatible - LibreSSL és compatible com a substitut compatible d'OpenSSL; les noves funcions de l'API `tls_*()` específiques de LibreSSL no s'empren. Els components Zabbix compilats amb LibreSSL no podran emprar PSK, només es poden emprar certificats. :::notetip Podeu trobar més informació sblre com configurar SSL per la interfície de Zabbix seguint aquestes [bones pràctiques](/manual/installation/requirements/best_practices). ::: La biblioteca es tria especificant l'opció corresponent per "configurar" l'script: - `--with-gnutls[=DIR]` - `--with-openssl[=DIR]` (també s'utilitza per a LibreSSL) Per exemple, per configurar les fonts del servidor i de l'agent amb *OpenSSL*, podeu emprar alguna cosa com: ./configure --enable-server --enable-agent --with-mysql --enable-ipv6 --with-net-snmp --with-libcurl --with-libxml2 --with-openssl Es poden compilar diferents components de Zabbix amb diferents biblioteques de xifrat (per exemple, servidor amb *OpenSSL*, agent amb *GnuTLS*). ::: noteimportant Si teniu previst emprar claus precompartides (PSK), penseu a emprar biblioteques *GnuTLS* o *OpenSSL 1.1.0* (o més recent) als components Zabbix mitjançant PSK. Les biblioteques *GnuTLS* i *OpenSSL 1.1.0* admeten suites de xifrat PSK amb [Perfect Forward Secrecy](https://en.wikipedia.org/wiki/Forward_secrecy#Perfect_forward_secrecy_.28PFS.29). Les versions anteriors de la biblioteca *OpenSSL* (1.0.1, 1.0.2c) també admeten PSK, però les suites de xifrat PSK disponibles no proporcionen Perfect Forward Secrecy. ::: #### Compiling Zabbix with LibreSSL The process is similar to compiling with OpenSSL, but you need to make small changes in files located in the `build\win32\project` directory: - In Makefile_tls delete `/DHAVE_OPENSSL_WITH_PSK`, i.e. find: ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL /DHAVE_OPENSSL_WITH_PSK ``` and replace it with ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL ``` - In Makefile_common.inc add `/NODEFAULTLIB:LIBCMT` i.e. find: ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb ``` and replace it with ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb /NODEFAULTLIB:LIBCMT ``` #### Compilar Zabbix amb LibreSSL El procés és similar a la compilació amb OpenSSL, però cal fer petits canvis als fitxers que es troben al directori `build\win32\project`: - Al Makefile_tls , esborreu `/DHAVE_OPENSSL_WITH_PSK`, per exemple cerqueu: ``` CFLAGS = $(CFLAGS) /DHAVE\_OPENSSL /DHAVE\_OPENSSL\_WITH\_PSK ``` i substituïu per ``` CFLAGS = $(CFLAGS) /DHAVE_OPENSSL ``` - Al Makefile_common.inc, afegiu `/NODEFAULTLIB:LIBCMT` i, per exemple, cerqueu: ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\\$(TARGETNAME).pd ``` i substituïu per: ``` /MANIFESTUAC:"level='asInvoker' uiAccess='false'" /DYNAMICBASE:NO /PDB:$(TARGETDIR)\$(TARGETNAME).pdb /NODEFAULTLIB:LIBCMT ``` #### Compiling Zabbix with ODBC support To enable ODBC support, Zabbix should be compiled with the following flag: --with-unixodbc[=ARG] # Use ODBC driver against unixODBC package. ::: noteclassic See more about Zabbix installation from the [source code](/manual/installation/install#from_the_sources). ::: #### Compilar Zabbix amb suport ODBC Per habilitar el suport ODBC, Zabbix s'ha de compilar amb la marca següent: --with-unixodbc[=ARG] # Emprar el control·lador ODBCcontra el paquet unixODBC. ::: noteclassic Més informació sobre la instal·lació de Zabbix des del [codi font](/manual/installation/install#from_the_sources). ::: #### Compressed content in web monitoring The ability to handle compressed content has been added to Zabbix web monitoring. All encoding formats supported by **libcurl** are supported. ### Contingut comprimit al monitoratge Web S'ha afegit la capacitat de gestionar contingut comprimit al monitoratge web de Zabbix. S'admeten tots els formats de codificació compatibles amb **libcurl**. ### Conditions The following conditions can be used in service actions: |Condition type|Supported operators|Description| |--|--|------| |*Service*|equals<br>does not equal|Specify a service or a service to exclude.<br>**equals** - event belongs to this service.<br>**does not equal** - event does not belong to this service.<br>Specifying a parent service implicitly selects all child services. To specify the parent service only, all nested services have to be additionally set with the **does not equal** operator.| |*Service name*|contains<br>does not contain|Specify a string in the service name or a string to exclude.<br>**contains** - event is generated by a service, containing this string in the name.<br>**does not contain** - this string cannot be found in the service name.| |*Service tag name*|equals<br>does not equal<br>contains<br>does not contain|Specify an event tag or an event tag to exclude. Service event tags can be defined in the service configuration section *Tags*.<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.| |*Service tag value*|equals<br>does not equal<br>contains<br>does not contain|Specify an event tag and value combination or a tag and value combination to exclude. Service event tags can be defined in the service configuration section *Tags*.<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.| :::noteimportant Make sure to define [message templates](/manual/config/notifications/media#overview) for Service actions in the *Administration->Media types* menu. Otherwise, the notifications will not be sent. ::: ### Condicions Les condicions següents es poden emprar en accions de manteniment: |Tipus de condició|Operadors admesos|Descripció| |--|--|------| |*Servei*|igual<br>no és igual|Especifiqueu un servei o servei que voleu excloure.<br>**igual** - l'esdeveniment pertany a aquest servei.<br>**no és igual** - l'esdeveniment no pertany a aquest servei.<br>Especificar un servei principal selecciona implícitament tots els serveis secundaris. Per especificar només el servei principal, tots els serveis heretats s'han de definir addicionalment amb l'operador **no és igual**.| |*Nom del servei*|conté<br>no conté|Especifiqueu una cadena al nom del servei o una cadena a excloure.<br>**conté** - l'esdeveniment el genera un servei, que conté aquesta cadena al nom . <br>**no conté** - aquesta cadena no s'ha pogut trobar al nom del servei.| |*El nom de l'etiqueta de servei*|igual<br>no és igual<br>conté<br>no conté|Especifiqueu una etiqueta d'esdeveniment o una etiqueta d'esdeveniment per excloure. Les etiquetes d'esdeveniment de servei es poden establir a la secció de configuració del servei *Etiquetes*.<br>**igual** - l'esdeveniment té aquesta etiqueta<br>**no és igual** - l'esdeveniment no té aquesta etiqueta<br >**conté** - l'esdeveniment té una etiqueta que conté aquesta cadena<br> **no conté** - l'esdeveniment no conté aquesta cadena. |*El valor de l'etiqueta de servei*|igual<br>no és igual<br>conté<br>no conté|Especifiqueu una combinació d'etiqueta d'esdeveniment i valor o una combinació d'etiqueta i valor per excloure. Les etiquetes d'esdeveniment de servei es poden establir a la secció de configuració del servei *Etiquetes*.<br>**igual** - l'esdeveniment té aquesta etiqueta i valor<br>**no és igual** - l'esdeveniment no té aquesta etiqueta i valor< br>**conté** - l'esdeveniment té una etiqueta i un valor que conté aquestes cadenes<br>**no conté** - l'esdeveniment n 'no té cap etiqueta i valor que contingui aquestes cadenes.| :::noteimportant Assegureu-vos de definir les [plantilles de missatges](/manual/config/notifications/media#overview) per a les accions de servei al menú *Administració->Tipus de mitjans*. En cas contrari, no s'enviaran notificacions. ::: #### 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. ::: #### Camps configurables Les comandes a executar han d'ésser al camp **Script executat** a la configuració de l'element.<br> Es poden executar múltiples comandes, una rere l'altra, posant-les a línies noves. En aquest cas, el valor tornat serà igualment formulat en diverses línies. Els caràcters admesos amb els que el prompt pot acabar són: - $ - \# - > - % ::: noteclassic Una línia telnet que acaba per un d'aquests caràcters s'esborrarà del valor tornat, però només per la primera comanda de la llista de comandes; és a dir, només al principi de la sessió Telnet. ::: |Clau|Descripció|Comentaris| |---|-----------|--------| |**telnet.run\[<unique short description>,<ip>,<port>,<encoding>\]**|Executa una comanda sobre un perifèric remot emprant una connexió Telnet| | ::: noteimportant Si una verificació telnet retorna un valor amb caràcters no-ASCII i una codificació no-UTF8, el paràmetre <encoding> de la clau s'ha d'especificar correctament. Veieu la pàgina de [codificació dels valors retornats](/manual/appendix/items/encoding_of_values) per tindre més detalls. ::: #### Configurable fields The **key** is a unique item identifier (per host). You can create any key name using supported symbols. Calculation definition should be entered in the **Formula** field. There is virtually 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.| |*parameter(s)*|Parameters of the function, if required.| ::: 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 #### Camps configurables La **clau** és un identificador d'element únic (per equip). Podeu crear qualsevol nom de clau emprant símbols admesos. La definició del càlcul s'ha d'introduir al camp **Fórmula**. Gairebé no hi ha connexió entre la fórmula i la clau. Els paràmetres clau no s'empren a la fórmula de cap manera. La sintaxi d'una fórmula simple és: function(/host/key,<paràmetre1>,<paràmetre2>,...) O: | | | |--|---------| |*function*|Una de les [funcions admeses](/manual/apèndix/funcions): last, min, max, avg, count, etc| |*host*|Equip de l'element emprat per al càlcul.<br>L'equip actual es pot ometre (com a `function(//key,parameter,...)`).| |*key*|Clau de l'element emprat per al càlcul.| |*paràmetre(s)*|Paràmetres de funció, si cal.| ::: noteimportant Les [macros d'usuari](/manual/config/macros/user_macros) de la fórmula s'ampliaran si s'empren per fer referència a un paràmetre de funció, un paràmetre de filtre d'element o una constant. Les macros d'usuari NO s'ampliaran pas si fan referència a una funció, nom d'equip, clau d'element, paràmetre de clau d'element o operador. ::: Una fórmula més complexa pot emprar una combinació de funcions, operadors i parèntesis. Podeu emprar totes les funcions admeses i [operators](/manual/config/triggers/expression#operators) a les expressions de triggers. La lògica i la precedència de l'operador són exactament la mateixa. A diferència dels triggers, Zabbix processa els elements calculats en funció de l'interval d'actualització de l'element, no quan es rep un valor nou. Tots els elements als quals fan referència les funcions d'històric a la fórmula d'elements calculats han d'existir i recopilar dades. A més, si canvieu la clau d'element d'un element de referència, haureu d'actualitzar manualment totes les fórmules amb aquesta clau. Un element calculat pot quedar sense suport en diversos casos: - els articles de referència - no es troba - és inhabilitat - pertany a l'equip desactivat - no és compatible (excepte amb la funció nodata() i [operadors](/manual/config/triggers/expression#operators) amb valors desconeguts) - No hi ha dades per calcular una funció - Divisió per zero - S'empra una sintaxi incorrecta ### Configurable TLS and connection parameters in MQTT plugin The [MQTT plugin](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin) for Zabbix agent 2 now provides additional configuration options, which can be defined in the plugin configuration file as [named session](/manual/config/items/plugins#named-sessions) or [default](/manual/config/items/plugins#default-values) parameters: - Connection-related parameters: broker URL, topic, username, and password; - TLS encryption parameters: location of the top-level CA(s) certificate, MQTT certificate or certificate chain, private key. All of the new parameters are optional. ### TLS i paràmetres de connexió configurables al connector MQTT El [connector MQTT](/manual/appendix/config/zabbix_agent2_plugins/mqtt_plugin) per a l'agent Zabbix 2 ara ofereix opcions de configuració addicionals, que es poden definir al fitxer de configuració del connector com a [sessió anomenada](/manual/config/items/plugins #named-sessions) o paràmetres [per defecte](/manual/config/items/plugins#default-values): - Paràmetres relacionats amb la connexió: URL del corredor, tema, nom d'usuari i mot de pas; - Paràmetres de xifrat TLS: ubicació del certificat de CA(s) de nivell superior, certificat MQTT o cadena de certificats, clau privada. Tots els nous paràmetres són opcionals. ### Configuration ### Configuració #### Configuration #### Configuració #### Configuration #### Configuració #### Configuration #### Configuració #### Configuration #### Configuració #### Configuration #### Configuració #### Configuration #### Configuració #### Configuration #### Configuració ### Configuration 1. Create disabled Script item on the main VMware host (where the **eventlog[]** item is present) with the following parameters:  - *Name*: VMware metrics - *Type*: Script - *Key*: vmware.metrics - *Type of information*: Text - *Script*: copy and paste the [script](#script) provided below - *Timeout*: 10 - *History storage period*: Do not keep history - *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]` ### Configuració 1. Crear un element d'script desactivat sobre l'equip VMware principal (on l'element **eventlog[]** és present) amb els paràmetres següents:  - *Nom*: mètriques VMware - *Tipus*: Script - *Clau*: vmware.metrics - *Tipus d'informació*: Text - *Script*: copieu i enganxeu l'[script](#script) proveït aquí sota - *Caducitat*: 10 - *Període d'emmagatzematge de l'històric*: No deseu pas històric - *Actiu* : sense marcar #### 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; Une fois l'élément configuré, appuyez sur le bouton *Test*, puis appuyez sur *Obtenir la valeur*. {width=600} Copiez le XML reçu dans n'importe quel formateur XML et trouvez la métrique souhaitée. Exemple de XML pour une métrique : <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> Utilisez XPath pour extraire le chemin du compteur du XML reçu. Pour l'exemple ci-dessus, le XPath sera : |champ |xPath | valeur | |--|--|--| |group| //groupInfo[../key=6]/key | cpu | |counter |//nameInfo[../key=6]/key |usagemhz | |rollup |//rollupType[../key=6] |average | Le chemin du compteur de performances résultant dans ce cas est : `cpu/usagemhz[average]` #### 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** - numeric value to be entered to specify map area width<br>**Height** - numeric value to be entered to specify 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} 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| #### Configuració {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Aquesta taula consta de paràmetres típics per al tipus d'element *Grup d'equips*: |Paràmetre|Descripció| |--|---------| |*Tipus*|Seleccioneu el tipus d'element:<br>**Grup d'equips** - icona que representa l'estat de tots els activadors de tots els amfitrions que pertanyen al grup triat| |*Mostra*|Mostra les opcions:<br>**Grup d'equips** - en triar aquesta opció, es mostrarà una sola icona que mostrarà la informació corresponent sobre el grup d'equips determinat<br>**Elements del grup d'equips** - triar aquesta opció resulta com a múltiples icones que mostren la informació corresponent sobre cada element (equip) d'un determinat grup d'equips| |*Tipus d'àrea*|Aquesta configuració és disponible si *Mostra* s'estableix a "Elements del grup d'equips":<br>**Ajust al mapa** - tots els elements del grup d'equips es posen de la mateixa manera dins del mapa<br>**Mida personalitzada* * - una configuració manual de l'àrea del mapa per a tots els elements del grup d'equips que es mostraran| |*Mida de l'àrea*|Aquesta configuració és disponible si *Tipus d'àrea" s'estableix a "Mida personalitzada":<br>**Amplada** - valor numèric que s'ha d'introduir per especificar l'amplada de l'àrea del mapa<br>** Alçada** - valor numèric que s'ha d'introduir per especificar l'alçada de l'àrea del mapa| |*Algorisme de col·locació*|**Graella** - només opció disponible per mostrar tots els elements del grup d'equips| |*Etiqueta*|Etiqueta de la icona, qualsevol cadena.<br>Es poden emprar [Macros](/manual/config/macros) i cadenes multilínia a les etiquetes.<br>Si el tipus d'element del mapa és "Grup d'equips", especificant determinades macros tenen un impacte en la vista del mapa que mostra la informació corresponent sobre cada equip. Per exemple, si s'empra la macro {HOST.IP}, la vista d'edició del mapa només mostrarà la macro {HOST.IP} mentre que la vista del mapa inclourà i mostrarà l'adreça IP única de cada equip | #### Configuration  ::: 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/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Enter host groups to display in the widget. 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.| |*Exclude host groups*|Enter host groups to hide from the widget. 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.| |*Hosts*|Enter hosts to display in the widget. 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.| |*Tags*|Specify tags to limit the number of web scenarios 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| |*Show hosts in maintenance*|Include hosts that are in maintenance in the statistics.| #### Configuració  :::noteclassic En els casos en què un usuari no té permís per accedir a determinats elements del giny, el nom d'aquest element apareixerà com a *Inaccessible* quan es configura el giny. Això fa que apareguin *Element inaccessible, Equip inaccessible, Grup inaccessible, Mapa inaccessible i Gràfic inaccessible* en lloc del nom "real" de l'element. ::: A més dels paràmetres [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: ||| |--|---------| |*Grups d'equips*|Introduïu els grups d'equips que voleu veure al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups que coincideixen.<br>En especificar un grup d'equips principal, es tria implícitament tots els grups d'equips heretats.<br> Es mostraran les dades de l'equip d'aquests grups d'equips al giny. Si no s'introdueix cap grup d'equips, es veuran tots els grups d'equips.| |*Exclou els grups d'equips*|Introduïu els grups d'equips que voleu amagar del giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups que coincideixen.<br>Especificar un grup d'equips principal triarà implícitament tots els grups d'equips heretats.<br> Les dades d'equip d'aquests grups d'equips no es veuran al giny. Per exemple, els equips 001, 002, 003 poden pertànyer al grup A i els equips 002, 003 també al grup B. Si optem per *ensenyar* el grup A i *excloure* el grup B al mateix temps, només es mostraran les dades de l'equip 001 al tauler.| |*Equips*|Introduïu els equips que voleu ensenyar al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom d'equip oferirà una llista desplegable d'equips coincidents.<br>Si no s'introdueix cap equip, es mostraran tots els equips.| |*Etiquetes*|Especifiqueu etiquetes per limitar el nombre d'escenaris web que es mostren al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms i valors d'etiquetes especificats ​​(distingeix entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats on els valors d'etiquetes contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou els noms d'etiquetes especificats <br>**No és igual a** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen el contingut introduït cadena (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per condició O<br>**O** - suficient si es compleix una condició| |*Ensenya equips en manteniment*|Inclou equips en manteniment a les estadístiques.| #### configuration Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `configuration.import`, `configuration.importcompare`: option `deleteMissing: true` for `templateLinkage` will now unlink missing templates (instead of unlink and clear). #### configuració Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `configuration.import`, `configuration.importcompare`: l'opció `deleteMissing: true` per `templateLinkage` es desenllaçarà de les plantilles absents (enlloc de desenllaçar i netejar). #### 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/administration/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. ::: #### Configuració El mode de depuració es pot activar per a usuaris individuals que pertanyen a un grup d'usuaris: - quan es configura un [grup d'usuaris](/manual/config/users_and_usergroups/usergroup#configuration); - en visualitzar la configuració de [grups d'usuaris](/manual/web_interface/frontend_sections/administration/user_groups). Quan el *mode de depuració* és habilitat per a un grup d'usuaris, aquest usuari veurà un botó *Depuració* a l'extrem inferior dret del navegador:  Si feu clic al botó *Depurar*, s'obre una finestra nova sota el contingut de la pàgina que conté les estadístiques SQL de la pàgina, així com una llista de trucades a l'API i sentències SQL individuals: {width="600"} En cas de problemes de rendiment amb la pàgina, aquesta finestra es podria emprar per cercar la causa principal del problema. ::: notewarning L'habilitació del *mode de depuració* afecta negativament el rendiment de la interfície web. ::: #### 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) #### Exemples de configuració Després de configurar els certificats necessaris, configureu els components de Zabbix per utilitzar el xifrat basat en certificats. Tot seguit es mostren les passes detallades per a la configuració: - [Servidor Zabbix](#zabbix-server) - [proxy Zabbix](#zabbix-proxy) - [agent Zabbix](#zabbix-agent) # configuration.export # configuration.export #### Configuration file For details on configuring Zabbix agent see the configuration file options for [zabbix\_agentd](/manual/appendix/config/zabbix_agentd) or [Windows agent](/manual/appendix/config/zabbix_agentd_win). #### Arxiu de configuració Per tindre més detalls de la configuració de l'agent Zabbix, veieu les opcions de l'arxiu de configuració per [zabbix\_agentd](/manual/appendix/config/zabbix_agentd) o l'[agent Windows]/manual/appendix/config/zabbix_agentd_win). ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_proxy) options for details on configuring zabbix\_proxy. ##### Arxiu de configuració Veure les opcions de l'[arxiu de configuració](/manual/appendix/config/zabbix_proxy) per tindre més detalls sobre la configuració del zabbix\_proxy. ##### Configuration file See the [configuration file](/manual/appendix/config/zabbix_server) options for details on configuring zabbix\_server. ##### Arxiu de configuració Veure les opcions de l'[arxiu de configuració](/manual/appendix/config/zabbix_server) per tindre més detalls sobre la configuració del zabbix\_server. #### Configuration file The configuration parameters of agent 2 are mostly compatible with Zabbix agent with some exceptions. |New parameters|Description| |--|--------| |*ControlSocket*|The runtime control socket path. 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 agent 2 for active items.| |*ForceActiveChecksOnStart*|Determines whether the agent should perform active checks immediately after restart or spread evenly over time. Supported since Zabbix 6.0.2.| |*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 agent 2 will be listening on for HTTP status request and display of a list of configured plugins and some internal parameters| |**Dropped parameters**|**Description**| |*AllowRoot*, *User*|Not supported because daemonization is not supported.| |*LoadModule*, *LoadModulePath*|Loadable modules are not supported.| |*StartAgents*|This parameter was used in Zabbix agent to increase passive check concurrency or disable them. In Agent 2, the concurrency is configured at a plugin level and can be limited by a capacity setting. Whereas disabling passive checks is not currently supported.| |*HostInterface*, *HostInterfaceItem*|Not yet supported.| For more details see the configuration file options for [zabbix\_agent2](/manual/appendix/config/zabbix_agent2). #### Arxiu de configuració La configuració de l'agent 2 és majoritàriament compatible amb l'agent Zabbix, però amb algunes excepcions. |Nova configuració|Descripció| |--|---------| |*ControlSocket*|La ruta al socket de control d'execució. L'agent 2 empra un sòcol de control per a [ordres d'execució](#runtime_control).| |*EnablePersistentBuffer*,<br>*PersistentBufferFile*,<br>*PersistentBufferPeriod*|Aquests paràmetres s'empren per configurar l'emmagatzematge persistent a l'agent 2 per als elements actius.| |*ForceActiveChecksOnStart*|Determina si l'agent ha de fer comprovacions actives immediatament després del reinici o si es distribueixen uniformement al llarg del temps. Suportat des de Zabbix 6.0.2.| |*Connectors*|Els connectors poden tindre els seus propis paràmetres, en format `Connectors.<Nom del connector>.<Paràmetre>=<valor>`. Un paràmetre de connector comú és *System.Capacity*, que estableix el límit de comprovacions que es poden executar al mateix temps.| |*StatusPort*|Port Agent 2 escoltarà la petició d'estat HTTP i mostrarà una llista de connectors configurats i alguns paràmetres interns| |**Dropped paràmeters**|**Description**| |*AllowRoot*,*User*|No s'admet perquè la demonització no és compatible.| |*LoadModule*,*LoadModulePath*|No s'admeten els mòduls carregables.| |*StartAgents*|Aquest paràmetre es va emprar a l'agent Zabbix per augmentar la concurrència de comprovacions passives o per desactivar-les. A l'Agent 2, la concurrència es configura a nivell de connector i es pot limitar per una configuració de capacitat, tot i que la desactivació de comprovacions passives actualment no és compatible.| |*HostInterface*,*HostInterfaceItem*|Encara no és compatible.| Per obtindre més informació, veieu les opcions del fitxer de configuració per a [zabbix\_agent2](/manual/appendix/config/zabbix_agent2). #### Configuration For virtual machine monitoring to work, Zabbix should be [compiled](/manual/installation/install#configure_the_sources) with the --with-libxml2 and --with-libcurl compilation options. The following configuration file options can be used to tune the Virtual machine monitoring: - **StartVMwareCollectors** - the number of pre-forked vmware collector instances.<br> This value depends on the number of VMware services you are going to monitor. For the most cases this should be:<br> *servicenum < StartVMwareCollectors < (servicenum \* 2)*<br> where *servicenum* is the number of VMware services. E. g. if you have 1 VMware service to monitor set StartVMwareCollectors to 2, if you have 3 VMware services, set it to 5. Note that in most cases this value should not be less than 2 and should not be 2 times greater than the number of VMware services that you monitor. Also keep in mind that this value also depends on your VMware environment size and *VMwareFrequency* and *VMwarePerfFrequency* configuration parameters (see below). - **VMwareCacheSize** - **VMwareFrequency** - **VMwarePerfFrequency** - **VMwareTimeout** For more details, see the configuration file pages for Zabbix [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy). ::: noteimportant To support datastore capacity metrics Zabbix requires VMware configuration vpxd.stats.maxQueryMetrics parameter to be at least 64. See also the VMware knowledge base [article](https://kb.vmware.com/s/article/2107096). ::: #### Configuració Perquè funcioni el monitoratge de VM, Zabbix ha d'ésser [compilat](/manual/installation/install#configure-the-sources) amb les opcions de compilació --with-libxml2 i --with-libcurl. Les opcions de fitxer de configuració següents es poden emprar per optimitzar el monitoratge de la màquina virtual: - **StartVMwareCollectors** - nombre d'instàncies predefinides de vmware collector.<br> Aquest valor depèn del nombre de serveis de VMware que monitoreu. La majoria dels casos, això hauria de ser:<br> *servicenum < StartVMwareCollectors < (servicenum * 2)*<br> on *servicenum* és el nombre de serveis de VMware. Per exemple, si teniu 1 servei VMware per monitorar, establiu StartVMwareCollectors a 2, si teniu 3 serveis VMware, establiu-lo a 5. Tingueu en compte que, en la majoria dels casos, aquest valor no hauria de ser inferior a 2 i no hauria de ser el doble del nombre dels serveis de VMware que controleu. Tingueu en compte que aquest valor també depèn de la mida del vostre entorn VMware i dels paràmetres de configuració *VMwareFrequency* i *VMwarePerfFrequency* (vegeu més avall). - **VMwareCacheSize** - **VMwareFrequency** - **VMwarePerfFrequency** - **VMwareTimeout** Per obtindre més informació, consulteu les pàgines del fitxer de configuració del [servidor](/manual/appendix/config/zabbix_server) i [proxy](/manual/appendix/config/zabbix_proxy) Zabbix. ::: noteimportant Per admetre les mètriques de capacitat del magatzem de dades, Zabbix requereix que el paràmetre de configuració de VMware vpxd.stats.maxQueryMetrics sigui com a mínim 64. Veieu també l'[article](https://kb.vmware.com/s/article/2107096) de la base de coneixement de VMware. ::: #### Configuration Global notifications can be enabled per user in the *Messaging* tab of [profile configuration](/manual/web_interface/user_profile).  |Parameter|Description| |--|--------| |*Frontend messaging*|Mark the checkbox to enable global notifications.| |*Message timeout*|You can set for how long the message will be displayed. By default, messages will stay on screen for 60 seconds.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 5m, 2h, 1d.| |*Play sound*|You can set how long 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*|You can set the trigger severities that global notifications and sounds will be activated for. You can also select the sounds appropriate for various severities.<br>If no severity is marked then no messages will be displayed at all.<br>Also, recovery messages will only be displayed for those severities that are marked. So if you mark *Recovery* and *Disaster*, global notifications will be displayed for the problems and the recoveries of disaster severity triggers.| |*Show suppressed problems*|Mark the checkbox to display notifications for problems which would otherwise be suppressed (not shown) because of host maintenance.| #### Configuració Les notificacions globals es poden activar per usuari a la pestanya *Missatgeria* de [Configuració del perfil](/manual/web_interface/user_profile).  |Configuració|Descripció| |-----------|-----------| |*Missatge a la interfície*|Marqueu la casella per activar les notificacions globals.| |*Caducitat del missatge*|Podeu establir quant de temps es veurà el missatge. De manera predeterminada, els missatges romanen a la pantalla durant 60 segons.<br>El [sufixos](/manual/appendix/suffixes) de temps són compatibles, per exemple: 30 s, 5 m, 2 h, 1 d.| |*Reproduir un so*|Podeu definir quant de temps es reproduirà el so.<br>**Un cop** - el so es reprodueix una vegada completament.<br>**10 segons** - el so es repeteix durant 10 segons.<br>**Temps d'espera del missatge** - el so es repeteix mentre el missatge sigui visible.| |*Gravetat del trigger*|Podeu establir gravetats del trigger per als quals s'habiliten les notificacions i els sons globals. També podeu triar sons per a diferents graveteats.<br>Si no hi ha cap gravetat marcada, no es veurà cap missatge.<br>A més, els missatges de recuperació només es veuran per a les gravetats marcades. Per tant, si marqueu *Recuperació* i *Desastre*, es veuran notificacions globals per a problemes i recuperacions de triggers de la gravetat del desastre.| |*Veure els problemes esborrats*|Marqueu la casella per veure notificacions sobre problemes que d'altra manera es suprimirien (no es mostrarien) a causa del manteniment de l'equip.| # configuration.import # configuration.import # configuration.importcompare # configuration.importcompare ### Configuration import Previously, the import process would fail on a UUID mismatch of an importable entity (host group, item, graph, etc). For example, it was not possible to import a host group if a host group with the same name already existed on the host. In the new version the import will not fail because of a UUID mismatch; instead the entity will be matched by the uniqueness criteria such as entity ID (name). The entity will be imported, and the UUID will be updated to the UUID of the imported entity. In another improvement, when removing template linkage (the *Delete missing* option for template linkage) through the imported template or host, the inherited entities of the unlinked template are no longer removed (template gets unlinked, not unlinked and cleared), unless these entities are missing in the import file **and** the *Delete missing* option for the specific entity is marked. Due to this change, the warning message when marking the *Delete missing* option for template linkage will no longer be displayed. ### Configuració d'importació Abans, el procés d'importació fallava si hi havia una discrepància en l'UUID d'una entitat importable (grup d'equips, element, gràfic, etc.). Per exemple, no era possible importar un grup d'equips si ja hi havia un grup d'equips amb el mateix nom a l'equip. A la nova versió, la importació no fallarà a causa d'una discrepància d'UUID; en canvi, l'entitat es farà coincidir amb criteris d'unicitat, com ara l'identificador d'entitat (nom). L'entitat s'importarà i l'UUID s'actualitzarà amb l'UUID de l'entitat importada. En una altra millora, quan s'esborra l'acoblament de models (manca l'opció *Suprimir* per a l'acoblament de models) mitjançant un model o un equip importats, les entitats heretades del model sense enllaç ja no s'esborren (el model és desenllaçat, no desenllaçat i esborrat), tret que aquestes entitats no siguin al fitxer d'importació **i** l'opció *Esborra el que manca* per a l'entitat específica sigui marcada. A causa d'aquest canvi, el missatge d'avís en marcar l'opció *Esborrar el que manca* per a l'aparellament de models ja no es mostrarà. ### Configuration import See changes in the [configuration import](/manual/introduction/whatsnew6013#configuration-import) process. ### Importar configuracions Veieu els canvis al procés [importació de la configuració](/manual/introduction/whatsnew6013#configuration-import). #### Configuration In order to enable maintenance mode, the `maintenance.inc.php` file (located in `/conf` of Zabbix HTML document directory on the web server) must be modified to 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...'; #### Configuració Per habilitar el mode de manteniment, el fitxer `maintenance.inc.php` (situat a /conf del directori HTML de Zabbix al servidor web) s'ha d'editar per esborrar els comentaris i assemblar-se a: // Mode de manteniment. define('ZBX_DENY_GUI_ACCESS', 1); // Matriu d'adreces IP que es permeten connectar a la interfície (opcional). $ZBX_GUI_ACCESS_IP_RANGE = array('127.0.0.1'); // Missatge que es veuen a la pantalla d'avís (opcional). $ZBX_GUI_ACCESS_MESSAGE = 'Som actualitzant la base de dades MySQL fins a les 15:00. Estigueu atents...'; ### Configuration In the *Type* field of [item configuration form](/manual/config/items/item) select Script then fill out required fields.  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>[Built-in macros](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} and [user macros](/manual/config/macros/user_macros) are supported.| |Script|Enter JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it). This code must provide the logic for returning the metric value.<br>The code has access to all parameters, it may perform HTTP GET, POST, PUT and DELETE requests and has control over HTTP headers and request body.<br>See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects), [JavaScript Guide](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |Timeout|JavaScript execution timeout (1-60s, default 3s); exceeding it will return error.<br>Time suffixes are supported, e.g. 30s, 1m.<br>Depending on the script it might take longer for the timeout to trigger. | #### Configuració Al camp *Tipus* del [formulari de configuració d'element](/manual/config/items/item), trieu Script i ompliu els camps necessaris.  Tots els camps obligatoris es marquen amb un asterisc vermell. Els camps que necessiten informació específica per als elements d'script són: |Camp|Descripció| |--|--------| |Clau|Clau única que s'emprarà per identificar l'element.| |Paràmetres|Especifiqueu les variables a transmetre a l'script com atributs i valors.<br>S'admeten [Macros integrades](/manual/config/macros) {HOST.CONN}, {HOST.DNS}, {HOST .HOST}, {HOST.IP}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG} i [macros d'usuari](/manual/config/macros/user_macros).| |Script|Entreu el codi JavaScript al bloc que apareix quan cliqueu el camp de paràmetre (o al botó afegir/modificar que hi ha al seu costat). Aquest codi proveeix la lògica per retornar el valor de la mètrica.<br>El codi té accés a tots els paràmetres, i pot fer peticions HTTP GET, POST, PUT i DELETE i controlar les capçaleres HTTP i el cos de la petició.<br>Veieu també: [Objectes JavaScript suplementaris](/manual/config/items/preprocessing/javascript/javascript_objects), [Guia JavaScript](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide).| |Caducitat|Temps d'execució de JavaScript (1-60s, 3s per defecte); sobrepassar-ho tornarà un error.<br>Els sufixes horaris s'admeten, per exemple. 30s, 1m.<br>Segons l'script, el temps d'espera pot prendre més temps a executar el trigger. | #### Configuration ::: noteimportant Only Super admin users can create host groups. ::: There are two options of creating a host group in Zabbix frontend. **Option one**: - Go to: *Configuration* → *Host groups* - Click on *Create Group* in the upper right corner of the screen - 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 *Groups* input field. Once the host group is created, you can click on the group name in the list under *Configuration* → *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. #### Configuració ::: noteimportant Només els usuaris superadministradors poden crear grups d'equips. ::: Hi ha dues opcions per crear un grup d'equips a la interfície Zabbix. **Opció 1**: - Vés a: *Configuració* → *Grups d'equips* - Feu clic a *Crea un grup* a la cantonada superior dreta de la pantalla - Introduïu el nom del grup al formulari  **Opció dos**: quan [configureu un equip](/manual/config/hosts/host#configuration), introduïu un nom de grup inexistent al camp d'entrada *Grups*. Un cop creat el grup d'equips, podeu fer clic al nom del grup a la llista sota *Configuració* → *Grups d'equips* per editar el nom del grup, clonar-lo o esborrar-lo. En esborrar un grup d'equips, només s'esborra el grup lògic, no els equips del grup. No és possible esborrar un grup d'equips que sigui l'únic grup per a qualsevol equip existent. #### Configuration ODBC configuration is done by editing **odbcinst.ini** and **odbc.ini** files. These configuration files can be found in */etc* folder. The file **odbcinst.ini** may be missing and in this case it is necessary to create it manually. **odbcinst.ini** [mysql] Description = General ODBC for MySQL Driver = /usr/lib64/libmyodbc5.so Setup = /usr/lib64/libodbcmyS.so FileUsage = 1 Please consider the following examples of **odbc.ini** configuration parameters. - An example with a connection through an IP: ```{=html} <!-- --> ``` [TEST_MYSQL] Description = MySQL database 1 Driver = mysql Port = 3306 Server = 127.0.0.1 - An example with a connection through an IP and with the use of credentials. A Zabbix database is used by default: ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED] Description = MySQL database 2 Driver = mysql User = root Port = 3306 Password = zabbix Database = zabbix Server = 127.0.0.1 - An example with a connection through a socket and with the use of credentials. A Zabbix database is used by default: ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED_SOCK] Description = MySQL database 3 Driver = mysql User = root Password = zabbix Socket = /var/run/mysqld/mysqld.sock Database = zabbix All other possible configuration parameter options can be found in [MySQL official documentation](https://dev.mysql.com/doc/connector-odbc/en/connector-odbc-configuration-connection-parameters.html) web page. #### Configuració La configuració ODBC es fa editant els arxius **odbcinst.ini** i **odbc.ini**. Aquest arxius de configuració són al directori */etc*. L'arxiu **odbcinst.ini** potser no hi és i cal crear-lo manualment. **odbcinst.ini** [mysql] Description = General ODBC for MySQL Driver = /usr/lib64/libmyodbc5.so Setup = /usr/lib64/libodbcmyS.so FileUsage = 1 Tingueu en compte els següents exemples de paràmetres de configuració **odbc.ini**. - Un exemple amb una connexió via una dreça IP: ```{=html} <!-- --> ``` [TEST_MYSQL] Description = MySQL database 1 Driver = mysql Port = 3306 Server = 127.0.0.1 - Un exemple amb una connexió via una adreça IP i emprant informació d'identificació. Una base de dades Zabbix s'empra per defecte: ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED] Description = MySQL database 2 Driver = mysql User = root Port = 3306 Password = zabbix Database = zabbix Server = 127.0.0.1 - Un exemple amb una connexió via un socket i emprant informació d'identificació. S'empra una base de dades Zabbix per defecte: ```{=html} <!-- --> ``` [TEST_MYSQL_FILLED_CRED_SOCK] Description = MySQL database 3 Driver = mysql User = root Password = zabbix Socket = /var/run/mysqld/mysqld.sock Database = zabbix Totes les altres opcions de paràmetres de configuració possibles es poden trobar al lloc web de la [documentació oficial de MySQL (https://dev.mysql.com/doc/connector-odbc/en/connector-odbc-configuration-connection-parameters.html). #### Configuration ODBC configuration is done by editing the **odbcinst.ini** and **odbc.ini** files. These configuration files can be found in */etc* folder. The file **odbcinst.ini** may be missing and in this case it is necessary to create it manually. Please consider the following examples: **odbcinst.ini** [postgresql] Description = General ODBC for PostgreSQL Driver = /usr/lib64/libodbcpsql.so Setup = /usr/lib64/libodbcpsqlS.so FileUsage = 1 # Since 1.6 if the driver manager was built with thread support you may add another entry to each driver entry. # This entry alters the default thread serialization level. Threading = 2 **odbc.ini** [TEST_PSQL] Description = PostgreSQL database 1 Driver = postgresql #CommLog = /tmp/sql.log Username = zbx_test Password = zabbix # Name of Server. IP or DNS Servername = 127.0.0.1 # Database name Database = zabbix # Postmaster listening port Port = 5432 # Database is read only # Whether the datasource will allow updates. ReadOnly = No # PostgreSQL backend protocol # Note that when using SSL connections this setting is ignored. # 7.4+: Use the 7.4(V3) protocol. This is only compatible with 7.4 and higher backends. Protocol = 7.4+ # Includes the OID in SQLColumns ShowOidColumn = No # Fakes a unique index on OID FakeOidIndex = No # Row Versioning # Allows applications to detect whether data has been modified by other users # while you are attempting to update a row. # It also speeds the update process since every single column does not need to be specified in the where clause to update a row. RowVersioning = No # Show SystemTables # The driver will treat system tables as regular tables in SQLTables. This is good for Access so you can see system tables. ShowSystemTables = No # If true, the driver automatically uses declare cursor/fetch to handle SELECT statements and keeps 100 rows in a cache. Fetch = Yes # Bools as Char # Bools are mapped to SQL_CHAR, otherwise to SQL_BIT. BoolsAsChar = Yes # SSL mode SSLmode = Require # Send to backend on connection ConnSettings = #### Configuració La configuració ODBC es fa editant els arxius **odbcinst.ini** i **odbc.ini**. Aquests arxius de configuració es poden trobar al directori */etc*. L'arxiu **odbcinst.ini** potser no hi és; en aquest cas, cal crear-lo manualment. Tingueu en compte els exemples següents: **odbcinst.ini** [postgresql] Description = General ODBC for PostgreSQL Driver= /usr/lib64/libodbcpsql.so Setup= /usr/lib64/libodbcpsqlS.so FileUsage= 1 # Since 1.6 if the driver manager was built with thread support you may add another entry to each driver entry. # This entry alters the default thread serialization level. Threading= 2 **odbc.ini** [TEST_PSQL] Description = PostgreSQL database 1 Driver= postgresql #CommLog = /tmp/sql.log Username = zbx_test Password = zabbix # Name of Server. IP or DNS Servername = 127.0.0.1 # Database name Database = zabbix # Postmaster listening port Port = 5432 # Database is read only # Whether the datasource will allow updates. ReadOnly = No # PostgreSQL backend protocol # Note that when using SSL connections this setting is ignored. # 7.4+: Use the 7.4(V3) protocol. This is only compatible with 7.4 and higher backends. Protocol = 7.4+ # Includes the OID in SQLColumns ShowOidColumn = No # Fakes a unique index on OID FakeOidIndex= No # Row Versioning # Allows applications to detect whether data has been modified by other users # while you are attempting to update a row. # It also speeds the update process since every single column does not need to be specified in the where clause to update a row. RowVersioning = No # Show SystemTables # The driver will treat system tables as regular tables in SQLTables. This is good for Access so you can see system tables. ShowSystemTables = No # If true, the driver automatically uses declare cursor/fetch to handle SELECT statements and keeps 100 rows in a cache. Fetch = Yes # Bools as Char # Bools are mapped to SQL_CHAR, otherwise to SQL_BIT. BoolsAsChar = Yes # SSL mode SSLmode = Require # Send to backend on connection ConnSettings = #### Configuration ODBC configuration is done by editing the **odbcinst.ini** and **odbc.ini** files. These configuration files can be found in */etc* folder. The file **odbcinst.ini** may be missing and in this case it is necessary to create it manually. Please consider the following examples: **odbcinst.ini** vi /etc/odbcinst.ini [FreeTDS] Driver = /usr/lib64/libtdsodbc.so.0 **odbc.ini** vi /etc/odbc.ini [sql1] Driver = FreeTDS Server = <SQL server 1 IP> PORT = 1433 TDS_Version = 8.0 #### Configuració La configuració d'ODBC es fa editant els arxius **odbcinst.ini** i **odbc.ini**. Aquests arxius de configuració són al directori */etc*. Podria ser que l'arxiu **odbcinst.ini** no hi fos pas, i per tant cal crear-lo a mà. Considereu els següents exemples: **odbcinst.ini** vi /etc/odbcinst.ini [FreeTDS] Driver = /usr/lib64/libtdsodbc.so.0 **odbc.ini** vi /etc/odbc.ini [sql1] Driver = FreeTDS Server = <SQL server 1 IP> PORT = 1433 TDS_Version = 8.0 ### 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. #### Configuració Un cop el proxy sigui [instal·lat](/manual/installation/install) i [configurat](/manual/appendix/config/zabbix_proxy), cal afegir-lo a la interfície Zabbix. #### Configuration Overall, the process of setting up the notification should feel familiar to those who have set up alerts in Zabbix before. #### Configuració En general, el procés de configuració de notificacions hauria de semblar familiar per a aquells que ja han configurat alertes a Zabbix. #### Configuration parameters For Zabbix server/proxy new configuration parameters have been added for Vault authentication and retrieving database credentials: - VaultToken - Vault authentication token (see Zabbix [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) configuration file for details) - VaultURL - Vault server HTTP\[S\] URL - VaultDBPath - Vault path from where credentials for database will be retrieved by keys 'password' and 'username' (for example: secret/zabbix/database) Zabbix server and Zabbix proxy read the Vault-related configuration parameters from zabbix\_server.conf and zabbix\_proxy.conf upon startup. Zabbix server and Zabbix proxy will additionally read "VAULT\_TOKEN" environment variable once during startup and unset it so that it would not be available through forked scripts; it is an error if both VaultToken and VAULT\_TOKEN contain value. ::: noteclassic Forward slash and colon are reserved symbols. Forward slash can only be used to separate mount point from path (e.g. secret/zabbix where mount point is "secret" and "zabbix" is path) and, in case of Vault macros, colon can only be used to separate path from key. It is possible to URL-encode "/" and ":" if there is need to create mount point with name that is separated by forward slash (e.g. foo/bar/zabbix where mount point is "foo/bar" and path is "zabbix" as "foo%2Fbar/zabbix") and if mount point name or path needs to contain colon. ::: #### Paràmetres de configuració Per al servidor/proxy Zabbix, s'han afegit nous paràmetres de configuració per a l'autenticació de Vault i la recuperació de credencials de base de dades: - VaultToken: testimoni d'autenticació de Vault (veieu els fitxers de configuració de Zabbix [servidor](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) per a més informació) - VaultURL - URL HTTP\[S\] del servidor Vault - VaultDBPath: camí de volta des d'on es recuperaran les credencials de la base de dades mitjançant les claus "mot de pas" i "nom d'usuari" (p. ex.: secret/zabbix/base de dades) El servidor Zabbix i el proxy Zabbix llegeixen els paràmetres de configuració relacionats amb Vault des de zabbix\_server.conf i zabbix\_proxy.conf a l'inici. El servidor Zabbix i el proxy Zabbix també llegiran la variable d'entorn "VAULT\_TOKEN" un cop a l'inici i la desactivaran perquè no sigui disponible mitjançant scripts externs o maliciosos; és un error si VaultToken i VAULT\_TOKEN contenen un valor. :::noteclassic La barra inclinada i els dos punts són símbols reservats. La barra inclinada només es pot emprar per separar el punt de muntatge del camí (per exemple, secret/zabbix on el punt de muntatge és "secret" i "zabbix" és el camí) i, en el cas de les macros de Vault, només es poden emprar els dos punts per separar el camí de la clau. És possible codificar l'URL "/" i ":" si és necessari crear un punt de muntatge amb un nom separat per una barra inclinada (per exemple, foo/bar/zabbix on el punt de muntatge és "foo/bar" i el path és "zabbix" com "foo%2Fbar/zabbix") i si el nom del punt de muntatge o el camí ha de contindre dos punts. ::: #### 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: 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. #### Paràmetres de configuració L'agent, el servidor i el proxy de Zabbix admeten dos [paràmetres](/manual/appendix/config/zabbix_server) per gestionar els mòduls: - LoadModulePath: camí complet a la ubicació dels mòduls carregables - LoadModule: mòdul(s) per carregar a l'inici. Els mòduls s'han d'ubicar en un directori especificat per LoadModulePath o el camí ha de precedir el nom del mòdul. Si el camí anterior és absolut (comença amb '/'), llavors LoadModulePath s'ignora. Es permeten incloure diversos paràmetres de LoadModule. Per exemple, per ampliar l'agent Zabbix, podríem afegir els paràmetres següents: LoadModulePath=/usr/local/lib/zabbix/agent/ LoadModule=mariadb.so LoadModule=apache.so LoadModule=kernel.so LoadModule=/usr/local/lib/zabbix/dummy.so A l'inici de l'agent, carregarà els mòduls mariadb.so, apache.so i kernel.so des del directori /usr/local/lib/zabbix/agent mentre que dummy.so es carregarà des de /usr/local/lib/zabbix. Fallarà si manca un mòdul, si hi ha permisos incorrectes o si una biblioteca compartida no és un mòdul Zabbix. #### Configuration Preprocessing rules are defined in the **Preprocessing** tab of the item [configuration](/manual/config/items/item#configuration) form. {width="600"} ::: noteimportant An item will become [unsupported](/manual/config/items/item#unsupported_items) if any of the preprocessing steps fail, unless *Custom on fail* error-handling (available for supported transformations) has been configured to discard the value or to set a specified value. For log items, log metadata (without value) will always reset item unsupported state and make item supported again, even if the initial error occurred after receiving a log value from agent. ::: [User macros](/manual/config/macros/user_macros) and user macros with context are supported in item value preprocessing parameters, including JavaScript code. ::: noteclassic Context is ignored when a macro is replaced with its value. Macro value is inserted in the code as is, it is not possible to add additional escaping before placing the value in the JavaScript code. Please be advised, that this can cause JavaScript errors in some cases. ::: |Type|<|<| |-|----------|----------------------------------------| | |*Transformation*|Description| |Text|<|<| | |*Regular expression*|Match the value to the <pattern> regular expression and replace value with <output>. The regular expression supports extraction of maximum 10 captured groups with the \\N sequence. Failure to match the input value will make the item unsupported.<br>Parameters:<br>**pattern** - regular expression<br>**output** - 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.<br>Please refer to [regular expressions](/manual/regular_expressions#example) section for some existing examples.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Replace*|Find the search string and replace it with another (or nothing). All occurrences of the search string will be replaced.<br>Parameters:<br>**search string** - the string to find and replace, case-sensitive (required)<br>**replacement** - the string to replace the search string with. The replacement string may also be empty effectively allowing to delete the search string when found.<br>It is possible to use escape sequences to search for or replace line breaks, carriage return, tabs and spaces "\\n \\r \\t \\s"; backslash can be escaped as "\\\\" and escape sequences can be escaped as "\\\\n". Escaping of line breaks, carriage return, tabs is automatically done during low-level discovery.| |^|*Trim*|Remove specified characters from the beginning and end of the value.| |^|*Right trim*|Remove specified characters from the end of the value.| |^|*Left trim*|Remove specified characters from the beginning of the value.| |Structured data|<|<| | |*XML XPath*|Extract value or fragment from XML data using XPath functionality.<br>For this option to work, Zabbix server must be compiled with libxml support.<br>Examples:<br>`number(/document/item/value)` will extract `10` from `<document><item><value>10</value></item></document>`<br>`number(/document/item/@attribute)` will extract `10` from `<document><item attribute="10"></item></document>`<br>`/document/item` will extract `<item><value>10</value></item>` from `<document><item><value>10</value></item></document>`<br>Note that namespaces are not supported.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*JSON Path*|Extract value or fragment from JSON data using [JSONPath functionality](/manual/config/items/preprocessing/jsonpath_functionality).<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*CSV to JSON*|Convert CSV file data into JSON format.<br>For more information, see: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).| |^|*XML to JSON*|Convert data in XML format to JSON.<br>For more information, see: [Serialization rules](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |Arithmetic|<|<| | |*Custom multiplier*|Multiply the value by the specified integer or floating-point value.<br>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>Supported: scientific notation, for example, `1e+70` (since version 2.2); user macros and LLD macros (since version 4.0); strings that include macros, for example, `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}`(since version 5.2.3)<br>The macros must resolve to an integer or a floating-point number.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |Change|<|<| | |*Simple change*|Calculate the difference between the current and previous value.<br>Evaluated as **value**-**prev\_value**, where<br>*value* - current value; *prev\_value* - previously received value<br>This setting can be useful to measure a constantly growing value. If the current value is smaller than the previous value, Zabbix discards that difference (stores nothing) and waits for another value.<br>Only one change operation per item is allowed.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Change per second*|Calculate the value change (difference between the current and previous value) speed per second.<br>Evaluated as (**value**-**prev\_value**)/(**time**-**prev\_time**), where<br>*value* - current value; *prev\_value* - previously received value; *time* - current timestamp; *prev\_time* - timestamp of previous value.<br>This setting is useful for calculating the speed per second for a constantly growing value. 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>*Note*: 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>Only one change operation per item is allowed.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |Numeral systems|<|<| | |*Boolean to decimal*|Convert the value from boolean format to decimal. 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:<br>*TRUE* - true, t, yes, y, on, up, running, enabled, available, ok, master<br>*FALSE* - false, f, no, n, off, down, unused, disabled, unavailable, err, slave<br>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 select 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.| |^|*Octal to decimal*|Convert the value from octal format to decimal.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Hexadecimal to decimal*|Convert the value from hexadecimal format to decimal.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |Custom scripts|<|<| | |*JavaScript*|Enter JavaScript code in the block that appears when clicking in the parameter field or on a pencil icon.<br>Note that available JavaScript length depends on the [database used](/manual/config/items/item#custom-script-limit).<br>For more information, see: [Javascript preprocessing](/manual/config/items/preprocessing/javascript).| |Validation|<|<| | |*In range*|Define a range that a value should be in by specifying minimum/maximum values (inclusive).<br>Numeric values are accepted (including any number of digits, optional decimal part and optional exponential part, negative values). User macros and low-level discovery macros can be used. The minimum value should be less than the maximum.<br>At least one value must exist.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Matches regular expression*|Specify a regular expression that a value must match.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Does not match regular expression*|Specify a regular expression that a value must not match.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Check for error in JSON*|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. Note that 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 select 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.| |^|*Check for error in XML*|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. Note that 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 select 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.| |^|*Check for error using a regular expression*|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. Note that these external service errors are reported to the user as is, without adding preprocessing step information.<br>Parameters:<br>**pattern** - regular expression<br>**output** - 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.<br>If you mark the *Custom on fail* checkbox, it is possible to select 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.| |^|*Check for not supported value*|Check if no item value could be retrieved. Normally that would lead to the item becoming unsupported, but you may modify that behavior by specifying the *Custom on fail* error-handling options: to discard the value, to set a specified value (that can also be used in triggers) 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. Note that for this preprocessing step, the *Custom on fail* checkbox is grayed out and always marked.<br>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).<br>This step is always executed as the first preprocessing step and is placed above all others after saving changes to the item. It can be used only once.<br>Supported since 5.2.0.| |Throttling|<|<| | |*Discard unchanged*|Discard a value if it has not changed.<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 for an item.<br>Note that in case of a very small difference (less than 0.000001) between the values of the items monitored by Zabbix proxy, it is possible that discarding will not be performed correctly by the proxy, and the values will be stored in the history as the same value, unless Zabbix server database is [upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling-extended-range-of-numeric-float-values).| |^|*Discard unchanged with heartbeat*|Discard a value if it has not changed within the defined time period (in seconds).<br>Positive integer values are supported to specify the seconds (minimum - 1 second). Time suffixes can be used in this field (e.g. 30s, 1m, 2h, 1d). User macros and low-level discovery macros can be used in this field.<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 for an item.<br>Note that in case of a very small difference (less than 0.000001) between the values of the items monitored by Zabbix proxy, it is possible that discarding will not be performed correctly by the proxy, and the values will be stored in the history as the same value, unless Zabbix server database is [upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling-extended-range-of-numeric-float-values).| |Prometheus|<|<| | |*Prometheus pattern*|Use the following query to extract required data from Prometheus metrics.<br>See [Prometheus checks](/manual/config/items/itemtypes/http/prometheus) for more details.| |^|*Prometheus to JSON*|Convert required Prometheus metrics to JSON.<br>See [Prometheus checks](/manual/config/items/itemtypes/prometheus) for more details.| ::: noteimportant For change and throttling preprocessing steps Zabbix has to remember the last value to calculate/compare the new value as required. These previous values are handled by the preprocessing manager. If Zabbix server or proxy is restarted or there is any change made to preprocessing steps the last value of the corresponding item is reset, resulting in: - for *Simple change*, *Change per second* steps - the next value will be ignored because there is no previous value to calculated change from; - for *Discard unchanged*. *Discard unchanged with heartbeat* steps - the next value will never be discarded, even if it should have been because of discarding rules. ::: Item's *Type of information* parameter 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. ::: notetip 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. ::: #### Configuració Les regles de preprocessament es defineixen a la pestanya **Preprocessament** del formulari [configuració](/manual/config/items/item#configuration) de l'element. {width="600"} ::: noteimportant Un element es convertirà en [no suportat](/manual/config/items/item#items-not-supported) si alguna de les passes de preprocessament falla, tret que s'hagi especificat la gestió d'errors personalitzada mitjançant una opció *Personalitzada en cas d'error* per a les transformacions admeses. Per als articles del diari, les metadades del diari (sense valor) sempre restabliran l'estat no admès de l'element i tornaran a ser compatible amb l'element, fins i tot si l'error inicial es va produir després de rebre un valor de registre de l'agent. ::: Tant les [macros d'usuari](/manual/config/macros/user_macros) com les macros d'usuari amb context són compatibles amb els paràmetres de preprocessament del valor de l'element, inclòs el codi JavaScript. :::noteclassic El context s'ignora quan es substitueix una macro pel seu valor. El valor de la macro s'insereix tal com és al codi, no és possible afegir una escapada addicional abans de posar valor al codi JavaScript. Tingueu en compte que això pot provocar errors de JavaScript en alguns casos. ::: |Tipus|<|<| |-|-----------|-------------------------------------- ----| | |*Transformació*|Descripció| |Text|<|<| | |*Expressió regular*|Fa coincidir el valor amb l'expressió regular \<patró\> i substitueix el valor per \<sortida\>. L'expressió regular permet extreure un màxim de 10 grups capturats amb la seqüència \\N. Si el valor d'entrada no coincideix, l'element no serà compatible.<br>Paràmetres:<br>**patró** - expressió regular<br>**sortida** - patró de format de sortida. Una seqüència d'escapada \\N (on N=1...9) es substitueix pel grup enèssim corresponent. Una seqüència d'escapada \\0 es substitueix pel text corresponent.<br>Consulteu la secció [expressions regulars](/manual/regular_expressions#example) per veure alguns exemples existents.<br>Si marqueu el *Personalitzat en cas d'error* , l'element no serà compatible si la passa de preprocessament falla i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|*Reemplaça*|Cerqueu la cadena de cerca i substituïu-la per una altra (o per res). Es substituiran totes les ocurrències de la cadena de cerca.<br>Paràmetres:<br>**cadena de cerca** - la cadena a cercar i substituir, distingeix entre majúscules i minúscules (obligatori)<br>** substituir** - la cadena a substituir amb la cadena de cerca. La cadena de substitució també pot ésser buida, la qual cosa permet esborrar la cadena de cerca quan la trobi.<br> És possible emprar seqüències d'escapada per cercar o substituir salts de línia, retorns de carro, tabulacions i espais "\\n \\r \\ t \\s"; la barra invertida es pot escapar com a "\\\\" i les seqüències d'escapament es poden escapar com a "\\\\n". Els salts de línia, els retorns de carro i les pestanyes s'escapen automàticament durant la descoberta de baix nivell.| |^|*Retallar*|Esborra els caràcters especificats al principi i al final del valor.| |^|*Retalla a la dreta*|Esborra els caràcters especificats del final del valor.| |^|*Retalla a l'esquerra*|Esborra els caràcters especificats del principi del valor.| |Dades estructurades|<|<| | |*XPath XML*|Extreu valor o fragment de dades XML mitjançant la funcionalitat XPath.<br>Per tal que aquesta opció funcioni, el servidor Zabbix s'ha de compilar amb suport libxml.<br>Exemples:< br>`number(/document/item /value)` extreu `10` de `<document><item><value>10</value></item></document>`<br>`number(/document/item/@attribute)` extreu `10` de `<document><item attribute="10"></item></document>`<br>`/document/item` extreu `<item><value> 10</value></item>` de `<document><item><value>10</value></item></document>`<br>Tingueu en compte que els espais de noms no són compatibles.<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament falla i és possible especificar errors d'opcions de gestió personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|*JSONPath*|Extreu el valor o el fragment de les dades JSON mitjançant la [funcionalitat JSONPath](/manual/config/items/preprocessing/jsonpath_functionality).<br>Si marqueu el *Personalitzat en error*, l'element no s'admetrà si la passa de preprocessament falla i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|*CSV a JSON*|Convertir les dades del fitxer CSV al format JSON.<br>Per obtindre més informació, consulteu: [Preprocessament de CSV a JSON](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).| |^|*XML a JSON*|Convertir dades en format XML a JSON.<br>Per obtindre més informació, veieu: [Regles de serialització](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).<br> Si marqueu la casella *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament falla i és possible especificar errors d'opcions de gestió personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |Aritmètica|<|<| | |*Multiplicador personalitzat*|Multiplica el valor per l'enter o el valor de coma flotant especificat.<br>Fes servir aquesta opció per convertir els valors rebuts a Ko, Mops, etc. en o, ops. En cas contrari, Zabbix no pot establir correctament [prefixos](/manual/apèndix/sufixos) (K, M, G, etc.).<br>*Tingueu en compte* que si el tipus d'element de dades és *Numèric (sense signe)*, els valors entrants es retallaran amb una part fraccionària (és a dir, '0,9' es convertirà en '0') abans que s'apliqui el multiplicador personalitzat.<br>Suport: notació científica, per exemple, `1e+70` (des de la versió 2.2); macros d'usuari i macros LLD (des de la versió 4.0); cadenes que inclouen macros, per exemple, `{#MACRO}e+10`, `{$MACRO1}e+{$MACRO2}` (des de la versió 5.2.3)<br>Les macros s'han de resoldre en un nombre enter o flotant.< br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament falla i és possible especificar opcions per al tractament d'errors personalitzats: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Canvi|<|<| | |*Canvi simple*|Calculeu la diferència entre el valor actual i el valor anterior.<br> S'avalua com a **valor**-**valor\_anterior**, on<br>*valor* - valor actual; *valor\_precedent* - valor rebut anteriorment<br>Aquest paràmetre pot ser útil per mesurar un valor que augmenta constantment. Si el valor actual és inferior al valor anterior, Zabbix ignora aquesta diferència (no emmagatzema res) i espera un altre valor.<br>Només es permet una operació d'edició per element.<br>Si marqueu *Personalitzar en cas d'error* , l'element no serà compatible si la passa de preprocessament falla i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|*Canvi per segon*|Calculeu la taxa de canvi de valor (diferència entre el valor actual i anterior) per segon.<br>Avaluat com a (**valor**-**valor\_anterior**)/(**temps**-**hora\_anterior**), on<br>*valor* - valor actual; *previous_value* - valor rebut anteriorment; *time* - marca de temps actual; *time\_previous* - marca de temps del valor anterior.<br>Aquest paràmetre és extremadament útil per obtindre la velocitat per segon per a un valor que augmenta constantment. Si el valor actual és inferior al valor anterior, Zabbix ignora aquesta diferència (no emmagatzema res) i espera un altre valor. Això permet que funcioni bé, per exemple, amb embolcall de comptador SNMP de 32 bits (desbordament).<br>*Nota*: Com que aquest càlcul pot produir nombres de coma flotant, es recomana establir el "Tipus d'informació" a *Numèric (flotant)*, fins i tot si els valors en brut entrants són nombres enters. Això és especialment rellevant per a nombres petits on la part decimal compta. Si els valors de coma flotant són grans i poden superar la longitud del camp "float", en aquest cas es pot perdre el valor sencer, en realitat es recomana emprar *Numèric (sense signe)* i, per tant, esborrar només la part decimal .<br>Només es permet una operació d'edició per element.<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament i és possible especificar opcions de gestió d'errors personalitzades: ignora el valor, estableix un valor especificat o estableix un missatge d'error especificat.| |Sistemes digitals|<|<| | |*Booleà a decimal*|Converteix el valor del format booleà a decimal. La representació textual és traduïda com a 0 o 1. Per tant, "TRUE" s'emmagatzema com a 1 i "FALSE" s'emmagatzema com a 0. Tots els valors coincideixen si no distingeixen entre majúscules i minúscules. Els valors reconeguts actualment són, per a:<br>*TRUE* - true, t, yes, y, on, up, running, enabled, available, ok, master<br>*FALSE* - false, f, no, n , off, down, unused, disabled, unavailable, err, slave<br>A més, qualsevol valor numèric diferent de zero es considera TRUE i zero es considera FALSE. L'element no serà compatible si la passa de preprocessament falla, i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|*Octal a Decimal*|Converteix el valor del format octal a decimal.<br>Si marqueu la casella *Personalitzat en cas d'error*, l'element no quedarà incompatible si la passa de preprocessament fallés i és possible especificar-lo. Opcions de gestió d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*Hexadecimal a Decimal*|Converteix el valor del format hexadecimal a decimal.<br>Si marqueu la casella *Personalitzat en cas d'error*, l'element no serà compatible si falla la passa de preprocessament i és possible especificar-lo. Opcions de gestió d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Scripts personalitzats|<|<| | |*JavaScript*|Introduïu el codi JavaScript al bloc que apareix quan feu clic al camp de paràmetres o a una icona de llapis.<br>Tingueu en compte que la longitud de JavaScript disponible depèn de la [base de dades emprada](#custom_script_limit).<br>Per obtindre més informació, veieu: [Preprocessament de Javascript](/manual/config/items/preprocessing/javascript).| |Validació|<|<| | |*A l'interval*|Definiu un interval dins del qual un valor ha de caure especificant valors mínims/màxims (inclosos).<br>S'accepten valors numèrics (incloent qualsevol nombre de dígits, part decimal opcional i part exponencial opcional, valors negatius). Es poden emprar macros d'usuari i macros de descoberta de baix nivell. El valor mínim ha d'ésser inferior al valor màxim.<br>Ha d'existir com a mínim un valor.<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no quedarà incompatible en cas d'error de la passa de preprocessament i és possible especificar opcions personalitzades de gestió d'errors: per ignorar el valor, o per establir un valor especificat, o per establir un missatge d'error especificat.| |^|*Coincideix amb l'expressió regular*|Especifiqueu una expressió regular amb la qual ha de coincidir un valor.<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament falla i és possible especificar-lo. Opcions de gestió d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*No coincideix amb l'expressió regular*|Especifiqueu una expressió regular amb la qual un valor no ha de coincidir.<br>Si marqueu la casella *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament falla i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*Cerqueu un error al JSON*|Cerqueu un missatge d'error a nivell d'aplicació situat al JSONpath. Atura el processament si té èxit i si el missatge no és buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de preprocessament. Tingueu en compte que aquests errors de servei extern s'informaran a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.<br>No s'informarà d'errors si l'anàlisi de JSON no vàlid falla.< br>Si marqueu la casella *Personalitzat en cas d'error*, l'element no serà compatible si la passa de preprocessament falla i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|*Cerca un error a l'XML*|Cerca un missatge d'error a nivell d'aplicació situat a XPath. Atura el processament si té èxit i si el missatge no és buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquesta passa de pretractament. Tingueu en compte que aquests errors de servei extern s'informen a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.<br>No s'informarà d'error si l'anàlisi d'un XML no vàlid falla. <br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no quedarà incompatible si la passa de preprocessament falla i és possible especificar opcions personalitzades per a la gestió d'errors: per ignorar el valor, per establir un valor especificat o per establir un missatge d'error especificat.| |^|*Cerca un error mitjançant una expressió regular*|Cerca un missatge d'error a nivell d'aplicació mitjançant una expressió regular. Atura el processament si té èxit i si el missatge no és buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquest pas de preprocessament. Tingueu en compte que aquests errors de servei extern s'informen a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.<br>Paràmetres:<br>**patró** - expressió regular<br>**sortida** - patró de format de sortida. Una seqüència d'escapada \\N (on N=1...9) es substitueix pel grup enèssim corresponent. Es substitueix una seqüència d'escapada \\0 pel text corresponent.<br>Si marqueu la casella *Personalitzat en cas d'error*, l'element no quedarà incompatible en cas d'error de la passa de preprocessament i és possible especificar opcions de gestió d'errors personalitzades: per ignorar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*Comprova si hi ha valors no compatibles*|Comprova si no s'ha pogut recuperar cap valor d'element. Normalment, això faria que l'element deixés de ser compatible, però podeu modificar aquest comportament especificant les opcions de gestió d'errors *Personalitzat en cas d'error*: descartar el valor, establir un valor especificat (que també es pot utilitzar amb triggers) o establir un missatge d'error especificat. En cas d'una passa de preprocessament fallida, l'element no deixarà de ser compatible si s'ha triat l'opció de descartar el valor o establir un valor especificat. Tingueu en compte que per a aquesta passa de preprocessament, la casella de selecció *Personalitzat en cas d'error* és desactivada i sempre marcada.<br>Aquesta passa de preprocessament només comprova si no s'ha pogut recuperar cap valor d'element. No comprova, per exemple, si el tipus del valor recuperat (per exemple, cadena) coincideix amb el tipus d'informació de l'element (per exemple, numèric); per a més detalls, consulteu els [Exemples de preprocessament](/manual/config/items/preprocessing/examples#checking-for-not-supported-value). Si hi ha una discrepància de tipus, és possible que l'element encara no sigui compatible després d'executar totes les passes de preprocessament. Per comprovar si hi ha una discrepància de tipus, podeu utilitzar, per exemple, la passa de preprocessament *Multiplicador personalitzat*; veieu [Exemples de preprocessament](/manual/config/items/preprocessing/examples#checking-retrieved-value-type).<br>Aquesta passa sempre s'executa com a primera passa de preprocessament i es posa per damunt de totes les altres després de desar els canvis a l'element. Només es pot utilitzar un cop.<br>Compatible des de la versió 5.2.0.| |Escanyament|<|<| | |*Descartar sense canvis*|Ignorar un valor si no ha canviat.<br>Si s'ignora un valor, no es desa a la base de dades i el servidor Zabbix no sap que aquest valor s'ha canviat. No s'avaluarà cap trigger i, per tant, no es crearan ni resoldran problemes relacionats amb els triggers. Les funcions només funcionaran en funció de les dades realment desades a la base de dades. Com que les tendències es creen a partir de les dades de la base de dades, si no hi ha cap valor registrat durant una hora, tampoc no hi haurà dades de tendències per a aquesta hora.<br> Només es pot especificar una opció d'acceleració per a un element.<br>*Tingueu en compte* que és possible per als elements monitorats pel proxy Zabbix que les diferències de valor molt petites (menys de 0,000001) no s'esborrin correctament pel proxy, però s'emmagatzemen a l'historial amb el mateix valor si la base de dades del servidor Zabbix [no s'ha actualitzat](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values).| |^|*Descartar sense canvis amb el bit de vida*|Ignoreu un valor si no ha canviat en el període de temps especificat (en segons).<br>S'admeten valors enters positius per especificar segons (mínim - 1 segon). Els sufixos de temps es poden emprar en aquest camp (per exemple, 30 s, 1 m, 2 h, 1 d). En aquest camp es poden emprar macros d'usuari i macros de descoberta de baix nivell.<br>Si s'ignora un valor, no es desa a la base de dades i el servidor Zabbix no sap que s'ha rebut aquest valor. No s'avaluarà cap trigger i, per tant, no es crearan ni resoldran problemes relacionats amb els triggers. Les funcions només funcionaran en funció de les dades realment desades a la base de dades. Com que les tendències es creen a partir de les dades de la base de dades, si no hi ha cap valor registrat durant una hora, tampoc no hi haurà dades de tendències per a aquesta hora.<br> Només es pot especificar una opció d'acceleració per a un element.<br>*Tingueu en compte* que només és possible per als elements monitorats pel proxy Zabbix les diferències de valors petites (menys de 0,000001) no s'esborren correctament pel proxy, però s'emmagatzemen a l'historial amb el mateix valor si la base de dades del servidor Zabbix [no s'ha actualitzat] (https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values).| |Prometheus|<|<| | |*Patró de Prometheus*|Empreu la consulta següent per extreure les dades necessàries de les mètriques de Prometheus.<br>Consulteu les [comprovacions de Prometheus](/manual/config/items/itemtypes/http/prometheus) per obtindre més informació.| |^|*Prometheus a JSON*|Convertiu les mètriques de Prometheus requerides a JSON.<br>Consulteu les [comprovacions de Prometheus](/manual/config/items/itemtypes/prometheus) per obtindre més informació.| ::: noteimportant Per modificar i limitar les passes de preprocessament, Zabbix ha de recordar el darrer valor per calcular/comparar el nou valor segons sigui necessari. Aquests valors anteriors els gestiona el gestor de preprocessament. Si es reinicia el servidor o el proxy Zabbix o es fan canvis a les passes de preprocessament, es restableix el darrer valor de l'element corresponent, donant lloc a: - per a passes *Canvi únic*, *Canvi per segon* - el valor següent s'ignorarà perquè no hi ha cap valor anterior per calcular el canvi; - per a les passes *Descartar el que no ha canviat*, *Descartar sense canvis amb bit viu* - el valor següent no s'esborrarà mai, encara que hauria d'haver sigue a causa de regles d'esborrat. ::: El paràmetre *Tipus d'informació* de l'element es mostra a la part inferior de la pestanya quan es defineix almenys una passa de preprocessament. Si cal, és possible modificar el tipus d'informació sense sortir de la pestanya *Preprocessament*. Veieu la [creació d'un element](/manual/config/items/item) per a la descripció detallada dels paràmetres. ::: notetip Si empreu un multiplicador personalitzat o un valor d'emmagatzematge com ara *Canvis per segon* per als elements amb el tipus d'informació establert a *Numèric (sense signe)* i el valor calculat resultant és en realitat un nombre flotant, el valor calculat encara s'admet com el valor correcte esborrant la part decimal i emmagatzemant el valor com a nombre enter. ::: #### Configuration Providing you have the HTTP master item configured, you need to create a [dependent item](/manual/config/items/itemtypes/dependent_items) that uses a Prometheus preprocessing step: - Enter general dependent item parameters in the configuration form - Go to the Preprocessing tab - Select a Prometheus preprocessing option (*Prometheus pattern* or *Prometheus to JSON*)  The following parameters are specific to the *Prometheus pattern* preprocessing option: |Parameter|Description|Examples| |--|------|------| |*Pattern*|To define the required data pattern you may use a query language that is similar to Prometheus query language (see [comparison table](#query-language-comparison)), e.g.:<br><metric name> - select by metric name<br>{\_\_name\_\_="<metric name>"} - select by metric name<br>{\_\_name\_\_=\~"<regex>"} - select by metric name matching a regular expression<br>{<label name>="<label value>",...} - select by label name<br>{<label name>=\~"<regex>",...} - select by label name matching a regular expression<br>{\_\_name\_\_=\~".\*"}==<value> - select by metric value<br>Or a combination of the above:<br><metric name>{<label1 name>="<label1 value>",<label2 name>=\~"<regex>",...}==<value><br><br>Label value can be any sequence of UTF-8 characters, but the backslash, double-quote and line feed characters have to be escaped as `\\`, `\"` and `\n` respectively; other characters shall not be escaped.|*wmi\_os\_physical\_memory\_free\_bytes*<br>*cpu\_usage\_system{cpu="cpu-total"}*<br>*cpu\_usage\_system{cpu=\~".\*"}*<br>*cpu\_usage\_system{cpu="cpu-total",host=\~".\*"}*<br>*wmi\_service\_state{name="dhcp"}==1*<br>*wmi\_os\_timezone{timezone=\~".\*"}==1*| |*Result processing*|Specify whether to return the value, the label or apply the appropriate function (if the pattern matches several lines and the result needs to be aggregated):<br>**value** - return metric value (error if multiple lines matched)<br>**label** - return value of the label specified in the *Label* field (error if multiple metrics are matched)<br>**sum** - return the sum of values<br>**min** - return the minimum value<br>**max** - return the maximum value<br>**avg** - return the average value<br>**count** - return the count of values<br>This field is only available for the *Prometheus pattern* option. |See also examples of using parameters below.| |*Output*|Define label name (optional). In this case the value corresponding to the label name is returned.<br>This field is only available for the *Prometheus pattern* option, if 'Label' is selected in the *Result processing* field.| | **Examples of using parameters** 1. The most common use case is to return the **value**. To return the value of `/var/db` from: > `node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09`<br> > `node_disk_usage_bytes{path="/var/db"} 20480`<br> > `node_disk_usage_bytes{path="/var/dpkg"} 8192`<br> > `node_disk_usage_bytes{path="/var/empty"} 4096` use the following parameters: * *Pattern* - `node_disk_usage_bytes{path="/var/db"}` * *Result processing* - select 'value' 2. You may also be interested in the **average** value of all `node_disk_usage_bytes` parameters: * *Pattern* - `node_disk_usage_bytes` * *Result processing* - select 'avg' 3. While Prometheus supports only numerical data, it is popular to use a workaround that allows to return the relevant textual description as well. This can be accomplished with a filter and specifying the label. So, to return the value of the 'color' label from > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0` use the following parameters: * *Pattern* - `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Result processing* - select 'label' * *Label* - specify 'color' The filter (based on the numeric value '1') will match the appropriate row, while the label will return the health status description (currently 'green'; but potentially also 'red' or 'yellow'). #### Configuració Si l'element principal HTTP és configurat, heu de crear un [element dependent](/manual/config/items/itemtypes/dependent_items) que empri una passa de preprocessament de Prometheus: - Introduïu els paràmetres generals de l'element dependent al formulari de configuració - Accediu a la pestanya Preprocessament - Trieu una opció de preprocessament de Prometheus (*Patró Prometheus* o *Prometheus a JSON*)  Els paràmetres següents són específics de l'opció de preprocessament *Patró Prometheus*: |Paràmetre|Descripció|Exemples| |--|-------|------| |*Patró*|Per definir el model de dades requerit, podeu emprar un llenguatge de consulta similar al llenguatge de consulta de Prometheus (veieu la [taula de comparació](#query-language-comparison)), per exemple:<br> \<metric nom\>: seleccioneu pel nom de la mètrica<br>{\_\_name\_\_="\<nom de la mètrica\>"}: seleccioneu pel nom de la mètrica<br>{\_\_name\_ \_=\~ "\<regex\>"}: seleccioneu pel nom de la mètrica que coincideixi amb una expressió regular<br>{\<tag name\>="<\tag value\>",...}: seleccioneu pel nom de l'etiqueta<br>{ \<nom de l'etiqueta\>=\~"\<regex\>",...}: seleccioneu el nom de l'etiqueta que coincideixi amb una expressió regular<br>{\_\_name \_\_=\~".\*" }==\<valor\>: seleccioneu per valor de mètrica<br>O una combinació de les anteriors:<br>\<nom de la mètrica\>{\< tag de nom1\>="\<etiqueta de valor1\>",\ <name tag2\>=\~"\<regex\>",...}==\<valor\><br><br>L'etiqueta de valor pot ésser qualsevol seqüència de caràcters UTF-8, però barra invertida, cometes dobles i els caràcters de nova línia s'han de fer escapar com a `\\`, `\"` i ` \n` respectivament; els altres caràcters no s'han de fer escapar .|*wmi\_os\_physical\_memory\_free\_bytes*<br>*cpu\_usage\_system{cpu="cpu-total"}*<br>*cpu\_usage\ _system{ cpu=\~".\*"}*<br>*cpu\_usage\_system{cpu="cpu-total",host=\~".\*"}*<br>*wmi\_service\ _state{ name="dhcp"}==1*<br>*wmi\_os\_timezone{timezone=\~".\*"}==1*| |*Processat de resultats*|Indiqueu si voleu retornar el valor, l'etiqueta o aplicar la funció adequada (si el patró coincideix amb diverses fileres i el resultat s'ha d'afegir):<br>**valor** - retorna el valor de la mètrica (error si coincideixen diverses files)<br>**etiqueta** - retorna el valor de l'etiqueta especificat al camp *Etiqueta* (error si coincideixen diverses mètriques)<br>**suma** - retorna la suma de valors<br>**min** - retorna el valor mínim<br>**max** - retorna el valor màxim<br>**mitjana** - retorna el valor mitjà<br>**count** - retorna el nombre de valors<br>Aquest camp és només disponible per a l'opció *Patró Prometheus*. |Veieu també exemples d'ús de paràmetres a continuació.| |*Sortida*|Estableix el nom de l'etiqueta (opcional). En aquest cas, es retorna el valor corresponent al nom de l'etiqueta.<br>Aquest camp només és disponible per a l'opció *Patró Prometheus*, si es selecciona "Etiqueta" al camp *Processat de resultats*.| **Exemples d'ús de paràmetres** 1. El cas d'ús més comú és retornar el **valor**. Per retornar el valor de `/var/db` de: > `node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09`<br> > `node_disk_usage_bytes{path="/var/db"} 20480`<br> > `node_disk_usage_bytes{path="/var/dpkg"} 8192`<br> > `node_disk_usage_bytes{path="/var/empty"} 4096` empreu la configuració següent: * *Patró* - `node_disk_usage_bytes{path="/var/db"}` * *Processat de resultats* - trieu "valor" 2. També us pot interessar el valor **mitjana** de tots els paràmetres `node_disk_usage_bytes`: * *Patró* - `node_disk_usage_bytes` * *Processat dels resultats* - trieu "mitjana" 3. Tot i que Prometheus només admet dades numèriques, és habitual emprar una solució alternativa que també retorni la descripció textual rellevant. Això es pot aconseguir amb un filtre i especificant l'etiqueta. Per tant, per retornar el valor de l'etiqueta "color" de > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0` empreu la configuració següent: * *Patró* - `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Processat dels resultats* - seleccioneu "etiqueta" * *Etiqueta*: especifiqueu "color" El filtre (basat en el valor numèric "1") coincidirà amb la filera adequada, mentre que l'etiqueta retornarà la descripció de l'estat de salut (actualment "verd"; però potencialment també "vermell" o "groc"). #### Configuration Providing you have the HTTP master item configured, you need to create a [dependent item](/manual/config/items/itemtypes/dependent_items) that uses a Prometheus preprocessing step: - Enter general dependent item parameters in the configuration form - Go to the Preprocessing tab - Select a Prometheus preprocessing option (*Prometheus pattern* or *Prometheus to JSON*)  The following parameters are specific to the *Prometheus pattern* preprocessing option: |Parameter|Description|Examples| |--|------|------| |*Pattern*|To define the required data pattern you may use a query language that is similar to Prometheus query language (see [comparison table](#query-language-comparison)), e.g.:<br><metric name> - select by metric name<br>{\_\_name\_\_="<metric name>"} - select by metric name<br>{\_\_name\_\_=~"<regex>"} - select by metric name matching a regular expression<br>{<label name>="<label value>",...} - select by label name<br>{<label name>=~"<regex>",...} - select by label name matching a regular expression<br>{\_\_name\_\_=~".\*"}==<value> - select by metric value<br>Or a combination of the above:<br><metric name>{<label1 name>="<label1 value>",<label2 name>=~"<regex>",...}==<value><br><br>Label value can be any sequence of UTF-8 characters, but the backslash, double-quote and line feed characters have to be escaped as `\\`, `\"` and `\n` respectively; other characters shall not be escaped.|*wmi\_os\_physical\_memory\_free\_bytes*<br>*cpu\_usage\_system{cpu="cpu-total"}*<br>*cpu\_usage\_system{cpu=~".\*"}*<br>*cpu\_usage\_system{cpu="cpu-total",host=~".\*"}*<br>*wmi\_service\_state{name="dhcp"}==1*<br>*wmi\_os\_timezone{timezone=~".\*"}==1*| |*Result processing*|Specify whether to return the value, the label or apply the appropriate function (if the pattern matches several lines and the result needs to be aggregated):<br>**value** - return metric value (error if multiple lines matched)<br>**label** - return value of the label specified in the *Label* field (error if multiple metrics are matched)<br>**sum** - return the sum of values<br>**min** - return the minimum value<br>**max** - return the maximum value<br>**avg** - return the average value<br>**count** - return the count of values<br>This field is only available for the *Prometheus pattern* option. |See also examples of using parameters below.| |*Output*|Define label name (optional). In this case the value corresponding to the label name is returned.<br>This field is only available for the *Prometheus pattern* option, if 'Label' is selected in the *Result processing* field.| | **Examples of using parameters** 1. The most common use case is to return the **value**. To return the value of `/var/db` from: > `node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09`<br> > `node_disk_usage_bytes{path="/var/db"} 20480`<br> > `node_disk_usage_bytes{path="/var/dpkg"} 8192`<br> > `node_disk_usage_bytes{path="/var/empty"} 4096` use the following parameters: * *Pattern* - `node_disk_usage_bytes{path="/var/db"}` * *Result processing* - select 'value' 2. You may also be interested in the **average** value of all `node_disk_usage_bytes` parameters: * *Pattern* - `node_disk_usage_bytes` * *Result processing* - select 'avg' 3. While Prometheus supports only numerical data, it is popular to use a workaround that allows to return the relevant textual description as well. This can be accomplished with a filter and specifying the label. So, to return the value of the 'color' label from > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0` use the following parameters: * *Pattern* - `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Result processing* - select 'label' * *Label* - specify 'color' The filter (based on the numeric value '1') will match the appropriate row, while the label will return the health status description (currently 'green'; but potentially also 'red' or 'yellow'). #### Configuració Sempre que tingueu configurat l'element mestre HTTP, heu de crear un [element dependent](/manual/config/itemtypes/dependent_items) que utilitza un pas de preprocessament de Prometheus: - Introduïu els paràmetres d'element dependent general en el formulari de configuració - Aneu a la pestanya Preprocessament - Seleccioneu una opció de preprocessament de Prometheus (*Prometheus patró* o *Prometeu a JSON *)  Els paràmetres següents són específics per a l'opció de preprocessament *Prometheus patró*: |Paràmetre|Descripció|Exemples| |-----------------| |*Pattern*|Definir el patró de dades requerit podeu utilitzar un llenguatge de consulta que sigui similar al llenguatge de consulta de Prometheus (veieula [taula de comparació](#query-language-comparison)), e.g.:<br><nom mètric> - triar per nom de la mètrica<br>{\_\_name\_\_="<nom de la mètrica>"} - triar per nom de la mètrica<br>{\_\_name\_\_==~"<expressió regular>"} - seleccionar per nom de la mètrica que coincideixi amb una expressió regular<br>{<nom de l'etiqueta>="<valor de l'etiqueta>",...} - trieu per nom de l'etiqueta<br>{<nom de l'etiqueta>=~"<expressió regular>",...} - trieu per nom de l'etiqueta que coincideixi amb una expressió regular<br>{\_\_nom\_\_=~".\*"}==<valor> - seleccioneu per valor de la mètrica<br>O una combinació de les anteriors:<br><nom de la mètrica>{<nom de l'etiqueta1>="<valor de l'etiqueta1>",<nom de l'etiqueta2>=~"<expressió regular>",...}==<valor><br><br>El valor de l'etiqueta pot ser qualsevol seqüència de caràcters UTF-8, però els caràcters de barra invertida, cometes dobles i salt de línia s'han d'escapar com a `\\`, `\"` i `\n` respectivament; altres caràcters no es podran escapat.|*wmi\_os\_physical\_memory\_free\_bytes*<br>*cpu\_usage\_system{cpu="cpu-total"}*<br>*cpu\_usage\_system{cpu=~".\*"}*<br>*cpu\_usage\_system{cpu="cpu-total",host=~".\*"}*<br>*wmi\_service\_state{name="dhcp"}==1*<br>*wmi\_os\_timezone{timezone=~".\*"}==1*| |*Processament de resultats*|Especificar si retornar el valor, l'etiqueta o aplicar la funció adequada (si el patró coincideix amb diverses línies i el resultat ha de ser agregat):<br>**valor** - valor mètric de retorn (error si s'ajusten a múltiples línies)<br>**etiqueta** - valor de retorn de l'etiqueta especificada al camp * Etiqueta* (error si s' coincideixen múltiples mètriques)<br>**s | Veieu també exemples d'ús de paràmetres a continuació. | |*Output*|Defineix el nom de l'etiqueta (opcional). En aquest cas es retorna el valor corresponent al nom de l'etiqueta.<br>Aquest camp només està disponible per a l'opció *Prometheus patró*, si 'Etiqueta' està seleccionada en el camp *Processament de resultats*. | | ** Exemples d'ús de paràmetres** 1. El cas d'ús més comú és retornar el **valor**. Per tornar el valor de `/var/db` de: > `node_disk_usage_bytes{path="/var/cache"} 2.1766144e+09`<br> > `node_disk_usage_bytes{path="/var/db"} 20480`<br> > `node_disk_usage_bytes{path="/var/dpkg"} 8192`<br> > `node_disk_usage_bytes{path="/var/empty"} 4096` Utilitzeu els paràmetres següents: * *Patró* - `node_disk_usage_bytes{path="/var/db"}` * * Processament de resultats * - seleccioneu 'valor' 2. També et pot interessar el valor **mitjà** de tots `node_disk_usage_bytes` paràmetres: * *Patró * - `node_disk_usage_bytes` * *Processament de resultats* - seleccioneu 'avg' 3. Tot i que Prometheus només admet dades numèriques, és popular utilitzar un solució que permet retornar també la descripció textual pertinent. Això es pot aconseguir amb un filtre i especificant l'etiqueta. Així doncs, per retorneu el valor de l'etiqueta 'color' de > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="green"} 1`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="red"} 0`<br> > `elasticsearch_cluster_health_status{cluster="elasticsearch",color="yellow"} 0` Utilitzeu els paràmetres següents: * *Patró* - `elasticsearch_cluster_health_status {cluster="elasticsearch"} == 1` * *Tramitació de resultats* - seleccioneu 'etiqueta' * * Etiqueta* - especifica 'color' El filtre (basat en el valor numèric '1') coincidirà amb la fila adequada, mentre que l'etiqueta retorneu la descripció de l'estat de salut (actualment 'verd'; però potencialment també 'vermell' o 'groc'). #### Configuration Real-time export of trigger events, item values and trends is configured by specifying a directory for the export files - see the `ExportDir` parameter in server [configuration](/manual/appendix/config/zabbix_server). 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. #### Configuració La exportació en temps real dels esdeveniments de triggers, dels valors dels elements i de les tendències és configurat especificant un directori per els arxius d'exportació - veieu el paràmetre `ExportDir` a la [configuració](/manual/appendix/config/zabbix_server) del servidor. Hi ha disponibles dos altres paràmetres: - `ExportFileSize` es pot emprar per definir la mida màxima autoritzada d'un arxiu d'exportació individual. Quan un procés hagi d'escriure a un fitxer, primer comprova la mida del fitxer. Si sobrepassa la mida límit configurada, l'arxiu es reanomena afegint-t'hi .old al seu nom i es genera un nou arxiu amb el nom original. ::: noteimportant Es crearà un arxiu per cada procés que escrigui dades (és a dir, sobre 4 a 30 arxius). Com la mida per defecte de l'arxiu d'exportació és d'1Go, conservar els arxius d'exportació grossos pot restar espai de disc molt ràpid. ::: - `ExportType` permet especificar quin tipus d'entitats (esdeveniments, històric, tendències) s'exportaran. #### Configuration Some of the operands (installation options) require additional resources to be created before. The following section describes these prerequisites. All possible configuration options are available during operand deployment. For example, **Zabbix proxy (MySQL)**: {width="600"} The YAML section provides all available options with default values: {width="600"} #### Configuració Alguns dels operands (opcions d'instal·lació) requereixen recursos addicionals per ser creat abans. La secció següent descriu els requisits previs. Totes les opcions de configuració possibles són disponibles durant el desplegament d'operands. Per exemple, **proxy Zabbix (MySQL)**: {width="600"} La secció YAML ofereix totes les opcions disponibles amb valors predeterminats: {width="600"} ##### Configuration syncer Performance of the configuration syncer has been improved. It is recommended to increase the CacheSize on server/proxy if there is a large amount of templates. It is also recommended to remove unused templates. Note that the default CacheSize on server/proxy has been increased to 32M. ##### Sincronitzador de configuració S'ha millorat el rendiment del sincronitzador de configuració. Es recomana pujar la mida de la memòria cau al servidor/proxy si hi ha una gran quantitat de models. També es recomana esborrar les plantilles no emprades. Tingueu en compte que la mida de la memòria cau per defecte al servidor/proxy s'ha augmentat a 32 Mo. #### Configuration sync optimization for Oracle For Zabbix installations with Oracle, it is now possible to manually change item and item preprocessing database field types from *nclob* to *nvarchar2* by applying a database patch. Patch application may increase the speed of configuration sync in environments with large number of items and item preprocessing steps, but will reduce the maximum field size limit from 65535 bytes to 4000 bytes for some item parameters. See [Known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle) for details. #### Optimització de la sincronització de la configuració per a Oracle Per a les instal·lacions de Zabbix amb Oracle, ara és possible canviar manualment els tipus de camps de base de dades de preprocessament d'elements i elements de *nclob* a *nvarchar2* aplicant un pedaç de base de dades. L'aplicació de pedaços pot augmentar la velocitat de sincronització de configuració en entorns amb un gran nombre d'elements i passes de preprocessament d'elements, però reduirà el límit màxim de mida del camp de 65535 octets a 4000 octets per a alguns paràmetres d'element. Consulteu els [Problemes coneguts](/manual/installation/known_issues#slow-configuration-sync-with-oracle) per obtindre més informació. #### Configuration Tags can be entered in a dedicated tab, for example, in trigger configuration:  #### Configuració Les etiquetes es poden introduir en una pestanya dedicada, per exemple, a la configuració del trigger:  #### 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-2). #### Configuració La zona horària global: - es pot configurar manualment durant la [instal·lació] de la interfície (/manual/installation/frontend) - es pot canviar a *Administració* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)* La zona horària a nivell d'usuari: - es pot configurar quan es [configura o actualitza ](/manual/config/users_and_usergroups/user#general_attributes) un usuari - pot ser definit per cada usuari al seu [perfil d'usuari](/manual/web_interface/user_profile#user-profile) **Veieu també:** Alineació de zones horàries quan empreu [intervals de programació](/manual/config/items/item/custom_intervals#aligning-time-zones-for-proxies-and-agent-2) #### 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, graphs, etc) will be inherited from the template.<br>To link a new template, start typing the template name in the *Templates* field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the *Templates* field; then, first select the host group by clicking on *Select* next to the *Host groups* field; mark the checkbox in front of one or multiple templates from the list displayed below; click on *Select*. The template(s) that are selected in the *Templates* field 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 *Templates* block:<br>*Unlink* - unlink the template, but preserve its items, triggers and graphs<br>*Unlink and clear* - unlink the template and remove all its items, triggers and graphs<br>Listed template names are clickable links leading to the template configuration form.| |*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 a host by typing in a non-existing group name; the new name will be displayed in a dropdown list as "new" in the brackets; clicking on it, will add it to the selection field.| |*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 proxy*|<|The host can be monitored either by Zabbix server or one of Zabbix proxies:<br>**(no proxy)** - host is monitored by Zabbix server<br>**Proxy name** - host is monitored by Zabbix proxy "Proxy name"| |*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 (under 2 minutes) 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 **Host 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. #### Configuració La pestanya **Equip** té els atributs generals de l'equip:  Tots els camps d'entrada obligatoris estan marcats amb un asterisc vermell. |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom d'equip*|<|Introduïu un nom d'equip únic. Es permeten caràcters alfanumèrics, espais, punts, guions i guions baixos. Tanmateix, els espais inicials i finals no es permeten.<br>*Nota:* Amb l'agent Zabbix s'executa a l'equip que esteu configurant, la configuració *Hostname* a [fitxer de configuració](/manual/ appendix/config/zabbix_agentd) de l'agent hauria de tindre el mateix valor que el nom d'equip introduït aquí. El nom del paràmetre és necessari en el processament de [comprovacions actives](/manual/appendix/items/activepassive).| |*Nom visible*|<|Introduïu un nom visible únic per a l'equip. Si poseu aquest nom, serà el visible a les llistes, mapes, etc. en lloc del nom d'equip tècnic. Aquest atribut admet UTF-8.| |*Plantilles*|<|Enllaça les [plantilles](/manual/config/templates) a l'equip. Totes les entitats (elements, triggers, gràfics, etc.) s'heretaran de les plantilles.<br>Per enllaçar una plantilla nova, comenceu a escriure el nom de la plantilla al camp *Enllaça plantilles noves*. Apareixerà una llista de plantilles coincidents; desplaça't cap avall per triar-les. També podeu fer clic a *Tria* al costat del camp i escollir plantilles de la llista en una finestra emergent. Els models triats al camp *Associa nous models* s'enllaçaran a l'equip quan es desi o s'actualitzi el formulari de configuració de l'equip.<br>Per anul·lar l'associació d'un model, empreu una de les dues opcions del bloc *Plantilles enllaçades*:<br >*Desenllaça*: desenllaça la plantilla, però mantingues els seus elements, triggers i gràfics<br>*Desenllaça i esborra*: desenllaça la plantilla i esborra tots els seus elements, triggers i gràfics<br>Els noms dels models enumerats són enllaços on es pot fer clic al formulari de configuració del model.| |*Grups*|<|Trieu els [grups d'equips](/manual/config/hosts/host_groups) als quals pertany l'equip. Un equip ha de pertànyer a almenys un grup d'equip. Es pot crear un grup nou i enllaçar-lo amb el grup equip afegint un nom de grup inexistent.| |*Interfícies*|<|Hi ha diversos tipus d'interfícies d'equip admeses per a un equip: *Agent*, *SNMP*, *JMX* i *IPMI*.<br>No es defineix cap interfície per defecte. Per afegir una interfície nova, feu clic a *Afegeix* al bloc *Interfícies*, trieu el tipus d'interfície i introduïu la informació *IP/DNS*, *Connexió a* i *Port*.<br>*Nota:* Interfícies que no s'empren a cap element no es poden esborrar i l'enllaç *Suprimeix* apareix en gris per a elles.<br>Veieu [Configuració de monitoratge SNMP](/manual/config/items/itemtypes/snmp# snmp-monitoring-configuration) per obtindre més informació i detalls sobre la configuració d'una interfície SNMP (v1, v2 i v3).| | |*Adreça IP*|Adreça IP de l'equip (opcional).| |^|*Nom DNS*|Nom DNS de l'equip (opcional).| |^|*Connecteu-vos a*|Fent clic al botó corresponent indicarà al servidor Zabbix què ha d'emprar per obtindre les dades de l'agent:<br>**IP** - Connecteu-vos a l'adreça IP de l'equip (recomanat)<br>**DNS** - Connecteu-vos al nom DNS de l'equip.| |^|*Port*|Nombre de port TCP/UDP. Els valors per defecte són: 10050 per a l'agent Zabbix, 161 per a l'agent SNMP, 12345 per a JMX i 623 per a IPMI.| |^|*Per defecte*|Marqueu el botó d'opció per establir la interfície predeterminada.| |*Descripció*|<|Introduïu la descripció de l'equip.| |*Monitorant mitjançant proxy*|<|L'equip es pot monitorar pel servidor Zabbix o per un dels proxys Zabbix:<br>**(sense proxy)** - l'equip és monitorat pel servidor Zabbix<br>**Nom proxy** - l'equip és monitorat pel proxy Zabbix "Nom del proxy" | |*Activat*|<|Quan la casella és marcada, l'equip és actiu - a punt per a monitorar.<br><br>Quan la casella no ho és pas, l'equip és desactivat - no monitorat:<br>Per peticions passives iniciades per el sevidor o el proxy de Zabbix (per exemple, l'[agent de Zabbix](/manual/appendix/items/activepassive#passive-checks), [agent SNMP](/manual/config/items/itemtypes/snmp), [simple checks](/manual/config/items/itemtypes/simple_checks)), el monitoratge s'atura durant una estona (menys de dos minuts) a que l'agent Zabbix rebi informació sobre l'equip que ha estat desactivat. Durant aquesta estona, l'equip continuarà recollint dades per les comprovacions passives i mirant d'enviar-ho al servidor o proxy; de tota manera, quan l'equip sigui marcat com a *Desactivat*, el proxy o servidor rebutjaran les dades.| La pestanya **IPMI** conté atributs de gestió d'IPMI. |Paràmetre|Descripció| |--|---------| |*Algorisme d'autenticació*|Trieu l'algoritme d'autenticació.| |*Nivell de privilegis*|Trieu el nivell de privilegis.| |*Nom d'usuari*|Nom d'usuari per a l'autenticació. Es poden emprar macros d'usuari.| |*Mot de pas*|Mot de pas per a l'autenticació. Es poden emprar macros d'usuari.| La pestanya **Etiquetes** us permet definir [etiquetes](/manual/config/tagging) a nivell d'equip. Tots els problemes d'aquest equip es marcaran amb els valors introduïts aquí.  Macros d'usuari, {INVENTORY.\*}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} macros i {HOST Les macros .PORT} .ID} són compatibles amb les etiquetes. La pestanya **Macros** us permet definir [macros d'usuari](/manual/config/macros/user_macros) com a parelles nom-valor. Tingues en compte que els valors de macro es poden mantindre com a text sense format, text secret o secret de volta. També s'admet afegir una descripció.  També podeu veure macros d'usuari globals i a nivell de plantilla aquí si trieu l'opció *Macros heretades i d'equip*. Aquí és on es mostren totes les macros d'usuari definides per a l'equip juntament amb el valor al qual es resolen i el seu origen. {width="600"} Per comoditat, es proporcionen enllaços a les plantilles respectives i la configuració global de macros. També és possible editar una plantilla/macro global a nivell d'equip, creant una còpia de la macro a l'equip. La pestanya **Inventari** us permet introduir manualment la informació d'[inventari] de l'equip. També podeu triar activar l'emplenament d'inventari *automàtic* o desactivar l'emplenament d'inventari per a aquest equip.  Si l'inventari és habilitat (manual o automàtic), es mostra un punt verd al nom de la pestanya. #### Configuration The **Item** tab contains general item attributes.  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |--|--------| |*Name*|Item name.| |*Type*|Item type. See individual [item type](itemtypes) sections.| |*Key*|Item key (up to 2048 characters).<br>The supported [item keys](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>**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>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 will add postprocessing to the received value and display it with the set unit postfix.<br>By default, if the raw value exceeds 1000, it is divided by 1000 and displayed accordingly. For example, if you set *bps* and receive a value of 881764, it will be displayed as 881.76 Kbps.<br>Special processing is applied to the following units: **B**, **Bps**, **unixtime**, **uptime**, **s**.<br>The [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) memory standard is used for processing **B** (byte), **Bps** (bytes per second) units, which are divided by 1024. Thus, if units are set to **B** or **Bps** Zabbix will display:<br>1 as 1B/1Bps<br>1024 as 1KB/1KBps<br>1536 as 1.5KB/1.5KBps<br>Special processing is used if the following time-related units are used:<br>**unixtime** - translated to "yyyy.mm.dd hh:mm:ss". To translate correctly, the received value must be a *Numeric (unsigned)* type of information.<br>**uptime** - translated to "hh:mm:ss" or "N days, hh:mm:ss"<br>For example, if you receive the value as 881764 (seconds), it will be displayed as "10 days, 04:56:04"<br>**s** - translated to "yyy mmm ddd hhh mmm sss ms"; parameter is treated as number of seconds.<br>For example, if you receive the value as 881764 (seconds), it will be displayed as "10d 4h 56m"<br>Only 3 upper major units are shown, like "1m 15d 5h" or "2h 4m 46s". If there are no days to display, only two levels are displayed - "1m 5h" (no minutes, seconds or milliseconds are shown). Will be translated to "< 1 ms" if the value is less than 0.001.<br>*Note* that if a unit is prefixed with `!`, then no unit prefixes/processing is applied to item values. See [preventing unit conversion](/manual/appendix/suffixes#preventing-unit-conversion).| |*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>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.<br>Scheduling is supported since Zabbix 3.0.0.<br>*Note*: custom intervals for active checks are supported by Zabbix agent 2 only.| |*History storage period*|Select either:<br>**Do not keep history** - 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/general#housekeeper).<br>**Storage period** - 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 *Storage period* value can be overridden globally in *Administration → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.<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 (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 keeping a long history of values, you can keep longer data of trends.<br>See also [History and trends](/manual/config/items/history_and_trends).| |*Trend storage period*|Select either:<br>**Do not keep trends** - trends are not stored.<br>This setting cannot be overridden by global housekeeper [settings](/manual/web_interface/frontend_sections/administration/general#housekeeper).<br>**Storage period** - 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 *Storage period* value can be overridden globally in *Administration → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper)*.<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](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).  #### Configuració L'**Element ** conté atributs generals d'elements.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Nom*|Nom de l'element.| |*Tipus*|Tipus d'element. Veieu les seccions individuals [tipus d'element](tipus d'element).| |*Clau*|Clau d'element (fins a 2048 caràcters).<br>Les [claus d'element](tipus d'element) admeses es poden trobar a les seccions de tipus d'element individuals.<br>La clau ha d'ésser única dins d'un únic equip.<br >Si el tipus de clau és "Agent Zabbix", "Agent Zabbix (actiu)" o "Comprovació senzilla", el valor de la clau ha d'ésser compatible amb l'agent Zabbix o el servidor Zabbix.<br>Veieu també: el [format de clau] correcte(/manual/config/items/item/key).| |*Tipus d'informació*|Tipus de dades tal com s'emmagatzemen a la base de dades després de fer conversions, si n'hi ha.<br>**Numèric (sense signe)** - Enter sense signe de 64 bits<br>**Numèric (flotant)** - nombre de coma flotant de 64 bits<br>Aquest tipus permetrà una precisió d'aproximadament 15 dígits i ballarà entre aproximadament -1,79E+308 i 1,79E+308 (a excepció de [PostgreSQL 11 i versions anteriors](/manual/installation/known_issues#floating_point_values)).<br>També s'admet la recepció de valors en notació científica. Per exemple. 1.23E+7, 1e308, 1.1E-4.<br>**Caràcter** - dades de text breu<br>**Registre** - dades de text llarg amb propietats opcionals relacionades amb el registre (marca de temps, font, gravetat, logeventid) <br>**Text** - dades de text llarg. Veieu també [límits de dades de text](#text-data-limits).<br>Per a les claus d'element que només retornen dades en un format específic, el tipus d'informació coincident es selecciona automàticament.| |*Interfície de l'equip*|Seleccioneu la interfície de l'equip. Aquest camp és disponible en editar un element al nivell d'equip.| |*Unitats*|Si s'estableix un símbol d'unitat, Zabbix afegirà postprocessament al valor rebut i el mostrarà amb el postfix d'unitat establert.<br>Per defecte, si el valor brut supera 1000, es divideix per 1000 i es mostra conseqüentment. Per exemple, si configureu *bps* i rebeu un valor de 881764, es mostrarà com a 881,76 Kbps.<br>El processament especial s'aplica a les unitats següents: **O**, **Ops**, **unixtime**, **uptime**, **s**.<br>S'empra l'estàndard de memòria [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) per processar unitats **B** (octet), **Bps** (octets per segon), que es divideixen per 1024. Per tant, si les unitats s'estableixen a **B** o **Bps**, Zabbix mostrarà:<br>1 com a 1B/1Bps<br>1024 com 1KB/1KBps<br>1536 com 1,5KB/1,5KBps<br>S'empra un processament especial si s'empren les unitats relacionades amb el temps següents:<br>**unixtime ** - traduït a "aaaa.mm.dd hh:mm:ss". Per traduir correctament, el valor rebut ha de ser un tipus d'informació *numèric (sense signe)*.<br>**uptime** - traduït a "hh:mm:ss" o "N dies, hh:mm:ss"< br>Per exemple, si rebeu el valor com a 881764 (segons), es mostrarà com a "10 dies, 04:56:04"<br>**s** - traduït a "aaaa mmm ddd hhh mmm sss ms"; el paràmetre es tracta com a nombre de segons.<br>Per exemple, si rebeu el valor com a 881764 (segons), es mostrarà com a "10d 4h 56m"<br>Només es mostren les 3 unitats principals superiors, com ara "1m 15d 5h" o "2h 4m 46s". Si no hi ha dies per mostrar, només es mostren dos nivells: "1m 5h" (no es mostren minuts, segons o mil·lisegons). Es traduirà a "< 1 ms" si el valor és inferior a 0,001.<br>*Tingueu en compte* que si una unitat té el prefix `!`, no s'aplicarà cap prefix/processament d'unitat als valors dels elements. Veieu [previnguent conversió d'unitats](/manual/appendix/suffixes#preventing-unit-conversion).| |*Interval d'actualització*|Recuperar un valor nou per a aquest element cada N segons. L'interval d'actualització màxim permès és de 86.400 segons (1 dia).<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), p. ex. 30s, 1m, 2h, 1d.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros).<br>Una sola macro ha d'omplir tot el camp. No s'admeten diverses macros en un camp o les macros barrejades amb text.<br>*Nota*: L'interval d'actualització només es pot establir a "0" si existeixen intervals personalitzats amb un valor diferent de zero. Si s'estableix a "0" i existeix un interval personalitzat (flexible o programat) amb un valor diferent de zero, l'element es consultarà durant la durada de l'interval personalitzat.<br>*Tingueu en compte* que la primera enquesta d'element després que l'element esdevingui actiu o després d'un canvi d'interval d'actualització es pot produir abans del valor configurat.<br>Un element passiu existent es pot consultar per valor immediatament prement el botó *Execute now* (#form_buttons).| |*Intervals personalitzats*|Podeu crear regles personalitzades per comprovar l'element:<br>**Flexible** - crear una excepció a l'*Interval d'actualització* (interval amb freqüència diferent)<br>**Programat** - crear un programa de sondeig personalitzat.<br>Per obtindre informació detallada, consulteu [intervals personalitzats](/manual/config/items/item/custom_intervals).<br>[Sufixos de temps](/manual/appendix/suffixes) s'admeten al camp *Interval*, p. ex. 30s, 1m, 2h, 1d.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros).<br>Una sola macro ha d'omplir tot el camp. No s'admeten diverses macros en un camp o macros barrejades amb text.<br>La programació és compatible des de Zabbix 3.0.0.<br>*Nota*: els intervals personalitzats per a comprovacions actives només són compatibles amb l'agent Zabbix 2.| |*Període d'emmagatzematge de l'historial*|Trieu:<br>**No conservar l'historial** - l'historial d'elements no s'emmagatzema. Útil per als elements mestres si només cal conservar l'historial dels elements dependents.<br>Aquesta configuració no es pot substituir per la [configuració](/manual/web_interface/frontend_sections/administration/general#housekeeper) de l'administrador global.<br>**Període d'emmagatzematge** - especifiqueu la durada de conservació de l'historial detallat a la base de dades (d'1 hora a 25 anys). Les dades més antigues seran esborrades per el procediment de neteja. Emmagatzemat en segons.<br>S'admeten [sufixos d'hora](/manual/appendix/sufixos), p. ex. 2h, 1d. Les [macros d'usuari](/manual/config/macros/user_macros) són compatibles.<br>El valor *Període d'emmagatzematge* es pot substituir globalment a *Administració → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general #housekeeper)*.<br>Si existeix un paràmetre d'anul·lació global, es mostra una icona d'informació carbassa. Si col·loqueu el ratolí a sobre, es mostra un missatge d'avís, p.e. *Substituït per la configuració global de la neteja (1d)*.<br>Es recomana mantindre els valors registrats durant el menor temps possible per reduir la mida de l'historial de valors a la base de dades. En lloc de mantindre un llarg historial de valors, podeu conservar dades més llargues de tendències.<br>Veieu també [històric i tendències](/manual/config/items/history_and_trends).| |*Període d'emmagatzematge de tendències*|Trieu una de les dues opcions:<br>**No conservar les tendències** - les tendències no s'emmagatzemen.<br>Aquesta configuració no pot ésser anul·lada per la [configuració](/manual/web_interface/frontend_sections/administration/general#housekeeper) de neteja global.<br>**Període d'emmagatzematge** - especifiqueu la durada de conservació de l'historial agregat (mínim, màxim, mitjà, recompte) a la base de dades (d'1 dia a 25 anys). Les dades més antigues seran eliminades per la neteja. Emmagatzemat en segons.<br>S'admeten [sufixos d'hora](/manual/appendix/sufixos), p. ex. 24h, 1d. Les [macros d'usuari](/manual/config/macros/user_macros) són compatibles.<br>El valor *Període d'emmagatzematge* es pot substituir globalment a *Administració → General → [Housekeeper](/manual/web_interface/frontend_sections/administration/general #housekeeper)*.<br>Si existeix un paràmetre d'anul·lació global, es mostra una icona d'informació carbassa. Si col·loqueu el ratolí a sobre, es mostra un missatge d'advertència, p.e. *Substituït per la configuració global de la neteja (7d)*.<br>*Nota:* El manteniment de tendències no és pas disponible per a dades no numèriques: caràcters, registre i text.<br>Veieu també [històric i tendències](/manual/config/items/history_and_trends).| |*Mapa de valors*|Aplica l'assignació de valors a aquest element. [Mapa de valors](/manual/config/items/mapping) no canvia els valors rebuts, només serveix per mostrar dades.<br>Funciona amb *Numeric(sense signe)*, *Numeric(flotant)* i *Caràcter* elements.<br>Per exemple, "Estats del servei de Windows".| |*Format d'hora de registre*|Disponible només per a elements del tipus **Registre**. Marcadors de posició admesos:<br>\* **y**: *Any (1970-2038)*<br>\* **M**: *Mes (01-12)*<br>\* **d**: *Dia (01-31)*<br>\* **h**: *Hora (00-23)*<br>\* **m**: *Minut (00-59)*<br>\* **s**: *Segon (00-59)*<br>Si es deixa en blanc, la marca de temps s'establirà a 0 de temps Unix, que representa l'1 de gener de 1970.<br>Per exemple, tingueu en compte la línia següent del fitxer de registre de l'agent Zabbix:<br> "23480:20100328:154718.045 S'ha iniciat l'agent Zabbix. Zabbix 1.8.2 (revisió 11211)."<br>Comença amb sis posicions de caràcters per al PID, seguides de la data, l'hora i la resta de la línia.<br>Temps de registre. el format d'aquesta línia seria "pppppp:yyyyMMdd:hhmmss".<br>Tingueu en compte que els caràcters "p" i ":" són només marcadors de posició i poden ser qualsevol cosa menys "yMdhms".| |*Emplena el camp d'inventari de l'equip*|Podeu seleccionar un camp d'inventari de l'equip que omplirà el valor de l'element. Això funcionarà si la població automàtica d'[inventari](/manual/config/hosts/inventory) és habilitada per a l'equip.<br>Aquest camp no és pas disponible si *Tipus d'informació* és establert a "Registre".| |*Descripció*|Introduïu una descripció de l'element.| |*Activat*|Marqueu la casella de selecció per habilitar l'element perquè es processi.| |*Darreres dades*|Fes clic a l'enllaç per veure les darreres dades de l'element.<br>Aquest enllaç només és disponible quan s'edita un element ja existent.| ::: noteclassic Els camps específics del tipus d'element es descriuen a les [pàgines corresponents] (tipus d'elements). ::: ::: noteclassic En editar un element existent de nivell [plantilla](/manual/config/templates) a nivell d'equip, el nombre de camps són només de lectura. Podeu emprar l'enllaç a la capçalera del formulariper anar al nivell de plantilla i editar-ho allà, tinguent en compte que els canvis a nivell de plantilla canviaran l'element per a tots els equips on la plantilla sigui enllaçada. ::: La pestanya **Etiquetes** permet definir el nivell d'element [etiquetes](/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. #### Configuració La regla de descoberta de baix nivell s'ha de crear com a [element dependent](/manual/config/items/itemtypes/dependent_items) de l'element principal HTTP que recull les dades de Prometheus. #### Configuration The options for aggregation are available in data set settings when configuring a [graph widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph).  You may pick the aggregation function and the time interval. As the data set may comprise several items, there is also another option allowing to show aggregated data for each item separately or for all data set items as one aggregated value. #### Configuració Les opcions d'agregació són disponibles a la configuració del conjunt de dades quan es configura un [giny de gràfic](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#graph).  Podeu triar la funció d'agregació i l'interval de temps. Com que el conjunt de dades pot consistir en diversos elements, també hi ha una altra opció per mostrar les dades agregades de cada element per separat o per a tots els elements del conjunt de dades com a valor agregat. #### 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.<br>If a dashboard contains multiple pages, only the first page will be sent as a report.| |*Period*|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.| #### Configuració La pestanya d'*Informes programats* conté atributs generals dels informes. {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Propietari*|Usuari que crea un informe. Els usuaris de nivell *superadministrador* poden canviar de propietari. Per als usuaris de nivell *administrador*, aquest camp és només de lectura.| |*Nom*|Nom de l'informe; ha de ser únic.| |*Tauler*|Tauler en què es basa l'informe; només es pot triar un tauler alhora. Per triar un tauler, comenceu a escriure el nom: apareixerà una llista de taulers coincidents; desplaceu-vos cap avall per seleccionar. Alternativament, podeu fer clic a *Triar* al costat del camp i triar un tauler de control de la llista que es mostra.<br>Si un tauler de control conté diverses pàgines, només s'enviarà la primera pàgina com a informe.| |*Període*|Període durant el qual s'elaborarà l'informe. Seleccioneu el dia, la setmana, el mes o l'any anteriors.| |*Cicle*|Freqüència de generació d'informes. Els informes es poden enviar diàriament, setmanalment, mensualment o anualment. El mode "setmanal" permet seleccionar els dies de la setmana en què s'enviarà l'informe.| |*Hora d'inici*|Hora del dia en el format hh:mm en què es prepararà l'informe. Tingueu en compte que s'empra la zona horària del servidor Zabbix.| |*Repetiu els*|Dies de la setmana en què s'enviarà l'informe. Aquest camp només està disponible si *Cicle* està establert a "Semanal".| |*Data d'inici*|Data en què s'ha de començar la generació d'informes periòdics.| |*Data de finalització*|Data en què s'hauria d'aturar la generació regular d'informes.| |*Assumpte*|Assumpte del correu electrònic de l'informe. Admet la macro {TIME}.| |*Missatge*|Cos del correu electrònic de l'informe. Admet la macro {TIME}.| |*Subscripcions*|Llista de destinataris de l'informe. De manera predeterminada, només inclou el propietari de l'informe. Qualsevol usuari de Zabbix amb mitjans de correu electrònic configurats es pot especificar com a destinatari de l'informe.<br>Feu clic a *Afegeix un usuari* o a *Afegeix un grup d'usuaris* per afegir més destinataris.<br>Feu clic al nom d'usuari per editar la configuració:<br>*Genera un informe. per*: si les dades de l'informe s'han de generar en funció dels permisos del tauler de control de l'usuari actual o del destinatari.<br>*Estat*: seleccioneu "Inclou" per enviar l'informe a l'usuari o "Exclou" per evitar l'enviament de l'informe. a aquest usuari. Com a mínim un usuari ha de tenir l'estat "Inclou". L'estat "Exclou" es pot emprar per excloure usuaris específics d'un grup d'usuaris inclòs.<br><br>Tingueu en compte que els usuaris amb permisos insuficients (és a dir, usuaris amb una funció basada en el tipus d'usuari *Administrador* que són no membres del mateix grup d'usuaris que el destinatari o el propietari de l'informe) veurà "Usuari inaccessible" o "Grup d'usuaris inaccessible" en lloc dels noms reals als camps *Destinatari* i *Genera informe per*; els camps *Estat* i *Acció* es mostraran només de lectura.| |*Activat*|Estat de l'informe. Si desactiveu aquesta casella de selecció, es desactivarà l'informe.| |*Descripció*|Una descripció opcional de l'informe. Aquesta descripció és per a ús intern i no s'enviarà als destinataris de l'informe.| #### Configuration The **Trigger** tab contains all the essential trigger attributes.  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*|If defined, this name will be used to create the problem event name, instead of 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.<br>Supported since Zabbix 5.2.0.| |*Operational data*|Operational data allow to define arbitrary strings along with macros. The macros will resolve dynamically to real time data in *Monitoring* → *[Problems](/manual/web_interface/frontend_sections/monitoring/problems)*. While macros in the trigger name (see above) will resolve to their values at the moment of a problem happening and will become the basis of a static problem name, the macros in the operational data maintain the ability to display the very latest information dynamically. If no operational data is configured on a trigger level, the latest values of all items from the expression will be displayed.<br>The same set of macros is supported as in the trigger name.| |*Severity*|Set the required trigger [severity](severity) by clicking the buttons.| |*Expression*|Logical [expression](expression) used to define the conditions of a problem.<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.| |*URL*|If not empty, the URL entered here is available as a link in several frontend locations, e.g. when clicking on the problem name in *Monitoring → Problems* (*URL* option in the *Trigger* menu) and *Problems* dashboard widget.<br>The same set of macros is supported as in the trigger name, plus {EVENT.ID}, {HOST.ID} and {TRIGGER.ID}. Note that 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.  In addition the *Inherited and trigger tags* option allows to view tags defined on 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 with 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. ::: #### Configuració La pestanya **Trigger** conté tots els atributs essencials del trigger.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Nom*|Nom del trigger.<br>Les [macros](/manual/appendix/macros/supported_by_location) admeses són: {HOST.HOST}, {HOST.NAME}, {HOST.PORT}, { HOST.CONN} , {HOST.DNS}, {HOST.IP}, {ITEM.VALUE}, {ITEM.LASTVALUE}, {ITEM.LOG.\*} i macros d'usuari {$MACRO}.<br>Les macros **$1, $2...$9** es poden emprar per fer referència a la primera, segona...novena constant de l'expressió.<br>*Nota*: les macros $1-$9 es resolen correctament si fan referència a constants en expressions relativament simples i senzilles. Per exemple, el nom "Càrrega de la CPU superior a $1 a {HOST.NAME}" canviarà automàticament a "Càrrega de la CPU superior a 5 al nou equip" si l'expressió és last(/New Host/system.cpu.load \[percpu ,avg1 \])>5| |*Nom de l'esdeveniment*|Si s'estableix, aquest nom s'emprarà per crear el nom de l'esdeveniment del problema, en lloc del nom del trigger.<br>El nom de l'esdeveniment es pot emprar per crear alertes que continguin dades del problema (veieu [exemple](/manual /config/triggers/expression#example_17)).<br>S'admeten el mateix conjunt de macros que al nom del trigger, més les macros d'expressió {TIME} i {?EXPRESSION}.<br>S'admet des de Zabbix 5.2.0. | |*Dades operacionals*|Les dades operatives permeten definir cadenes arbitràries amb macros. Les macros es resoldran dinàmicament en dades en temps real a *Monitoratge* → *[Problemes](/manual/web_interface/frontend_sections/monitoring/problems)*. Tot i que les macros del nom del trigger (veieu més amunt) resoldran els seus valors en el moment que es produeixi un problema i es convertiran en la base d'un nom de problema estàtic, les macros de les dades operatives conserven la capacitat de mostrar dinàmicament la informació més recent. Si no es configura les dades operacionals a nivell de triggers, s'ensenyaran els darrers valors de tots els elements de l'expressió.<br>S'admet el mateix conjunt de macros que al nom del trigger.| |*Gravetat*|Definiu el trigger requerit [gravetat] fent clic als botons.| |*Expressió del problema*|Lògica [Expressió](expressió) que s'empra per definir les condicions d'un problema.<br>Es crea un problema un cop es compleixen totes les condicions incloses a l'expressió, és a dir, dir que l'expressió s'avalua com a VERTADERA. El problema es resoldrà tan bon punt l'expressió s'avaluï com a FALSA, tret que s'especifiquen condicions de recuperació addicionals a *Expressió de recuperació*.| |*Generació d'esdeveniments d'acord*|Opcions de generació d'esdeveniments d'acord:<br>**Expressió** - Els esdeveniments d'acord es generen a partir de la mateixa expressió que els esdeveniments problemàtics;<br>**Expressió de recuperació** - Els esdeveniments d'acord es generen si l'expressió del problema s'avalua com a FALSA i l'expressió de recuperació s'avalua com a CERTA;<br>**Cap** - en aquest cas, el trigger mai tornarà a un estat correcte per si mateix.| |*Expressió de recuperació*|[Expressió](expressió) lògica (opcional) que defineix condicions addicionals que s'han de complir abans de resoldre el problema, després que l'expressió del problema original ja s'hagi avaluat com a FALSA. <br>L'expressió de recuperació és útil per a la [histèresi](/manual/config/triggers/expression#hysteresis) del trigger. **No** és possible resoldre un problema només amb l'expressió de recuperació si l'expressió del problema sempre és CERTA.<br>Aquest camp només és disponible si se selecciona "Expressió de recuperació" per a *Generació d'esdeveniments d'acord*.| |*Mode de generació d'esdeveniments de PROBLEMA*|Mode de generació d'esdeveniments de problemes:<br>**Només** - es genera un únic esdeveniment quan un trigger passa a l'estat "Problema" per primer cop; <br>**Múltiple** - es genera un esdeveniment per a *cada* avaluació 'Problema' del trigger.| |*Es tanca un esdeveniment correcte*|Trieu si es tanca l'esdeveniment correcte:<br>**Tots els problemes** - tots els problemes d'aquest trigger<br>**Tots els problemes si els valors de l'etiqueta coincideixen** - només els problemes de trigger amb valors corresponents de l'etiqueta d'esdeveniment| |*Etiqueta per a la coincidència*|Introduïu el nom de l'etiqueta d'esdeveniment que s'emprarà per a la correlació d'esdeveniments.<br>Aquest camp es mostra si s'han triat "Tots els problemes si els valors de l'etiqueta coincideixen" per a la propietat *Es tanca un esdeveniment d'acord* i es mostra obligatòria en aquest cas. | |*Permetre el tancament manual*|Marqueu per permetre el [tancament manual](/manual/config/events/manual_close) d'esdeveniments problemàtics generats per aquest trigger. El tancament manual és possible quan es reconeixen esdeveniments problemàtics.| |*URL*|Si no és buida, la URL introduïda aquí és disponible com a enllaç a diverses ubicacions de front-end, com ara fent clic al nom del problema a *Monitoratge → Problemes* (opció *URL* al menú *Trigger*) i al giny del tauler de control *Problemes*.<br>S'admeten el mateix conjunt de macros que al nom del trigger, més {EVENT.ID}, {HOST.ID} i {TRIGGER.ID}. Tingueu en compte que les macros d'usuari amb valors secrets no es resoldran a l'URL.| |*Descripció*|Camp de text emprat per proporcionar més informació sobre aquest trigger. Pot contindre instruccions per resoldre un problema específic, informació de contacte del personal responsable, etc.<br>S'admeten el mateix conjunt de macros que al nom del trigger.| |*Activat*|Desmarcar aquesta casella desactivarà el trigger, si escau.<br>Els problemes d'un trigger desactivat ja no es veuen a la interfície, però no s'esborren.| La pestanya **Etiquetes** us permet definir [etiquetes](/manual/config/tagging) al nivell de trigger. Tots els problemes d'aquest trigger s'etiquetaran amb els valors introduïts aquí.  A més, l'opció *Etiquetes i triggers heretats* us permet veure les etiquetes definides a nivell de model, si el trigger prové d'aquest model. Si hi ha diversos models amb la mateixa etiqueta, aquestes etiquetes només es mostren una vegada i els noms dels models es separen per comes. Un trigger no "hereta" i mostra etiquetes a nivell d'equip. |Paràmetre|Descripció| |--|---------| |*Nom/Valor*|Definiu etiquetes personalitzades per marcar esdeveniments triggers.<br>Les etiquetes són un parell de valors i nom d'etiqueta. Podeu emprar només el nom o combinar-lo amb un valor. Un trigger pot tindre diverses etiquetes amb el mateix nom, però amb valors diferents.<br> Macros d'usuari, context de macro d'usuari, macros de descoberta de baix nivell i [funcions macro](/manual/config/macros/macro_functions) amb `{{ITEM .VALUE}}`, `{{ITEM.LASTVALUE}}`, s'admeten a les etiquetes d'esdeveniment. Les macros de descoberta de baix nivell es poden emprar en un context de macro.<br>La macro {TRIGGER.ID} és compatible amb els valors de l'etiqueta de trigger. Això pot ser útil per identificar triggers creats a partir de prototips de trigger i, per exemple, esborrar problemes d'aquests triggers durant el manteniment.<br>Si la longitud total del valor ampliat supera els 255, es reduirà a 255 caràcters.<br>Veieu totes les [macros](/manual/config/tagging#macro_support) admeses per a les etiquetes d'esdeveniment.<br>Les [etiquetes d'esdeveniment](/manual/config/tagging) es poden emprar per a la correlació d'esdeveniments, en condicions d'acció i també serà visible a *Monitoratge* → *Problemes* o el giny *Problemes*.| La pestanya **Dependències** conté totes les [dependències] del trigger. Feu clic a *Afegir* per afegir una nova dependència. :::noteclassic També podeu configurar un trigger obrint un trigger existent, prement el botó *Clonar* i després desant-lo amb un nom diferent. ::: ### Configuration The Zabbix API allows you to manage the configuration of your monitoring system. ### Configuració L'API Zabbix ens permet gestionar la configuració del nostre sistema de monitoratge. [API Configuració](/manual/api/reference/configuration) # Configuration This class is designed to export and import Zabbix configuration data. Available methods: - [configuration.export](/manual/api/reference/configuration/export) - exporting the configuration - [configuration.import](/manual/api/reference/configuration/import) - importing the configuration - [configuration.importcompare](/manual/api/reference/configuration/importcompare) - comparing import file with current system elements # Configuració Aquesta classe és dissenyada per exportar i importar informació de la configuració de Zabbix. Mètodes disponibles: - [configuration.export](/manual/api/reference/configuration/export) - exportant la configuració - [configuration.import](/manual/api/reference/configuration/import) - important la configuració - · [configuration.importcompare](/manual/api/reference/configuration/importcompare) - comparant l'arxiu d'importació amb els elements actuals del sistema #### 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. ::: noteimportant Remote commands do not work with active Zabbix agents. ::: Then, when configuring a new action in *Configuration → Actions*: - Define the appropriate conditions. In this example, set that the action is activated upon any disaster problems with one of Apache applications:  - In the *[Operations](/manual/config/notifications/action/operation#configuring_an_operation)* tab, click on Add in the Operations/Recovery operations/Update operations block - From the Operation dropdown field select one of the predefined scripts  - Select the target list for the script #### Configuració Les ordres remotes executades a l'agent Zabbix (scripts personalitzats) primer s'han d'habilitar al fitxer [configuració de l'agent](/manual/appendix/config/zabbix_agentd). Assegureu-vos que s'afegeix el paràmetre AllowKey=system.run[<command>,\*] per a cada ordre permesa a la configuració de l'agent per permetre una ordre específica amb el mode nowait. Reinicieu el dimoni de l'agent si canvieu aquesta configuració. ::: noteimportant Les ordres remotes no funcionen amb agents Zabbix actius. ::: Aleshores, quan es configura una acció nova a *Configuració → Accions*: - Definiu les condicions adequades. En aquest exemple, indiqueu que l'acció és activada en cas d'un problema a nivell de desastre amb una de les aplicacions Apache:  - A la pestanya *[Operacions](/manual/config/notifications/action/operation#configuring_an_operation)*, feu clic a Afegeix al bloc Operacions/Recuperar operacions/Actualitzar operacions - Al camp desplegable Operació, trieu un dels scripts predefinits  - Trieu la llista d'objectius per a l'script #### Configuration To add the widget, select *Geomap* as type.  #### Configuració Per afegir el giny, trieu *Geomapes* com a tipus.  #### 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. #### Configuració Per assignar triggers com a indicadors d'enllaç, seguiu aquestes passes: - troeu un element del mapa - feu clic a *Editar* a la secció *Enllaços* per trobar l'enllaç adequat - feu clic a *Afegir* al bloc *Indicadors d'enllaç* i seleccioneu un o més triggers {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els triggers afegits es poden veure a la llista *Indicadors d'enllaç*. Podeu definir el tipus i el color d'enllaç per a cada trigger directament des de la llista. Quan hagis acabat, fes clic a *Aplicar*, tanca el formulari i fes clic a *Actualitzar* per desar els canvis al mapa. #### 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 e-mails from Zabbix, e-mail servers/clients must support standard 'SMTP/MIME e-mail' 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 e-mail' format standard. Message limit after all macros expansion is the same as message limit for [Remote commands](/manual/config/notifications/action/operation/remote_command). #### Configuració Per poder enviar i rebre notificacions de Zabbix has de: - [definir el suport](/manual/config/notifications/media) per enviar un missatge Si l'operació es fa fora del període de temps [quan és actiu](/manual/config/notifications/media#user-media) definit per al suport triat a la configuració de l'usuari, el missatge no s'enviarà pas. La gravetat del trigger predeterminat ('No classificat') **ha d'ésser** marcat a la [configuració](/manual/config/notifications/media/email#user_media) dels suports d'usuari si voleu rebre notificacions d'esdeveniments que no desencadenen, com ara descoberta, registre automàtic d'agent actiu o esdeveniments interns. - [configurar una operació d'acció](/manual/config/notifications/action/operation) que envia un missatge a un dels suports definits ::: noteimportant Zabbix envia notificacions només als usuaris que tinguin almenys permisos de "lectura" a l'equip que ha generat el fitxer d'esdeveniment. Com a mínim un equip d'una expressió de trigger ha d'ésser accessible. ::: Podeu configurar escenaris personalitzats per enviar missatges mitjançant [escalades](/manual/config/notifications/action/escalations). Per rebre i llegir correctament els correus electrònics de Zabbix, envieu un correu electrònic Des d'aleshores, els servidors/clients han de suportar el format estàndard de "correu electrònic SMTP/MIME". Zabbix envia dades UTF-8 (si el tema només conté caràcters ASCII, no és codificat amb UTF-8). El tema i el cos del missatge són codificats en base64 per seguir l'estàndard de format "SMTP/MIME e-mail". El límit de missatges després de l'expansió de totes les macros és el mateix que el límit de missatges per a [comandes remotes](/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. #### Configuració Per configurar una passa de preprocessament CSV a JSON: - Aneu a la pestanya Preprocessament a [element](/manual/config/items/preprocessing) configuració/[regla de descoberta](/manual/discovery/low_level_discovery#preprocessing) - Feu clic a *Afegir* - Trieu l'opció *CSV a JSON* {width="600"} El primer paràmetre us permet definir un delimitador personalitzat. Tingueu en compte que si la primera línia de l'entrada CSV comença amb "Sep=" i va seguida d'un únic caràcter UTF-8, aquest caràcter s'emprarà com a delimitador si no s'estableix el primer paràmetre. Si el primer paràmetre no és pas definit i no s'extreu un delimitador de la línia "Sep=", s'empra una coma com a separador. El segon paràmetre opcional permet definir un símbol de cotització. Si la casella *Amb filera de capçalera* és marcada, els valors de la filera de capçalera s'interpretaran com a noms de columna (veieu [processament de capçalera](#csv_header_processing) per obtindre més informació). Si la casella *Personalitzat en cas d'errada* és marcada, l'element no serà compatible si manca una passa de preprocessament. A més, es poden establir opcions de gestió d'errors personalitzades: ignorar el valor, establir el valor especificat o establir el missatge d'error especificat. #### Configuration To configure a maintenance period: - Go to: *Configuration → Maintenance* - Click on *Create maintenance period* (or on the name of an existing maintenance period) - Enter maintenance parameters in the form  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 will be collected by the server during maintenance, triggers will be processed<br>**No data collection** - data will not be collected by the server during maintenance| |*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*|If maintenance tags are specified, maintenance for the selected hosts will be activated, but only problems with matching tags will be suppressed (i.e. no actions will be taken).<br>In case of multiple tags, they are calculated as follows:<br>**And/Or** - all tags must correspond; however tags with the same tag name are calculated by the Or condition<br>**Or** - enough if one tag corresponds<br>There are two ways of matching the tag value:<br>**Contains** - case-sensitive substring match (tag value contains the entered string)<br>**Equals** - case-sensitive string match (tag value equals the entered string) <br> Tags can be specified only if *With data collection* mode is selected.| |*Description*|Description of maintenance period.| #### Configuració Per configurar un període de manteniment: - Aneu a: *Configuració → Manteniment* - Feu clic a *Crear un període de manteniment* (o al nom d'un període de manteniment existent) - Introduïu els paràmetres de manteniment al formulari  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Nom*|Nom del període de manteniment.| |*Tipus de manteniment*|Es poden definir dos tipus de manteniment:<br>**Amb recollida de dades** - les dades seran recollides pel servidor durant el manteniment, es processaran els triggers<br>**Sense recollida de dades** - les dades no seran recollides pel servidor durant el manteniment| |*Actiu des de*|La data i l'hora des que aquest període de manteniment és actiu.<br>*Nota*: establir una data aquí no activa el període de manteniment; per fer-ho, aneu a la pestanya *Períodes*.| |*Actiu fins a*|La data i l'hora en què aquesta finestra de manteniment deixarà d'ésser activa.| |*Períodes*|Aquest bloc permet definir els dies i hores exactes en què es realitza el manteniment. Si feu clic a  s'obre un formulari flexible de *període de manteniment* on podeu establir un programa de manteniment. Veieu [períodes de manteniment](#períodes_de_manteniment) per a una descripció més detallada.| |*Grups d'equips*|Trieu els grups d'equips per als quals s'habilitarà el manteniment. El manteniment s'habilitarà per a tots els equips dels grups d'equips especificats. Aquest camp s'emplena automàticament. Per tant, si l'escriviu, un menú desplegable mostra tots els grups d'equips disponibles.<br>Especificar un grup d'equips principal tria implícitament tots els grups d'equips heretats. Així, el manteniment també s'habilitarà als equips dels grups heretats.| |*Equips*|Trieu els equips per als quals s'habilitarà el manteniment. Aquest camp s'emplena automàticament. Per tant, si comenceu a escriure, un menú desplegable mostra tots els equips disponibles.<br>| |*Etiquetes*|Si s'especifiquen etiquetes de manteniment, els equips seleccionats continuaran tinguent el manteniment activat, però els problemes s'esborraran (és a dir, no es farà cap acció) si les seves etiquetes coincideixen.<br>En el cas de diverses etiquetes, es calculen com a segueix:<br>**I/O** - totes les etiquetes han de coincidir; tanmateix, les etiquetes amb el mateix nom es calculen mitjançant la condició O<br>**O** - suficient si una etiqueta coincideix<br>Hi ha dues maneres de fer coincidir el valor de l'etiqueta:<br>**Conté** - concordança de subcadenes sensible a majúscules i minúscules (el valor de l'etiqueta conté la cadena introduïda)<br>**Igual** - coincidència de cadena sensible a majúscules (el valor de l'etiqueta és igual a la cadena introduïda) | |*Descripció*|Descripció del període de manteniment.| #### Configuration To configure an HTTP item: - Go to: *Configuration* → *Hosts* - Click on *Items* in the row of the host - Click on *Create item* - Enter parameters of the item in the form  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*| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (1-60 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>Time suffixes are supported, e.g. 30s, 1m.<br>Supported macros: user macros, low-level discovery macros.<br>This sets the [CURLOPT\_TIMEOUT](https://curl.haxx.se/libcurl/c/CURLOPT_TIMEOUT.html) cURL option.| |*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.<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*|Authentication type:<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>Selecting an authentication method will provide two additional fields for entering a user name and password, where user macros and low-level discovery macros are supported.<br>This sets the [CURLOPT\_HTTPAUTH](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPAUTH.html) cURL option.| |*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.| |*Enable trapping*|With this checkbox marked, the item will also function as [trapper item](/manual/config/items/itemtypes/trapper) and will accept data sent to this item by Zabbix sender or using Zabbix sender protocol.| |*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 ::: #### Configuració Per configurar un element HTTP: - Vés a: *Configuració* → *Equips* - Feu clic a *Elements* a la fila de l'equip - Feu clic a *Crear element* - Introduïu els paràmetres de l'element al formulari  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els camps que requereixen informació específica per als elements HTTP són: |Paràmetre|Descripció| |--|---------| |*Type*|Trieu **Agent HTTP** aquí.| |*Key*|Introduïu una clau d'element única.| |*URL*|URL de connexió i recuperació de dades. Per exemple:<br>https://www.example.com<br>http://www.example.com/download<br>Els noms de domini es poden especificar en caràcters Unicode. Es converteixen automàticament de punycode a ASCII quan s'executa la comprovació HTTP.<br>El botó *Analitzar* es pot emprar per separar els camps de consulta opcionals (com ara ?name=Admin&password=mypassword) de l'URL, movent els atributs i els valors als *camps de consulta* per a la codificació automàtica d'URL.<br> Limitat a 2048 caràcters.<br> Macros admeses: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST . NOM}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.<br> Això estableix el [CURLOPT\_URL](https://curl.haxx). .se/libcurl/c/CURLOPT_URL.html) de cURL.| |*Camps de consulta*|Variables per a l'URL (veieu més amunt).<br>Especificat com a parells d'atribut i valor.<br>Els valors es codifiquen automàticament per URL. Els valors de macro es resolen i després es codifica automàticament l'URL.<br>Macros admeses: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM .ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.<br>Això estableix el [CURLOPT\_URL](https://curl. haxx.se/libcurl/ c/CURLOPT_URL.html) de cURL.| |*Tipus de petició*|Trieu el tipus de mètode de petició: *GET*, *POST*, *PUT* o *HEAD*| |*Temps d'espera*|Zabbix no gastarà més del temps establert al processament d'URL (1-60 segons). De fet, aquest paràmetre defineix el temps màxim per establir una connexió a l'URL i el temps màxim per fer una petició HTTP. Per tant, Zabbix no dedicarà més de 2 segons de temps d'espera en una comprovació.<br>S'admeten sufixos de temps, p. 30 s, 1 min.<br> Macros admeses: macros d'usuari, macros de descoberta de baix nivell.<br> Això estableix el [CURLOPT\_TIMEOUT](https://curl.haxx.se/libcurl/c/ CURLOPT_TIMEOUT.html) de cURL .| |*Tipus de cos de la petició*|Trieu el tipus de cos de la petició:<br>**Dades en brut**: cos de petició HTTP personalitzat, les macros es substitueixen però no es fa cap codificació<br> **Dades JSON**: cos de la petició HTTP a Format JSON. Les macros es poden emprar com a cadena, nombre, vertader i fals; Les macros emprades com a cadenes s'han de lliurar entre cometes dobles. Els valors de macro es resolen i després s'escapa automàticament. Si no s'especifica "Tipus de contingut" a les capçaleres, serà per defecte "Tipus de contingut: aplicació/json"<br>**Dades XML**: cos de la petició HTTP en format XML. Les macros es poden emprar com a node de text, atribut o secció CDATA. Els valors de macro es resolen i després s'escapa automàticament a un node i atribut de text. Si "Content-Type" no s'especifica a les capçaleres, per defecte serà "Content-Type: application/xml"<br>*Tingueu en compte* que triar *XML Data* requereix libxml2.| |*Cos de la petició*|Introduïu el cos de la petició.<br>Macros admeses: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, { ARTICLE. ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.| |*Capçaleres*|Capçaleres HTTP personalitzades que s'enviaran en executar una petició.<br>Especificada com a parells d'atributs i valors.<br>Macros admeses: {HOST .IP}, {HOST.CONN}, {HOST.DNS} , {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.<br> Això estableix l'opció [CURLOPT \_HTTPHEADER](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) de cURL.| |*Codis d'estat obligatoris*|Llista de codis d'estat HTTP esperats. Si Zabbix obté un codi que no es troba a la llista, l'element ja no serà compatible. Si és buit, no es fa pas cap comprovació.<br>Per exemple: 200,201,210-299<br>Macros admeses a la llista: macros d'usuari, macros de descoberta de baix nivell.<br>Això empra l'[opció CURLINFO \_RESPONSE\_CODE](https ://curl.haxx.se/libcurl/c/CURLINFO_RESPONSE_CODE.html) de cURL.| |*Seguir redireccions*|Marqueu la casella per seguir les redireccions HTTP.<br>Això estableix l'opció cURL [CURLOPT\_FOLLOWLOCATION](https://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html).| |*Mode de recuperació*|Trieu la part de la resposta que voleu recuperar:<br>**Cos** - només el cos<br>**Capçaleres** - només les capçaleres<br>**Cos i capçaleres** - cos i capçaleres| |*Convertir a JSON*|Les capçaleres es desen com a parells d'atributs i valors sota la clau "capçalera".<br>Si es troba "Tipus de contingut: aplicació/json", el cos es desa com a objecte, en cas contrari s'emmagatzema com a cadena, per exemple:<br>| |*Proxy HTTP*|Podeu especificar un proxy HTTP per emprar, emprant el format `[protocol://][nom d'usuari[:contrasenya]@]proxy.example.com[:port]`.<br>El prefix opcional `protocol://` es pot emprar per especificar protocols de proxy alternatius (per exemple, https, socks4, socks5; veieu [documentació](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html); el suport del prefix de protocol era afegit a cURL 7.21.7. Sense un protocol especificat, el proxy es tractarà com un proxy HTTP. Si especifiqueu un protocol incorrecte, la connexió fallarà i l'element ja no serà compatible. br>Per defecte, s'emprarà el port 1080.<br>Si s'especifica, el proxy substituirà les variables d'entorn relacionades amb el proxy, com ara http\_proxy, HTTPS\_PROXY. Si no s'especifica, el proxy no sobreescriurà les variables d'entorn relacionades amb el proxy. El valor introduït es passa "tal com ve", no es fa cap comprovació d'integritat.<br>*Tingueu en compte* que només s'admet l'autenticació simple amb el proxy HTTP.<br>Macros compatibles: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, { HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY }, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.<br>Això estableix l'opció cURL [CURLOPT\ _PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY .html).| |*Autenticació HTTP*|Tipus d'autenticació:<br>**Cap**: no s'empra cap autenticació.<br>**Bàsica**: s'empra l'autenticació bàsica.<br>**NTLM** - NTLM ([Windows NT S'empra LAN Manager](http://en.wikipedia.org/wiki/NTLM)).<br>**Kerberos**: s'empra l'autenticació Kerberos. Veieu també: [Configuració de Kerberos amb Zabbix](/manual/appendix/items/kerberos).<br>**Digest**: s'empra l'autenticació de Digest.<br>Seleccionar un mètode d'autenticació proporcionarà dos camps addicionals per introduir un nom d'usuari i mot de pas, on s'admeten macros d'usuari i macros de descoberta de baix nivell.<br>Això estableix l'opció cURL [CURLOPT\_HTTPAUTH](https://curl.haxx.se/libcurl/c/CURLOPT_HTTPAUTH.html).| |*Verifiqueu SSL peer*|Marqueu la casella per verificar el certificat SSL del servidor web. El certificat del servidor es recuperarà automàticament des de la ubicació de l'Autoritat de certificació (CA) de tot el sistema. Podeu substituir la ubicació dels fitxers CA mitjançant el paràmetre de configuració del servidor Zabbix o del proxy SSLCALocation.<br>Això estableix l'opció cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*Verifica l'equip SSL*|Marca la casella per verificar que el camp Nom comú o Nom alternatiu de l'assumpte del certificat del servidor web coincideix.<br>Això estableix el [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) de cURL.| |*Fitxer de certificat SSL*|Nom del fitxer de certificat SSL emprat per a l'autenticació del client. El fitxer del certificat ha d'ésser en format PEM^1^. Si el fitxer del certificat també conté la clau privada, deixeu el camp Fitxer de clau SSL en blanc. Si la clau és xifrada, especifiqueu el mot de pas al camp Mot de pas de la clau SSL. El directori que conté aquest fitxer l'especifica el servidor Zabbix o el paràmetre de configuració del proxy SSLCertLocation.<br> Macros admeses: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST }, {HOST.NAME } , {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.<br>Això estableix l'opció cURL [CURLOPT\ _SSLCERT](http://curl.haxx .se/libcurl/c/CURLOPT_SSLCERT.html).| |*Fitxer de clau SSL*|Nom del fitxer de clau privada SSL emprat per a l'autenticació del client. El fitxer de clau privada ha d'ésser en format PEM^1^. El directori que conté aquest fitxer l'especifica el servidor Zabbix o el paràmetre de configuració del proxy SSLKeyLocation.<br> Macros admeses: {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}, {ITEM.KEY.ORIG}, macros d'usuari, macros de descoberta de baix nivell.<br>Això estableix l'opció cURL [CURLOPT\ _SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html).| |*Mot de pas de clau SSL*|Mot de pas del fitxer de clau privada SSL.<br>Macros admeses: macros d'usuari, macros de descoberta de baix nivell.<br>Això estableix l'opció cURL [CURLOPT \_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html).| |*Activa trampes*|Amb aquesta casella marcada, l'element també funcionarà com a [element trapper](/manual/config/items/itemtypes/trapper) i acceptarà les dades enviades a aquest element pel remitent Zabbix o mitjançant el protocol de remitent Zabbix.| |*Equips permesos*|Visible només si la casella *Activa trampes* és marcada.<br>Llista d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms d'equips.<br>Si s'especifica, les connexions només s'acceptaran de trucades entrants dels equips que s'indiquen aquí.<br>Si el suport d'IPv6 és habilitat, "127.0.0.1", "::127.0.0.1", "::ffff:127.0.0.1" es tracten de la mateixa manera i "::/0" permetrà qualsevol adreça IPv4 o IPv6.<br>'0.0.0.0/0' es pot emprar per permetre qualsevol adreça IPv4.<br>Tingueu en compte que les adreces IPv6 compatibles amb IPv4 (prefix 0000::/96) són compatibles, però és obsolet per [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Exemple: Server=127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, zabbix.domain<br>Els espais i les [macros d'usuari](/manual/config/macros/user_macros) són permeses en aquest camp.<br>Les macros d'equip: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} són permeses en aquest camp.| ::: notetip Si el camp *Proxy HTTP* es deixa en blanc, una altra manera d'emprar un proxy HTTP és establir variables d'entorn relacionades amb el proxy. Per a HTTP: establiu la variable d'entorn "http_proxy" per a l'usuari del servidor Zabbix. Per exemple:<br> `http_proxy=http://proxy_ip:proxy_port`. Per a HTTPS: establiu la variable d'entorn `HTTPS_PROXY`. Per exemple:<br> `HTTPS_PROXY=http://proxy_ip:proxy_port`. Hi ha més detalls disponibles executant l'ordre de shell: *\# man curl*. ::: ::: noteimportant \[1\]Zabbix només admet fitxers de certificat i clau privada en format PEM. Si teniu el vostre certificat i les vostres dades de clau privada en un fitxer en format PKCS \#12 (normalment amb l'extensió \*.p12 o \*.pfx), podeu generar-ne el fitxer PEM amb les ordres següents: 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 user group: - Go to *Administration → User groups* - Click on *Create user group* (or on the group name to edit an existing group) - Edit group attributes in the form The **User group** tab contains general group attributes:  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/administration/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| |*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 **Permissions** tab allows you to specify user group access to host group (and thereby host) data: {width="600"} Current permissions to host groups are displayed in the *Permissions* block. If current permissions of the host group are inherited by all nested host groups, this is indicated after the host group name ("*including subgroups*"). Note that a *Super admin* user can enforce nested host groups to have the same level of permissions as the parent host group; this can be done in the host group [configuration](/manual/config/hosts/host#creating_a_host_group) form. You may change the level of access to a host group: - **Read-write** - read-write access to a host group; - **Read** - read-only access to a host group; - **Deny** - access to a host group denied; - **None** - no permissions are set. Use the selection field below to select host groups and the level of access to them. This field is auto-complete so starting to type the name of a host group will offer a dropdown of matching host groups. If you wish to see all host groups, click on *Select*. If you wish to include nested host groups, mark the *Include subgroups* checkbox. Click on  to add the selected host groups to the list of host group permissions. :::noteimportant Adding a parent host group with the *Include subgroups* checkbox marked will override (and remove from the list) previously configured permissions of all related nested host groups. Adding a host group with *None* as the level of access selected will remove the host group from the list if the host group is already in the list. ::: The **Tag filter** tab allows you to set tag-based permissions for user groups to see problems filtered by tag name and its value:  To select a host group to apply a tag filter for, click *Select* to get the complete list of existing host groups or start to type the name of a host group to get a dropdown of matching groups. If you want to apply tag filters to nested host groups, mark the *Include subgroups* checkbox. Tag filter allows to separate 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 "Service" tag name and "MySQL" value.  If "Service" tag name is specified and value field is left blank, corresponding user group will see all problems for selected host group with tag name "Service". If both tag name and value fields are left blank but host group selected, corresponding user group will see all problems for selected host group. Make sure a tag name and tag value are correctly specified otherwise a corresponding 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*|^| |Templates/Databases|Service|MySQL|Templates/Databases|Service|Oracle|Service: MySQL or Oracle problems visible| |Templates/Databases|*blank*|*blank*|Templates/Databases|Service|Oracle|All problems visible| |*not selected*|*blank*|*blank*|Templates/Databases|Service|Oracle|<Service:Oracle> problems visible| ::: noteimportant Adding a filter (for example, all tags in a certain host group "Templates/Databases") results in not being able to see the problems of other host groups. ::: #### configuració Per configurar un grup d'usuaris: - aneu a *Administració → Grups d'usuaris* - Feu clic a *Crear un grup d'usuaris* (o al nom del grup per editar un grup ja existent) - Editar els atributs del grup, al formulari La pestanya **Grup d'usuaris** conté atributs generals del grup:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Nom del grup*|Nom únic del grup.| |*Usuaris*|Per afegir usuaris al grup comenceu a escriure el nom d'un usuari existent. Quan aparegui el menú desplegable amb els noms d'usuari coincidents, desplaceu-vos cap avall per triar-lo.<br>Com a alternativa, podeu fer clic al botó *Triar* per triar usuaris en una finestra emergent.| |*Accés a l'interfície*|Com s'autentiquen els usuaris del grup.<br>**Per defecte del sistema** - empreu el mètode d'autenticació predeterminat (configureu [globalment](/manual/web_interface/frontend_sections/administration/authentication))<br> **Intern** - empreu l'autenticació interna de Zabbix (fins i tot si l'autenticació LDAP s'empra globalment).<br>Ignorat si l'autenticació HTTP és la predeterminada global.<br>**LDAP** - empreu l'autenticació LDAP (encara que l'autenticació interna sigui emprada globalment).<br>S'ignora si l'autenticació HTTP és la predeterminada global.<br>**Desactivat** - l'accés a la interfície de Zabbix és prohibit per a aquest grup| |*Activat*|Estat del grup d'usuaris i dels membres del grup.<br>*Marcat* - el grup d'usuaris i els usuaris són actius<br>*Desmarcat* - el grup d'usuaris i els usuaris són desactivats| |*Mode de depuració*|Marqueu aquesta casella de selecció per activar el [mode de depuració](/manual/web_interface/debug_mode) per als usuaris.| La pestanya **Permisos** us permet especificar l'accés del grup d'usuaris a les dades del grup d'equipss (i, per tant, de l'equip): {width="600"} Els permisos actuals per allotjar grups es mostren al bloc *Permisos*. Si tots els grups d'equips heredats hereten els permisos actuals del grup d'equips, això s'indica després del nom del grup d'equips ("*inclosos subgrups*"). Tingueu en compte que un usuari *Superadministrador* pot fer que els grups d'equips heredats tinguin el mateix nivell de permisos que el grup d'equipss principal; això es pot fer al formulari [configuració](/manual/config/hosts/host#creating_a_host_group). Podeu canviar el nivell d'accés a un grup d'equipss: - **Lectura-escriptura** - accés de lectura-escriptura a un grup d'equipss; - **Llegir** - accés de només lectura a un grup d'equipss; - **Denegar** - s'ha denegat l'accés a un grup d'equipss; - **Cap** - no hi ha permisos establerts. Empreu el camp de selecció següent per triar grups d'equipss i el nivell d'accés a ells. Aquest camp s'emplena automàticament, de manera que començar a escriure el nom d'un grup d'equips oferirà un menú desplegable dels grups d'equips coincidents. Si voleu veure tots els grups d'equips, feu clic a *Triar*. Si voleu incloure grups d'equips heredats, marqueu la casella de selecció *Incloure subgrups*. Feu clic a  per afegir els grups d'equips triats a la llista de permisos de grups d'equipss. :::noteimportant Afegir un grup d'equipss principal amb la casella de selecció *Inclou subgrups* marcada anul·larà (i s'esborrarà de la llista) els permisos configurats anteriorment de tots els grups d'equipss heredats relacionats. Afegir un grup d'equipss amb *Cap* com a nivell d'accés seleccionat esborrarà el grup d'equipss de la llista si el grup d'equipss és a la llista. ::: La pestanya **Filtre d'etiquetes** us permet establir permisos basats en etiquetes perquè els grups d'usuaris vegin els problemes filtrats pel nom de l'etiqueta i el seu valor:  Per triar un grup d'equipss per aplicar un filtre d'etiquetes, feu clic a *Tria* per obtindre la llista completa dels grups d'equipss existents o comenceu a escriure el nom d'un grup d'equips per obtenir un menú desplegable dels grups que coincideixen. Si voleu aplicar filtres d'etiquetes als grups d'equips heredats, marqueu la casella de selecció *Incloure subgrups*. El filtre d'etiquetes permet separar l'accés al grup d'equips de la possibilitat de veure problemes. Per exemple, si un administrador de base de dades només ha de veure problemes de base de dades "MySQL", primer cal crear un grup d'usuaris per als administradors de bases de dades i després especificar el nom de l'etiqueta "Servei" i el valor "MySQL".  Si s'especifica el nom de l'etiqueta "Servei" i el camp de valor es deixa en blanc, el grup d'usuaris corresponent veurà tots els problemes del grup d'equips triat amb el nom d'etiqueta "Servei". Si els camps de nom i valor de l'etiqueta es deixen en blanc però el grup d'equips triat, el grup d'usuaris corresponent veurà tots els problemes del grup d'equips triat. Assegureu-vos que un nom d'etiqueta i un valor d'etiqueta siguin especificats correctament, en cas contrari, el grup d'usuaris corresponent no veurà cap problema. Revisem un exemple quan un usuari és membre de diversos grups d'usuaris seleccionats. El filtrat en aquest cas emprarà la condició OR per a les etiquetes. | | | | | | | | |---|---|---|---|---|---|---| |**Grup d'usuaris A**|<|<|**Grup d'usuaris B**|<|<|**Resultat visible per a un usuari (membre) dels dos grups**| |*Filtre d'etiquetes*|<|<|<|<|<|^| |*Grup d'equip*|*Nom de l'etiqueta*|*Valor de l'etiqueta*|*Grup d'equips*|*Nom de l'etiqueta*|*Valor de l'etiqueta*|^| |Plantilles/Bases de dades|Servei|MySQL|Plantilles/Bases de dades|Servei|Oracle|Servei: problemes MySQL o Oracle visibles| |Plantilles/Bases de dades|*en blanc*|*en blanc*|Plantilles/Bases de dades|Servei|Oracle|Tots els problemes visibles| |*no seleccionat*|*en blanc*|*en blanc*|Plantilles/Bases de dades|Servei|Oracle|<Service:Oracle> problemes visibles| ::: noteimportant Afegir un filtre (per exemple, totes les etiquetes d'un determinat grup d'equips "Plantilles/Bases de dades") fa que no es puguin veure els problemes d'altres grups d'equips. ::: #### 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.  #### Configuració Per definir un dels valors: - Obriu un formulari de configuració d'equip o model - Aneu a la pestanya *Taula de correspondència* - Feu clic a *Afegeix* per afegir una taula nova - Feu clic al nom d'una taula existent per modificar-la  Paràmetres d'una taula de mapeig de valors: |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom*|<|Nom únic d'un conjunt de coincidències de valors.| |*Coincidències*|<|Regles de concordança individuals per assignar valors numèrics/cadenes a representacions de cadena.<br>El mapatge s'aplica en l'ordre de les regles de mapatge. Els mapes es poden reordenar arrossegant.<br>Només s'admeten els tipus de valors numèrics per als intervals de mapes (els tipus de mapes *és major o igual que*, *és menor o igual que*, *és dins l'interval*).| | |*Tipus*|Tipus de mapeig:<br>**igual** - s'assignaran valors iguals<br>**és més gran o igual que** - s'assignaran valors iguals o superiors<br> **és menor o igual a** - es mapejaran valors iguals o menors<br>**es dins l'interval** - els valors dins l'interval s'assignaran; l'interval s'expressa com a <nombre1>-<nombre2> o <nombre>. S'admeten diversos intervals (p. ex., 1-10 101-110 201)<br>**expressió regular** - els valors que coincideixen amb [expressió regular](/manual/expressions_regulars) s'assignaran (no s'admeten expressions regulars)<br >* *per defecte** - tots els valors pendents s'assignaran, excepte els que tinguin mapes específics.| |^|*Valor*|Valor entrant.<br>Depenent del tipus de mapatge, també pot contindre un interval o una expressió regular.| |^|*Coincidències*|Representació de cadena (fins a 64 caracters) per al valor entrant.| Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Quan la taula d'assignació de valors es mostra a la llista, només els tres primers mapes són visibles, mentre que tres punts indiquen que hi ha altres mapes.  #### Configuration To configure custom alert scripts as the media type: - Go to *Administration → Media types* - Click on *Create media type* The **Media type** tab contains general media type attributes:  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 server [configuration file](/manual/appendix/config/zabbix_server) `AlertScriptsPath` parameter.| |*Script parameters*|Add command-line parameters to the script.<br>{ALERT.SENDTO}, {ALERT.SUBJECT} and {ALERT.MESSAGE} [macros](/manual/appendix/macros/supported_by_location) are supported in script parameters.<br>Customizing script parameters is supported since Zabbix 3.0.| 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 doesn't use default messages, message templates for operation types used by this media type must still be defined, otherwise a notification will not be sent. ::: ::: noteimportant As parallel processing of media types is implemented since Zabbix 3.4.0, it is important to note that with more than one script media type configured, these scripts may be processed in parallel by alerter processes. The total number of alerter processes is limited by the StartAlerters [parameter](/manual/appendix/config/zabbix_server). ::: #### Configuració Per configurar scripts d'alerta personalitzats com a tipus de suport: - Aneu a *Administració → Tipus de suport* - Feu clic a *Crear un tipus de suport* La pestanya **Tipus de suport** conté atributs generals del tipus de suport:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els paràmetres següents són específics del tipus de suport d'script: |Paràmetre|Descripció| |--|---------| |*Nom de l'script*|Introduïu el nom de l'script (per exemple, notificacio.sh) que és al directori definit al paràmetre `AlertScriptsPath` de l'[arxiu de configuració](/manual/appendix/config/zabbix_server) del servidor.| |*Paràmetres de l'script*|Afegiu paràmetres de línia d'ordres a l'script.<br>S'admeten les [macros](/manual/appendix/macros/supported_by_location) {ALERT.SENDTO}, {ALERT.SUBJECT} i {ALERT.MESSAGE} als paràmetres de l'script.<br>La personalització dels paràmetres de l'script és compatible des de Zabbix 3.0.| Veieu [paràmetres de tipus de mitjans comuns](/manual/config/notifications/media#common_parameters) per obtindre informació sobre com configurar els missatges predeterminats i les opcions de gestió d'alertes. ::: notewarning Encara que un script d'alerta no empri missatges predeterminats, les plantilles de missatges per als tipus d'operacions emprats per aquest tipus de suport encara s'han de definir, en cas contrari no s'enviarà cap notificació. ::: ::: noteimportant Com que el processament paral·lel de tipus de suport s'ha implementat des de Zabbix 3.4.0, és important tindre en compte que amb més d'un tipus de suport d'script configurat, aquests scripts es poden processar en paral·lel mitjançant processos d'alerta. El nombre total de processos d'alerta és limitat pel [paràmetre](/manual/appendix/config/zabbix_server) StartAlerters. ::: #### Configuration To configure e-mail as the media type: - Go to *Administration → Media types* - Click on *Create media type* (or click on *E-mail* in the list of pre-defined media types). The **Media type** tab contains general media type attributes:  All mandatory input fields are marked with a red asterisk. The following parameters are specific for the e-mail media type: |Parameter|Description| |--|--------| |*SMTP server*|Set an SMTP server to handle outgoing messages.| |*SMTP server port*|Set the SMTP server port to handle outgoing messages.<br>This option is supported *starting with Zabbix 3.0*.| |*SMTP helo*|Set a correct SMTP helo value, normally a domain name.| |*SMTP 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 e-mail address is supported since Zabbix 2.2 version.<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)| |*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<br>This option is supported *starting with Zabbix 3.0*.| |*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).<br>This option is supported *starting with Zabbix 3.0*.| |*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).<br>This option is supported *starting with Zabbix 3.0*.| |*Authentication*|Select the level of authentication:<br>**None** - no cURL options are set<br>(since 3.4.2) **Username and password** - implies "AUTH=\*" leaving the choice of authentication mechanism to cURL<br>(until 3.4.2) **Normal password** - [CURLOPT\_LOGIN\_OPTIONS](http://curl.haxx.se/libcurl/c/CURLOPT_LOGIN_OPTIONS.html) is set to "AUTH=PLAIN"<br>This option is supported *starting with Zabbix 3.0*.| |*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>This option is supported *starting with Zabbix 3.0*.<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supported as of Zabbix 6.0.30.| |*Password*|Password to use in authentication.<br>This sets the value of [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).<br>This option is supported *starting with Zabbix 3.0*.<br>[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supported as of Zabbix 6.0.30.| |*Message format*|Select message format:<br>**HTML** - send as HTML<br>**Plain text** - send as plain text| ::: noteimportant To enable SMTP authentication options, Zabbix server must be both compiled with the `--with-libcurl` [compilation](/manual/installation/install#configure_the_sources) option (with cURL 7.20.0 or higher) and use the `libcurl-full` packages during runtime. ::: See also [common media type parameters](/manual/config/notifications/media#common_parameters) for details on how to configure default messages and alert processing options. #### Configuració Per configurar el correu electrònic com a tipus de suport: - Aneu a *Administració → Tipus de suport* - Feu clic a *Crea un tipus de suport* (o feu clic a *Correu electrònic* al llistat dels tipus de suport predefinits). La pestanya **Tipus de suport** conté atributs generals de tipus de suport:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els paràmetres següents són específics del tipus de suport de correu electrònic: |Paràmetre|Descripció| |--|---------| |*Servidor SMTP*|Configureu un servidor SMTP per gestionar els missatges de sortida.| |*Port del servidor SMTP*|Configureu el port del servidor SMTP per gestionar els missatges de sortida.<br>Aquesta opció és compatible *des de Zabbix 3.0*.| |*SMTP helo*|Estableix un valor SMTP helo vàlid, normalment un nom de domini.| |*Adreça SMTP*|L'adreça introduïda aquí s'emprarà com a adreça **De** per als missatges enviats.<br>S'ha afegit un nom de remitent per mostrar (com ara "Zabbix\_info" a *Zabbix\_info <zabbix\@.company.com>* a la captura de pantalla anterior) amb adreça de correu electrònic real s'admet des de la versió 2.2 de Zabbix.<br>Hi ha algunes restriccions sobre els noms de visualització als correus electrònics de Zabbix en comparació amb el que permet RFC 5322, tal com es mostra amb exemples:<br>Exemples vàlids:<br>*zabbix\@company.com* (només l'adreça de correu electrònic, no cal emprar claudàtors angulars)<br>*Zabbix\_info <zabbix\@company.com>* (mostra el nom i l'adreça de correu electrònic entre claudàtors quadrats)<br>*∑Ω-monitoring <zabbix\@company.com>* (caràcters UTF-8 al nom de visualització)<br>Exemples no vàlids:<br>*Zabbix HQ zabbix\@company.com* (nom de visualització) present però sense claudàtors angulars al voltant de l'adreça de correu electrònic)<br>*"Zabbix@\<H(comment)Q\>" <zabbix\@company.com>* (tot i que és vàlid segons RFC 5322, els parells citats i comentaris no són compatibles amb els correus electrònics de Zabbix) | |*Seguretat de connexió*|Seleccioneu el nivell de seguretat de la connexió:<br>**Cap** - no feu servir l'opció [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)<br>**STARTTLS** - empra l'opció CURLOPT\_USE\_SSL amb el valor CURLUSESSL\_ALL<br>**SSL/TLS** - empra CURLOPT\_USE\_SSL opcional<br>Aquesta opció és compatible *des de de Zabbix 3.0*.| |*Verifiqueu el peer SSL*|Marqueu la casella per verificar el certificat SSL del servidor SMTP.<br>El valor de la directiva de configuració del servidor "SSLCALocation" s'ha de posar a [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) per a la validació del certificat.<br> Això estableix l'opció cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html). <br>Aquesta opció és compatible *des de Zabbix 3.0*.| |*Verifica l'equip SSL*|Marca la casella per verificar que el camp *Nom comú* o el camp *Nom alternatiu de l'assumpte* del certificat del servidor SMTP coincideix.<br>Això estableix l'opció cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).<br>Aquesta opció és compatible *des de Zabbix 3.0*.| |*Autenticació*|Seleccioneu el nivell d'autenticació:<br>**Cap** - no s'ha establert cap opció cURL<br>(des de 3.4.2) **Nom d'usuari i mot de pas** - implica que "AUTH=\*" deixa el elecció del mecanisme d'autenticació per cURL<br>(fins a 3.4.2) **Mot de pas normal** - [CURLOPT\_LOGIN\_OPTIONS](http://curl.haxx.se/libcurl/c/CURLOPT_LOGIN_OPTIONS.html) és establert a "AUTH=PLAIN"<br>Aquesta opció és compatible *des de Zabbix 3.0*.| |*Nom d'usuari*|Nom d'usuari a emprar per a l'autenticació.<br>Això estableix el valor de [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).<br>Aquesta opció és compatible *des de de Zabbix 3.0*.<br>Les [Macros d'usuari](/manual/appendix/macros/supported_by_location_user#other-locations) s'admeten des de Zabbix 6.0.30.| |*Mot de pas*|Mot de pas a emprar per a l'autenticació.<br>Això estableix el valor de [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html). <br>Aquesta opció és compatible *des de Zabbix 3.0*.<br>Les [Macros d'usuari](/manual/appendix/macros/supported_by_location_user#other-locations) s'admeten des de Zabbix 6.0.30.| |*Format del missatge*|Selecciona el format del missatge:<br>**HTML** - envia com a HTML<br>**Text senzill** - envia com a text sense format| ::: noteimportant Per fer que les opcions d'autenticació SMTP siguin disponibles, el servidor Zabbix s'ha de compilar amb l'opció de [compilació](/manual/installation/install#configure_the_sources) `--with-libcurl` (amb cURL 7.20.0 o superior) i emprar els paquets `libcurl-full` durant el temps d'execució. ::: Veieu també els [paràmetres de tipus de suport comuns](/manual/config/notifications/media#common_parameters) per obtindre més informació sobre com configurar missatges predeterminats i opcions de gestió d'alertes. #### Configuration To configure event correlation rules globally: - Go to *Configuration* → *Event correlation* - Click on *Create correlation* to the right (or on the correlation name to edit an existing rule) - Enter parameters of the correlation rule in the form {width="600"} 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| |*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** - specify the old event tag for matching.<br>**New event tag** - specify the new event tag for matching.<br>**New event host group** - specify the new event host group for matching.<br>**Event tag pair** - specify new event tag and old event tag 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 1](/manual/config/event_correlation/global#examples)).<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. ```{=html} <!-- --> ``` - 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. #### Configuració Per configurar globalment regles de correlació d'esdeveniments: - Aneu a *Configuració* → *Correlació d'esdeveniments* - Feu clic a *Crear una correlació* a la dreta (o al nom de la correlació per modificar una regla existent) - Introduïu els paràmetres de la regla de correlació al formulari {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|--------| |*Name*|Nom únic de la regla de correlació.| |*Type of calculation*|Les opcions següents per calcular les condicions són disponibles:<br>**I** - s'han de complir totes les condicions<br>**O** - prou si es compleix una condició<br> ** I/O** - I amb diferents tipus de condició i O amb el mateix tipus de condició<br>**Expressió personalitzada**: una fórmula de càlcul definida per l'usuari per avaluar les condicions d'acció. Ha d'incloure totes les condicions (representades amb lletres majúscules A, B, C, ...) i pot incloure espais, tabulacions, parèntesis ( ), **i** (distingeix entre majúscules i minúscules), **o** (distingeix entre majúscules i minúscules) , **no** (distingeix entre majúscules i minúscules).| |*Conditions*|Llista de condicions. Veieu a continuació per obtindre més informació sobre com configurar una condició.| |*Description*|Descripció de la regla de correlació.| |*Operations*|Marqueu la casella de l'operació a realitzar quan l'esdeveniment estigui correlacionat. Les operacions següents són disponibles:<br>**Tanca els esdeveniments antics**: tanca els esdeveniments antics quan es produeix un esdeveniment nou. Afegiu sempre una condició basada en l'esdeveniment antic quan empreu l'operació *Tanca esdeveniments antics* o es poden tancar tots els problemes existents.<br>**Tanca l'esdeveniment nou**: tanca l'esdeveniment nou quan es produeixi| |*Enabled*|Si marqueu aquesta casella, s'habilitarà la regla de correlació.| Per configurar els detalls d'una condició nova, feu clic a  al bloc Condicions. S'obrirà una finestra emergent on podeu editar els detalls de la condició.  |Paràmetre|Descripció| |--|---------| |*New condition*|Trieu una condició per correlacionar els esdeveniments.<br>*Tingueu en compte* que si no s'especifica cap condició d'esdeveniment antiga, tots els esdeveniments antics es poden fer coincidir i tancar. De la mateixa manera, si no s'especifica cap condició d'esdeveniment nova, es poden fer coincidir i tancar tots els esdeveniments nous.<br>Les condicions següents estan disponibles:<br>**Nom de l'etiqueta d'esdeveniment antiga**: especifiqueu l'etiqueta d'esdeveniment antiga per fer coincidir.<br >**Nou nom de l'etiqueta d'esdeveniment**: especifiqueu una etiqueta d'esdeveniment nova per fer coincidir.<br>**Equip d'esdeveniment del grup d'esdeveniment nou**: especifiqueu un grup d'equips d'esdeveniment nou per fer coincidir.<br>**Parell d'etiquetes d'esdeveniment**: especifiqueu etiqueta nova d'esdeveniment i etiqueta antiga d'esdeveniment per fer coincidir. En aquest cas, hi haurà una coincidència si els **valors** de les etiquetes dels dos esdeveniments coincideixen. L'etiqueta *names* no ha de coincidir.<br>Aquesta opció és útil per fer coincidir els valors d'execució, que potser no es coneguin en el moment de la configuració (veieu també l'[exemple 1](/manual/config /event_correlation/global#examples)) .< br>**Valor de l'etiqueta d'esdeveniment antic**: especifiqueu el nom i el valor de l'etiqueta d'esdeveniment antiga per a la coincidència, emprant els operadors següents: <br>*igual* - té un valor d'etiqueta d'esdeveniment antic<br>*no és igual* - no té un valor d'etiqueta d'esdeveniment antic<br>*conté* - té la cadena al valor de l'etiqueta d'esdeveniment antic<br>*no conté* - no té una cadena al valor de l'etiqueta d'esdeveniment antic<br>**Nou valor de l'etiqueta d'esdeveniment** - especifiqueu el nom i el valor de l'etiqueta d'esdeveniment nova per a la coincidència, emprant els operadors següents:<br>*igual* - té el valor de l'etiqueta d'esdeveniment nou<br>*no és igual * - no té una etiqueta d'esdeveniment nova valor<br>*conté* - conté una cadena a l'etiqueta d'esdeveniment nova valor<br>*no conté* - no conté una cadena a l'etiqueta d'esdeveniment nova valor| ::: notewarning Com que és possible que hi hagi una configuració incorrecta, on es poden crear etiquetes d'esdeveniments similars per a problemes **no relacionats**, reviseu els casos que es descriuen a continuació. ::: - Les etiquetes i els valors d'etiquetes reals només són visibles quan s'activa un trigger. Si l'expressió regular emprada no és vàlida, es substitueix en silenci per una cadena \*DESCONEGUDA\*. Si es perd l'esdeveniment de problema inicial amb un valor d'etiqueta \*DESCONEGUDA\*, els esdeveniments OK posteriors poden aparèixer amb el mateix valor de l'etiqueta \*DESCONEGUDA\* que poden tancar esdeveniments de problema que no haurien de tancar. ```{=html} <!-- --> ``` - Si un usuari empra la macro {ITEM.VALUE} sense funcions de macro com a valor d'etiqueta, s'aplica el límit de 255 caràcters. Quan els missatges de registre són llargs i els primers 255 caràcters no són específics, això també pot donar lloc a etiquetes d'esdeveniments similars per a problemes no relacionats. #### Configuration To configure, select *Action log* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*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.| #### Configuració Per configurar, trieu *Registre d'accions* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Ordenar les entrades per*|Ordenar les entrades per:<br>**Hora** (decreixent o creixent)<br>**Tipus** (decreixent o creixent)<br>**Estat** (decreixent o creixent) <br>**Destinatari** (descendent o creixent).| |*Mostra les línies*|Defineix el nombre de línies de registre d'accions que es mostraran al giny.| #### Configuration To configure, select *Clock* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/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 for displaying time. To display host time, use the `system.localtime[local]` [item](/manual/config/items/itemtypes/zabbix_agent). This item must exist on the host.<br>This field is available only when *Host time* is selected.| #### Configuració Per configurar, trieu *Rellotge* com a tipus:  A més dels paràmetres [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Tipus d'hora*|Trieu l'hora local, del servidor o de l'equip especificat.<br>L'hora del servidor serà la mateixa que la zona horària establerta globalment o per a l'usuari de Zabbix.| |*Element*|Trieu l'element per al qual voleu veure l'hora. Per veure l'hora de l'equip, empreu l'[element](/manual/config/items/itemtypes/zabbix_agent) `system.localtime[local]`. Aquest element ha d'existir a l'equip.<br>Aquest camp només és disponible quan es tria *Hora de l'equip*.| #### Configuration To configure, select *Data overview* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups. 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.| |*Hosts*|Select hosts. 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.| |*Tags*|Specify tags to limit the number of item data 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| |*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.| #### Configuració Per configurar, trieu *Previsualització de dades* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Grups d'equips*|Seleccioneu els grups d'equips. Aquest camp s'emplena automàticament, de manera que començar a escriure un nom de grup oferirà una llista desplegable de grups coincidents. Desplaceu-vos cap avall per triar. Feu clic a 'x' per desmarcar la selecció.| |*Equips*|Trieu equips. Aquest camp s'emplena automàticament, de manera que començar a escriure un nom d'equip oferirà una llista desplegable d'equips coincidents. Desplaceu-vos cap avall per seleccionar. Feu clic a 'x' per desmarcar la selecció.| |*Etiquetes*|Especifiqueu etiquetes per limitar la quantitat de dades d'elements que es mostren al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms i valors d'etiquetes especificats ​​(distingeix entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br >**No existeix** - exclou els valors especificats noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen les dades introduïdes cadena (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per condició O< br >**O** - suficient si es compleix una condició| |*Mostra els problemes esborrats*|Marqueu la casella per mostrar problemes que, d'altra manera, s'esborrarien (no es mostren) a causa del manteniment de l'equip.| |*Ubicació de l'equip*|Trieu la ubicació de l'equip - esquerra o superior.| #### Configuration To configure, select *Graph* as type: {width="600"} The **Data set** tab allows to add data sets and define their visual representation: | | | | |-|----------|----------------------------------------| |*Data set*|<|Select hosts and items to display on the graph. Alternatively, you may enter host and item patterns. Wildcard patterns may be used (for example, `*` will return results that match zero or more characters). To specify a wildcard pattern, just enter the string manually and press *Enter*. While you are typing, note how all matching hosts are displayed in the dropdown.<br>Up to 50 items may be displayed in the graph.<br>Host pattern and item pattern fields are mandatory.<br>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).| | |*Base color*|Adjust base color, either from the color picker or manually. The base color is used to calculate different colors for each item of the data set. Base color input field is mandatory.| |^|*Draw*|Choose the draw type of the metric. Possible draw types are *Line* (set by default), *Points*, *Staircase* and *Bar*.<br>Note that if there's 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.| |^|*Width*|Set the line width. This option is available when *Line* or *Staircase* draw type is selected.| |^|*Point size*|Set the point size. This option is available when *Points* draw type is selected.| |^|*Transparency*|Set the transparency level.| |^|*Fill*|Set the fill level. 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>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. 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:<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>**none** - display all values (no aggregation)<br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of all values. See also: [Aggregation in graphs](/manual/config/visualization/graphs/aggregate).<br>This option is supported since Zabbix 4.4.| |^|*Aggregation interval*|Specify the interval for aggregating values. 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>This option is supported since Zabbix 4.4.| |^|*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.<br>This option is supported since Zabbix 4.4.| Existing data sets are displayed in a list. You may: -  - click on this button to add a new data set -  - click on the color icon to expand/collapse data set details -  - click on the move icon and drag a data set to a new place in the list #### Configuració Per configurar, trieu *Gràfic* com a tipus: {width="600"} La pestanya **Conjunt de dades** us permet afegir conjunts de dades i definir-ne la representació visual: | | | | |-|-----------|-------------------------------------- ----| |*Conjunt de dades*|<|Seleccioneu equips i elements per veure al gràfic. També podeu introduir plantilles d'equips i d'elements. Es poden emprar patrons de comodins (per exemple, `*` retornarà resultats que coincideixin amb zero o més caràcters). Per especificar un patró de comodí, simplement introduïu la cadena manualment i premeu *Retorn*. Mentre escriviu, observeu com es mostren tots els equips coincidents a la llista desplegable.<br>Es poden veure fins a 50 elements al gràfic.<br>Els camps Patró d'equip i Patró d'elements són obligatoris. <br>El símbol genèric sempre s'interpreta, de manera que no és possible afegir, per exemple, un element anomenat "element\*" individualment, si hi ha altres elements coincidents (p. ex. element2, element3).| | |*Color base*|Ajusta el color base, ja sigui des del selector de colors o manualment. El color base s'empra per calcular diferents colors per a cada element del conjunt de dades. El camp d'entrada del color base és obligatori.| |^|*Traça*|Trieu el tipus de traça mètrica. Els tipus de traçat possibles són *Línia* (per defecte), *Punts*, *Escales* i *Barra*.<br>Tingueu en compte que si només hi ha un punt de dades al gràfic en línia/escala, es dibuixa com a punt independentment del tipus de sorteig. La mida del punt es calcula a partir de l'amplada de la línia, però no pot ser inferior a 3 píxels, encara que l'amplada de la línia sigui menor.| |^|*Amplada*|Defineix l'amplada de la línia. Aquesta opció és disponible quan es tria el tipus de traçat *Línia* o *Escala*.| |^|*Mida del punt*|Defineix la mida del punt. Aquesta opció és disponible quan es tria el tipus de dibuix *Punts*.| |^|*Transparència*|Estableix el nivell de transparència.| |^|*Fill*|Defineix el nivell d'emplenat. Aquesta opció és disponible quan es tria el tipus de traçat *Línia* o *Escala*.| |^|*Dades que manquen*|Trieu aquesta opció per veure les dades que manquen:<br>**Cap** - l'espai es deixa en blanc<br>**Connectat** - dos valors de vora són connectats< br>**Tractat com a 0** - les dades que manquen es mostren com a valors 0<br>No s'aplica als tipus de dibuix *Punts* i *Barra*.| |^|*Eix Y*|Trieu el costat del gràfic on es mostrarà l'eix Y.| |^|*Diferència horària*|Especifiqueu la diferència horària si cal. Podeu emprar [sufixos de temps](/manual/appendix/suffixes#time_suffixes) en aquest camp. Es permeten valors negatius.| |^|*Funció d'agregació*|Especifiqueu la funció d'agregació a emprar:<br>**min** - mostra el valor més petit<br>**max** - mostra el valor més gran<br> **mitjana** - mostrar el valor mitjà<br>**suma** - mostrar la suma de valors<br>**nombre** - mostrar el nombre de valors<br>**primer** - mostrar el primer valor<br>**darrer** - mostra el darrer valor<br>**cap** mostra tots els valors (sense agregació)<br>L'agregació mostra un valor afegit per a l'interval escollit (5 minuts, una hora, un dia), en lloc de tots els valors. Veieu també: [Agregació en gràfics](/manual/config/visualization/graphs/aggregate).<br>Aquesta opció és compatible des de Zabbix 4.4.| |^|*Interval d'agregació*|Especifiqueu l'interval per a l'agregació de valors. Podeu emprar [sufixos de temps](/manual/appendix/suffixes#time_suffixes) en aquest camp. El valor numèric sense sufix es considerarà com a segons.<br>Aquesta opció és compatible des de Zabbix 4.4.| |^|*Agregat*|Especifiqueu si voleu afegir:<br>**Cada element** - cada element del conjunt de dades s'safegiran i es veuran per separat.<br>**Conjunt de dades** - tots els elements del conjunt de dades s'afegiran i es veuran com un valor.<br>Aquesta opció és compatible des de Zabbix 4.4.| Els conjunts de dades existents es mostren en una llista. Podeu: -  - feu clic a aquest botó per afegir un nou conjunt de dades -  - feu clic a la icona de color per ampliar/replegar els detalls del conjunt de dades -  - feu clic a la icona de moure i arrossegueu un conjunt de dades a una nova ubicació de la llista #### Configuration To configure, select *Graph (classic)* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source*|Select graph type:<br>**Graph** - custom graph<br>**Simple graph** - simple graph| |*Graph*|Select the custom graph to display.<br>This option is available if 'Graph' is selected as *Source*.| |*Item*|Select the item to display in a simple graph.<br>This option is available if 'Simple graph' is selected as *Source*.| |*Show legend*|Unmark this checkbox to hide the legend on the graph (marked by default).| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set graph to display different data depending on the selected host.| Information displayed by the classic graph widget can be downloaded as .png image using the [widget menu](/manual/web_interface/frontend_sections/monitoring/dashboard#widget_menu):  A screenshot of the widget will be saved to the Downloads folder. #### Configuració Per configurar, trieu *Gràfic (clàssic)* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Font*|Trieu el tipus de gràfic:<br>**Gràfic** - gràfic personalitzat<br>**Gràfic simple** - gràfic simple| |*Gràfic*|Trieu el gràfic personalitzat que voleu veure.<br>Aquesta opció és disponible si s'ha triat 'Gràfic' com a *Font*.| |*Element*|Trieu l'element que voleu veuer al gràfic senzill.<br>Aquesta opció és disponible si s'ha triat "Gràfic simple" com a *Font*.| |*Mostra la llegenda*|Desmarqueu aquesta casella per amagar la llegenda al gràfic (marcada per defecte).| |*[Element dinàmic](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Configureu el gràfic perquè mostri dades diferents en funció de l'equip triat.| La informació que mostra el giny de gràfic clàssic es pot descarregar com a imatge .png mitjançant el [menú del giny](/manual/web_interface/frontend_sections/monitoring/dashboard#widget_menu):  Es desarà una captura de pantalla del giny a la carpeta Descàrregues. #### Configuration To configure, select *Graph prototype* as widget type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source*|Select source: either a **Graph prototype** or a **Simple graph prototype**.| |*Graph prototype*|Select a graph prototype to display discovered graphs of the graph prototype.<br>This option is available if 'Graph prototype' is selected as Source.| |*Item prototype*|Select an item prototype to display simple graphs based on discovered items of an item prototype.<br>This option is available if 'Simple graph prototype' is selected as Source.| |*Show legend*|Mark this checkbox to show the legend on the graphs (marked by default).| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set graphs to display different data depending on the selected host.| |*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.| While the *Columns* and *Rows* settings 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.  #### Configuració Per configurar, trieu *Prototip de gràfic* com a tipus de giny:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Font*|Trieu la font: un **prototip de gràfic** o un **prototip de gràfic simple**.| |*Prototip de gràfic*|Trieu un prototip de gràfic per mostrar els gràfics descoberts del prototip de gràfic.<br>Aquesta opció és disponible si s'ha triat "rototip de gràfic" com a font.| |*Prototip d'element*|Trieu un prototip d'element per mostrar gràfics senzills basats en els elements descoberts d'un prototip d'element.<br>Aquesta opció és disponible si es tria "Prototip de gràfic simple" com a Font.| |*Veure la llegenda*|Marqueu aquesta casella per mostrar la llegenda als gràfics (marcat per defecte).| |*[Element dinàmic](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Defineix gràfics per mostrar diferents dades en funció de l'equip triat.| |*Columnes*|Introduïu el nombre de columnes de gràfic que voleu veure en un giny de prototip de gràfic.| |*Línies*|Introduïu el nombre de línies de gràfic per veure en un giny de prototip de gràfic.| Tot i que els paràmetres *Columnes* i *Fileres* permeten inserir més d'un gràfic al giny, encara es poden descobrir més gràfics que columnes/fileres al giny. En aquest cas, la paginació és disponible al giny i una capçalera lliscant permet canviar entre pàgines mitjançant les fletxes esquerra i dreta.  #### Configuration To configure, select *Host availability* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host group(s). 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.| |*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).| |*Show hosts in maintenance*|Include hosts that are in maintenance in the statistics.| #### Configuració Per configurar, trieu *Disponibilitat de l'equip* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Grups d'equips*|Trieu els grups d'equips. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups coincidents. Desplaceu-vos cap avall per triar. Feu clic a 'x' per esborrar la selecció.| |*Tipus d'interfície*|Trieu les interfícies de l'equip per a les quals voleu veure les dades de disponibilitat.<br>La disponibilitat de totes les interfícies es mostra de manera predeterminada si no se tria res.| |*Disposició*|Trieu la visualització horitzontal (columnes) o la visualització vertical (files).| |*Mostra equips en manteniment*|Inclou els equips en manteniment a les estadístiques.| #### Configuration To configure, select *Item value* as the widget type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |_**Item**_ |Select the item. | |_**Show**_ |Mark the checkbox to display the respective element (description, value, time, change indicator). Unmark to hide.<br>At least one element must be selected. | |_**Advanced configuration**_ |Mark the checkbox to display [advanced configuration](#advanced-configuration) options. | |_**[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic-widgets)**_ |Mark the checkbox to display a different value depending on the selected host. | #### Configuració Per configurar, trieu *Valor de l'element* com a tipus de giny:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |_**Element**_ |Trieu l'element. | |_**Mostra**_ |Marqueu la casella per veure l'element respectiu (descripció, valor, hora, indicador de canvi). Desmarqueu per amagar.<br>S'ha de triar almenys un element. | |_**Configuració avançada**_ |Marqueu la casella per mostrar les opcions [configuració avançada](#advanced-settings). | |_**[Element dinàmic](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic-widgets)**_ |Marqueu la casella per mostrar un valor diferent en funció de l'equip seleccionat. | #### Configuration To configure, select *Map* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Source type*|Select to display:<br>**Map** - network map;<br>**Map navigation tree** - one of the maps in the selected map navigation tree.| |*Map*|Select the map to display.<br>This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps.<br>This option is available if 'Map' is selected as *Source type*.| |*Filter*|Select the map navigation tree to display the maps of.<br>This option is available if 'Map navigation tree' is selected as *Source type*.| #### Configuració Per configurar, trieu *Mapa* com a tipus:  A més dels paràmetres [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Tipus de font*|Trieu per veure:<br>**Mapa** - mapa de xarxa<br>**Arbre de navegació del mapa** - un dels mapes de l'arbre de navegació de mapes triat.| |*Mapa*|Trieu el mapa que voleu mostrar.<br>Aquesta opció està disponible si s'ha triat 'Mapa' com a *Tipus de font*.<br>Aquesta opció és disponible si s'ha triat 'Mapa' com a *Tipus de font*.| |*Filtre*|Trieu l'arbre de navegació del mapa per mostrar-ho els mapes.<br>Aquesta opció és disponible si s'escull 'Arbre de navegació del mapa' com a *Tipus de font*.| #### Configuration To configure, select *Map navigation tree* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/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.| #### Configuració Per configurar el giny de l'arbre de navegació, trieu *Arbre de navegació del mapa* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Veure els mapes no disponibles*|Marqueu aquesta casella per veure mapes que l'usuari no és autoritzat a llegir.<br>Els mapes no disponibles a l'arbre de navegació es veuran amb una icona grisa.<br >Tingueu en compte que si aquesta casella és marcada, els submapes disponibles es veuen encara que el mapa de nivell principal no sigui disponible. Si no es marca, els submapes disponibles a un mapa principal no disponible no es veuran pas.<br>El recompte de problemes es calcula en funció dels mapes disponibles i dels elements del mapa disponibles.| #### Configuration To configure, select *Plain text* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Items*|Select the items.| |*Items location*|Choose the location of selected items to be displayed in the widget.| |*Show lines*|Set how many latest data lines will be displayed in the widget.| |*Show text as HTML*|Set to display text as HTML.| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set to display different data depending on the selected host.| #### Configuració Per configurar, trieu *Text sense format* com a tipus:  A més dels paràmetres [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Elements*|Trieu elements.| |*Ubicació dels elements*|Trieu la ubicació dels elements triats per veure'ls al giny.| |*Veure les fileres*|Estableix el nombre de darreres fileres de dades que es veuran al giny.| |*Veure el text en format HTML*|Configurar per veure text en format HTML.| |*[Element dinàmic](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Configurat per veure diferents dades en funció de l'equip triat.| #### Configuration To configure, select *Problem hosts* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Enter host groups to display in the widget. 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.| |*Exclude host groups*|Enter host groups to hide from the widget. 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.| |*Hosts*|Enter hosts to display in the widget. 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.| |*Problem*|You can limit the number of problem hosts displayed by the problem name. If you enter a string here, only those hosts with problems whose name contains the entered string will be displayed. 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.| |*Tags*|Specify problem 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| |*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.| |*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.| #### Configuració Per configurar, trieu *Equips amb problemes* com a tipus: {width="600"} A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: ||| |--|---------| |*Grups d'equips*|Introduïu els grups d'equips per veure'ls al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure el nom d'un grup oferirà un menú desplegable de grups coincidents.<br>Especificar un grup d'equip principal selecciona implícitament tots els grups d'equip heretats.<br>Es mostraran les dades de l'equip d'aquests grups d'equip. al giny. Si no s'introdueix cap grup d'equip, es mostraran tots els grups d'equip.| |*Exclou els grups d'equip*|Introduïu els grups d'equip per amagar-los del giny. Aquest camp s'emplena automàticament, de manera que començar a escriure el nom d'un grup oferirà un menú desplegable de grups coincidents.<br>Si especifiqueu un grup d'equip principal, es seleccionaran implícitament tots els grups d'equip heretats.<br>Les dades d'equip d'aquests grups d'equip no es veuran al giny. Per exemple, els equips 001, 002, 003 poden ser al grup A i els equips 002, 003 també al grup B. Si triem *veure* el grup A i *excloure* el grup B al mateix temps, només es veuran les dades de l'equip 001 al tauler.| |*Equips*|Introduïu els equips per veure'ls al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure el nom d'un equip oferirà un menú desplegable d'equips coincidents.<br>Si no s'introdueix cap equip, es veuran tots els equips.| |*Problema*|Podeu limitar el nombre d'equips amb problemes que es mostren pel nom del problema. Si introduïu una cadena aquí, només es mostraran aquells equips amb problemes el nom dels quals conté la cadena introduïda. Les macros no s'amplien.| |*Gravetat*|Marqueu la gravetat dels problemes per filtrar els problemes que voleu veure al gràfic.<br>Si no se'n marca cap, el giny les ensenyarà totes.| |*Etiquetes*|Especifiqueu etiquetes de problemes per limitar el nombre de problemes que es mostren al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden establir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms d'etiquetes especificats i valors (distingeix entre majúscules i minúscules)<br>**Conté** - inclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou l'especificat noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta continguin la cadena introduïda ( coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions que tinguin el mateix nom d'etiqueta s'agruparan per la condició O<br>**O** - prou si es compleix una condició| |*Mostra els problemes esborrats*|Marqueu la casella de selecció per mostrar problemes que d'altra manera s'esborrarien (no es veuen) a causa del manteniment de l'equip.| |*Amaga grups sense problemes*|Marqueu l'opció *Amaga grups sense problemes* per amagar les dades dels grups d'equip sense problemes al giny.| |*Visualització de problemes*|Mostra el recompte de problemes com a:<br>**Tots** - es veurà el recompte complet de problemes<br>**Separat** - el recompte de problemes no reconeguts es veurà separat com a nombre del recompte total de problemes <br>**Només no reconegut** - només es veurà el nombre de problemes no reconeguts.| #### Configuration To configure, select *Problems* as type:  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. | | | |--|--------| |*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*|Enter host groups to display problems of in the widget. 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.| |*Exclude host groups*|Enter host groups to hide problems of from the widget. 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.| |*Hosts*|Enter hosts to display problems of in the widget. 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.| |*Problem*|You can limit the number of problems displayed by their name. If you enter a string here, only those problems whose name contains the entered string will be displayed. 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.| |*Tags*|Specify problem 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>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 in *Monitoring → Problems*<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; 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 (for example: `Services,Applications,Application`). Tag names only should be used, no values. 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](/manual/web_interface/frontend_sections/monitoring/problems#operational_data_of_problems):<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| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*Show unacknowledged only*|Mark the checkbox to display unacknowledged problems only.| |*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).| |*Show timeline*|Mark the checkbox to display a visual timeline.| |*Show lines*|Specify the number of problem lines to display.| #### Configuració Per configurar, trieu *Problemes* com a tipus:  Podeu limitar el nombre de problemes que es mostren al giny de diferents maneres: per estat del problema, nom del problema, gravetat, grup d'equips, equip, etiqueta d'esdeveniment, estat de reconeixement, etc. ||| |--|---------| |*Mostra*|Filtra per estat del problema:<br>**Problemes recents** - es mostren els problemes no resolts i resolts recentment (per defecte)<br>**Problemes** - es mostren els problemes no resolts<br>**Historial** - es mostra l'historial de tots els esdeveniments | |*Grups d'equips*|Introduïu els grups d'equips per als quals voleu veure problemes al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups que coincideixen.<br>Si especifiqueu un grup d'equips principal, es triaran implícitament tots els grups d'equips heretats.<br> Els problemes per a aquests grups d'equips es veuran al giny. Si no s'introdueix cap grup d'equips, es veuran problemes per a tots els grups d'equips.| |*Grups d'equips exclosos*|Introduïu els grups d'equips per als quals voleu amagar els problemes del giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups que coincideixen.<br>Si especifiqueu un grup d'equips principal, es triaran implícitament tots els grups d'equips heretats.<br> Els problemes d'aquests grups d'equips no es veuran al giny. Per exemple, els equips 001, 002, 003 poden pertànyer al grup A i els equips 002, 003 també al grup B. Si optem per *veure* el grup A i *excloure* el grup B al mateix temps, només es veuran els problemes de l'equip 001 al giny.| |*Equips*|Introduïu els equips per als quals veure problemes al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure el nom d'un equip oferirà una llista desplegable d'equips coincidents.<br>Si no s'introdueix cap equip, es veuran problemes per a tots els equips.| |*Problema*|Podeu limitar el nombre de problemes que es veuen pel seu nom. Si introduïu una cadena aquí, només es veuran els problemes el nom dels quals contingui la cadena introduïda. Les macros no s'amplien.| |*Gravetat*|Marqueu la gravetat dels problemes per filtrar els problemes que voleu veure al gràfic.<br>Si no se'n marca cap, el giny les ensenyarà totes.| |*Etiquetes*|Especifiqueu etiquetes de problemes per limitar el nombre de problemes que es veuen al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms i valors d'etiquetes especificats ​​(distingeix entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou els valors especificats noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen les dades introduïdes cadena (concordança de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per la condició O <br>**O** - suficient si es compleix una condició<br>Quan es filtren, les etiquetes especificades aquí es veuran primer amb el problema, tret que es substitueixin per la llista *prioritat de visualització de l'etiqueta* (veieu més avall).| |*Veure les etiquetes*|Trieu el nombre d'etiquetes que es veuen:<br>**Cap** - cap columna *Etiquetes* a *Monitoratge → Problemes*<br>**1** - La columna *Etiquetes* conté una etiqueta<br>**2** - La columna *Etiquetes* conté dues etiquetes<br>**3** - La columna *Etiquetes* conté tres etiquetes<br>Per veure totes les etiquetes del problema, passeu el ratolí per sobre icona de tres punts. | |*Nom de l'etiqueta*|Trieu com es veu el nom de l'etiqueta:<br>**Tot** - els noms i els valors de les etiquetes es veuen sencers<br>**Drecera** - les etiquetes de noms d'etiquetes s'escurcen a 3 símbols; els valors de les etiquetes es mostren sencers<br>**Cap** - només es mostren els valors de les etiquetes; sense nom | |*Prioritat de visualització de l'etiqueta*|Introduïu la prioritat de visualització de l'etiqueta per a un problema, com a llista d'etiquetes separades per comes (per exemple: `Serveis,Aplicacions,Aplicació`). Només s'han d'emprar noms d'etiquetes, sense valors. Les etiquetes d'aquesta llista sempre es veuran primer, substituint l'ordre natural per l'ordre alfabètic.| |*Ensenya les dades operatives*|Trieu com veure [dades operacionals](/manual/web_interface/frontend_sections/monitoring/problems#operational_data_of_problems):<br>**Cap** - no es mostren dades operatives<br>**Per separat** - les dades operatives es mostren a una columna separada<br>**Amb el nom del problema** - afegiu dades operatives al nom del problema, emprant parèntesis per a les dades operatives| |*Ensenya els problemes esborrats*|Marqueu la casella per veure problemes que, d'altra manera, es suprimirien (no es veurien) a causa del manteniment de l'equip.| |*Ensenya només els problemes no reconeguts*|Marqueu la casella per veure només els problemes no reconeguts.| |*Ordenar les entrades per*|Ordenar les entrades per:<br>**Temps** (decreixent o ascendent)<br>**Gravetat** (decreixent o ascendent)<br>**Nom del problema** (dereixent o ascendent)<br>**Equip** (descendent o ascendent).| |*Ensenya la línia de temps*|Marqueu la casella per veure una línia de temps visual.| |*Ensenya les línies*|Especifiqueu el nombre de línies del problema a veure.| #### Configuration To configure, select *Problems by severity* as type: {width="600"} In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Enter host groups to display in the widget. 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.| |*Exclude host groups*|Enter host groups to hide from the widget. 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.| |*Hosts*|Enter hosts to display in the widget. 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.| |*Problem*|You can limit the number of problem hosts displayed by the problem name. If you enter a string here, only those hosts with problems whose name contains the entered string will be displayed. 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.| |*Tags*|Specify problem 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| |*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.| |*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 field is available for editing if 'Totals' is selected as the *Show* option.| |*Show operational data*|Display operational data (see description of *[Operational data](/manual/web_interface/frontend_sections/monitoring/problems#operational-data-of-problems)* in *Monitoring* > *Problems*) 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.| |*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.| |*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.| #### Configuració Per configurar, Trieu *Problemes per gravetat* com a tipus: {width="600"} A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: ||| |--|---------| |*Grups d'equips*|Introduïu els grups d'equips que voleu veure al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups que coincideixen.<br>En especificar un grup d'equips principal, es tria implícitament tots els grups d'equips heretats.<br> Es veuran les dades de l'equip d'aquests grups d'equips. al giny. Si no s'introdueix cap grup d'equips, es veuran tots els grups d'equips.| |*Exclou els grups d'equips*|Introduïu els grups d'equips que voleu amagar del giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups que coincideixen.<br>Especificar un grup d'equips principal triarà implícitament tots els grups d'equips heretats.<br> Les dades d'equip d'aquests grups d'equips no es veuran al giny. Per exemple, els equips 001, 002, 003 poden pertànyer al grup A i els equips 002, 003 també al grup B. Si optem per *veure* el grup A i *excloure* el grup B al mateix temps, només es veuran les dades de l'equip 001 al tauler.| |*Equips*|Introduïu els equips que voleu veure al giny. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom d'equip oferirà una llista desplegable d'equips coincidents.<br>Si no s'introdueix cap equip, es veuran tots els equips.| |*Problema*|Podeu limitar el nombre d'equips amb problemes que es veuen pel nom del problema. Si introduïu una cadena aquí, només es veuran els equips amb problemes els noms dels quals continguin la cadena introduïda. Les macros no s'amplien.| |*Gravetat*|Marqueu la gravetat dels problemes per filtrar els problemes que voleu veure al gràfic.<br>Si no se'n marca cap, el giny les ensenyarà totes.| |*Etiquetes*|Especifiqueu etiquetes de problemes per limitar el nombre de problemes que es veuen al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms i valors d'etiquetes especificats ​​(distingeix entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou els valors especificats noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen les dades introduïdes cadena (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>** I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per condició O<br>**O** - suficient si es compleix una condició| |*Visualització*|Trieu l'opció de visualització:<br>**Grups d'equips** - veure problemes per grup d'equips<br>**Totals** - veure un total de problemes per a tots els grups d'equips triats en blocs de color corresponents a la gravetat del problema.| |*Disposició*|Trieu l'opció de disseny:<br>**Horizontal** - els blocs de colors dels totals es veuran horitzontalment<br>**Vertical** - els blocs de colors dels totals es veuran verticalment<br>Aquest camp és disponible per editar si es tria 'Totals' com a opció *Visualització*.| |*Veure les dades operatives*|Marqueu la casella per veure les dades operatives (veieu la descripció de *[Dades operatives](/manual/web_interface/frontend_sections/monitoring/problems#overview)* a *Monitoratge* → *Problemes*) com a:<br>**Cap** - no es veurà pas la informació operacional<br>**Per separat** - la informacio operacional es veurà com una línia separada<br>**Amb el nom del problema** - la informació operacional es veurà també amb el nom del problema.| |*Veure els problemes suprimits*|Marqueu la casella per veure problemes que, d'altra manera, es suprimirien (no es mostren) a causa del manteniment de l'equip.| |*Amaga grups sense problemes*|Marqueu l'opció *Amaga grups sense problemes* per amagar les dades del grup equip sense problemes al giny.| |*Visualització del problema*|Veure el nombre de problemes com a:<br>**Tots** - es veurà el nombre total de problemes<br>**Separats** - el nombre de problemes no reconeguts es veurà separat com un recompte del total nombre de problemes <br>**Només no reconeguts** - només es veuran el nombre de problemes no reconeguts.| |*Veure la línia de temps*|Marqueu la casella per veure una línia de temps visual.| #### Configuration To configure, select *SLA report* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/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/config/visualization/graphs/simple#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/config/visualization/graphs/simple#time-period-selector) are supported: `now`, `now/d`, `now/w-1w` etc; supported date modifiers: d, w, M, y.| #### Configuració Per configurar, trieu *Informe SLA* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*SLA*|Trieu el SLA per a l'informe.| |*Departament*|Trieu el departament per a l'informe.| |*Veure els períodes*|Defineix el nombre de períodes que es veuran al giny (20 per defecte, 100 com a màxim).| |*Des de*|Trieu la data d'inici de l'informe.<br>S'admeten [dates relatives](/manual/config/visualization/graphs/simple#time-period-selector): `now`, `now/d`, `now/w-1w` etc; modificadors de data admesos: d, w, M, y.| |*Per*|Trieu la data de finalització de l'informe.<br>S'admeten [dates relatives](/manual/config/visualization/graphs/simple#time-period-selector): `ara`, `ara/d`, `ara/w-1w`, etc.; modificadors de data admesos: 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).| #### Configuració Per configurar, trieu *Informació del sistema* com a tipus:  A més dels paràmetres de configuració que són comuns són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) a tots els ginys, podeu establir les següents opcions espefíciques: ||| |--|--------| |*Veure*|Trieu què veure:<br>**Estat del sistema** - veure un resum de la informació clau del sistema i servidor de Zabbix;<br>**Nodes d'alta disponibilitat** - veure l'estat dels nodes d'alta disponibilitat (si el [clúster d'alta disponibilitat](/manual/concepts/server/ha) és activat).| #### Configuration To configure, select *Top hosts* as type: {width="600"} #### Configuració Per configurar, trieu *Equips top* com a tipus: {width="600"} #### Configuration To configure, select *Trigger overview* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/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 the host group(s). This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups.| |*Hosts*|Select hosts. 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.| |*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.<br>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.| #### Configuració Per configurar, trieu *Visió general del trigger* com a tipus:  A més de la configuració [comuna](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-settings) per a tots els ginys, podeu definir les opcions específiques següents: | | | |--|---------| |*Mostra*|Filtra per estat del problema:<br>**Problemes recents** - *(per defecte)* mostren els triggers que han estat recentment o encara estan en un estat PROBLEMA (resolts i no resolts);<br>**Problemes** - mostra els triggers que es troben en un estat PROBLEMA (no resolt);<br>**Tots** - mostra tots els triggers.| |*Grups d'equips*|Trieu els grups d'equips. Aquest camp s'emplena automàticament, de manera que començar a escriure el nom d'un grup oferirà una llista desplegable de grups coincidents.| |*Equips*|Trieu equips. Aquest camp s'emplena automàticament, de manera que començar a escriure un nom d'equip oferirà una llista desplegable d'equips coincidents. Desplaceu-vos cap avall per triar. Feu clic a 'x' per netejar la selecció.| |*Etiquetes*|Especifiqueu etiquetes per filtrar els triggers que es mostren al giny.<br>És possible incloure i excloure etiquetes i valors d'etiquetes específics.<br>Es poden establir diverses condicions. La concordança del nom de l'etiqueta sempre distingeix entre majúscules i minúscules.<br><br>**Nota:** si *Mostra* s'estableix a "Tots", es veuran tots els triggers encara que s'especifiquen etiquetes. Tanmateix, mentre que els canvis recents de l'estat del trigger (que es mostren com a blocs intermitents) s'actualitzaran per a tots els triggers, els detalls de l'estat del trigger (color de la gravetat del problema i si es reconeix el problema) només s'actualitzaran per als triggers que coincideixin amb les etiquetes especificades.<br> <br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats;<br> **Igual** - inclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules);<br> **Conté** - inclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència secundaria) -cadena, no distingeix entre majúscules i minúscules);<br>**No existeix** - exclou els noms d'etiquetes especificats; <br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules);<br>**No conté** - exclou els noms d'etiquetes especificats on els valors d'etiquetes contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules).<br> <br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per condició *O* ;<br>**O** - suficient si es compleix una condició.| |*Mostra els problemes esborrats*|Marqueu la casella per mostrar problemes que, d'altra manera, es suprimirien (no es mostren) a causa del manteniment de l'equip.| |*Ubicació de l'equip*|Trieu la ubicació de l'equip - esquerra o superior.| #### Configuration To configure, select *URL* as type:  In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*URL*|Enter the URL to display.<br>External URLs must start with `http://` or `https://`.<br>Since Zabbix 4.4.8, internal URLs support relative paths (for example, `zabbix.php?action=report.status`).<br>{HOST.\*} macros are supported.| |*[Dynamic item](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Set to display different URL content depending on the selected host.<br>This can work if {HOST.\*} macros are used in the URL.| ::: noteimportant Browsers might not load an HTTP page included in the widget if Zabbix frontend is accessed over HTTPS. ::: #### Configuració Per configurar, trieu *URL* com a tipus:  A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*URL*|Introduïu l'URL que voleu veure.<br>Les URLs externes han de començar amb `http://` o `https://`.<br>S'admeten camins relatius des de Zabbix 4.4.8.<br>S'admeten macros {HOST.\*}.| |*[Element dinàmic](/manual/web_interface/frontend_sections/monitoring/dashboard#dynamic_widgets)*|Configureu-lo per veure contingut d'URL diferent en funció de l'equip triat.<br>Això pot funcionar si s'empren macros {HOST.\*} a l'URL.| ::: note important És possible que els navegadors no carreguin una pàgina HTTP inclosa al giny si la interfície Zabbix és accessible mitjançant HTTPS. ::: #### Configuration To configure SMS as the media type: - Go to *Administration → 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.| 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. ### Configuració Per configurar SMS com a tipus de suport: - Aneu a *Administració → Tipus de suport* - Feu clic a *Crea un tipus de suport* (o feu clic a *SMS* a la llista de tipus de suport predefinits). Els paràmetres següents són específics del tipus de suport SMS: | Paràmetre | Descripció | | --- | --- | | *Mòdem GSM* | Establiu el nom del dispositiu sèrie del mòdem GSM. | Veieu els [paràmetres de tipus de suport comuns](/manual/config/notifications/media#common_parameters) per obtindre informació sobre com configurar els missatges predeterminats i les opcions de gestió d'alertes. Tingueu en compte que el processament paral·lel de l'enviament de notificacions per SMS no és possible. #### 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/config/visualization/graphs/simple#time_period_selector) available and the possibility to switch from the "normal" line graph to a stacked one (and back). {width="600"} #### Configuració Per crear un gràfic ad hoc, feu el següent: - Aneu a *Monitoratge* → *Dades més recents* - Empreu el filtre per mostrar els elements que voleu - Marqueu les caselles dels elements que voleu representar gràficament - Feu clic als botons *Mostrar gràfic apilat* o *Mostrar gràfic* {width="600"} El vostre gràfic es crea a l'instant: {width="600"} Tingueu en compte que per evitar que es vegin massa línies al gràfic, només es veu el valor mitjà de cada element (no es mostren les línies de valor mínim/màxim). Els triggers i la informació del trigger no es mostren al gràfic. A la finestra de gràfic creada, es posa a disposició un [selector de període de temps](/manual/config/visualization/graphs/simple#time_period_selector) i la possibilitat de canviar del gràfic de línies "normal" a un gràfic apilat (i viceversa)). {width="600"} ### Configuration To create a new service action, go to the *Service actions* subsection of the *Services* menu, then click on *Create action* in the upper right corner. Service actions are configured in the same way as other types of actions in Zabbix. For more details, see configuring [actions](/manual/config/notifications/action#configuring-an-action). The key differences are: - User access to service actions depends on access rights to services granted by user's [role](/manual/web_interface/frontend_sections/administration/user_roles). - Service actions support different set of [conditions](#conditions). ### Configuració Per crear una acció de servei nova, aneu a la subsecció *Accions de servei* del menú *Serveis* i feu clic a *Crear una acció* a l'extrem superior dret. Les accions de servei es configuren de la mateixa manera que altres tipus d'acció a Zabbix. Per obtindre més detalls, veieu la configuració d'[accions] (/manual/config/notifications/action#configuring-an-action). Les principals diferències són: - L'accés de l'usuari a les accions de servei depèn dels drets d'accés al servei concedits pel [rol](/manual/web_interface/frontend_sections/administration/user_roles) de l'usuari. - Les accions de servei admeten diferents conjunts de [condicions](#conditions). ### 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. ### Configuració Per crear un SLA nou, feu clic al botó *Crea SLA*. La pestanya **SLA** s'empra per especificar paràmetres generals de SLA. {width=600} |Paràmetre|Descripció| |--|---------| |*Nom*|Introduïu el nom del SLA. | |*SLO*|Introduïu l'objectiu de nivell de servei (SLO) en percentatge. | |*Període d'informe*|Seleccioneu el període d'informe SLI utilitzat per calcular les dades SLI a l'[informe SLA](/manual/web_interface/frontend_sections/services/sla_report):<br>**Diàriament** - cada dia, de 00:00:00 a 23:59:59.<br>**Setmanalment** - cada setmana, de diumenge a les 00:00:00 fins a dissabte a les 23:59:59.<br>**Mensualment** - cada mes, des del primer dia a les 00:00:00 fins al darrer dia a les 23:59:59.<br>**Trimestralment** - cada trimestre natural: T1 (gener-març), T2 (abril-juny), T3 (juliol-setembre), T4 (octubre-desembre).<br>**Anualment** - cada any natural, de l'1 de gener a les 00:00:00 fins al 31 de desembre 23:59:59.| |*Zona horària*|Trieu la zona horària del SLA. | |*Programació*|Trieu la programació SLA: 24x7 o personalitzada. | |*Data efectiva*|Trieu la data d'inici per al càlcul de SLA. | |*Etiquetes de servei*|Afegiu etiquetes de servei per identificar els serveis als quals s'ha d'aplicar aquest SLA. <br> **Nom** - nom de l'etiqueta de servei, ha de ser una coincidència exacta, distingeix entre majúscules i minúscules. <br> **Operació** - trieu *Igual* si el valor de l'etiqueta ha de coincidir exactament (distingeix entre majúscules i minúscules) o *Conté* si una part del valor de l'etiqueta ha de coincidir (no distingeix entre majúscules i minúscules). <br> **Valor** - valor de l'etiqueta de servei que cal cercar en funció de l'operació seleccionada.<br> L'SLA s'aplica a un servei si almenys una etiqueta de servei coincideix. | |*Descripció*|Afegiu una descripció per al SLA. | |*Activat*|Marqueu la casella per habilitar el càlcul de SLA. | La pestanya **Temps d'inactivitat exclosos** us permet especificar els temps d'inactivitat que s'exclouen del càlcul de SLA. {width=600} Feu clic a *Afegir* per configurar el temps d'inactivitat exclòs i, tot seguit, introduïu el nom del període, la data d'inici i la durada. #### Configuration To define a dependency, open the Dependencies tab in the trigger [configuration form](trigger#configuration). Click on *Add* in the 'Dependencies' block and select one or more triggers that the trigger will depend on.  Click *Update*. Now the trigger has the indication of its dependency in the list.  #### Configuració Per definir una dependència, obriu la pestanya Dependències a un trigger [formulari de configuració](trigger#configuració). Feu clic a *Afegir* al bloc "Dependències" i trieu un o més triggers dels quals dependrà el nostre trigger.  Feu clic a *Actualitzar*. Ara el trigger té una indicació de la seva dependència a la llista.  #### Configuration To define user macros, go to the corresponding location in the frontend: - for global macros, visit *Administration → General → Macros* - for host and template level macros, open host or template properties and look for the *Macros* tab ::: notetip If a user macro is used in items or triggers in a template, it is suggested to add that macro to the template even if it is defined on a global level. That way, if the macro type is *text* exporting the template to XML and importing it in another system will still allow it to work as expected. Values of secret macros are not [exported](/manual/xml_export_import). ::: 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** - the value is masked with asterisks, which could be useful to protect sensitive information such as passwords or shared keys.<br>**Vault secret** - the value contains a reference path (as 'path:key', for example “secret/zabbix:password”) to a [Vault secret](/manual/config/secrets)<br><br>*Note* that while the value of a secret macro is hidden from sight, the value can be revealed through the use in items. For example, in an external script an 'echo' statement referencing a secret macro may be used to reveal the macro value to the frontend because Zabbix server has access to the real macro value.<br><br>To select the value type click on the button at the end of the value input field:<br> icon indicates a text macro;<br> icon indicates a secret text macro. Upon hovering, the value field transforms into a  button, which allows to enter a new value of the macro (to exit without saving a new value, click the backwards arrow ().<br> icon indicates a secret Vault macro.<br><br>Maximum length of a user macro value is 2048 characters (255 characters in versions before 5.2.0).| |*Description*|Text field used to provide more information about this macro.| ::: noteclassic URLs that contain a secret macro will not work as the macro in them will be resolved as "\*\*\*\*\*\*". ::: ::: noteimportant In trigger expressions user macros will resolve 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. ::: #### Configuració Per definir macros d'usuari, aneu a la ubicació corresponent a la interfície: - per a macros globals, visiteu *Administració → General → Macros* - Per a les macros de nivell d'equip i plantilla, obriu les propietats de l'equip o de la plantilla i cerqueu la pestanya *Macros* ::: notetip Si s'empra una macro d'usuari en elements o triggers d'una plantilla, es recomana afegir aquesta macro a la plantilla encara que sigui definida a nivell global. Així, si el tipus de macro és *text*, exportar el model a XML i importar-lo a un altre sistema farà que funcioni com s'esperava. Els valors de macro secretes no s'exporten (/manual/xml_export_import). ::: Una macro d'usuari té els atributs següents: {width="600"} |Paràmetre|Descripció| |--|---------| |*Macro*|Nom de la macro. El nom ha d'anar entre claus i començar amb un signe de dòlar.<br>Exemple: {$FRONTEND\_URL}. Els caràcters següents es permeten als noms de macro: **A-Z** (només en majúscules), **0-9**, **\_**, **.**| |*Valor*|Valor de macro. S'admeten tres tipus de valors:<br>**Text** (predeterminat) - valor de text sense format<br>**Text secret** - el valor és emmascarat per asteriscs, que poden ésser útils per protegir la informació sensible, com ara mots de pas o claus compartides.<br>**Vault secret** - el valor conté un camí de referència (com ara 'path:key', per exemple, "secret/zabbix: password") a un [Vault Secret](/manual/config/secrets )<br><br>*Tingueu en compte* que encara que el valor d'una macro secreta sigui amagat, el valor es pot trobar mitjançant l'ús en objectes. Per exemple, en un script extern, es pot emprar una instrucció "eco" que fa referència a una macro secreta per revelar el valor de la macro a la interfície perquè el servidor Zabbix té accés al valor de la macro real.<br> <br>Per triar el tipus de valor, feu clic al botó al final del camp d'entrada de valor:<br>la icona  indica una macro de text;<br>la icona  indica una macro de text secreta. En passar el cursor, el camp de valor es converteix en un botó , que us permet introduir un valor nou de macro (per sortir sense desar un valor nou, feu clic a la fletxa enrere () .<br>La icona  indica una macro Vault Secret.<br>< br>L'allargada màxima d'un valor de la macro d'usuari és de 2048 caràcters (255 caràcters en versions anteriors a la 5.2.0).| |*Descripció*|Camp de text emprat per proporcionar més informació sobre aquesta macro.| :::noteclassic Els URL que continguin una macro secreta no funcionaran perquè la macro que contenen es resoldrà en "\*\*\*\*\*\*". ::: ::: noteimportant A les expressions triggers, les macros d'usuari es resoldran si fan referència a un paràmetre o una constant. NO es resoldran si es refereixen a un equip, clau d'element, funció, operador o una altra expressió trigger. Les macros secretes no es poden emprar en expressions de triggers. ::: #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration file parameters are properly configured. #### Configuració Per assegurar una bona comunicació entre tots els elements implicats, assegureu-vos que els paràmetres de l'arxiu de configuració del servidor i de l'arxiu de configuració frontal són ben configurats. #### Configuration To ensure proper communication between all elements involved make sure server configuration file and frontend configuration parameters are properly configured. #### Configuració Per assegurar una bona comunicació entre tots els elements implicats, assegureu-vos que l'arxiu de configuració del servidor i els paràmetres de configuració del frontal són configurats correctament. #### Configuration To execute a passive check immediately: - click on *Execute now* in an existing item (or discovery rule) configuration form:  - click on *Execute now* for selected items/rules in the list of items/discovery rules:  In the latter case several items/rules can be selected and "executed now" at once. #### Configuració Per executar una verificació passiva immediatament: - feu clic a *Executar ara* al formulari de configuració d'elements (o regla de descoberta) existent:  - feu clic a *Executar ara* per els elements/regles triats a la llista d'elements/regles de descoberta:  En aquest darrer cas, els múltiples elements/regles es poden triar i "executades ara" alhora. #### 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%2F6.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: - Go to *Administration → Media types* - Click on *Create media type* The **Media type** tab contains various attributes specific for this media type:  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>All [macros](/manual/appendix/macros/supported_by_location) that are supported in problem notifications are supported in the parameters.<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 block that appears when clicking in the parameter field (or on the view/edit button 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 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 instead of global ones is recommended to make sure that each script operates on its own data and that there are no collisions between simultaneous calls (see [known issues](/manual/installation/known_issues#use-case-with-global-variables-shared-across-webhook-calls)).<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/frontend_sections/monitoring/problems#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) 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) 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) 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. ::: #### Configuració Per començar a emprar una integració de webhook: 1. Localitzeu el fitxer .yaml necessari al directori `templates/media` de la versió de Zabbix baixada o descarregueu-lo des del [repositori git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix. 2. [Importeu](/manual/xml_export_import/media#importing) el fitxer a la instal·lació de Zabbix. El webhook apareixerà a la llista de tipus de suports. 3. Configureu el webhook segons les instruccions del fitxer *Readme.md* (podeu fer clic al nom d'un webhook a dalt per accedir ràpidament a *Readme.md*). Per crear un webhook personalitzat des de zero: - Aneu a *Administració → Tipus de suport* - Feu clic a *Crea un tipus de suport* La pestanya **Tipus de suport** conté diversos atributs específics d'aquest tipus de suport:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els paràmetres següents són específics del tipus de suport de webhook: |Paràmetre|Descripció| |--|---------| |*Paràmetres*|Especifiqueu les variables del webhook com a parelles d'atribut i valor.<br>Per als webhooks preconfigurats, una llista de paràmetres varia segons el servei. Comproveu el fitxer *Readme.md* del webhook per a la descripció del paràmetre.<br>Per als webhooks nous, s'inclouen diverses variables habituals de manera predeterminada (URL:<buit>, HTTPProxy:<buit>, Per a:{ALERT.SENDTO}, Assumpte: {ALERT.SUBJECT}, Missatge:{ALERT.MESSAGE}), no dubteu a conservar-los o esborrar-los.<br>Totes les [macros](/manual/appendix/macros/supported_by_location) admeses a les notificacions de problemes s'admeten al paràmetres.<br>Si especifiqueu un proxy HTTP, el camp suporta la mateixa funcionalitat que al camp de configuració de l'element [proxy HTTP](/manual/config/items/itemtypes/http#configuration). La cadena de proxy pot tindre el prefix `[scheme]://` per especificar quin tipus de proxy s'empra (p. ex. https, socks4, socks5; veieu la [documentació](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html)).| |*Script*|Introduïu el codi JavaScript al bloc que apareix en fer clic al camp de paràmetres (o al botó de visualització/edició al costat). Aquest codi realitzarà l'operació webhook.<br>L'script és un codi de funció que accepta paràmetres - valor. Els valors s'han de convertir en objectes JSON mitjançant el mètode JSON.parse(), per exemple: `var params = JSON.parse(value);`.<br><br>El codi té accés a tots els paràmetres, pot fer peticions HTTP, GET, POST, PUT i DELETE i té control sobre les capçaleres HTTP i el cos de la petició.<br>L'script ha de contindre un operador de retorn, en cas contrari, no serà vàlid. Pot tornar l'estat correcte juntament amb un llistat opcional d'etiquetes i valors d'etiquetes (veieu l'opció *Etiquetes de procés*) o una cadena d'error.<br><br>Tingueu en compte que l'script només s'executa després de crear una alerta. Si l'script és configurat per tornar i processar etiquetes, aquestes etiquetes no es resoldran a les macros {EVENT.TAGS} i {EVENT.RECOVERY.TAGS} al missatge de problema inicial i als missatges de recuperació perquè l'script no ha tingut temps d'executar-se encara.<br>*Nota*: Es recomana emprar variables locals enlloc de globals, per assegurar que cada script opera la seva pròpia informació i que no hi ha conflictes entre crides simultànies (veieu els [problemes coneguts](/manual/installation/known_issues#use-case-with-global-variables-shared-across-webhook-calls)).<br><br>Veieu també: [Directrius de desenvolupament de Webhook](https://www.zabbix.com/documentation/guidelines/en/webhooks), [Exemples d'scripts de Webhook](/manual/config/notifications/media /webhook/webhook_examples), [Objectes JavaScript addicionals](/manual/config/items/preprocessing/javascript/javascript_objects).<br>| |*Temps d'espera*|Temps d'espera d'execució de JavaScript (1-60 s, 30 s per defecte).<br>S'admeten sufixos de temps, p. 30 anys, 1m.| |*Processar les etiquetes*|Marqueu la casella de selecció per processar els valors de propietat JSON retornats com a etiquetes. Aquestes etiquetes s'afegeixen a les etiquetes d'esdeveniment de problemes ja existents (si n'hi han) a Zabbix.<br>Si un webhook empra etiquetes (la casella de selecció Processar etiquetes és marcada), el webhook sempre hauria de retornar un objecte JSON que contingui almenys un objecte buit per a tags:`var resultat = {etiquetes: {}};`.<br>Exemples d'etiquetes que es poden retornar: *Jira ID: PROD-1234*, *Responsable: John Smith*, *Processat:<sense valor>* , etc.| |*Inclou l'entrada del menú d'esdeveniments*|Marqueu la casella de selecció per incloure una entrada al [menú d'esdeveniment](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) que enllaça amb el bitllet extern creat.<br>Si és marcat, el webhook no s'ha d'emprar per enviar notificacions a diferents usuaris (considereu crear un [usuari dedicat](/manual/config/notifications/media/webhook#user_media)) o a diverses accions d'alerta [relacionades amb un sol esdeveniment problema](/manual /config/notifications/media/webhook#configuring-alert-actions).| |*Nom de l'entrada del menú*|Especifiqueu el nom de l'entrada del menú.<br>La macro {EVENT.TAGS.<nom de l'etiqueta>} és compatible.<br>Aquest camp només és obligatori si és seleccionat *Inclou l'entrada del menú d'esdeveniments*.| |*URL de l'entrada del menú*|Especifiqueu l'URL subjacent de l'entrada del menú.<br>S'admet la macro {EVENT.TAGS.<nom de l'etiqueta>}.<br>Aquest camp només és obligatori si és seleccionat *Inclou l'entrada del menú d'esdeveniments* .| Veieu [paràmetres de tipus de mitjans comuns](/manual/config/notifications/media#common_parameters) per obtindre informació sobre com configurar els missatges predeterminats i les opcions de processat d'alertes. ::: notewarning Fins i tot si un webhook no empra missatges predeterminats, les plantilles de missatges per als tipus d'operacions emprats per aquest webhook encara s'han de definir. ::: #### Configuration Two steps are required to close a problem manually. #### Configuració Calen dues etapes per resoldre un problema manualment. #### Configuration We assume that TimescaleDB extension has been already installed on the database server (see installation instructions in [TimescaleDB documentation](https://docs.tigerdata.com/self-hosted/latest/install/)). TimescaleDB extension must also be enabled for the specific DB by executing: 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.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)): cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: noteimportant Please ignore warning messages informing that the best practices are not followed while running `timescaledb.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 and trend data may take a lot of time. Zabbix server and frontend must be down for the period of migration. The `timescaledb.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. For PostgreSQL version 10.2 or higher and TimescaleDB version 1.5 or higher, the `timescaledb.sql` script sets two additional parameters: - Enable compression - Compress records older than 7 days #### Configuració Assumim que l'extensió TimescaleDB ja s'ha instal·lat al servidor de base de dades (veieu les instruccions d'instal·lació a la [documentació de Timescale](https://www.tigerdata.com/self-hosted/latest/install/)). L'extensió de TimescaleDB s'ha d'activar per la DB específica, executant: echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix Per executar aquesta comanda cal privilegis d'administrador de la base de dades. ::: noteclassic Si empreu un esquema de base de dades diferent a 'public', heu d'afegir una clàusula SCHEMA a la comanda de més amunt. Per exemple:<br> `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` ::: Després, executar l'script `postgresql/timescaledb.sql` ubicat a database/postgresql. Per instal·lacions noves, l'script ha de córrer després de que la base de dades PostgreSQL s'hagi creat amb l'esquema inicial (veieu [creació de base de dades](/manual/appendix/install/db_scripts)): cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: noteimportant Ignoreu els missatges d'avís informatn que les millors pràctiques no s'han seguit quan executeu l'script `timescaledb.sql` a la versió 2.9.0 o superior de TimescaleDB. A banda d'aquest avís, la configuració s'executarà correctament. ::: La migració de l'historial i informació de tendències existents pot dur molt de temps. El servidor Zabbix i el frontal s'aturaran durant el període de migració. L'script `timescaledb.sql` estableix els següents paràmetres de neteja: - Sobreescriure l'element del període històric - Sobreescriure l'element del període de tendències Per emprar neteja particionada per l'històric i les tendències, ambdós paràmetres s'han d'activar. També és possible activar la sobreescriptura individualment només per històric o tendències. Per la versió 10.2 o superior de PostgreSQL i la versió 1.5 o superior de TimescaleDB, l'script `timescaledb.sql` estableix dos paràmetres més: - Permetre compressió - Comprimir els registres anteriors a 7 dies ##### Configure database for Zabbix proxy Edit Zabbix proxy configuration file (``/etc/zabbix/zabbix_proxy.conf``): DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBName for Zabbix proxy use a separate database from Zabbix server. In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. Refer to the [respective section](/manual/installation/install_from_packages/rhel#selinux_configuration) for RHEL for instructions. ##### Configurar la base de dades per al proxy Zabbix Modifiqueu l'arxiu de configuració del proxy Zabbix (``/etc/zabbix/zabbix_proxy.conf``): DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> A DBName per al proxy Zabbix, empreu una base de dades independent del servidor Zabbix. A DBPassword, utilitzeu el mot de pas de la base de dades Zabbix per a MySQL; mot de pas d'usuari de PosgreSQL per a PosgreSQL. Empreu `DBHost=` amb PostgreSQL. És possible que vulgueu mantindre el `DBHost=localhost` per defecte (o una adreça IP), però això obligaria a PostgreSQL a emprar un sòcol de xarxa per connectar-se a Zabbix. Consulteu la [secció rellevant](/manual/installation/install_from_packages/rhel#selinux_configuration) per obtindre instruccions per a RHEL. ##### Configure database for Zabbix proxy Edit Zabbix proxy configuration file (``/etc/zabbix/zabbix_proxy.conf``): DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBName for Zabbix proxy use a separate database from Zabbix server. In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. See [SELinux configuration](/manual/installation/install_from_packages/rhel#selinux_configuration) for instructions. ##### Configurar la base de dades per al proxy Zabbix Modifiqueu l'arxiu de configuració del proxy Zabbix (``/etc/zabbix/zabbix_proxy.conf``): DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> A DBName per al proxy Zabbix, empreu una base de dades independent del servidor Zabbix. A DBPassword, utilitzeu el mot de pas de la base de dades Zabbix per a MySQL; mot de pas d'usuari de PosgreSQL per a PosgreSQL. Empreu `DBHost=` amb PostgreSQL. És possible que vulgueu mantindre el `DBHost=localhost` per defecte (o una adreça IP), però això obligaria a PostgreSQL a emprar un sòcol de xarxa per connectar-se a Zabbix. Veieu la [configuració d'SELinux ](/manual/installation/install_from_packages/rhel#selinux_configuration) per obtindre les instruccions. #### Configure database for Zabbix server/proxy Edit Zabbix server configuration file (``/etc/zabbix/zabbix_server.conf``) and, if required, Zabbix proxy configuration file (``/etc/zabbix/zabbix_proxy.conf``) for their respective databases. For example: DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL. Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. #### Configurar la base de dades per al servidor/proxy Zabbix Editeu l'arxiu de configuració de servidor Zabbix (``/etc/zabbix/zabbix_server.conf``) i, si escau, l'arxiu de configuració del proxy Zabbix (``/etc/zabbix/zabbix_proxy.conf``) per les seves bases de dades respectives. Per exemple: DBHost=localhost DBName=zabbix DBUser=zabbix DBPassword=<password> A DBPassword, empreu el mot de pas de la base de dades Zabbix per MySQL; mot de pas d'usuari PostgreSQL per PostgreSQL. Empreu `DBHost=` amb PostgreSQL. Voldreu conservar el paràmetre per defecte `DBHost=localhost` (o una adreça IP), però això obligarà que PostgreSQL empri un socket de xarxa per connectar-se a Zabbix. #### Configure DB connection Enter details for connecting to the database. Zabbix database must already be created. {width="550"} 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 HashiCorp Vault option is selected for storing credentials, additional fields are available for specifying the Vault API endpoint, secret path and authentication token: {width="550"} #### Configuració de la connexió de la base de dades Introduïu els detalls de connexió de la base de dades. La base de dades Zabbix ja s'hauria de crear. {width="550"} Si l'opció *Xifrat TLS de la base de dades* és marcada, apareixeran camps addicionals per a [configurar la connexió TLS](/manual/appendix/install/db_encrypt) a la base de dades (només MySQL o PostgreSQL). Si se selecciona l'opció HashiCorp Vault per emmagatzemar les credencials, hi ha camps addicionals disponibles per especificar el punt final de l'API Vault, el camí secret i el testimoni d'autenticació: {width="550"} ###### 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":{...}} ###### Petició de configuració Una petició per executar la funció *Configure* de la interfície *Configurator*. | | | |---|---| |direction|agent → plugin| |response|n/a| Paràmetres específics de les peticions *Configure*: |Nom|Tipus|Comentaris| |---------|--------|----------| |global_options|JSON object|Objecte JSON que conté les opcions de configuració globals de l'agent.| |private_options|JSON object (optional)|Objecte JSON que conté les opcions de configuració del plug-in privat, si es proporciona.| *Exemple:* {"id":6,"type":8,"global_options":{...},"private_options":{...}} #### Configuring a *Clock* widget Configure a *Clock* widget that displays Zabbix server time. Request: ```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": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "time_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Rellotge* Configura un giny *Rellotge* que ensenya l'hora del servidor Zabbix. Petició: ```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": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 0, "name": "time_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids", "value": 10084 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Visió general de dades* Configura un giny *Visió general de dades* que ensenya dades de l'equip "10084" i només per als elements per als quals l'etiqueta amb el nom "component" conté el valor "cpu". A més, ensenya les dades amb els equips situats a la part superior. Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 3, "name": "hostids", "value": 10084 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "cpu" }, { "type": 0, "name": "style", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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 can use the default configuration file `C:\zabbix_agentd.conf` or 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 Zabbix source archive as `conf/zabbix_agentd.win.conf`. See the [configuration file](/manual/appendix/config/zabbix_agentd_win) options for details on configuring Zabbix Windows agent. #### Configuració de l'agent Les dues generacions d'agents Zabbix s'executen com a servei de Windows. Per l'agent Zabbix 2, canvieu *agentd* per *agent2* a les instruccions de sota. Podeu executar una sola instància de l'agent Zabbix o més d'una en un equip Microsoft Windows. Una sola instància pot emprar l'arxiu de configuració per defecte `C:\zabbix_agentd.conf` o un arxiu de configuració especificat a la línia de comandes. En cas d'instàncies múltiples, cadascuna de les instàncies de l'agent ha de tindre el seu propi fitxer de configuració (una de les instàncies sí que pot emprar l'arxiu de configuració per defecte). Un exemple d'arxiu de configuració (`conf/zabbix_agentd.win.conf`) es pot trobar a l'arxiu font de Zabbix. Veieu les opcions de l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) per tindre més detalls de la configuració de l'agent Windows de Zabbix. #### 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", or 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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 22 }, { "type": 2, "name": "groupids", "value": 2 }, { "type": 1, "name": "default_view", "value": "40.6892494,-74.0466891,10" }, { "type": 0, "name": "evaltype", "value": 2 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "node" }, { "type": 1, "name": "tags.tag.1", "value": "location" }, { "type": 0, "name": "tags.operator.1", "value": 1 }, { "type": 1, "name": "tags.value.1", "value": "New York" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Mapa geogràfic* Configureu un giny *Mapa geogràfic* que mostri els equips dels grups d'equips "2" i "22" segons la configuració de l'etiqueta següent: L'etiqueta amb el nom "component" conté el valor "node", o l'etiqueta amb el nom "ubicació" és igual al valor "Nova York". A més, configureu la vista inicial del mapa a les coordenades "40.6892494" (latitud), "-74.0466891" (longitud) amb el nivell de zoom "10". Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 22 }, { "type": 2, "name": "groupids", "value": 2 }, { "type": 1, "name": "default_view", "value": "40.6892494,-74.0466891,10" }, { "type": 0, "name": "evaltype", "value": 2 }, { "type": 1, "name": "tags.tag.0", "value": "component" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "node" }, { "type": 1, "name": "tags.tag.1", "value": "location" }, { "type": 0, "name": "tags.operator.1", "value": 1 }, { "type": 1, "name": "tags.value.1", "value": "New York" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a global script  ::: 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, from the [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) or from the [event menu](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) respectively.<br>Setting the scope to 'Action operation' makes the script available for all users with access to *Configuration* → *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 an action operation, as action operations are executed automatically.<br>To find out which 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 the script type:<br>**Webhook**, **Script**, **SSH**, **Telnet** or **[IPMI](/manual/config/notifications/action/operation/remote_command#ipmi_remote_commands)** command.| | |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 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 block that appears when clicking in the parameter field (or on the view/edit button 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 server (proxy)** - the script will be executed by Zabbix server or proxy (if enabled by [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy)) - depending on whether the host is monitored by server or proxy<br>**Zabbix server** - the script will be executed by Zabbix server only| |^|*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 port.| |^|*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 port.| |^|*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).<br>It is **not recommended** to use discovered groups in this field. When discovered groups will be undiscovered and deleted, the script scope will be reset to *All*.| |*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*.| |*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.<br>This option is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Confirmation text*|<|Enter a 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>{HOST.\*} and {USER.\*} macros are supported. Custom [user macros](/manual/config/macros/user_macros) are supported.<br>*Note:* the macros will not be expanded when testing the confirmation message.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| #### Configuració d'un script global  ::: noteclassic Es recomana utilitzar [funcions de macro](/manual/config/macros/macro_functions) en lloc de macros simples en scripts globals per millorar la seguretat, ja que les macros no s'escapen automàticament. ::: Attributs de l'script: |Paràmetre|<|Descripció| |-|----------|----------------------------------------| |*Nom*|<|Nom únic de l'script.<br>Ex. `Busqueu el sistema de fitxers /tmp`| |*Àmbit*|<|Àmbit de l'script: operació d'acció, acció manual de l'equip o acció manual d'esdeveniments. Aquesta configuració determina on es pot emprar l'script: a les comandes remotes d'operacions d'acció, des del [menú equips](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) o des del [menú d'esdeveniments](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) respectivament.<br>Establir l'abast a "Acció d'operació" fa que l'script sigui disponible per a tots els usuaris amb accés a *Configuració* → *Accions*.<br>Si realment s'empra un script en un acció, el seu abast no es pot canviar fora de l'"Acció d'operació".<br>**Compatibilitat amb macros**<br>L'abast afecta el rang de macros disponibles. Per exemple, les macros relacionades amb l'usuari ({USER.\*}) s'admeten als scripts per permetre que es transmeti informació sobre l'usuari que va iniciar l'script. Tanmateix, no s'admeten si l'abast de l'script és una operació d'acció, ja que les operacions d'acció es fan automàticament.<br>Per esbrinar quines macros s'admeten, cerqueu "Notificacions i comandes basades en triggers/comandes basades en triggers", "Scripts d'acció manual de l'equip" i "Scripts d'acció manual d'esdeveniments" a la taula de [macros compatibles](/manual/appendix/ macros/supported_by_location). Tingueu en compte que si una macro pot resoldre un valor amb espais (per exemple, nom d'equip), cal citar quan sigui necessari.| |*Camí del menú*|<|Camí del menú desitjat a l'script. Per exemple, `Default` o `Default/`, mostrarà l'script al directori respectiu. Els menús es poden niuar, p. `Menú principal/Submenú1/Submenú2`. En accedir als scripts mitjançant el menú d'equip/esdeveniment a les seccions de monitoratge, s'organitzaran segons els directoris donats.<br>Aquest camp només es veu si s'ha triat "Acció manual de l'equip" o "Acció manual de l'esdeveniment" com a *Extensió*. | |*Tipus*|<|Feu clic al botó corresponent per seleccionar el tipus d'script:<br>**Webhook**, **Script**, **SSH**, **Telnet** o **[IPMI] (/manual/config/notifications/action/operation/remote_command#ipmi_remote_commands)**.| | |Tipus d'script: Webhook|<| |^|*Configuració*|Especifiqueu les variables de webhook com a parelles d'atribut-valor.<br>Veieu també: [Configuració de mitjans Webhook](/manual/config/notifications/media/webhook).<br>Macros i [usuari personalitzat]( Les macros /manual/config/macros/user_macros) són compatibles amb els valors dels paràmetres. La compatibilitat amb les macros depèn de l'abast de l'script (veieu *Ambit* més amunt).| |^|*Script*|Introduïu el codi JavaScript al bloc que apareix quan feu clic al camp de paràmetres (o al botó de visualització/edició al costat).<br>El suport de macro depèn de l'abast de l'script (veieu *Extensió* a dalt).<br>Veieu també: [Configuració de mitjans Webhook](/manual/config/notifications/media/webhook), [Objectes Javascript addicionals](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Temps d'espera*|Temps d'espera d'execució de JavaScript (1-60 s, 30 s per defecte).<br>S'admeten sufixos de temps, p. 30 anys, 1m.| | |Tipus de script: Script|<| |^|*Executar*|Feu clic al botó corresponent per executar l'script de l'intèrpret de comandes a:<br>**agent Zabbix** - l'agent Zabbix executarà l'script (si l'element system.run és [permès](/manual/config/items/restrict_checks)) a l'equip<br>**Servidor Zabbix (proxy)** - l'script s'executarà pel servidor o proxy Zabbix (si és activat per [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy)) - depenent de si l'equip és monitorat per un servidor o un proxy<br>**servidor Zabbix** - l'script només l'executarà el servidor Zabbix| |^|*Comandes*|Introduïu el camí complet de les comandes que s'han d'executar a l'script.<br>El suport de macro depèn de l'abast de l'script (veieu *Àmbit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| | |Tipus d'script: SSH|<| |^|*Mètode d'autenticació*|Trieu el mètode d'autenticació: mot de pas o clau pública.| |^|*Nom d'usuari*|Introdueix el nom d'usuari.| |^|*Mot de pas*|Introduïu el mot de pas.<br>Aquest camp és disponible si s'ha triat "Mot de pas" com a mètode d'autenticació.| |^|*Fitxer de clau pública*|Introduïu la ruta al fitxer de clau pública.<br>Aquest camp és disponible si es tria "Clau pública" com a mètode d'autenticació.| |^|*Fitxer de clau privada*|Introduïu la ruta al fitxer de clau privada.<br>Aquest camp és disponible si es tria "Clau pública" com a mètode d'autenticació.| |^|*Clau de pas*|Introduïu la frase de pas.<br>Aquest camp és disponible si s'ha triat "Clau pública" com a mètode d'autenticació.| |^|*Port*|Introduïu el port.| |^|*Comandes*|Introduïu les comandes.<br>El suport de macro depèn de l'abast de l'script (veieu *Àmbit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| | |Tipus d'script: Telnet|<| |^|*Nom d'usuari*|Introduïu el nom d'usuari.| |^|*Mot de pas*|Introduïu el mot de pas.| |^|*Port*|Introduïu el port.| |^|*Comandes*|Introduïu les comandes.<br>El suport de macro depèn de l'abast de l'script (veieu *Àmbit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| | |Tipus d'script: IPMI|<| |^|*Comandes*|Introduïu les comandes IPMI.<br>La compatibilitat amb macros depèn de l'abast de l'script (veieu *Ambit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| |*Descripció*|<|Introduïu una descripció per a l'script.| |*Grup d'equips*|<|Trieu el grup d'equips per al qual serà disponible l'script (o *Tot* per a tots els grups d'equips).<br>**No es recomana** emprar els grups trobats en aquest camp. Quan els grups trobats es deixin de trobar i s'esborrin, l'abast de l'script es definirà a *Tot*.| |*Grup d'usuaris*|<|Trieu el grup d'usuaris per al qual serà disponible l'script (o *Tot* per a tots els grups d'usuaris).<br>Aquest camp només apareix si "Acció manual de l'equip" o "Acció manual d'esdeveniment" és triat com a *Àmbit*.| |*Permisos d'equip necessaris*|<|Trieu el nivell de permís per al grup d'equip: *Lectura* o *Escriptura*. Només els usuaris amb el nivell de permís necessari tindran accés per executar l'script.<br>Aquest camp només es mostra si s'ha triat "Acció manual de l'equip" o "Acció manual d'esdeveniment" com a *Àmbit *.| |*Activa la confirmació*|<|Marqueu la casella per mostrar un missatge de confirmació abans d'executar l'script. Aquesta funció pot ser especialment útil amb operacions potencialment perilloses (com un script de reinici) o aquelles que poden trigar molt de temps.<br>Aquesta opció només apareix si s'ha triat com a *Àmbit* "Acció manual de l'equip" o "Acció manual de l'equip".| |*Text de confirmació*|<|Introduïu un text de confirmació personalitzat per a la finestra emergent de confirmació activada amb la casella de selecció de dalt (per exemple, *El sistema remot es reiniciarà. N'esteu segur?*). Per veure com serà el text, feu clic a *Confirmació de la prova* al costat del camp.<br>S'admeten les macros {HOST.\*} i {USER.\*}. Les [macros d'usuari](/manual/config/macros/user_macros) personalitzades s'admeten.<br>*Nota:* les macros no s'ampliaran en provar el missatge de confirmació.<br>Aquest camp només es mostra si "Acció manual de l'equip" o L'"Acció d'esdeveniment manual" són triades com a *Àmbit*.| #### Configuring a *Graph (classic)* widget Configure a *Graph (classic)* widget that displays a simple graph for the item "42269". Request: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 1 }, { "type": 4, "name": "itemid", "value": 42269 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny de *Gràfic (clàssic)* Configurar un giny de *Gràfic (clàssic)* que mostri un gràfic senzill per a l'element "42269". Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 1 }, { "type": 4, "name": "itemid", "value": 42269 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 16, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 3 }, { "type": 5, "name": "itemid", "value": 42316 }, { "type": 0, "name": "columns", "value": 3 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Prototipus de gràfics* Configurar un giny *Prototipus de gràfics* que mostri una graella de 3 gràfics (3 columnes, 1 fila) creats a partir d'un prototip d'element (ID: "42316") mitjançant una descoberta de baix nivell. Petició: ```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": 16, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 3 }, { "type": 5, "name": "itemid", "value": 42316 }, { "type": 0, "name": "columns", "value": 3 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Graph* widget Configure a *Graph* widget in the following way: - 4 data sets for a total of 9 items on 1 host. - Each data set consists of a line that has a custom color, width, transparency, and fill. - Data set 4 has a configured aggregation. - 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 Data set 4. - Graph legend displays configured items in 2 rows. Request: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "ds.hosts.0.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.0.0", "value": "Zabbix server: Utilization of poller data collector processes, in %" }, { "type": 1, "name": "ds.color.0", "value": "FF0000" }, { "type": 0, "name": "ds.width.0", "value": 3 }, { "type": 0, "name": "ds.transparency.0", "value": 3 }, { "type": 0, "name": "ds.fill.0", "value": 1 }, { "type": 1, "name": "ds.hosts.1.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.1.0", "value": "Zabbix server: Utilization of trapper data collector processes, in %" }, { "type": 1, "name": "ds.color.1", "value": "BF00FF" }, { "type": 0, "name": "ds.width.1", "value": 3 }, { "type": 0, "name": "ds.transparency.1", "value": 3 }, { "type": 0, "name": "ds.fill.1", "value": 1 }, { "type": 1, "name": "ds.hosts.2.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.2.0", "value": "Zabbix server: Utilization of history syncer internal processes, in %" }, { "type": 1, "name": "ds.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.width.2", "value": 3 }, { "type": 0, "name": "ds.transparency.2", "value": 3 }, { "type": 0, "name": "ds.fill.2", "value": 1 }, { "type": 1, "name": "ds.hosts.3.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.3.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.color.3", "value": "000000" }, { "type": 0, "name": "ds.transparency.3", "value": 0 }, { "type": 0, "name": "ds.fill.3", "value": 0 }, { "type": 0, "name": "ds.axisy.3", "value": 1 }, { "type": 0, "name": "ds.aggregate_function.3", "value": 3 }, { "type": 1, "name": "ds.aggregate_interval.3", "value": "1m" }, { "type": 0, "name": "ds.aggregate_grouping.3", "value": 1 }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_from", "value": "now-3h" }, { "type": 0, "name": "legend_lines", "value": 2 }, { "type": 0, "name": "show_problems", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Gràfic* Configureu un giny *Gràfic* de la manera següent: - 4 conjunts de dades per a un total de 9 elements d'1 equip. - Cada conjunt de dades consta d'una línia que té un color, amplada, transparència i farciment personalitzats. - El conjunt de dades 4 té un afegit configurat. - Les dades del gràfic es mostren durant un període de temps de les darreres 3 hores. - Els problemes del gràfic només es mostren per als elements configurats. - El gràfic té dos eixos Y dels quals l'eix Y dret només mostra valors per al conjunt de dades 4. - La llegenda del gràfic mostra els elements configurats en 2 files. Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "ds.hosts.0.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.0.0", "value": "Zabbix server: Utilization of poller data collector processes, in %" }, { "type": 1, "name": "ds.color.0", "value": "FF0000" }, { "type": 0, "name": "ds.width.0", "value": 3 }, { "type": 0, "name": "ds.transparency.0", "value": 3 }, { "type": 0, "name": "ds.fill.0", "value": 1 }, { "type": 1, "name": "ds.hosts.1.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.1.0", "value": "Zabbix server: Utilization of trapper data collector processes, in %" }, { "type": 1, "name": "ds.color.1", "value": "BF00FF" }, { "type": 0, "name": "ds.width.1", "value": 3 }, { "type": 0, "name": "ds.transparency.1", "value": 3 }, { "type": 0, "name": "ds.fill.1", "value": 1 }, { "type": 1, "name": "ds.hosts.2.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.2.0", "value": "Zabbix server: Utilization of history syncer internal processes, in %" }, { "type": 1, "name": "ds.color.2", "value": "0040FF" }, { "type": 0, "name": "ds.width.2", "value": 3 }, { "type": 0, "name": "ds.transparency.2", "value": 3 }, { "type": 0, "name": "ds.fill.2", "value": 1 }, { "type": 1, "name": "ds.hosts.3.0", "value": "Zabbix server" }, { "type": 1, "name": "ds.items.3.0", "value": "*: Number of processed *values per second" }, { "type": 1, "name": "ds.color.3", "value": "000000" }, { "type": 0, "name": "ds.transparency.3", "value": 0 }, { "type": 0, "name": "ds.fill.3", "value": 0 }, { "type": 0, "name": "ds.axisy.3", "value": 1 }, { "type": 0, "name": "ds.aggregate_function.3", "value": 3 }, { "type": 1, "name": "ds.aggregate_interval.3", "value": "1m" }, { "type": 0, "name": "ds.aggregate_grouping.3", "value": 1 }, { "type": 0, "name": "graph_time", "value": 1 }, { "type": 1, "name": "time_from", "value": "now-3h" }, { "type": 0, "name": "legend_lines", "value": 2 }, { "type": 0, "name": "show_problems", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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. #### Configuració de les accions d'alertes Les accions determinen quines notificacions s'han d'enviar mitjançant el webhook. Les passes per a [configurar accions](/manual/config/notifications/action) que involucren webhooks són les mateixes que per a tots els altres tipus de suport amb aquestes excepcions: - Si un webhook empra etiquetes per emmagatzemar el bitllet\\ID del missatge i per fer un seguiment de les operacions d'actualització\\resolució, aquest webhook no s'hauria d'emprar a diverses accions d'alerta per a un únic esdeveniment problema. Si {EVENT.TAGS.<nom>} ja existeix i s'actualitza al webhook, el seu valor resultant no serà definit. En aquest cas, s'ha d'emprar un nom d'etiqueta nova al webhook per emmagatzemar els valors actualitzats. Això s'aplica als webhooks Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad i Zendesk proporcionats per Zabbix i la majoria dels webhooks que empren l'opció *Inclou l'entrada del menú*. Es permet emprar el webhook en diverses operacions si aquestes operacions o passes d'escalat pertanyen a la mateixa acció. També és acceptable emprar aquest webhook en diferents accions si les accions no s'apliquen al mateix esdeveniment problemàtic a causa de diferents condicions de filtre. - Quan empreu un webhook en accions per a [esdeveniments interns](/manual/config/events/sources#internal-events): a la configuració de l'operació d'acció, marqueu la casella *Missatge personalitzat* i configureu el missatge personalitzat, en cas contrari, no hi haurà cap notificació quan s'enviï. #### 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: ```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": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 2 }, { "type": 1, "name": "filter_widget_reference", "value": "ABCDE" } ] }, { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configurar un giny de *Mapa* enllaçat Configurar un giny *Mapa* que sigui enllaçat a un giny [*Arbre de navegació de mapa*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget). Petició: ```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": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "source_type", "value": 2 }, { "type": 1, "name": "filter_widget_reference", "value": "ABCDE" } ] }, { "type": "navtree", "name": "Map navigation tree", "x": 0, "y": 0, "width": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Arbre de navegació de mapes* Configureu un giny *Arbre de navegació del mapa* que mostri l'arbre de navegació del mapa següent: - Element A - Element A1 - Element A2 - Element B - Element B1 (conté el mapa enllaçat "1" que es pot mostrar en un [*Giny de mapa* enllaçat](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget)) - Element B2 - Element C Petició: ```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": 6, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "navtree.name.1", "value": "Element A" }, { "type": 1, "name": "navtree.name.2", "value": "Element B" }, { "type": 1, "name": "navtree.name.3", "value": "Element C" }, { "type": 1, "name": "navtree.name.4", "value": "Element A1" }, { "type": 1, "name": "navtree.name.5", "value": "Element A2" }, { "type": 1, "name": "navtree.name.6", "value": "Element B1" }, { "type": 1, "name": "navtree.name.7", "value": "Element B2" }, { "type": 0, "name": "navtree.parent.4", "value": 1 }, { "type": 0, "name": "navtree.parent.5", "value": 1 }, { "type": 0, "name": "navtree.parent.6", "value": 2 }, { "type": 0, "name": "navtree.parent.7", "value": 2 }, { "type": 0, "name": "navtree.order.1", "value": 1 }, { "type": 0, "name": "navtree.order.2", "value": 2 }, { "type": 0, "name": "navtree.order.3", "value": 3 }, { "type": 0, "name": "navtree.order.4", "value": 1 }, { "type": 0, "name": "navtree.order.5", "value": 2 }, { "type": 0, "name": "navtree.order.6", "value": 1 }, { "type": 0, "name": "navtree.order.7", "value": 2 }, { "type": 8, "name": "navtree.sysmapid.6", "value": 1 }, { "type": 1, "name": "reference", "value": "ABCDE" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a *Map* widget Configure a *Map* widget that displays the map "1". Request: ```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": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 8, "name": "sysmapid", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Mapa* Configureu un giny *Mapa* que ensenyi el mapa "1". Petició: ```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": 18, "height": 5, "view_mode": 0, "fields": [ { "type": 8, "name": "sysmapid", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an action To configure an action, do the following: - Go to *Configuration* -> *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 *Note* that service actions can be configured in the [service action](/manual/web_interface/frontend_sections/services/service_actions) section. 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.| #### Configurar una acció Per configurar una acció, feu el següent: - Aneu a *Configuració* -> *Accions* i trieu el tipus d'acció requerit al submenú (podeu canviar a un altre tipus més endavant, emprant el menú desplegable del títol) - Feu clic a *Crea una acció* - Anomeneu l'acció - Trieu les [condicions](/manual/config/notifications/action/conditions) per a les quals es realitzen les operacions - Trieu les [operacions](/manual/config/notifications/action/operation) a fer *Tingueu en compte* que les accions de servei es poden configurar a la secció [accions de serveis](/manual/web_interface/frontend_sections/services/service_actions). Atributs generals de l'acció:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic de l'acció.| |*Tipus de càlcul*|Trieu l'[opció](/manual/config/notifications/action/conditions#type_of_calculation) d'avaluació per a les condicions d'acció (amb més d'una condició):<br>**I** - totes les condicions s'han de complir<br>**O** - n'hi ha prou si es compleix una condició<br>**I/O** - combinació de totes dugues: AND amb diferents tipus de condició i OR amb el mateix tipus de condició<br>**Expressió personalitzada** - una fórmula de càlcul definida per l'usuari per avaluar les condicions d'acció.| |*Condicions*|Llistat de condicions d'acció.<br>Feu clic a *Afegir* per afegir una nova [condició](/manual/config/notifications/action/conditions).| |*Activat*|Marqueu la casella per habilitar l'acció. En cas contrari, es desactivarà.| #### 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 script: ./startup.sh Likewise, once you no longer need Java gateway, run the shutdown script to stop it: ./shutdown.sh Note that unlike server or proxy, Java gateway is lightweight and does not need a database. #### Configuració i execució de la passarel·la Java Per defecte, la passarel·la de Java escolta el port 10052. Si teniu previst executar la passarel·la de Java en un port diferent, podeu especificar-ho a l'script settings.sh. Consulteu la descripció del [fitxer de configuració de la passarel·la Java](/en/manual/appendix/config/zabbix_java) per saber com especificar aquesta i altres opcions. ::: notewarning El port 10052 no és pas [registrat a IANA] (http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). ::: Un cop familiaritzat amb aquesta configuració, podeu iniciar la passarel·la de Java executant l'script d'inici: ./startup.sh De la mateixa manera, quan ja no us calgui la passarel·la Java, executeu l'script d'aturada per tancar-la: ./apagat.sh Tingueu en compte que, a diferència del servidor o el proxy, Java Gateway és lleuger i no requereix d'una base de dades. #### 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: # service zabbix-java-gateway restart 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 #### Configuració i execució de la passarel·la Java Els paràmetres de configuració de la passarel·la Java Zabbix es poden personalitzar a l'arxiu: /etc/zabbix/zabbix_java_gateway.conf Per tindre més detalls, veieu els [paràmetres](/manual/appendix/config/zabbix_java) de configuració de la passarel·la Java Zabbix. Per engegar la passarel·la Java Zabbix: # service zabbix-java-gateway restart Per engegar automàticament la passarel·la Java Zabbix quan s'engegui el sistema operatiu: RHEL 7 and later: # systemctl enable zabbix-java-gateway Versions anteriors de RHEL 7: # chkconfig --level 12345 zabbix-java-gateway on #### 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 #### Configuració i execució de la passarel·la Java Els paràmetres de configuració de la passarel·la Java Zabbix es poden personalitzar a l'arxiu: /etc/zabbix/zabbix_java_gateway.conf Per tindre més detalls, veieu els [paràmetres](/manual/appendix/config/zabbix_java) de configuració de la passarel·la Java Zabbix. Per engegar la passarel·la Java Zabbix: systemctl restart zabbix-java-gateway Per engegar automàticament la passarel·la Java Zabbix quan s'engegui el sistema operatiu: RHEL 7 and later: systemctl enable zabbix-java-gateway Versions anteriors de RHEL 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 #### Configuració i execució de la passarel·la Java Els paràmetres de configuració de la passarel·la Java Zabbix es poden personalitzar a l'arxiu: /etc/zabbix/zabbix_java_gateway.conf Per tindre més detalls, veieu els [paràmetres](/manual/appendix/config/zabbix_java) de configuració de la passarel·la Java Zabbix. Per engegar la passarel·la Java Zabbix : systemctl zabbix-java-gateway Per engegar automàticament la passarel·la Java Zabbix quan s'engegui el sistema operatiu: systemctl enable zabbix-java-gateway #### 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. Request: ```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": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid", "value": 42266 }, { "type": 0, "name": "show", "value": 1 }, { "type": 0, "name": "show", "value": 2 }, { "type": 0, "name": "show", "value": 3 }, { "type": 0, "name": "adv_conf", "value": 1 }, { "type": 1, "name": "bg_color", "value": "D1C4E9" }, { "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" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Valor d'element* Configureu un giny *Valor de l'element* que mostri el valor de l'element "42266" (disponibilitat de l'agent Zabbix). A més, afineu visualment el giny amb múltiples opcions avançades. Petició: ```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": 4, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemid", "value": 42266 }, { "type": 0, "name": "show", "value": 1 }, { "type": 0, "name": "show", "value": 2 }, { "type": 0, "name": "show", "value": 3 }, { "type": 0, "name": "adv_conf", "value": 1 }, { "type": 1, "name": "bg_color", "value": "D1C4E9" }, { "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" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.| |*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 (e-mail, 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 (e-mail, 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 (e-mail, 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 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 popup window will open where you can edit the operation step details. #### Configurar una operació Per configurar una operació, aneu a la pestanya *Operacions* a la configuració [acció] (/manual/config/notifications/action). {width="600"} Atributs generals de funcionament: |Paràmetre|Descripció| |--|------------| |*Durada de la passa de l'operació per defecte*|Durada de la passa de l'operació per defecte (de 60 segons a 1 setmana).<br>Per exemple, una durada de la passa d'1 hora significa que si es realitza una operació, passarà una hora abans de la passa següent.< br>S'admeten [sufixos de temps](/manual/appendix/sufixos), per exemple 60s, 1m, 2h, 1d, des de Zabbix 3.4.0.<br>Les [macros d'usuari](/manual/config/macros/user_macros) són compatibles, des de Zabbix 3.4.0.| |*Operacions*|Es mostren les operacions d'acció (si n'hi han) amb aquests detalls:<br>**Passes** - passes d'escalada a les quals s'assigna l'acord<br>**Detalls** - tipus d'operació i el seu destinatari/destinatari.<br>La llista d'operacions també mostra el tipus de suport emprat (correu electrònic, SMS o script), així com el nom i cognoms (entre parèntesis després del nom, nom d'usuari) d'un destinatari de la notificació.< br>**Comença a** - quan després d'un esdeveniment es realitza l'operació<br>**Durada** - es mostra la durada de la passa. Es mostra *Predeterminat* si la passa empra una durada predeterminada, i es mostra un temps si s'empra una durada personalitzada.<br>**Acció** - es mostren els enllaços per editar i suprimir una operació.| |*Operacions de recuperació*|Es mostren les operacions d'acció (si n'hi han) amb aquests detalls:<br>**Detalls** - tipus d'operació i el seu receptor/destí.<br>La llista d'operacions també mostra el tipus de mitjans emprats (correu electrònic, SMS o script), així com el nom i els cognoms (entre parèntesis després del nom d'usuari) d'un destinatari de la notificació.<br>**Acció** - els enllaços per modificar i esborrar es mostren a l'operació.| |*Operacions d'actualització*|Es mostren les operacions d'acció (si n'hi han) amb aquests detalls:<br>**Detalls** - tipus d'operació i el seu destinatari/destinatari.<br>Les operacions de llista també mostren el tipus de suport emprat (correu electrònic, SMS o script), així com el nom i els cognoms (entre parèntesis després del nom d'usuari) d'un destinatari de la notificació.<br>**Acció** - es mostren els enllaços per modificar i esborrar una operació.| |*Atura les operacions dels problemes esborrats*|Marqueu aquesta casella per endarrerir l'inici de les operacions mentre duri una finestra de manteniment. Quan s'inicien les operacions, després del manteniment, es realitzen totes les operacions, incloses les operacions d'esdeveniments durant el manteniment.<br>Tingueu en compte que aquesta configuració només afecta les escalades de problemes; les operacions de recuperació i actualització no es veuran afectades.<br>Si desmarqueu aquesta casella, les operacions s'executaran sense demora fins i tot durant un període de manteniment.<br>Aquesta opció no és disponible per al *servei d'accions*.| |*Notificar sobre les escalades cancel·lades*|Desmarqueu aquesta casella per desactivar les notificacions sobre les escalades cancel·lades (quan l'equip, l'element, el trigger o l'acció són desactivats).| Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Per configurar els detalls d'una operació nova, feu clic a  al bloc Operacions. Per editar una operació existent, feu clic a  al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls de la passa de l'operació. #### 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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 10, "name": "slaid", "value": 4 }, { "type": 9, "name": "serviceid", "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 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *informe SLA* Configureu un giny *informe SLA* que ensenyi l'informe SLA per al servei "2" de SLA "4" durant el període dels darrers 30 dies. Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 10, "name": "slaid", "value": 4 }, { "type": 9, "name": "serviceid", "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 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring an update operation To configure an update operation go to the *Operations* tab in action [configuration](/manual/config/notifications/action).  To configure details of a new update operation, click on  in the Update operations block. To edit an existing operation, click on  next to the operation. A popup window will open where you can edit the operation step details. #### Configuració d'una operació d'actualització Per configurar una operació d'actualització, aneu a la pestanya *Operacions* a la [configuració](/manual/config/notifications/action) de l'acció.  Per configurar els detalls d'una nova operació d'actualització, feu clic a  al bloc Operacions d'actualització. Per editar una operació existent, feu clic a  al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls de la passa de l'operació. #### Configuring a *Plain text* widget Configure a *Plain text* widget that displays latest data for items "42269" and "42253". In addition, configure the item names to be located at the top of the data columns, and only 15 lines of data to be displayed. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "plaintext", "name": "Plain text", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemids", "value": 42269 }, { "type": 4, "name": "itemids", "value": 42253 }, { "type": 0, "name": "style", "value": 1 }, { "type": 0, "name": "show_lines", "value": 15 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configurar d'un giny de *Text sense format* Configurar un giny de *Text pla* que ensenyi les dades més recents dels elements "42269" i "42253". A més, configura els noms d'elements perquè es trobin a la part superior de les columnes de dades i només es mostrin 15 línies de dades. Petició: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "My dashboard", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "plaintext", "name": "Plain text", "x": 0, "y": 0, "width": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 4, "name": "itemids", "value": 42269 }, { "type": 4, "name": "itemids", "value": 42253 }, { "type": 0, "name": "style", "value": 1 }, { "type": 0, "name": "show_lines", "value": 15 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 2 }, { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "problem", "value": "cpu" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Equips amb problemes* Configureu un giny *Equips amb problemes* que ensenyi els equips dels grups d'equips "2" i "4" que tenen problemes amb un nom que inclou la cadena "CPU" i que tenen les següents gravetats: "Avís", "Mitjana", "Alta", "Desastre". Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 2 }, { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "problem", "value": "cpu" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "value": 5 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Problemes per gravetat* Configureu el giny *Problemes per gravetat* que ensenyi el total de problemes per a tots els grups d'equips. Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 0, "name": "show_type", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "performance" }, { "type": 1, "name": "tags.tag.1", "value": "scope" }, { "type": 0, "name": "tags.operator.1", "value": 0 }, { "type": 1, "name": "tags.value.1", "value": "availability" }, { "type": 1, "name": "tags.tag.2", "value": "scope" }, { "type": 0, "name": "tags.operator.2", "value": 0 }, { "type": 1, "name": "tags.value.2", "value": "capacity" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "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 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Problemes* Configureu el giny *Problemes* que ensenyi problemes per al grup d'equips "4" que compleixin les condicions següents: - Problemes que tenen una etiqueta amb el nom "abast" que conté els valors "performance" o "availability" o "capacity". - Problemes que tenen la gravetat següent: "Avís", "Mitjana", "Alt", "Desastre". A més, configureu el giny per veure etiquetes i dades operatives. Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "performance" }, { "type": 1, "name": "tags.tag.1", "value": "scope" }, { "type": 0, "name": "tags.operator.1", "value": 0 }, { "type": 1, "name": "tags.value.1", "value": "availability" }, { "type": 1, "name": "tags.tag.2", "value": "scope" }, { "type": 0, "name": "tags.operator.2", "value": 0 }, { "type": 1, "name": "tags.value.2", "value": "capacity" }, { "type": 0, "name": "severities", "value": 2 }, { "type": 0, "name": "severities", "value": 3 }, { "type": 0, "name": "severities", "value": 4 }, { "type": 0, "name": "severities", "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 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` ### Configuring a recovery operation To configure a recovery operation, go to the *Operations* tab in [action](/manual/config/notifications/action) configuration.  To configure details of a new recovery operation, click on  in the *Recovery operations* block. To edit an existing operation, click on  next to the operation. A popup window will open where you can edit the operation step details. ### Configuració d'una operació de recuperació Per configurar una operació de recuperació, aneu a la pestanya *Operacions* a la configuració d'[acció](/manual/config/notifications/action).  Per configurar els detalls d'una nova operació de recuperació, feu clic a  al bloc d'operacions de recuperació. Per editar una operació existent, feu clic a  al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls del pas de l'operació. #### 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", "Utilization", "1m avg", "5m avg", "15m avg", "Processes". Request: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configurant el giny d'*Equips principals* Configura un giny d'*Equips principals* que ensenya els equips principals sobre ús de CPU del grup d'equips "4". A més, configura les columnes següents: "Nom d'equip", "Ús", "1m avg", "5m avg", "15m avg", "Processos". Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 }, { "type": 1, "name": "columns.name.0", "value": "" }, { "type": 0, "name": "columns.data.0", "value": 2 }, { "type": 1, "name": "columns.base_color.0", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.0", "value": "" }, { "type": 1, "name": "columns.name.1", "value": "Utilization" }, { "type": 0, "name": "columns.data.1", "value": 1 }, { "type": 1, "name": "columns.base_color.1", "value": "4CAF50" }, { "type": 1, "name": "columns.timeshift.1", "value": "" }, { "type": 1, "name": "columns.item.1", "value": "CPU utilization" }, { "type": 0, "name": "columns.display.1", "value": 3 }, { "type": 1, "name": "columns.min.1", "value": "0" }, { "type": 1, "name": "columns.max.1", "value": "100" }, { "type": 1, "name": "columnsthresholds.color.1.0", "value": "FFFF00" }, { "type": 1, "name": "columnsthresholds.threshold.1.0", "value": "50" }, { "type": 1, "name": "columnsthresholds.color.1.1", "value": "FF8000" }, { "type": 1, "name": "columnsthresholds.threshold.1.1", "value": "80" }, { "type": 1, "name": "columnsthresholds.color.1.2", "value": "FF4000" }, { "type": 1, "name": "columnsthresholds.threshold.1.2", "value": "90" }, { "type": 1, "name": "columns.name.2", "value": "1m avg" }, { "type": 0, "name": "columns.data.2", "value": 1 }, { "type": 1, "name": "columns.base_color.2", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.2", "value": "" }, { "type": 1, "name": "columns.item.2", "value": "Load average (1m avg)" }, { "type": 1, "name": "columns.name.3", "value": "5m avg" }, { "type": 0, "name": "columns.data.3", "value": 1 }, { "type": 1, "name": "columns.base_color.3", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.3", "value": "" }, { "type": 1, "name": "columns.item.3", "value": "Load average (5m avg)" }, { "type": 1, "name": "columns.name.4", "value": "15m avg" }, { "type": 0, "name": "columns.data.4", "value": 1 }, { "type": 1, "name": "columns.base_color.4", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.4", "value": "" }, { "type": 1, "name": "columns.item.4", "value": "Load average (15m avg)" }, { "type": 1, "name": "columns.name.5", "value": "Processes" }, { "type": 0, "name": "columns.data.5", "value": 1 }, { "type": 1, "name": "columns.base_color.5", "value": "FFFFFF" }, { "type": 1, "name": "columns.timeshift.5", "value": "" }, { "type": 1, "name": "columns.item.5", "value": "Number of processes" }, { "type": 0, "name": "column", "value": 1 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "availability" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *Visió general del trigger* Configureu un giny *Visió general del trigger* que ensenyi els estats del trigger per a tots els grups d'equipsque tinguin triggers amb una etiqueta que tingui el nom "abast" i que contingui el valor "disponibilitat". Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "scope" }, { "type": 0, "name": "tags.operator.0", "value": 0 }, { "type": 1, "name": "tags.value.0", "value": "availability" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "url", "value": "https://www.zabbix.com/documentation/6.0/en" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny *URL* Configureu un giny *URL* que ensenyi la pàgina d'inici del manual Zabbix. Petició: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "url", "value": "https://www.zabbix.com/documentation/6.0/en" } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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| |--|--------| |*Authentication*|Authentication options.<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>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*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).<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 ::: #### Configuració de l'autenticació La pestanya **Autenticació** us permet configurar les opcions d'autenticació de l'escenari. Un punt verd al costat del nom de la pestanya indica que hi ha habilitat algun tipus d'autenticació HTTP.  Configuració d'autenticació: |Paràmetre|Descripció| |--|---------| |*Autenticació*|Opcions d'autenticació.<br>**Cap** - no s'empra cap autenticació.<br>**Bàsica** - s'empra l'autenticació bàsica.<br>**NTLM** - l Autenticació NTLM ([Windows empra NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM).<br>**Kerberos** - s'empra l'autenticació Kerberos. Veieu també: [Configuració de Kerberos amb Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - s'empra l'autenticació de Digest.<br>En triar un mètode d'autenticació, es proporcionaran dos camps addicionals per introduir un nom d'usuari i mot de pas.<br>Les macros d'usuari es poden emprar als camps d'usuari i mot de pas.| |*Verifica SSL Peer*|Marca la casella per verificar el certificat SSL del servidor web.<br>El certificat del servidor es recuperarà automàticament des de la ubicació de l'Autoritat de certificació (CA) de tot el sistema. Podeu substituir la ubicació dels fitxers CA mitjançant el paràmetre de configuració del servidor o proxy Zabbix [SSLCALocation](/manual/appendix/config/zabbix_server).<br>Això estableix l'opció cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*Verifica l'equip SSL*|Marca la casella per verificar que el camp *Nom comú* o el camp *Nom alternatiu de l'assumpte* del certificat del servidor web coincideix.<br>Això estableix l'opció cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Fitxer de certificat SSL*|Nom del fitxer de certificat SSL emprat per a l'autenticació del client. El fitxer del certificat ha d'estar en format PEM^1^. Si el fitxer del certificat també conté la clau privada, deixeu el camp *Fitxer de clau SSL* en blanc. Si la clau és xifrada, introduïu el mot de pas al camp *Mot de pas de la clau SSL*. El directori que conté aquest fitxer l'especifica el servidor Zabbix o el paràmetre de configuració del proxy [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>En aquest camp es poden emprar les macros `HOST.*` i les macros d'usuari.<br> Això estableix l'opció cURL [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html).| |*Fitxer de clau SSL*|Nom del fitxer de clau privada SSL emprat per a l'autenticació del client. El fitxer de clau privada ha d'estar en format PEM^1^. El directori que conté aquest fitxer l'especifica el paràmetre de configuració del servidor o proxy de Zabbix [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>En aquest camp es poden utilitzar les macros `HOST.*` i les macros d'usuari.<br> Això estableix l'opció cURL [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html).| |*Contrasenya de clau SSL*|Contrasenya del fitxer de clau privada SSL.<br>En aquest camp es poden utilitzar macros d'usuari.<br>Això estableix l'opció cURL [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html).| ::: noteimportant \[1\] Zabbix només admet fitxers de certificat i clau privada en format PEM. Si teniu el vostre certificat i les vostres dades de clau privada en un fitxer en format PKCS \#12 (normalment amb l'extensió \*.p12 o \*.pfx), podeu generar el fitxer PEM amb les ordres següents: 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 El servidor Zabbix recull els canvis de certificat sense reiniciar. ::: :::noteclassic Si teniu un certificat de client i una clau privada en un fitxer, només cal que els especifiqueu en un camp "Fitxer de certificat SSL" i deixeu el camp "Fitxer de clau SSL" en blanc. El certificat i la clau han d'estar sempre en format PEM. Combinar certificat i clau és senzill: 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: ```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": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuració d'un giny de *monitoratge web* Configureu un giny *Monitoratge web* que ensenyi un resum d'estat dels escenaris de monitoratge web actius per al grup d'equips "4". Petició: ```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": 6, "height": 3, "view_mode": 0, "fields": [ { "type": 2, "name": "groupids", "value": 4 } ] } ] } ], "userGroups": [ { "usrgrpid": 7, "permission": 2 } ], "users": [ { "userid": 1, "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "3" ] }, "id": 1 } ``` #### Configuring a web scenario To configure a web scenario: - Go to: *Configuration → 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).| |*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>For example:<br>{username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex:hostid is (\[0-9\]+)<br>The macros can then be referenced in the steps as {username}, {password} and {hostid}. 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 "\*\*\*\*\*\*". ::: #### Configurant un escenari web Per configurar un escenari web: - Aneu a: *Configuració → Equips* (o *Plantilles*) - Feu clic a *Web* a la filera de l'equip/plantilla - Feu clic a *Crear un escenari* a la dreta (o al nom de l'escenari per editar un escenari existent) - Introduïu els paràmetres de l'escenari al formulari La pestanya **Escenari** us permet configurar els paràmetres generals d'un escenari web.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Paràmetres de l'escenari: |Paràmetre|Descripció| |--|---------| |*Nom*|Nom de l'escenari únic.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros). *Tingueu en compte* que si s'empren macros d'usuari, aquestes es deixaran sense resoldre als noms [element de monitoratge web](/manual/web_monitoring/items).| |*Interval d'actualització*|Amb quina freqüència s'executarà l'escenari.<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), p. 30s, 1m, 2h, 1d.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros). *Tingueu en compte* que si s'empra una macro d'usuari i es canvia el seu valor (per exemple, 5m → 30s), la següent comprovació s'executarà d'acord amb el valor anterior (més en el futur amb els valors d'exemple).| |*Intents*|Nombre d'intents per executar passes d'escenari web. En cas de problemes de xarxa (temps d'espera, sense connectivitat, etc.) Zabbix pot repetir l'execució d'una passa diversos cops. El conjunt de xifres afectarà per igual cada passa de l'escenari. Es poden especificar fins a 10 intents, el valor per defecte és 1.<br>*Nota*: Zabbix no repetirà cap passa per un codi de resposta incorrecte o de la falta de coincidència d'una cadena requerida.| |*Agent*|Trieu un agent client.<br>Zabbix simularà ser el navegador seleccionat. Això és útil quan un lloc web retorna contingut diferent per a diferents navegadors.<br>En aquest camp es poden emprar macros d'usuari.| |*Proxy HTTP*|Podeu especificar un proxy HTTP, emprant el format `[protocol://][nom d'usuari[:mot_de_pas]@]proxy.example.com[:port]`.<br>Això estableix l'opció cURL [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html).<br>El prefix opcional `protocol://` es pot emprar per especificar protocols alternatius de proxy (el suport del prefix del es va afegir a cURL 7.21.7). Sense cap protocol especificat, el proxy es tractarà com un proxy HTTP.<br>De manera predeterminada, s'emprarà el port 1080.<br>Si s'especifica, el proxy sobreescriurà variables d'entorn relacionades amb el proxy, com ara http\_proxy, HTTPS\_PROXY. Si no s'especifica, el proxy no sobreescriurà les variables d'entorn relacionades amb el proxy. El valor introduït es transmet "tal com és", no es fa cap comprovació de seny.<br>També podeu introduir una adreça intermediaria SOCKS. Si especifiqueu un protocol incorrecte, la connexió fallarà i l'element no s'admetrà.<br>*Tingueu en compte* que només s'admet l'autenticació simple amb el proxy HTTP.<br>En aquest camp es poden emprar macros d'usuari.| |*Variables*|Variables que es poden emprar a les passes de l'escenari (URL, variables de publicació).<br>Tenen el format següent:<br>**{macro1}**=valor1<br>**{macro2}**=valor2<br>**{macro3}**=regex:<expressió regular><br>Per exemple:<br>{nom d'usuari}=Alexei<br>{mot_de_pas}=kj3h5kJ34bd<br>{hostid}=regex :hostid és (\[0-9\]+)<br>Tot seguit, es pot fer referència a les macros a les passes com a {nom d'usuari}, {mot de pas} i {identificador}. Zabbix els substituirà automàticament per valors reals. Tingueu en compte que les variables amb `regex:` necessiten uns passa per obtindre el valor de l'expressió regular, de manera que el valor extret només es pot aplicar a la passa posterior.<br>Si la part del valor comença amb `regex:` aleshores la part posterior es tracta com una expressió regular que cerca a la pàgina web i, si es troba, emmagatzema la coincidència a la variable. Hi ha d'haver com a mínim un subgrup perquè es pugui extreure el valor coincident.<br>S'admeten macros d'usuari i {HOST.\*} [macros](/manual/appendix/macros/supported_by_location).<br>Les variables són automàticament Codificades per URL quan s'empra en camps de consulta o dades de formulari per a variables de publicació, però s'ha de codificar per URL manualment quan s'empra a la publicació sense processar o directament a l'URL.| |*Capçaleres*|Les capçaleres HTTP s'empren quan es fa una petició. Es poden emprar capçaleres predeterminades i personalitzades.<br>Les capçaleres s'assignaran mitjançant la configuració predeterminada en funció del tipus d'agent triat d'una llista desplegable a nivell d'escenari, i s'aplicaran a totes les passes, tret que siguin definits personalment a un nivell de passa.<br>**S'ha de tindre en compte que la definició de la capçalera en un nivell de passa descarta automàticament totes les capçaleres definides anteriorment, excepte una capçalera predeterminada que s'assigna seleccionant l'"Agent d'usuari" d'un menú desplegable de llista a nivell d'escenari.**<br>No obstant això, fins i tot la capçalera predeterminada "Agent d'usuari" es pot substituir especificant-la en un nivell de passa.<br>Per desactivar la capçalera a nivell d'escenari, la capçalera s'hauria d'anomenar i s'atribueix sense cap valor a nivell de passa.<br>Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP, opcionalment emprant algunes funcions addicionals compatibles amb l'opció cURL [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html).<br>Per exemple:<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>S'admeten macros d'usuari i [macros](/manual/appendix/macros/supported_by_location) {HOST.\*}.| |*Activat*|L'escenari és actiu si aquesta casella és marcada, en cas contrari - desactivat.| Tingueu en compte que en editar un escenari existent, hi ha dos botons addicionals disponibles al formulari: | | | |--|---------| ||Crear un altre escenari basat en les propietats de l'existent.| ||Esborra l'historial i les dades de tendències de l'escenari. Això farà que el servidor realitzi l'escenari immediatament després d'esborrar les dades.| ::: notetip Si el camp *Proxy HTTP* es deixa buit, una altra manera d'emprar un proxy HTTP és establir variables d'entorn relacionades amb el proxy. Per a les comprovacions HTTP: establiu la variable d'entorn **http\_proxy** per a l'usuari del servidor Zabbix. Per exemple, `http_proxy=http://proxy_ip:proxy_port`. Per a les comprovacions HTTPS: establiu la variable d'entorn **HTTPS\_PROXY**. Per exemple, `HTTPS_PROXY=http://proxy_ip:proxy_port`. Hi ha més detalls disponibles executant una ordre de shell: *\# man curl*. ::: La pestanya **Passes** us permet configurar les passes de l'escenari web. Per afegir una passa d'escenari web, feu clic a *Afegir* al bloc *Passes*. {width="600"} ::: noteclassic Les [macros d'usuari](/manual/config/macros/user_macros#configuration) secretes no s'han d'emprar a les URL, ja que es resoldran a "\*\*\*\*\*\*". ::: #### Configuring custom graphs To create a custom graph, do the following: - Go to *Configuration → 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 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.| #### Configuració dels gràfics personalitzats Per crear un gràfic personalitzat, seguiu aquestes passes: - Aneu a *Configuració → Equips (o plantilles)* - Feu clic a *Gràfics* a la filera al costat de l'equip o model desitjat - A la pantalla Gràfics, feu clic a *Crear un gràfic* - Canviar els atributs del gràfic {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Atributs del gràfic: |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom*|<|Nom únic del gràfic.<br>Les expressions [macros](/manual/appendix/macros/supported_by_location) s'admeten en aquest camp, però només amb `avg`, `last`, `min` i ` max`, amb el temps com a paràmetre (p. ex., `{?avg(/host/key,1h)}`).<br>S'admeten macros {HOST.HOST<1-9>} per emprar-les en aquesta macro, referint-se al primer, segon, tercer, etc. equip al gràfic, per exemple `{?avg(/{HOST.HOST2}/key,1h)}`. Tingueu en compte que fer referència al primer equip amb aquesta macro és redundant, ja que el primer equip es pot referenciar implícitament, per exemple, `{?avg(//key,1h)}`.| |*Amplada*|<|L'amplada del gràfic en píxels (només per a la vista prèvia i gràfics circulars/explotats).| |*Alçada*|<|Alçada del gràfic en píxels.| |*Tipus de gràfic*|<|Tipus de gràfic:<br>**Normal** - gràfic normal, els valors es mostren com a línies<br>**Apilat** - gràfic apilat, es mostren àrees plenes<br>**Pastís** - gràfic de sectors<br>**Explotat** - gràfic de sectors "explotat", que mostra les parts com a "retallades" del gràfic | |*Mostra la llegenda*|<|Marcar aquesta casella habilitarà la visualització de la llegenda del gràfic.| |*Mostra l'horari laboral*|<|Si es tria, les hores no laborals es mostraran sobre un fons gris. No disponible per a gràfics de sectors i gràfics de sectors explotats.| |*Mostra els triggers*|<|Si es tria, els triggers simples es mostraran com a línies amb guions negres al color de gravetat del trigger. No disponible per a gràfics de sectors i gràfics de sectors explotats.| |*Línia percentil (esquerra)*|<|Mostra el percentil de l'eix Y esquerre. Si, per exemple, s'estableix un percentil del 95%, la línia del percentil serà al nivell on el 95% dels valors caiguin per sota. Apareix com una línia verda brillant. Només disponible per a gràfics normals.| |*Línia percentil (dreta)*|<|Mostra el percentil de l'eix Y dret. Si, per exemple, s'estableix un percentil del 95%, la línia del percentil serà al nivell on el 95% dels valors caiguin per sota. Apareix com una línia vermella brillant. Només disponible per a gràfics normals.| |*Valor MIN de l'eix Y*|<|Valor mínim de l'eix Y:<br>**Calculat** - el valor mínim de l'eix Y es calcularà automàticament<br>**Fixat** - valor mínim fix per a Y eix. No disponible per als gràfics de sectors i els gràfics de sectors explotats.<br>**Element** - el darrer valor de l'element triat serà el valor mínim | |*Valor màxim de l'eix Y*|<|Valor màxim de l'eix Y:<br>**Calculat** - el valor màxim de l'eix Y es calcularà automàticament<br>**Fixat** - valor màxim fix per a l'eix Y eix. No disponible per a gràfics de sectors i gràfics de sectors explotats.<br>**Item** - el darrer valor de l'element triat serà el valor màxim | |*Vista 3D*|<|Activa l'estil 3D. Només per a gràfics de sectors i gràfics de sectors explotats.| |*Elements*|<|Els elements les dades dels quals s'han de mostrar en aquest gràfic. Feu clic a *Afegir* per triar elements. També podeu triar diferents opcions de visualització (funció, estil de dibuix, visualització de l'eix esquerre/dret, color).| |<|*Ordre d'ordenació (0→100)*|Ordre de dibuix. 0 es processarà primer. Es pot emprar per dibuixar línies o regions darrere (o davant) d'una altra.<br> Podeu arrossegar i deixar anar elements amb la fletxa a l'inici d'una línia per definir l'ordre d'ordenació o quin element es mostra davant de l'altre.| |^|*Nom*|El nom de l'element triat es mostra com a enllaç. En fer clic a l'enllaç s'obre la llista d'altres articles disponibles.| |^|*Tipus*|Tipus (només disponible per a gràfics de sectors i gràfics de sectors explotats):<br>**Simple** - el valor de l'element es representa proporcionalment al gràfic de sectors<br>**Suma del gràfic** - el valor de l'element representa tot el sector<br>Tingueu en compte que la coloració de l'element "suma gràfica" només serà visible en la mesura que no sigui ocupada per elements "proporcionals".| |^|*Funció*|Trieu els valors que es mostraran quan hi hagi més d'un valor per píxel de gràfic vertical per a un element:<br>**Tot** - mostra tots els valors possibles (mínim, màxim, mitjana) al gràfic. Tingueu en compte que durant períodes més llargs, aquest paràmetre no té cap efecte; només durant períodes de temps més llargs, quan augmenta la congestió de dades en un píxel de gràfic vertical, "tot" comença a mostrar valors mínims, màxims i mitjans. Aquesta funció només és disponible per al tipus de gràfic *Normal*. Veieu també: Generació de gràfics [a partir de l'historial/tendències](/manual/config/visualization/graphs/simple#generating_from_historytrends).<br>**mitjana** - mostra els valors mitjans<br>**darrer** - mostra els darrers valors. Aquesta funció només és disponible si se selecciona *Pastís/Explosió* com a tipus de gràfic.<br>**max** - mostra els valors màxims<br>**min** - mostra els valors mínims| |^|*Estil de dibuix*|Seleccioneu l'estil de dibuix (només disponible per a gràfics normals; per a gràfics apilats sempre s'empra l'àrea emplenada) per aplicar-lo a les dades de l'element: *Línia*, *Línia gruixuda*, *Regió completa*, *Punt*, *Línia discontínua*, *Línia i degradat*.| |^|*Cot de l'eix Y*|Seleccioneu el costat de l'eix Y per mostrar les dades de l'element - *Esquerra*, *Dreta*.| |^|*Color*|Seleccioneu el color que voleu aplicar a les dades de l'element.| #### 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. #### Configurant les interfícies i els elements JMX a la interficie de Zabbix Amb el Java gateway executant-se, el servidor que sap on és el gateway i una aplicació de Java engegada amb suport de monitoratge JMX remot, ara podem configurar les interfícies i els elements des de la interfície web de Zabbix. ##### 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. ##### Configuració de la interfície JMX Comencem creant una interfície de tipus JMX a l'equip {width="600"} Tots els camps obligatoris són marcats amb un asterisc vermell. #### Configuring low-level discovery rules See the [low-level discovery](/manual/discovery/low_level_discovery) section of the manual. #### Configuració de les regles de descoberta de baix nivell Veieu la secció de [descoberta de baix nivell](/manual/discovery/low_level_discovery) del manual. ### 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: - Go to: *Configuration* → *Templates* or *Hosts* - Click on *Discovery* in the row of an appropriate template/host {width="600"} - Click on *Create discovery rule* in the upper right corner of the screen - Fill in the discovery rule form with the required details ### Configuració de la descoberta de baix nivell Demostrarem la descoberta de baix nivell mitjançant un exemple de descoberta de sistemes de fitxers. Per configurar la descoberta, seguiu aquestes passes: - Aneu a: *Configuració* → *Plantilles* o *Equips* - Feu clic a *Descoberta* a la línia d'un model/equip adequat. {width="600"} - Feu clic a *Crear una regla de descoberta* a l'extrem superior dret de la pantalla. - Ompliu el formulari de regla de descoberta amb els detalls requerits #### Configuring nested templates To link templates, you need to take an existing template or a new one, and then: - Open the [template configuration form](/manual/config/templates/template#creating-a-template) - Find the *Templates* field - Click *Select* to open the *Templates* popup window - In the popup window, choose required templates, then click *Select* to add the templates to the list - Click *Add* or *Update* in the template configuration form Thus, all entities of the parent template, as well as all entities of linked templates (such as items, triggers, graphs, etc.) will now appear in the template configuration, except for linked template dashboards, which will, nevertheless, be inherited by hosts. To unlink any of the linked templates, in the same form use the *Unlink* or *Unlink and clear* buttons and click *Update*. Choosing the *Unlink* option will simply remove the association with the linked template, while not removing all its entities (items, triggers, graphs, etc.). Choosing the *Unlink and clear* option will remove both the association with the linked template and all its entities (items, triggers, graphs, etc.). #### Configuració de plantilles niuades Per enllaçar models, heu d'agafar un model existent o un de nou i després: - Obriu el [formulari de configuració de la plantilla](/manual/config/templates/template#creating-a-template) - Cerqueu el camp *Models* - Feu clic a *Triar* per obrir la finestra emergent *Plantilles* - A la finestra emergent, trieu les plantilles necessàries i feu clic a *Triar* per afegir les plantilles a la llista - Feu clic a *Afegir* o *Actualitzar* al formulari de configuració del model Així, totes les entitats del model pare, així com totes les entitats dels models relacionats (com ara elements, triggers, gràfics, etc.) ara apareixeran a la configuració del model, excepte els quadres de comandament del model enllaçats, que tanmateix s'heretaran als equips. Per desenllaçar un dels models enllaçats, al mateix formulari, empreu els botons *Desenllaçar* o *Desenllaçar i eliminar* i feu clic a *Actualitzar*. Si escolliu l'opció *Desenllaçar*, simplement esborrarà l'associació amb el model enllaçat, sense eliminar totes les seves entitats (elements, triggers, gràfics, etc.). Si escolliu l'opció *Desenllaçar i esborrar*, s'esborrarà tant l'associació amb el model enllaçat com totes les seves entitats (elements, triggers, gràfics, etc.). ##### 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 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 ``` ::: ##### Configurant el receptor de traps amb Perl Requisits: Perl, Net-SNMP compilat amb --enable-embedded-perl (fet per defecte des de Net-SNMP 5.4) Es pot emprar un receptor de traps Perl (cerqueu misc/snmptrap/zabbix\_trap\_receiver.pl) per passar traps al servidor Zabbix directament des d'snmptrapd. Per configurar-lo: - afegiu l'script Perl al fitxer de configuració snmptrapd (snmptrapd.conf), per exemple: ```perl perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; ``` - configureu el receptor, per exemple: ```ini $SNMPTrapperFile = '[TRAP FILE]'; $DateTimeFormat = '[DATE TIME FORMAT]'; ``` ::: notetip Si no s'anomena l'script, snmptrapd es negarà a començar amb missatges, semblants a aquests:<br><br> ```yaml Els modificadors d'expressió regular "/l" i "/a" s'exclouen mútuament a (eval 2) la línia 1, al final de la línia El modificador d'expressió regular "/l" pot no aparèixer dues vegades a (eval 2) la línia 1, al final de la línia ``` ::: ### 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. ### Configuració dels plugins Aquesta secció proporciona principis comuns de configuració de pluginsi pràctiques recomanades. Tots els pluginses configuren mitjançant el paràmetre *Plugins.\**, que pot formar part del [fitxer de configuració](/manual/appendix/config/zabbix_agent2) de l'agent Zabbix 2 o el seu propi [fitxer de configuració](/manual/appendix/config/zabbix_agent2_plugins) del plugin. Si un plugin empra un fitxer de configuració independent, el camí d'accés a aquest fitxer s'ha d'especificar al paràmetre inclòs del fitxer de configuració de l'agent Zabbix 2. Cada paràmetre del plugin ha de tindre l'estructura següent: *Plugins.<PluginName>.<Parameter>=<Value>* A més, hi ha dos grups específics més de paràmetres: -*Plugins.<PluginName>.Default.<Parameter>=<Value>* emprat per definir els [valors del paràmetre per defecte](#default-values). -*Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>* emprat per definir el joc de paràmetres separats per els objectius a monitorar via les [sessions anomenades](#named-sessions). Els noms dels paràmetres han de complir els requisits següents: - es recomana posar en majúscula els noms dels vostres connectors; - el paràmetre ha d'ésser en majúscules; - no es permeten pas caràcters especials; - la nidificació no és pas limitada per un nivell màxim; - el nombre de paràmetres no és pas limitat. #### 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`. #### Configuració de PSK per al servidor: comunicació d'un proxy actiu (exemple) Al proxy, escriviu el valor PSK en un fitxer, per exemple, `/home/zabbix/zabbix_proxy.psk`. El fitxer ha de contindre el PSK a la primera cadena de text, per exemple: e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9 Establiu els drets d'accés al fitxer PSK: només hauria de ser llegible per l'usuari de Zabbix. Modifiqueu la configuració de TLS al fitxer de configuració del proxy `zabbix_proxy.conf`, per exemple, configureu: TLSConnect=psk TLSPSKFile=/home/zabbix/zabbix_proxy.psk TLSPSKIidentity=PSK 002 El proxy es connecta al servidor mitjançant PSK. La identitat PSK serà "PSK 002". (Per minimitzar el temps d'inactivitat, canvieu el tipus de connexió tal com es descriu a [Gestió de xifrat de connexió](/manual/encryption#connection_encryption_management)). Configureu PSK per a aquest proxy a la interfície Zabbix. Aneu a *Administració → Proxys*, trieu el proxy i aneu a la pestanya "Xifrat". A "Connexions proxy", marqueu `PSK`. Enganxeu el camp "PSK Identitat" "PSK 002" i "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9" al camp "PSK". Feu clic a "Actualitzar". Reinicieu el proxy. Començarà a emprar connexions de servidor xifrades basades en PSK. Comproveu els fitxers de registre del servidor i del proxy per trobar missatges d'error. Per a un proxy passiu, el procediment és similar. L'única diferència és: establiu `TLSAccept=psk` al fitxer de configuració del proxy i configureu "Connexions proxy" a la interfície Zabbix a `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: *Configuration → Hosts* - Select host and click on **Encryption** tab Example:  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. #### Configuració de PSK per a la comunicació servidor-agent (exemple) A l'equip de l'agent, escriviu el valor PSK en un fitxer, per exemple, `/home/zabbix/zabbix_agentd.psk`. El fitxer ha de contindre un PSK a la primera cadena de text, per exemple: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952 Estableix els drets d'accés al fitxer PSK: només hauria de ser llegible per l'usuari de Zabbix. Modifiqueu la configuració de TLS al fitxer de configuració de l'agent `zabbix_agentd.conf`, per exemple, establiu: TLSConnect=psk TLSAccept=psk TLSPSKFile=/home/zabbix/zabbix_agentd.psk TLSPSKIdentity=PSK 001 L'agent es connecta al servidor (comprovacions actives) i accepta des del servidor i l'ordre `zabbix_get` només connexions amb PSK. La identitat PSK serà "PSK 001". Reinicieu l'agent. Ara podeu provar la connexió amb l'ordre `zabbix_get`, per exemple: 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 (Per minimitzar el temps d'inactivitat, canvieu el tipus de connexió tal com es descriu a [Gestió de xifrat de connexió](/manual/encryption?&#connection_encryption_management)). Configureu el xifrat PSK per a aquest agent a la interfície Zabbix: - Aneu a: *Configuració → Equips* - Trieu l'equip i feu clic a la pestanya **Xifrat** Exemple:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Un cop la memòria cau de configuració sigui sincronitzada amb la base de dades, les connexions noves empren PSK. Comproveu els fitxers de registre del servidor i de l'agent per si hi ha missatges d'error. #### 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. #### Configuració del servidor per emprar la passarel·la Java Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor. JavaGateway=192.168.3.14 JavaGatewayPort=10052 Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers. StartJavaPollers=5 No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les. #### 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. #### Configuració del servidor per emprar la passarel·la Java Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor. JavaGateway=192.168.3.14 JavaGatewayPort=10052 Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers. StartJavaPollers=5 No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les. #### 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. #### Configuració del servidor per emprar la passarel·la Java Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor. JavaGateway=192.168.3.14 JavaGatewayPort=10052 Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers. StartJavaPollers=5 No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les. #### 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. #### Configuració del servidor per emprar la passarel·la Java Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor. JavaGateway=192.168.3.14 JavaGatewayPort=10052 Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers. StartJavaPollers=5 No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les. #### Configuring SNMP monitoring To start monitoring a device through SNMP, the following steps have to be performed: #### configuració del monitoratge SNMP Per engegar el monitoratge d'un dispositiu via SNMP, s'han de seguir les passes següents: #### Configuring SNMP traps This item type requires the following frontend configuration. 1\. Create an SNMP interface for your host - In *Configuration > Hosts*, create/edit the host, and in the *Interfaces* field, add the interface type "SNMP", specifying the IP or DNS address.<br><br>The address from each received trap will be compared to the IP and DNS addresses of all SNMP interfaces to find the corresponding hosts. 2\. Configure the item - In *Configuration > Hosts*, create/edit the necessary item. - In the *Key* field, use one of the SNMP trap keys: |Key|<|<| |--|--|------| |Description|Return value|Comments| |**snmptrap**\[regexp\]|<|<| |Catches all SNMP traps that match the [regular expression](/manual/regular_expressions) specified in **regexp**. If regexp is unspecified, catches any trap.|SNMP trap|This item can be set only for SNMP interfaces.<br>User macros and global regular expressions are supported in the parameter of this item key.| |**snmptrap.fallback**|<|<| |Catches all SNMP traps that were not caught by any of the snmptrap\[\] items for that interface.|SNMP trap|This item can be set only for SNMP interfaces.| ::: noteclassic Multiline regular expression matching is not supported at this time. ::: - 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. #### Configuració de traps SNMP Aquest tipus d'element requereix la configuració següent de la interfície: 1\. Crear una interfície SNMP al vostre equip - A *Configuració > Equips*, al camp **Interfície d'equip**, definiu una interfície de tipus "SNMP" amb l'adreça IP correcta o el DNS correcte.<br><br> L'adreça de cada trap rebuda es compara amb les adreces IP i DNS de totes les interfícies SNMP per trobar els equips corresponents. 2\. Configurar l'element - A *Configuració > Equips*, creeu/ editeu l'element necessari. - Al camp **Clau**, empreu una de les claus de captura SNMP: |Clau|<|<| |--|--|------| |Descripció|Valor de retorn|Comentaris| |**snmptrap**\[regexp\]|<|<| |Atrapa tots els traps SNMP que coincideixin amb l'[expressió regular](/manual/regular_expressions) especificada a **regexp**. Si no s'especifica l'expressió regular, captura qualsevol trap.|Trap SNMP|Aquest element només es pot configurar per a interfícies SNMP.<br>Les macros d'usuari i les expressions regulars globals són compatibles amb el paràmetre d'aquesta clau d'element.| |**snmptrap.fallback**|<|<| |Captura tots els traps SNMP que no han estat capturats per cap dels elements snmptrap\[\] d'aquesta interfície.|Trap SNMP|Aquest element només es pot configurar per a interfícies SNMP.| :::noteclassic La concordança d'expressions regulars de diverses línies no s'admet en aquest moment. ::: - Establiu el *Tipus d'informació* a "Registre" perquè les marques de temps s'analitzin. Tingueu en compte que altres formats com ara "Numèric" també són acceptables, però poden requerir un gestor d'interrupcions personalitzat. ##### 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 = %H:%M:%S %Y/%m/%d ``` ::: 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 ``` ::: ##### Configurant SNMPTT Al principi, snmptrapd s'hauria de configurar per emprar SNMPTT. ::: notetip Per obtindre un millor rendiment, SNMPTT s'ha de configurar com a dimoni que empra **snmptthandler-embedded** per passar-hi els traps. Veieu les instruccions per [configurar SNMPTT](http://snmptt.sourceforge.net/docs/snmptt.shtml). ::: Quan SNMPTT sigui configurat per rebre els traps, configureu `snmptt.ini`: 1. habiliteu l'ús del mòdul Perl del paquet NET-SNMP: ```ini net_snmp_perl_enable = 1 ``` 2. registreu els traps al fitxer trap que llegirà Zabbix: ```ini log_enable = 1 log_file = [TRAP FILE] ``` 3. establiu el format de data i hora: ```ini date_time_format = %H:%M:%S %Y/%m/%d ``` ::: notewarning El paquet "net-snmp-perl" s'ha esborrat a RHEL 8.0-8.2; i afegit de nou a RHEL 8.3. Per obtindre més informació, veieu els [problemes coneguts](/manual/installation/known_issues#snmp_traps). ::: Ara formateu els traps perquè Zabbix els reconegui (editeu snmptt.conf): 1. Cada instrucció FORMAT hauria de començar amb "ZBXTRAP \[adreça\]", on \[adreça\] es compararà amb les adreces IP i DNS de SNMP interfícies a Zabbix. Per exemple: ```ini EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) ``` 2. Veieu tot seguit més informació sobre el format de traps SNMP. ::: noteimportant No empreu traps desconeguts: Zabbix no els podrà pas reconèixer. Els traps desconeguts es poden gestionar definint un esdeveniment general a snmptt.conf:<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.<br>Specifying custom headers is supported *starting with Zabbix 2.4*.| |*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. #### Configurant passes {width="600"} Paràmetres de les passes: |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic de passa.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros). *Tingueu en compte* que si s'empren macros d'usuari, aquestes es deixaran sense resoldre als noms [element de monitoratge web](/manual/web_monitoring/items).| |*URL*|URL per connectar-se i recuperar dades. Per exemple:<br>https://www.example.com<br>http://www.example.com/download<br>Els noms de domini es poden especificar en caràcters Unicode. Es converteixen automàticament a ASCII quan s'executa la passa de l'escenari web.<br>El botó *Analitzar* es pot emprar per separar els camps de consulta opcionals (com ara ?name=Admin&password=mypassword) de l'URL, movent els atributs i els valors a *Camps de consulta* per a la codificació automàtica d'URL.<br>Es poden emprar variables a l'URL mitjançant la sintaxi {macro}. Les variables es poden codificar per URL manualment mitjançant una sintaxi {{macro}.urlencode()}.<br>S'admeten macros d'usuari i {HOST.\*} [macros](/manual/appendix/macros/supported_by_location).<br>Limitat a 2048 caràcters.| |*Camps de consulta*|Variables HTTP GET per a l'URL.<br>Especificat com a parelles d'atribut i valor.<br>Els valors es codifiquen automàticament per URL. Els valors de les variables d'escenari, les macros d'usuari o les macros {HOST.\*} es resolen i després es codifiquen automàticament per URL. L'ús d'una sintaxi {{macro}.urlencode()} els codificarà per doble URL.<br>S'admeten macros d'usuari i {HOST.\*} [macros](/manual/appendix/macros/supported_by_location).| |*Publicació*|Variables HTTP POST.<br>Al mode **Dades de formulari**, especificat com a parelles d'atributs i valors.<br>Els valors es codifiquen automàticament per URL. Els valors de les variables d'escenari, les macros d'usuari o les macros {HOST.\*} es resolen i després es codifiquen automàticament per URL.<br>Al mode **Dades en brut**, els atributs/valors es mostren en una sola línia i es concatenen amb un Símbol **&**.<br>Els valors en brut es poden codificar/descodificar manualment mitjançant una sintaxi {{macro}.urlencode()} o {{macro}.urldecode()}.<br>Per exemple: id=2345&userid={usuari}<br>Si {usuari} es defineix com una variable de l'escenari web, es substituirà pel seu valor quan s'executi la passa. Si voleu codificar l'URL de la variable, substituïu {user} per {{user}.urlencode()}.<br>Les macros d'usuari i {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) són compatibles.| |*Variables*|Variables de nivell de passa que es poden emprar per a les funcions GET i POST.<br>Especificades com a parelles d'atributs i valors.<br>Les variables de nivell de passa anul·len les variables de nivell d'escenari o les variables de la passa anterior. Tanmateix, el valor d'una variable de nivell de passa només afecta la passa posterior (i no la passa actual).<br>Tenen el format següent:<br>**{macro}**=valor<br>**{macro}**=regex:<expressió regular><br>Per obtindre més informació, consulteu la descripció de la variable al nivell d'[escenari](web_monitoring#configuring_a_web_scenario).<br>Les variables es codifiquen automàticament a URL quan s'empren en camps de consulta o dades de formulari per a variables de publicació, però s'han de codificar manualment per URL quan s'empren a la publicació en brut o directament a l'URL.| |*Capçaleres*|Capçaleres HTTP personalitzades que s'enviaran quan es realitzi una petició.<br>Especificada com a parelles d'atribut i valor.<br>S'emprarà una capçalera definida en un nivell de passa per a aquesta passa concreta.<br>**Cal tindre en compte que la definició de la capçalera en un nivell de passa descarta automàticament totes les capçaleres definides anteriorment, excepte una capçalera predeterminada que s'assigna triant "User-Agent" d'una llista desplegable a nivell d'escenari.**<br>No obstant això, fins i tot la capçalera predeterminada "Agent d'usuari" es pot anul·lar especificant-la en un nivell de passa.<br>Per exemple, assignar el nom a una capçalera, però no establir cap valor anul·larà la capçalera predeterminada a nivell d'escenari.<br>S'admeten macros d'usuari i macros {HOST.\*}.<br>Això estableix l'opció cURL [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html). <br>S'admet l'especificació de capçaleres personalitzades *a partir de Zabbix 2.4*.| |*Seguir redireccions*|Marqueu la casella de selecció per seguir les redireccions HTTP.<br>Això estableix l'opció cURL [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html).| |*Mode de recuperació*|Trieu el mode de recuperació:<br>**Cos** - recupera només el cos de la resposta HTTP<br>**Capçaleres** - recupera només les capçaleres de la resposta HTTP<br>**Cos i capçaleres** - recupera el cos i les capçaleres de la resposta HTTP| |*Temps d'espera*|Zabbix no dedicarà més del temps establert a processar l'URL (d'un segon fins a un màxim d'1 hora). En realitat, aquest paràmetre defineix el temps màxim per fer la connexió a l'URL i el temps màxim per fer una petició HTTP. Per tant, Zabbix no dedicarà més de **2 x Temps d'espera** segons a la passa.<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), com ara 30s, 1m, 1h. [Les macros d'usuari](/manual/config/macros/user_macros) són compatibles.| |*Cadena obligatòria*|Patró obligatori d'expressió regular.<br>Llevat que el contingut recuperat (HTML) coincideixi amb el patró requerit, la passa fallarà. Si és buit, no es realitza cap comprovació de la cadena necessària.<br>Per exemple:<br>Pàgina d'inici de Zabbix<br>Benvingut.\*administrador<br>*Nota*: Les [expressions regulars](expressions_regulars) referenciades creades a la interfície Zabbix no s'admeten pas.<br>S'admeten macros d'usuari i {HOST.\*} [macros](/manual/appendix/macros/supported_by_location).| |*Codis d'estat obligatoris*|Llista de codis d'estat HTTP esperats. Si Zabbix obté un codi que no es troba a la llista, la passa fallarà.<br>Si és buit, no es fa cap comprovació dels codis d'estat.<br>Per exemple: 200,201,210-299<br>S'admeten macros d'usuari.| ::: noteclassic Qualsevol canvi a les passes de l'escenari web només es desarà quan tot l'escenari es desi. ::: Veieu també un [exemple de la vida real](/manual/web_monitoring/example) de com es poden configurar les passes de monitoratge web. #### 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). #### Configuració de les etiquetes La pestanya **Etiquetes** permet definir [etiquetes](/manual/config/tagging) a nivell d'escenari.  Les etiquetes s'empren per filtrar escenaris web i monitoratge d'[elements](/manual/web_monitoring/items) web. #### Configuring TLS Certificate signed by a certificate authority (CA) should be added to the default CA store. Alternatively a custom CA store location can be specified using the SSLCALocation configuration parameter; note that in this case the certificate directory must be prepared using the openssl c\_rehash utility, for example configure SSLCALocation and copy "ca.pem" inside that directory, then run the following command: c_rehash . #### Configuració TLS El certificat signat de l'autoritat de certificació (CA) s'ha d'afegir al magatzem de CA predeterminat. Alternativament, es pot especificar una ubicació de magatzem de CA personalitzada mitjançant el paràmetre de configuració SSLCALocation; tingueu en compte que, en aquest cas, el directori del certificat s'ha de preparar mitjançant la utilitat openssl c\_rehash, per exemple, configureu SSLCALocation i copieu "ca.pem" a aquest directori i, a continuació, executeu l'ordre següent: c_rehash . #### Configuring unixODBC ODBC configuration is done by editing the **odbcinst.ini** and **odbc.ini** files. To verify the configuration file location, type: odbcinst -j **odbcinst.ini** is used to list the installed ODBC database drivers: [mysql] Description = ODBC for MySQL Driver = /usr/lib/libmyodbc5.so Parameter details: |Attribute|Description| |--|--------| |*mysql*|Database driver name.| |*Description*|Database driver description.| |*Driver*|Database driver library location.| **odbc.ini** is used to define data sources: [test] Description = MySQL test database Driver = mysql Server = 127.0.0.1 User = root Password = Port = 3306 Database = zabbix Parameter details: |Attribute|Description| |--|--------| |*test*|Data source name (DSN).| |*Description*|Data source description.| |*Driver*|Database driver name - as specified in odbcinst.ini| |*Server*|Database server IP/DNS.| |*User*|Database user for connection.| |*Password*|Database user password.| |*Port*|Database connection port.| |*Database*|Database name.| To verify if ODBC connection is working successfully, a connection to database should be tested. That can be done with the **isql** utility (included in the unixODBC package): isql test +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ #### Configuració de unixODBC La configuració d'ODBC es fa editant els fitxers **odbcinst.ini** i **odbc.ini**. Per comprovar la ubicació del fitxer de configuració, escriviu: odbcinst -j **odbcinst.ini** s'empra per llistar els controladors de bases de dades ODBC instal·lats: [mysql] Description = ODBC for MySQL Driver = /usr/lib/libmyodbc5.so Detalls dels paràmetres: |Atribut|Descripció| |--|--------| |*mysql*|Nom del controlador de base de dades.| |*Description*|Descripció del controlador de la base de dades.| |*Driver*|Ubicació de la biblioteca de controladors de base de dades.| **odbc.ini** s'empra per definir fonts de dades: [test] Description = MySQL test database Driver = mysql Server = 127.0.0.1 User = root Password = Port = 3306 Database = zabbix Detalls dels paràmetres: |Atribut|Descripció| |--|--------| |*test*|Nom de la font de dades (DSN).| |*Description*|Descripció de la font de dades.| |*Driver*|Nom del controlador de base de dades, tal com s'especifica a odbcinst.ini| |*Server*|IP/DNS del servidor de base de dades.| |*User*|Usuari de la base de dades per la connexió.| |*Password*|Mot de pas de l'usuari de la base de dades.| |*Port*|Port de connexió a la base de dades.| |*Database*|Nom de la base de dades.| Per comprovar si la connexió ODBC funciona correctament, s'ha de provar una connexió de base de dades. Això es pot fer amb la utilitat **isql** (inclosa al paquet unixODBC): isql test +---------------------------------------+ | Connected! | | | | sql-statement | | help [tablename] | | quit | | | +---------------------------------------+ ##### 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/6.0/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it, add the `traphandle` option to snmptrapd configuration file (`snmptrapd.conf`), see [example](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.0/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf). ##### Configurant el servidor/proxy Zabbix Per llegir els traps, s'ha de configurar el servidor o el proxy Zabbix per iniciar el procés de traps SNMP i apuntar al fitxer de traps que és escrivint SNMPTT o un receptor de traps Bash/Perl. Per fer-ho, editeu el fitxer de configuració ([zabbix\_server.conf](/manual/appendix/config/zabbix_server) o [zabbix\_proxy.conf](/manual/appendix/config/zabbix_proxy)): ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ``` ::: notewarning Si s'empra el paràmetre systemd **[PrivateTmp](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=)**, és poc probable que aquest fitxer funcioni a */tmp*. ::: ##### Configurant el receptor de traps Bash Requisits: només snmptrapd. Es pot emprar un receptor de traps d'[script de bash](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.0/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) per passar traps al servidor Zabbix directament des d'snmptrapd. Per configurar-lo, afegiu l'opció `traphandle` al fitxer de configuració snmptrapd (`snmptrapd.conf`), veieu l'[exemple](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.2/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf). #### 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 *Configuration → 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 *Configuration → 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 *Configuration → 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 *Configuration → 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. ::: #### Gestió del xifrat de les connexions Les connexions a Zabbix poden emprar: - sense xifrat (per defecte) - [Xifrat basat en certificat RSA](/manual/encryption/using_certificates) - [Xifrat basat en PSK](/manual/encryption/using_pre_shared_keys) S'empren dos paràmetres importants per especificar el xifrat entre components Zabbix: - TLSConnect: especifica el xifrat que s'emprarà per a les connexions sortints (sense xifrar, PSK o certificat) - TLSAccept: especifica quins tipus de connexió es permeten per a connexions entrants (sense xifrar, PSK o certificat). Es poden especificar un o més valors. `TLSConnect` s'empra als fitxers de configuració per al proxy Zabbix (en mode actiu, només especifica les connexions del servidor) i l'agent Zabbix (per a comprovacions actives). A la interfície de Zabbix, l'equivalent de TLSConnect és el camp *Connexions a l'equip* a *Configuració → Equips → <un equip> → Pestanya Xifrat* i el camp *Connexions al proxy* a la pestanya *Administració → Proxys → <un proxy> → Xifrat* . Si el tipus de xifrat configurat per a la connexió falla, no es provarà cap altre tipus de xifrat. `TLSAccept` s'empra als fitxers de configuració per al proxy Zabbix (en mode passiu, només especifica connexions des del servidor) i l'agent Zabbix (per a comprovacions passives). A la interfície de Zabbix, l'equivalent de TLSAccept és el camp *Connexions des de l'equip* a la pestanya *Configuració → Equips → <un equip> → Xifrat* i el camp *Connexions des del proxy* a la pestanya *Administració → Proxys → <un proxy> → Xifrat* . Normalment, només configureu un tipus de xifrat per a connexions entrants. Però és possible que vulgueu canviar el tipus de xifrat, per exemple, de no xifrat a basat en certificats amb un temps d'inactivitat i una capacitat de retrocés mínims. Per aconseguir-ho: - Establiu `TLSAccept=unencrypted,cert` al fitxer de configuració de l'agent i reinicieu l'agent Zabbix - Proveu la connexió amb zabbix\_get amb l'agent mitjançant el certificat. Si funciona, podeu tornar a configurar el xifrat per a aquest agent a la interfície Zabbix a la pestanya *Configuració → Equips → <un equip> → Xifrat* configurant *Connexions a l'equip* a "Certificat". - Quan s'actualitza la memòria cau de configuració del servidor (i la configuració del proxy s'actualitza si l'equip és monitorat per el proxy), les connexions a aquest agent es xifraran - Si tot funciona com s'esperava, podeu establir `TLSAccept=cert` al fitxer de configuració de l'agent i reiniciar l'agent Zabbix. Ara l'agent només admetrà connexions basades en certificats xifrats. Les connexions no xifrades i basades en PSK seran rebutjades. De la mateixa manera, funciona al servidor i al proxy. Si a la interfície Zabbix, a la configuració de l'equip, *Connexions des de l'equip* s'estableix a "Certificat", només les connexions xifrades basades en certificats seran acceptades per l'agent (comprovacions actives) i el \_sender de zabbix (elements trapper). El més probable és que configureu les connexions entrants i sortints per emprar el mateix tipus de xifrat o cap xifrat. Però tècnicament és possible configurar-ho de manera asimètrica, com ara xifrat basat en certificats per a connexions entrants i encriptació basat en PSK per a connexions sortints. La configuració de xifrat per a cada equip es mostra a la interfície Zabbix, a *Configuració → Equips* a la columna *Xifrat de l'agent*. Per exemple: |Exemple|Connexions a l'equip|Connexions permeses des de l'equip|Connexions no permeses des de l'equip| |-------|--------------------|-----|---------------- ----| ||No xifrat|No xifrat|Xifrat, certificat i xifrat basat en PSK| ||Xifrat, basat en certificats|Xifrat, basat en certificats|No xifrat i xifrat amb PSK| ||Xifrat, basat en PSK|Xifrat, basat en PSK|Xifrat sense xifrar i xifrat en certificat| ||Xifrat, basat en PSK|Sense xifrat i xifrat amb PSK|Xifrat basat en certificat| ||Xifrat, basat en certificat|Sense xifrat, PSK o xifrat basat en certificat|\-| ::: noteimportant Les connexions no són xifrades per defecte. El xifrat s'ha de configurar per a cada equip i proxy individualment. ::: ### Connection options for Oracle plugin The Oracle plugin, supported for Zabbix agent 2, now allows to specify `as sysdba`, `as sysoper`, or `as sysasm` login option. The option can be appended either to the user item key parameter or to the plugin configuration parameter Plugins.Oracle.Sessions.<SessionName>.User in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). ### Opcions de connexió per al connector Oracle El connector d'Oracle, compatible amb l'agent Zabbix 2, permet especificar l'opció de connexió "com a sysdba", "com a sysoper" o "com a sysasm". L'opció es pot afegir al paràmetre clau de l'element d'usuari o al paràmetre de configuració del connector Plugins.Oracle.Sessions.<Nom de la sessió>.Usuari en el format `usuari com a sysdba` (l'opció d'inici de sessió no és sensible a les majúscules i minúscules; no ha de contindre espais). ### Connection set up 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>] ### Configuració de la connexió Zabbix suporta dos tipus d'identificadors de la connexió (mètodes de connexió): - Easy Connect - Net Service Name Els paràmetres de configuració de connexió per al servidor Zabbix i el proxy Zabbix poden definir-se a l'arxiu de configuració. Els paràmetres importants per al servidor i el proxy són *DBHost*, *DBUser*, *DBName* i *DBPassword*. Els mateixos paràmetres són importants per a la interfície Web : *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*. Zabbix empra la sintaxi de cadena de connexió següent: {DBUser/DBPassword[@<connect_identifier>]} <connect\_identifier> es pot especificar amb la forma "Net Nom del servei" o sota la forma "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.<br> Example: *Plugins.Memcached.KeepAlive* ::: #### Connexions Alguns connectors admeten la recollida de mètriques de diverses instàncies simultàniament. Es poden controlar tant les instàncies locals com les remotes. S'admeten tant les connexions de socket TCP com Unix. Es recomana configurar connectors per mantindre les connexions d'instància en estat obert. Els avantatges són la reducció de la congestió de la xarxa, la latència i l'ús de la CPU i la memòria a causa de menys connexions. La biblioteca del client s'encarrega d'això. ::: notetip Es pot determinar quant de temps han de romandre obertes les connexions no emprades mitjançant *Plugins.<PluginName>.KeepAlive*.<br> Exemple: *Plugins.Memcached.KeepAlive* ::: #### Consistency introduced in sha256 checksums of vfs.file.cksum item In earlier Zabbix versions, the Zabbix agent item [`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data) produced different sha256 sums for the same file depending on the platform (processor architecture) – sha256 sums on AIX, HP-UX (Itanium) and Solaris (SPARC) differed from those produced on Intel x86-64 platforms. The issue has now been fixed; however, after upgrading, monitoring sha256 sums of files on AIX, HP-UX, or Solaris SPARC may result in false positives of files having been modified. #### Afegida coherència a les sumes de control sha256 de l'element vfs.file.cksum En versions anteriors de Zabbix, l'element de l'agent Zabbix [`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#virtual-file-system-data) feia diferents sumes sha256 per al mateix fitxer en funció de la plataforma (arquitectura del processador) - les sumes sha256 a AIX, HP-UX (Itanium) i Solaris (SPARC) difereixen de les produïdes a les plataformes Intel x86-64. El problema s'ha corregit; tanmateix, després de l'actualització, el monitoratge de les sumes sha256 de fitxers a AIX, HP-UX o Solaris SPARC pot donar lloc a falsos positius dels fitxers modificats. #### Content conversion to UTF-8 HTTP agent items, web scenarios, web checks and JavaScript items have been improved to convert to UTF-8 from the character set specified in the HTTP header or HTTP meta tag. #### Conversió de contingut a UTF-8 Els elements de l'agent HTTP, els escenaris web, les comprovacions web i els elements JavaScript s'han millorat per convertir-los a UTF-8 a partir del conjunt de caràcters especificat a la capçalera HTTP o metaetiqueta HTTP. #### Copy an LLD rule to multiple hosts Copy an LLD rule to two hosts. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### copiar una regla LLD a diversos equips Copia una regla LLD a dos equips. Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.copy", "params": { "discoveryids": [ "27426" ], "hostids": [ "10196", "10197" ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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_and_editing_a_dashboard) - Click on the arrow next to the *Add* button and select the *Paste page* option #### Copiar/enganxar pàgines Les pàgines del tauler es poden copiar i enganxar, la qual cosa permet crear una pàgina nova amb les propietats d'una pàgina existent. Es poden enganxar des del mateix tauler o des d'un tauler diferent. Per enganxar una pàgina existent al tauler, primer copieu-la mitjançant el [menú de la pàgina](#page_menu):  Per enganxar la pàgina copiada: - Assegureu-vos que el tauler és en [mode d'edició](#viewing_and_editing_a_dashboard) - Feu clic a la fletxa al costat del botó *Afegir* i trieu l'opció *Enganxar pàgina* #### Copying/pasting widgets Dashboard widgets can be copied and pasted, allowing to create a new widget with the properties of an existing one. They can be copy-pasted within the same dashboard, or between dashboards opened in different tabs. A widget can be copied using the [widget menu](#widget_menu). To paste the widget: - click on the arrow next to the *Add* button and selecting the *Paste widget* option, when editing the dashboard - use the *Paste widget* option when adding a new widget by selecting some area in the dashboard (a widget must be copied first for the paste option to become available) A copied widget can be used to paste over an existing widget using the *Paste* option in the [widget menu](#widget_menu). #### Copiar/enganxar ginys widgets Els ginys del tauler de control es poden copiar i enganxar, la qual cosa permet crear un giny nou amb les propietats d'un giny existent. Es poden copiar i enganxar dins del mateix tauler o entre taulers oberts en diferents pestanyes. Es pot copiar un giny emprant el [menú del giny](#widget_menu). Per enganxar el giny: - feu clic a la fletxa que hi ha al costat del botó *Afegir* i trieu l'opció *Enganxar widget* quan editeu el tauler. - Empreu l'opció *Enganxar giny* quan afegiu un giny nou triat una àrea al tauler (primer s'ha de copiar un giny perquè l'opció d'enganxar sigui disponible) Un giny copiat es pot enganxar sobre un giny existent amb l'opció *Enganxar* al [menú del giny](#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 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. ##### Copiar els arxius PHP La interfície de Zabbix és escrit en PHP, de manera que per executar-lo cal un servidor web que admeti PHP. La instal·lació es fa senzillament copiant els fitxers PHP de frontends/php al directori HTML del servidor web. Les ubicacions habituals dels directoris HTML per als servidors web Apache inclouen: - /usr/local/apache2/htdocs (directori per defecte quan s'instal·la Apache des de la font) - /srv/www/htdocs (OpenSUSE, SLES) - /var/www/html (Debian, Ubuntu, Fedora, RHEL) Es recomana emprar el subdirectori en lloc de l'arrel HTML. Per crear un subdirectori i copiar-hi fitxers de l'interfície Zabbix, executeu les ordres següents substituint el directori actual: mkdir <htdocs>/zabbix cd ui cp -a. <htdocs>/zabbix Si teniu previst fer servir un idioma diferent de l'anglès, consulteu la [instal·lació d'idiomes d'interfície addicionals](/manual/appendix/install/locales) per obtindre instruccions. ### Copyright notice Zabbix documentation is NOT distributed under a GPL 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. ### Copyright La documentació de Zabbix NO es distribueix sota llicència GPL. L'ús de la documentació de Zabbix és subjecte a les condicions següents: Podeu crear una còpia impresa d'aquesta documentació només per al vostre ús personal. La conversió a altres formats és permesa sempre que el contingut real no es modifiqui o s'alteri de cap manera. No heu de publicar ni distribuir aquesta documentació en cap forma, mitjà o suport, tret que distribuïu la documentació d'una manera similar a com la distribueix Zabbix (és a dir, electrònicament per descarregar-la en un lloc web de Zabbix) o en una clau USB o mitjà similar, sempre que que la documentació es publiqui juntament amb el programari al mateix suport. Qualsevol altre ús, com ara qualsevol distribució de còpies impreses o l'ús d'aquesta documentació, total o parcialment, en una altra publicació, requereix el consentiment previ per escrit d'un representant autoritzat de Zabbix. Zabbix es reserva tots els drets sobre aquesta documentació no concedits expressament anteriorment. # 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. # Avís de drets d'autor La documentació de Zabbix NO es distribueix sota la llicència AGPL-3.0. L'ús de la documentació de Zabbix està subjecte als termes següents: Podeu crear una còpia impresa d'aquesta documentació únicament per al vostre ús personal. La conversió a altres formats està permesa sempre que el contingut real no s'alteri ni s'editi de cap manera. No publicareu ni distribuireu aquesta documentació de cap manera ni en cap mitjà, excepte si distribuïu la documentació d'una manera similar a com Zabbix la difon (és a dir, electrònicament per descarregar-la en un lloc web de Zabbix) o en un USB o mitjà similar, sempre que la documentació es difongui juntament amb el programari en el mateix mitjà. Qualsevol altre ús, com ara la difusió de còpies impreses o l'ús d'aquesta documentació, totalment o parcialment, en una altra publicació, requereix el consentiment previ per escrit d'un representant autoritzat de Zabbix. Zabbix es reserva tots els drets sobre aquesta documentació que no s'hagin concedit expressament anteriorment. # correlation.create # correlació.crear # 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**<br>(required)|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.| |tag|string|Event tag (old or new). Required when type of condition is: 0, 1, 4, 5.| |groupid|string|Host group ID. Required when type of condition is: 2.| |oldtag|string|Old event tag. Required when type of condition is: 3.| |newtag|string|Old event tag. Required when type of condition is: 3.| |value|string|Event tag (old or new) value. Required when type of condition is: 4, 5.| |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>Required when type of condition is: 2, 4, 5.| ::: 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| #### Condició del filtre de correlació L'objecte de condició de filtre de correlació defineix una condició específica que s'ha de verificar abans d'executar les operacions de correlació. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**type**<br>(obligatori)|integer|Tipus de condició.<br><br>Valors possibles:<br>0 - tag d'esdeveniment antic;<br>1 - tag d'esdeveniment nou;<br>2 - nou esdeveniment de grup d'equips;<br>3 - parell de tag d'esdeveniment;<br>4 - valor antic de tag d'esdeveniment;<br>5 - valor nou de tag d'esdeveniment.| |tag|string|Tag d'esdeveniment (antic o nou). Obligatori quan el tipus de condició sigui: 0, 1, 4, 5.| |groupid|string|ID del grup d'equips. Obligatori quan el tipus de condició sigui : 2.| |oldtag|string|Tag d'esdeveniment antic. Obligatori quan el tipus de condició sigui: 3.| |newtag|string|Tag d'esdeveniment nou. Obligatori quan el tipus de condició sigui: 3.| |value|string|Valor de tag d'esdeveniment (antic o nou). Obligatori quan el tipus de condició sigui: 4, 5.| |formulaid|string|ID únic arbitrari emprat per referenciar la condició a partir d'una expressió personalitzada. No pot pas contindre lletres majúscules. L'ID ha d'ésser definit per l'usuari quan es modifiquin les condicions de filtrat, però haurà de generar-se de nou quan hi hagi una petició posterior..| |operator|integer|Operador de condició.<br><br>Obligatori quan el tipus de condició sigui: 2, 4, 5.| ::: notetip Per entendre millor com fer anar els filtres amb diferents tipus d'expressions, veieu els exemples a les pàgines dels mètodes [correlation.get](get#retrieve_correlations) i [correlation.create](create#using_a_custom_expression_filter). ::: Les operacions i valors següents són suportats per cada tipus de condició. |Condició|Nom de condició|Operadors suportats|Valor esperat| |---------|--------------|-------------------|--------------| |2|Grup d'equips|=, <>|ID del grup d'equips.| |4|Valor de tag d'esdeveniment antic|=, <>, like, not like|string| |5|Valor de tag d'esdeveniment nou|=, <>, 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| |--|--|------| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |eval\_formula|string|*(readonly)* 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.| |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>Required for custom expression filters.| ### Filtre de correlació L'objecte de filtre de correlació defineix el conjunt de condicions que s'han de complir per dur a terme les operacions de correlacions configurades. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**evaltype**<br>(obligatori)|integer|Mètode d'avaluació de la condició del filtre.<br><br>Valors acceptats:<br>0 - i/o;<br>1 - i;<br>2 - o;<br>3 - expressió a mida.| |**conditions**<br>(obligatori)|array|Conjunt de condicions de filtre a emprar per filtrar els resultats.| |eval\_formula|string|*(només lectura)* Expressió generada que s'emprarà per avaluar les condicions de filtrat. L'expressió conté els ID que referencien les condicions de filtrat específiques per la seva `formulaid`. El valor d'`eval_formula` equival al valor de `formula` per als filtres amb expressions a mida.| |formula|string|Expressió definida per l'usuari a emprar per avaluar les condicions dels filtres amb una expressió personalitzada. L'expressió ha de contindre els IDs que referencien les condicions de filtrat específiques per a la seva `formulaid`. Els IDs emprats a l'expressió han de correspondre als definits per les condicions de filtrat: cap condició no pot pas restar sense ús o omesa.<br><br>Obligatori per els filtres d'expressió personalitzats.| # correlation.get # correlation.get # Correlation object The following objects are directly related to the `correlation` API. # Objecte de correlació Els següents objectes són relacionats amb l'API `correlation`. ### 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**<br>(required)|integer|Type of operation.<br><br>Possible values:<br>0 - close old events;<br>1 - close new event.| ### Operació de correlació L'objecte d'operació de correlació defineix una operació que es durà a terme quan la correlació s'executi. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**type**<br>(obligatori)|integer|Tipus d'operació.<br><br>Valors possibles:<br>0 - tancar esdeveniments antics;<br>1 - tancar un nou esdeveniment.| ### Correlation The correlation object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |correlationid|string|*(readonly)* ID of the correlation.| |**name**<br>(required)|string|Name of the correlation.| |description|string|Description of the correlation.| |status|integer|Whether the correlation is enabled or disabled.<br><br>Possible values are:<br>0 - *(default)* enabled;<br>1 - disabled.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Correlació L'objecte de correlació té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |correlationid|string|*(només lectura)* ID de la correlació.| |**name**<br>(obligatori)|string|Nom de la correlació.| |description|string|Descripció de la correlació.| |status|integer|Diu si la correlació és activa o desactivada.<br><br>Els valors possibles són:<br>0 - *(per defecte)* actiu;<br>1 - desactivat.| Veieu que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris o opcionals és diferent. # Correlation This class is designed to work with correlations. Object references: - [Correlation](/manual/api/reference/correlation/object#correlation) Available methods: - [correlation.create](/manual/api/reference/correlation/create) - creating new correlations - [correlation.delete](/manual/api/reference/correlation/delete) - deleting correlations - [correlation.get](/manual/api/reference/correlation/get) - retrieving correlations - [correlation.update](/manual/api/reference/correlation/update) - updating correlations # Correlació Aquesta classe és dissenyada per treballar amb correlacions. Referències d'objectes: - [Correlació](/manual/api/reference/correlation/object#correlation) Mètodes disponibles: - [correlation.create](/manual/api/reference/correlation/create) - crear noves correlacions - [correlation.delete](/manual/api/reference/correlation/delete) - esborrar correlacions - [correlation.get](/manual/api/reference/correlation/get) - recuperar correlacions - [correlation.update](/manual/api/reference/correlation/update) - actualitzar correlacions # correlation.update # correlation.update ### Cosmos DB monitoring The template *Azure by HTTP* now also works with Azure Cosmos DB for MongoDB. You can get this template: - In *Configuration → Templates* in new installations. - If you are upgrading from previous versions, you can download this template from Zabbix [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) or find it in the *zabbix/templates* directory of the downloaded latest Zabbix version. Then, while in *Configuration → Templates* you can import it manually into Zabbix. ### Monitoratge de Cosmos DB La plantilla *Azure by HTTP* ara també funciona amb Azure Cosmos DB per MongoDB. Podeu obtindre aquesta plantilla: - Per a noves instal·lacions, des de *Configuració → Plantilles*. - Si sou actualitzant des de versions prèvies, podeu descarregar la plantilla del [repositori Git de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http/README.md?at=refs%2Fheads%2Frelease%2F6.0) o cercar-les al directori *zabbix/templates* de la darrera versió de Zabbix descarregada. Ara, es poden importar manualment des de *Configuració → Plantilles*. ##### 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. ##### El recompte dels fils dels elements `proc.mem[]` i `proc.num[]` Els fils de kernel Linux es compten amb l'element `proc.num[]`, però no assenyalen pas la memòria de l'element `proc.mem[]`. Per exemple: $ 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. Però què passa si un procés d'usuari porta el mateix nom que un fil de kernel? S'assemblarà a això: $ 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[]` compta tant els fils de kernel com els processos d'usuari. `proc.mem[]` reporta la memòria només per als processos d'usuaris i compta la memòria del fil de kernel com si tingués estat 0. Aquesta és diferent del cas que hi ha aquí dalt, quan ZBX\_NOTSUPPORTED ha estat reportat. Mireu d'ésser prudents quan empreu els elements `proc.mem[]` i `proc.num[]` si el nom del programa correspon a un dels fils. Abans d'afegir els paràmetres als elements `proc.mem[]` i `proc.num[]`, podeu testar amb l'ajuda de l'element `proc.num[]` i la comanda `ps`. **CPU** Zabbix and especially Zabbix database may require significant CPU resources depending on number of monitored parameters and chosen database engine. **CPU** Zabbix i en particular la base de dades Zabbix poden requerir recursos de CPU importants en funció del nombre de paràmetres monitorats i del motor de base de dades triat. #### Create a custom script Create a custom script that will reboot a server. The script will require write access to the host and will display a configuration message before running in the frontend. Request: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server 1", "confirmation": "Are you sure you would like to reboot the server?", "scope": 2, "type": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### Crear un script a mida Crear un script a mida, que reiniciï un servidor. L'script necessitarà un accés d'escriptura a l'equip i mostrarà un missatge de configuració abans d'executar-se en pantalla. Petició: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "Reboot server", "command": "reboot server 1", "confirmation": "Are you sure you would like to reboot the server?", "scope": 2, "type": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "4" ] }, "id": 1 } ``` #### Create a discovery action Create a discovery action that will link discovered hosts to template "10001". Request: ```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" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "18" ] }, "id": 1 } ``` #### Crear una acció de descoberta Crea una acció que vincularà els equips descoberts amb la plantilla "10001". Petició: ```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" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "6" ] }, "id": 1 } ``` #### Crear una regla de descoberta Crear una regla de descoberta per trobar a la xarxa local màquines que corren l'agent de Zabbix. La regla ha d'emprar un únic test de descoberta d'agent de Zabbix sota el port 10050. Petició: ```json { "jsonrpc": "2.0", "method": "drule.create", "params": { "name": "Zabbix agent discovery", "iprange": "192.168.1.1-255", "dchecks": [ { "type": "9", "key_": "system.uname", "ports": "10050", "uniq": "0" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### Crear una regla de registre automàtic d'agent Crea una acció d'autoregistre que afegeix un equip al grup d'equips "2" quan el nom d'equip contingui "SRV" o trobi "AlmaLinux" a les metadades. Petició: ```json { "jsonrpc": "2.0", "method": "action.create", "params": { "name": "Registrar servidors Linux", "eventsource": "2", "filter": { "evaltype": "2", "conditions": [ { "conditiontype": "22", "operator": "2", "value": "SRV" }, { "conditiontype": "24", "operator": "2", "value": "AlmaLinux" } ] }, "operations": [ { "operationtype": "4", "opgroup": [ { "groupid": "2" } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "actionids": [ 19 ] }, "id": 1 } ``` #### 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: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Crear un mapa d'equips Crear un mapa amb dos equips i un enllaç entre ells. Tindre en compte que emprar els valors temporals "selementid1" i "selementid2" dins l'objecte vinculat del mapa pot fer referència els elements del mapa. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### Create an active proxy Create an action proxy "Active proxy" and assign a host to be monitored by it. Request: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Active proxy", "status": "5", "hosts": [ { "hostid": "10279" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### Crear un proxy actiu Crear un proxy actiu "Active proxy" i assignar-lo a un equip per monitorar-lo. Petició: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Active proxy", "status": "5", "hosts": [ { "hostid": "10279" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10280" ] }, "id": 1 } ``` #### Create an empty map Create a map with no elements. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "8" ] }, "id": 1 } ``` #### Crear un mapa buit Crear un mapa sense elements. Petició: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map", "width": 600, "height": 600 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Crear un nou tag d'esdeveniment de correlació Crear una correlació emprant el mètode d'avaluació `AND/OR` amb una condició i una operació. Per defecte, la correlació s'activarà. Petició: ```json { "jsonrpc": "2.0", "method": "correlation.create", "params": { "name": "new event tag correlation", "filter": { "evaltype": 0, "conditions": [ { "type": 1, "tag": "ok" } ] }, "operations": [ { "type": 0 } ] }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Create a new interface Create a secondary IP agent interface on host "30052." Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10050", }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Crear una nova interfície Crear una interfície d'agent IP secundària a l'equip "30052." Petició: ```json { "jsonrpc": "2.0", "method": "hostinterface.create", "params": { "hostid": "30052", "main": "0", "type": "1", "useip": "1", "ip": "127.0.0.1", "dns": "", "port": "10050", }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Create an icon map Create an icon map to display hosts of different types. Request: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Crear un mapa d'icones Crear un mapa d'iconese per mostrar els equips de diferent tipus. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2" ] }, "id": 1 } ``` #### Create an image Create a cloud icon. Request: ```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=" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### Crear una imatge Crear una icona de núvol. Petició: ```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=" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188" ] }, "id": 1 } ``` #### Create an interface with SNMP details Request: ```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}" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30063" ] }, "id": 1 } ``` #### Crear una interfícia am dealls SNMP Petició: ```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}" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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. Creeu un altre servei secundari de clúster Zabbix amb el nom "Node del servidor Zabbix 2". Definiu les etiquetes de problemes com: - Nom: component - Funcionament: Igual - Valor: HA node 2 Canvieu a la pestanya *Etiquetes* i afegiu una etiqueta de servei: `Servidor Zabbix:node 2`. Deseu el nou servei. #### 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: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "5" ] }, "id": 1 } ``` #### Crear un script SSH Crear un script SSH amb una autenticació de clau pública que pugui executar-se sobre un equip i tingui un menú contextual. Petició: ```json { "jsonrpc": "2.0", "method": "script.create", "params": { "name": "SSH script", "command": "my script command", "type": 2, "username": "John", "publickey": "pub.key", "privatekey": "priv.key", "password": "secret", "port": "12345", "scope": 2, "menu_path": "All scripts/SSH", "usrgrpid": "7", "groupid": "4" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Passive proxy", "status": "6", "interface": { "ip": "127.0.0.1", "dns": "", "useip": "1", "port": "10051" }, "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` #### Crear un proxy passiu Crear un proxy passiu "Passive proxy" i assignar-lo a dos equips a monitorar. Petició: ```json { "jsonrpc": "2.0", "method": "proxy.create", "params": { "host": "Passive proxy", "status": "6", "interface": { "ip": "127.0.0.1", "dns": "", "useip": "1", "port": "10051" }, "hosts": [ { "hostid": "10192" }, { "hostid": "10139" } ] }, "auth": "ab9638041ec6922cb14b07982b268f47", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10284" ] }, "id": 1 } ``` #### Create a token Create an enabled token that never expires and authenticates user of ID 2. Request: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "userid": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "status": "1", "expires_at": "1611238072" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "189" ] }, "id": 1 } ``` #### Crear un token Crear un token actiu que no caduqui mai i autentifiqui l'usuari amb ID "2". Petició: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "userid": "2" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "token.create", "params": { "name": "Your token", "status": "1", "expires_at": "1611238072" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```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/administration/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: ```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" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Crear una acció de trigger Crear una acció que serà executada quan un trigger de l'equip "10084"que tingui la paraula "memòria" al seu nom entri en estat de PROBLEMA. L'acció tindrà 4 operacions configurades. L'acció ha de, primerament, enviar un missatge a tots els usuaris del grup d'usuaris "7" per via del tipus de suport "1". Si l'esdeveniment no fos pas corregit en 30 minuts, llavors farà córrer l'[script](/manual/web_interface/frontend_sections/administration/scripts#configuring-a-global-script) "5" (script amb àmbit "Operació d'acció" a tots els equips del grup "2". Quan l'esdeveniment quedi resolt, una operació de recuperació notificarà a tots els usuaris que hagin rebut qualsevol dels missatges d'avís del problema. Si l'esdeveniment s'actualitza, es notificaran les operacions de reconeixement/actualització (amb un assumpte i missatge a mida) a tots els usuaris que hagin rebut qualsevol missatge veient el problema. Petició: ```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" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17" ] }, "id": 1 } ``` #### Create a trigger map Create a map with trigger element, which contains two triggers. Request: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### Crear un mapa de triggers Crear un mapa un element de trigger, que contenen dos triggers. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### Create a webhook script Create a webhook script that sends HTTP request to external service. Request: ```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}", "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### Crear un script de webhook Crear un script de webhook que envia una consulta HTTP a un servei extern. Petició: ```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}", "type": 5, "timeout": "40s", "parameters": [ { "name": "token", "value": "{$WEBHOOK.TOKEN}" }, { "name": "host", "value": "{HOST.HOST}" }, { "name": "v", "value": "2.2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3" ] }, "id": 1 } ``` #### Create HTTP agent item Create POST request method item with JSON response preprocessing. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url": "http://127.0.0.1/http.php", "query_fields": [ { "mode": "json" }, { "min": "10" }, { "max": "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": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Crear un element d'agent HTTP Crear un element de mètode de petició POST amb el pretractament de la resposta JSON. Petició: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "url": "http://127.0.0.1/http.php", "query_fields": [ { "mode": "json" }, { "min": "10" }, { "max": "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": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Create HTTP agent item prototype Create item prototype with URL using user macro, query fields and custom headers. Request: ```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": [ { "min": "10" }, { "max": "100" } ], "headers": { "X-Source": "api" }, "delay": "35" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### Crear un prototiups d'element d'agent HTTP agent Crear un prototip d'element amb una URL emprant una macro d'usuari, camps de cerca i capçaleres a mida. Petició: ```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": [ { "min": "10" }, { "max": "100" } ], "headers": { "X-Source": "api" }, "delay": "35" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28305" ] }, "id": 1 } ``` #### Create script item Create a simple data collection using a script item. Request: ```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 CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Crear un element d'script Crea una col·lecció senzilla e dades emprant un element d'script. Petició: ```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 CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Create script item prototype Create a simple data collection using a script item prototype. Request: ```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 CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Crear un prototipus d'element d'script Crear una col·lecció de dades simple emprant un prototipus d'element d'script. Petició: ```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 CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Create script LLD rule Create a simple data collection using a script LLD rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Script example", "key_": "custom.script.lldrule", "hostid": "12345", "type": 21, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### Creear una regla LLD script Crear una recollida simple de dades mercès a una regla LLD script. Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Script example", "key_": "custom.script.lldrule", "hostid": "12345", "type": 21, "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));", "parameters": [ { "name": "host", "value": "{HOST.CONN}" } ], "timeout": "6s", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "23865" ] }, "id": 3 } ``` #### 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: ```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": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "service" }, { "type": 0, "name": "tags.operator.0", "value": 1 }, { "type": 1, "name": "tags.value.0", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2" ] }, "id": 1 } ``` #### Creant un tauler Crea un tauler amb el nom de "El meu tauler" amb un giny de Problemes amb tags, i emprant dos tipus de comparticions (grups d'usuaris i usuari) en una única pàgina del tauler. Petició: ```json { "jsonrpc": "2.0", "method": "dashboard.create", "params": { "name": "El meu tauler", "display_period": 30, "auto_start": 1, "pages": [ { "widgets": [ { "type": "Problems", "x": 0, "y": 0, "width": 12, "height": 5, "view_mode": 0, "fields": [ { "type": 1, "name": "tags.tag.0", "value": "service" }, { "type": 0, "name": "tags.operator.0", "value": 1 }, { "type": 1, "name": "tags.value.0", "value": "zabbix_server" } ] } ] } ], "userGroups": [ { "usrgrpid": "7", "permission": 2 } ], "users": [ { "userid": "4", "permission": 3 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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. #### Créació d'un tauler És possible crear un tauler nou de dues maneres: - Feu clic a *Crear un tauler de control* quan es mostrin tots els taulers de control - Trieu *Crear nou* al menú d'accions, quan visualitzeu un únic tauler Primer se us demanarà que introduïu la configuració general del tauler:  |Paràmetre|Descripció| |--|---------| |*Propietari*|Trieu l'usuari del sistema que serà el propietari del tauler.| |*Nom*|Introduïu el nom del tauler.| |*Temps de visualització de la pàgina predeterminat*|Trieu quant de temps es mostrarà una pàgina del tauler abans de passar a la pàgina següent en una [presentació de diapositives](#creating_a_slideshow).| |*Inicia la presentació de diapositives automàticament*|Marqueu aquesta casella per executar una presentació de diapositives automàticament si existeixen diverses pàgines del tauler de control.| Quan feu clic a *Aplicar*, s'obre un tauler de control buit: {width="600"} Per omplir el tauler, podeu afegir ginys i pàgines. Feu clic al botó *Desar canvis* per desar el tauler. Si feu clic a *Cancel·lar*, el tauler no es crearà. #### Creating a global macro Create a global macro "{$SNMP\_COMMUNITY}" with value "public". Request: ```json { "jsonrpc": "2.0", "method": "usermacro.createglobal", "params": { "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "6" ] }, "id": 1 } ``` #### Crear una macro global Crear una macro global "{$SNMP\_COMMUNITY}" amb el valor "public". Petició: ```json { "jsonrpc": "2.0", "method": "usermacro.createglobal", "params": { "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "6" ] }, "id": 1 } ``` #### Creating a graph Create a graph with two items. Request: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Crear un gràfic Crear un gràfic amb dos elements. Petició: ```json { "jsonrpc": "2.0", "method": "graph.create", "params": { "name": "MySQL bandwidth", "width": 900, "height": 200, "gitems": [ { "itemid": "22828", "color": "00AA00" }, { "itemid": "22829", "color": "3333FF" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Creating a graph prototype Create a graph prototype with two items. Request: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652" ] }, "id": 1 } ``` #### Crear un prototipus de gràfic Crear un prototipus de gràfic amb dos elements. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Crear un equip Crear un equip anomenat "Linux server" amb una interfície IP i etiquetes; afegir-lo a un grup, vincular-lo a una plantilla i establir les adreces MAC dins de l'inventari d'equips. Petició: ```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" } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group Create a host group called "Linux servers". Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Linux servers" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Crear un grup d'equips Crea un grup d'equips anomenat "Servidors Linux". Petició: ```json { "jsonrpc": "2.0", "method": "hostgroup.create", "params": { "name": "Servidors Linux" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107819" ] }, "id": 1 } ``` #### Creating a host group ::: noteimportant Only Super Admin users can create host groups. ::: To create a host group in Zabbix frontend, do the following: - Go to: *Configuration → Host groups* - Click on *Create Group* in the upper right corner of the screen - Enter parameters of the group in the form  All mandatory input fields are marked with a red asterisk. |Parameter|Description| |---------|-----------| |*Group name*|Enter a unique host group name.<br>To create a nested host group, use the '/' forward slash separator, for example `Europe/Latvia/Riga/Zabbix servers`. You can create this group even if none of the three parent host groups (`Europe/Latvia/Riga`) exist. In this case creating these parent host groups is up to the user; they will not be created automatically.<br>Leading and trailing slashes, several slashes in a row are not allowed. Escaping of '/' is not supported.<br>Nested representation of host groups is supported since Zabbix 3.2.0.| |*Apply permissions and tag filters to all subgroups*|Checkbox is available to Super Admin users only and only when editing an existing host group.<br>Mark this checkbox and click on *Update* to apply the same level of permissions/tag filters to all nested host groups. For user groups that may have had differing [permissions](/manual/config/users_and_usergroups/usergroup#configuration) assigned to nested host groups, the permission level of the parent host group will be enforced on the nested groups.<br>This is a one-time option that is not saved in the database.<br>This option is supported since Zabbix 3.4.0.| **Permissions to nested host groups** - When creating a child host group to an existing parent host group, [user group](/manual/config/users_and_usergroups/usergroup) permissions to the child are inherited from the parent (for example, when creating `Riga/Zabbix servers` if `Riga` already exists) - When creating a parent host group to an existing child host group, no permissions to the parent are set (for example, when creating `Riga` if `Riga/Zabbix servers` already exists) #### Creació d'un grup d'equips ::: noteimportant Només els usuaris superadministradors poden crear grups d'equips. ::: Per crear un grup d'equips a la interfície Zabbix, feu el següent: - Vés a: *Configuració → Grups d'equips* - Feu clic a *Crea un grup* a la cantonada superior dreta de la pantalla - Introduïu els paràmetres del grup al formulari  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |---------|-----------| |*Nom del grup*|Introduïu un nom de grup d'equips únic.<br>Per crear un grup d'equips niuat, empreu el separador de barra inclinada '/', per exemple, `Europe/Latvia/Riga/Zabbix`. Podeu crear aquest grup encara que no existeixi cap dels tres grups d'equips principals ('Europe/Latvia/Riga'). En aquest cas, la creació d'aquests grups d'equips pare depèn de l'usuari; no es crearan automàticament.<br>No es permeten barres inclinades inicials i finals, ni barres inclinades múltiples consecutives. No s'admet l'escapament de '/'.<br>La representació niuada de grups d'equips és compatible des de Zabbix 3.2.0.| |*Aplica permisos i filtres d'etiquetes a tots els subgrups*|La casella de selecció només és disponible per a usuaris superadministradors i només quan editeu un grup d'equips existent.<br>Marqueu aquesta casella i feu clic a *Actualitzar* per aplicar el mateix nivell de permisos/etiqueta a tots els grups d'equips niuats. Per als grups d'usuaris que poden tindre diferents [permisos](/manual/config/users_and_usergroups/usergroup#configuration) assignats a grups d'equips niuats, el nivell de permís del grup d'equips principal s'aplicarà als grups niuats.<br>Aquesta és una opció única que no es desa a la base de dades.<br>Aquesta opció és compatible des de Zabbix 3.4.0.| **Permisos per a grups d'equips niuats** - Quan es crea un grup d'equips secundari en un grup d'equips principal existent, els permisos de [grup d'usuaris](/manual/config/users_and_usergroups/usergroup) del fill s'hereten del pare (per exemple, quan es creen "servidors Riga/Zabbix" si "Riga" ja existeix). - Quan es crea un grup d'equips principal per a un grup d'equips fill existent, no s'estableix cap permís per al pare (per exemple, quan es crea "Riga" si "servidors Riga/Zabbix" ja existeix). #### Creating a host inventory item Create a Zabbix agent item to populate the host's "OS" inventory field. Request: ```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 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 1 } ``` #### Crear un element d'inventari d'equip Crear un element d'agent Zabbix peremplenar el camp d'inventari "OS" de l'equip. Petició: ```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 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "usermacro.create", "params": { "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "11" ] }, "id": 1 } ``` #### Crear una macro d'equip Crear una macro d'equip "{$SNMP\_COMMUNITY}" amb el valor "public" a l'equip "10198". Petició: ```json { "jsonrpc": "2.0", "method": "usermacro.create", "params": { "hostid": "10198", "macro": "{$SNMP_COMMUNITY}", "value": "public" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "11" ] }, "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: ```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}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103" ] }, "id": 1 } ``` #### Crear un prototip d'equip Crear un prototip d'equip "{\#VM.NAME}" sobre la regla LLD "23542" amb un prototip de grup "{\#HV.NAME}", un parell d'etiquetes "Datacenter": "{\#DATACENTER.NAME}" i una interfície SNMPv2 personalitzada 127.0.0.1:161 amb la comunitat {$SNMP\_COMMUNITY}. Enllaçar-lo al grup d'equips "2". Petició: ```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}" } } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10590" ] }, "id": 1 } ``` #### Crear un equip amb xifrat PSK Crear un equip anomenat "equip PSK" amb el xifrat PSK configurat. Tingueu en compte que l'equip ha d'ésser [preconfigurat per emprar PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example). Petició: ```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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ``` #### Crear un equip amb una interfície SNMP Crear un equip anomenat "equip SNMP" amb una interfície SNMPv3 i els seus detalls. Petició: ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "equip SNMP", "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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "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": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3" ] }, "id": 1 } ``` #### Crear un manteniment Crear un manteniment amb un recull de dades per al grup d'equips amb ID "2" i amb els tags de problema **service:mysqld** i **error**. Ha d'ésser actiu des de 22.01.2013 fins a22.01.2014, entrar en vigor cada diumenge a les 6 de la tarda i durar una hora. Petició: ```json { "jsonrpc": "2.0", "method": "maintenance.create", "params": { "name": "Sunday maintenance", "active_since": 1358844540, "active_till": 1390466940, "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": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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* and *Full clone* buttons in the configuration form of an existing map to create a new map. Clicking on *Clone* will retain general layout attributes of the original map, but no elements. *Full clone* will retain both the general layout attributes and all elements of the original 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.<br>This parameter is supported starting with Zabbix 2.2.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*URLs*|URLs for each element type can be defined (with a label). 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'.| #### Crear un mapa Per crear un mapa, seguiu aquestes passes: - Aneu a *Monitoratge → Mapes* - Aneu a veure tots els mapes - Feu clic a *Crea una tarja* També podeu emprar els botons *Clonar* i *Clonar completament* al formulari de configuració del mapa existent per crear un mapa nou. Si feu clic a *Clonar*, es conservaran els atributs de disseny generals del mapa original, però sense elements. *El clon complet* conservarà tant els atributs de disseny general com tots els elements del mapa originals. La pestanya **Mapa** conté els atributs generals del mapa:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Atributs generals de la tarja: |Paràmetre|Descripció| |--|---------| |*Propietari*|Nom del propietari de la tarja.| |*Nom*|Nom únic del mapa.| |*Amplada*|Amplada del mapa en píxels.| |*Alçada*|Alçada del mapa en píxels.| |*Imatge de fons*|Empra la imatge de fons:<br>**Sense imatge** - sense imatge de fons (fons blanc)<br>**Imatge** - imatge seleccionada per emprar-la com a imatge de fons. No es fa cap escalat. Podeu emprar un mapa o qualsevol altra imatge per millorar el vostre mapa.| |*Mapeig automàtic d'icones*|Podeu configurar l'ús de l'assignació automàtica d'icones, configurat a *Administració → General → Mapes d'icones*. L'assignació d'icones permet assignar certes icones a determinats camps d'inventari de l'equip.| |*Icona destacada*|Si marqueu aquesta casella, els elements del mapa es ressaltaran.<br>Els elements amb un trigger actiu rebran un fons rodó, del mateix color que el trigger de més gravetat. A més, es mostrarà una línia verda gruixuda al voltant del cercle, si es reconeixen tots els problemes.<br>Els elements amb estat "desactivat" o "en manteniment" tindran un fons quadrat, gris i carbassa respectivament.<br>Veieu també: [visualització de mapes](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)| |*Marca els elements al canvi d'estat de trigger*|Un canvi d'estat de trigger recent (problema o resolució recent) es ressaltarà amb marcadors (triangles vermells cap a dins) als tres costats de la icona de l'element que no contenen l'etiqueta. Els marcadors es mostren durant 30 minuts.| |*Mostrar problemes*|Seleccioneu com es mostren els problemes amb un element del mapa:<br>**Detalleu el problema únic** - si només hi ha un problema, el nom del problema s'adjunta. En cas contrari, es mostra el nombre total de problemes.<br>**Nombre de problemes** - es mostra el nombre total de problemes<br>**Nombre de problemes i detall més crític** -: el nom del problema més crític i es mostra el nombre total de problemes.<br>El "Més crític" es determina en funció de la gravetat del problema i, si és igual, de l'identificador d'esdeveniment del problema (l'identificador superior o el problema es mostra més tard primer). Per a un *element del mapa trigger*, es basa en la gravetat del problema i, si és igual, la posició del trigger a la llista de trigger. En cas de diversos problemes del mateix trigger, es mostrarà el més recent.| |*Etiquetes avançades*|Si marqueu aquesta casella, podreu definir tipus d'etiquetes separats per a tipus d'elements separats.| |*Tipus d'etiqueta d'element del mapa*|Tipus d'etiqueta emprat per als elements del mapa:<br>**Etiqueta** - etiqueta de l'element del mapa<br>**Adreça IP** - Adreça IP<br>**Nom de l'element** - nom de l'element (p. ex., nom d'equip)<br>**Només estat** - només estat (BÉ o PROBLEMA)<br>** Res** - no es mostra cap etiqueta| |*Ubicació de l'etiqueta de l'element del mapa*|Ubicació de l'etiqueta en relació amb l'element del mapa:<br>**Sota** - a sota de l'element del mapa<br>**Esquerra** - esquerra<br>**Dreta** - dreta< br>**Sobre** - a sobre de l'element del mapa| |*Visualització del problema*|Mostra el nombre de problemes com a:<br>**Tots** - es mostrarà el nombre total de problemes<br>**Separats** - el nombre de problemes no reconeguts es mostrarà separat com un recompte del nombre total de problemes <br>**Només no reconegut** - només es mostrarà el nombre de problemes no reconeguts| |*Severitat mínima*|Els problemes per sota del nivell de gravetat mínima triada no es mostraran al mapa.<br>Per exemple, amb *Avís* triat, els canvis amb *Informació* i *Triggers de nivell no classificat* no es reflectiran al mapa. <br>Aquest paràmetre és compatible amb Zabbix 2.2.| |*Mostra els problemes esborrats*|Marqueu la casella per mostrar els problemes que, d'altra manera, s'esborrarien (no es mostren) a causa del manteniment d'equip.| |*URLs*|Es poden definir URL per a cada tipus d'element (amb una etiqueta). Aquests es mostraran com a enllaços quan un usuari faci clic a l'element en mode de visualització de mapa.<br>Les macros es poden emprar en els noms i els valors d'URL del mapa. Per obtindre una llista completa, veieu [macros compatibles](/manual/appendix/macros/supported_by_location) i cerqueu "noms i valors d'URL del mapa".| #### Creating an e-mail media type Create a new e-mail media type with a custom SMTP port and message templates. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "E-mail", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "content_type": "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}." } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### Crear un nou tipus de suport correu-e Crear un nou tipus de suport correu-e amb un port SMTP a mida i els models de missatge. Petició: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "0", "name": "E-mail", "smtp_server": "mail.example.com", "smtp_helo": "example.com", "smtp_email": "zabbix@example.com", "smtp_port": "587", "content_type": "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}." } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "7" ] }, "id": 1 } ``` #### Creating a new global regular expression. Request: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### Crear una nova expressió regular global. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16" ] }, "id": 1 } ``` #### Creating a new item Let's create a new [item](/manual/api/reference/item/object) on "Zabbix server" using the data we've obtained from the previous `host.get` request. This can be done by using the [item.create](/manual/api/reference/item/create) method: ```json { "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 }, "auth": "0424bd59b807674191e7d77572075f33", "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. ::: #### Creació d'un element nou Creem un nou [element](/manual/api/reference/item/object) a l'equip "Servidor Zabbix" emprant les dades que vam obtindre de la petició `host.get` anterior. Això es pot fer mitjançant el mètode [item.create](/manual/api/reference/item/create): ```json { "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 }, "auth": "0424bd59b807674191e7d77572075f33", "id": 3 } ``` Una resposta correcta contindrà l'ID de l'element que s'acaba de crear, que es pot emprar per fer referència a l'element en peticions posteriors: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24759" ] }, "id": 3 } ``` ::: notetip El mètode `item.create` i altres mètodes de creació també poden admetre matrius d'objectes i crear diversos elements amb una única crida a l'API. ::: #### Creating an item Create a numeric Zabbix agent item with 2 item tags to monitor free disk space on host with ID "30074". Request: ```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": "Disk usage" }, { "tag": "Equipment", "value": "Workstation" } ], "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "24758" ] }, "id": 1 } ``` #### Crear un element Crear un element d'agent Zabbix numèric amb dues etiquetes d'element per monitorar l'espai en disc lliure de l'equip amb ID "30074". Petició: ```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": "Disc usage" }, { "tag": "Equipment", "value": "Workstation" } ], "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27666" ] }, "id": 1 } ``` #### Crear un prototip d'element Crear un prototip d'element per monitorar l'espai lliure de disc d'un sistema d'arxius descobert. Els elements trobats han de tindre els elements numèrics de l'agent de Zabbix actualitzats cada 30 segons. Petició: ```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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Crear un prototip d'elememt amb preprocessament Crear un element emprant el canvi per segon i un multiplicador a mida com a segona passa. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Creating an item with preprocessing Create an item using custom multiplier. Request: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "11312", "type": 4, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "units": "uptime", "interfaceid": "1156", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44210" ] }, "id": 1 } ``` #### Crear un element nou amb preprocessament Crear un element emprant un multiplicador a mida. Petició: ```json { "jsonrpc": "2.0", "method": "item.create", "params": { "name": "Device uptime", "key_": "sysUpTime", "hostid": "11312", "type": 4, "snmp_oid": "SNMPv2-MIB::sysUpTime.0", "value_type": 1, "delay": "60s", "units": "uptime", "interfaceid": "1156", "preprocessing": [ { "type": 1, "params": "0.01", "error_handler": 1, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Crear una regla LLD Crear una regla de descoberta de baix nivell per descobrir els sistemes d'arxius muntats. Els objectes descoberts seran actualitzats cada 30 segons. Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Mounted filesystem discovery", "key_": "vfs.fs.discovery", "hostid": "10197", "type": 0, "interfaceid": "112", "delay": "30s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an LLD rule with macro paths Request: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Crear una regla LLD amb rutes de macros Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "27665" ] }, "id": 1 } ``` #### Creating an LLD rule with overrides Request: ```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" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "30980" ] }, "id": 1 } ``` #### Crear una regla LLD amb reemplaçaments Petició: ```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" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "30980" ] }, "id": 1 } ``` #### Creating an LLD rule with preprocessing Request: ```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": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Crear una regla LLD amb preprocessament Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.create", "params": { "name": "Discovery rule with preprocessing", "key_": "lld.with.preprocessing", "hostid": "10001", "ruleid": "27665", "type": 0, "value_type": 3, "delay": "60s", "interfaceid": "1155", "preprocessing": [ { "type": 20, "params": "20", "error_handler": 0, "error_handler_params": "" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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%. #### Creació d'un SLA Cal crear una entrada d'SLA: * per fer un seguiment de la disponibilitat de serveis relacionats amb el motor SQL; * amb horari personalitzat tots els dies de la setmana excepte la darrera hora de dissabte; * amb data efectiva el darrer dia de l'any 2022; * amb 1 hora i 15 minuts d'inactivitat programada a partir de la mitjanit del 4 de juliol; * S'habilitarà el càlcul setmanal d'informes de SLA; * SLO mínim acceptable serà del 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"} ##### Crear aplicació 1\. Inicieu sessió al centre d'administració de Microsoft Entra, a [Microsoft Entra ID](https://entra.microsoft.com). Amb finalitats de prova, podeu crear un compte de prova de franc a Microsoft Entra ID. 2\. Al centre d'administració de Microsoft Entra, trieu *Aplicacions* -> *Aplicacions empresarials* -> *Afegir una aplicació nova* -> *Creeu la vostra pròpia aplicació*. 3\. Afegiu el nom de la vostra aplicació i trieu l'opció *Integra qualsevol altra aplicació...*. Després d'això, feu clic a *Crear*. {width="550"} #### 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 } ``` #### Creació d'un proxy amb xifrat basat en certificats Creeu un proxy actiu amb [encriptació] basada en certificats (/manual/encryption/using_certificates#zabbix-proxy). El proxy és configurat per controlar l'equip "10785". [Sol·licitud](/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 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "role.create", "params": { "name": "Operator", "type": "1", "rules": { "ui": [ { "name": "monitoring.hosts", "status": "0" }, { "name": "monitoring.maps", "status": "0" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Crear un rol Crear un rol amb el tipus "Usuari" i prohibir l'accés a dos elements de la interfície d'usuari. Petició: ```json { "jsonrpc": "2.0", "method": "role.create", "params": { "name": "Operator", "type": "1", "rules": { "ui": [ { "name": "monitoring.hosts", "status": "0" }, { "name": "monitoring.maps", "status": "0" } ] } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Crear un informe planificat Crear un informe setmanal que es prepararà per la setmana anterior tots els dies de dilluns a divendres a les 1 del migdia des del 01.04.2021 fins a 31.08.2021. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n", "maxattempts": "5", "attempt_interval": "11s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "8" ] }, "id": 1 } ``` #### Crear un tipus de suport de script Crear un nou tipus de suport de script amb un valor personalitzat per al nombre d'intents i l'interval entre elles. Petició: ```json { "jsonrpc": "2.0", "method": "mediatype.create", "params": { "type": "1", "name": "Push notifications", "exec_path": "push-notification.sh", "exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n", "maxattempts": "5", "attempt_interval": "11s" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "service.create", "params": { "name": "Server 1", "algorithm": 1, "sortorder": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "5" ] }, "id": 1 } ``` #### Crear un servei Crear un servei que passarà a l'estat de problema si, com a mínim, un procés fill té un problema. Petició: ```json { "jsonrpc": "2.0", "method": "service.create", "params": { "name": "Server 1", "algorithm": 1, "sortorder": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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_and_editing_a_dashboard) (where only the page content is shown): -  - stop slideshow -  - start slideshow -  - go back one page -  - go to the next page #### Crear una presentació Una presentació de diapositives s'executarà automàticament si el tauler de control té dues o més pàgines (veieu [Afegir pàgines](#adding_pages)) i si es compleix una de les condicions següents: - L'opció *Engegar la presentació de diapositives automàticament* és marcada a les propietats del tauler - L'URL del tauler conté un paràmetre `slideshow=1` Les pàgines giren als intervals especificats a les propietats del tauler i de les pàgines individuals. Feu clic a: - *Aturar la presentació de diapositives* - per aturar la presentació de diapositives - *Iniciar la presentació de diapositives* - per iniciar la presentació de diapositives  Les ordres relacionades amb la presentació de diapositives també són disponibles al [mode quiosc](#viewing_and_editing_a_dashboard) (on només es mostra el contingut de la pàgina): -  - atura la presentació de diapositives -  - inicia la presentació de diapositives -  - torna una pàgina enrere -  - avança a la pàgina següent #### Creating a task Create a task `check now` for two items. One is an item, the other is a low-level discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": "6", "request": { "itemid": "10093" } } ], "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` Create a task `diagnostic information` task. Request: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxy_hostid": 0 } ], "auth": "700ca65537074ec963db7efabda78259", "id": 2 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 2 } ``` #### Crear una tasca Crear una tasca `check now` per a dos elements. Un es un element, l'altre és una regla de descoberta de baix nivell. Petició: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 6, "request": { "itemid": "10092" } }, { "type": "6", "request": { "itemid": "10093" } } ], "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "1", "2" ] }, "id": 1 } ``` Crear una tasca `diagnostic information`. Petició: ```json { "jsonrpc": "2.0", "method": "task.create", "params": [ { "type": 1, "request": { "alerting": { "stats": [ "alerts" ], "top": { "media.alerts": 10 } }, "lld": { "stats": "extend", "top": { "values": 5 } } }, "proxy_hostid": 0 } ], "auth": "700ca65537074ec963db7efabda78259", "id": 2 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "taskids": [ "3" ] }, "id": 2 } ``` #### Creating a template Create a template with tags and link two templates to this template. Request: ```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}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "11117" ] }, "id": 1 } ``` #### Crear una plantilla Crear una plantilla amb etiquetes, i enllaçar-hi dues plantilles a la plantilla. Petició: ```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}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### Crear una plantilla de tauler Crear una plantilla de tauler anomenada “Graphs” amb un giny gràfic, a una sola pàgina de tauler. Petició: ```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" } ] } ] } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "32" ] }, "id": 1 } ``` #### Creating a template To create a template, do the following: - Go to *Configuration → Templates* - Click on *Create template* - 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. Alphanumerics, spaces, dots, dashes, and underscores are allowed. However, leading and trailing spaces are disallowed.| |*Visible name*|If you set this name, it will be the one visible in lists, maps, etc.| |*Templates*|Link one or more "nested" templates to this template. All entities (items, triggers, graphs, etc.) will be inherited from the linked templates.<br>To link a new template, start typing the template name in the *Templates* field. A list of matching templates will appear; scroll down to select. Alternatively, you may click on *Select* next to the *Templates* field; then, first select the host group by clicking on *Select* next to the *Host groups* field; mark the checkbox in front of one or multiple templates from the list displayed below; click on *Select*. The template(s) that are selected in the *Templates* field will be linked to the template when the template configuration form 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 items, triggers, and graphs<br>*Unlink and clear* - unlink the template and remove all its items, triggers, and graphs| |*Groups*|Host/template groups the template belongs to.| |*Description*|Enter the template description.| 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.  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.  You may also view here macros from linked templates and global macros if you select the *Inherited and template macros* option. That is where all defined user macros for the template are displayed with the value they resolve to as well as their origin.  For convenience, links to respective templates and global macro configuration are provided. It is also possible to edit a nested template/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, including the entities (items, triggers, etc) inherited from linked templates.| ||Create another template based on the properties of the current template, including the entities (items, triggers, etc) both inherited from linked templates and directly attached to the current template.| ||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.| With a template created, it is time to add some entities to it. ::: noteimportant Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item. ::: #### Crear una plantilla Per crear una plantilla, feu el següent: - Aneu a *Configuració → Plantilles* - Feu clic a *Crear plantilla* - Editeu els atributs de la plantilla La pestanya **Plantilla** conté atributs generals de plantilla. {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Atributs de la plantilla: |Paràmetre|Descripció| |--|---------| |*Nom de la plantilla*|Nom únic de la plantilla. Es permet l'alfabet alfanumèric, els espais, els punts, els guions i els guions baixos. Tanmateix, no es permeten els espais inicials i posteriors.| |*Nom visible*|Si establiu aquest nom, serà el visible a les llistes, mapes, etc.| |*Plantilles*|Enllaça una o més plantilles heretades a aquesta plantilla. Totes les entitats (elements, triggers, gràfics, etc.) s'heretaran de les plantilles enllaçades.<br>Per enllaçar una plantilla nova, comenceu a escriure el nom de la plantilla al camp *Plantilles*. Apareixerà un reguitzell de plantilles coincidents; desplaça't cap avall per triar. Alternativament, podeu fer clic a *Triar* al costat del camp *Plantilles*; després, primer trieu el grup d'equip fent clic a *Triar* al costat del camp *Grups d'equips*; marqueu la casella de selecció davant d'una o diverses plantilles de la llista que es mostra tot seguit; feu clic a *Triar*. Les plantilles triades al camp *Plantilles* s'enllaçaran a la plantilla quan es desi o s'actualitzi el formulari de configuració de la plantilla.<br>Per desenllaçar una plantilla, empreu una de les dues opcions del bloc *Plantilles*. :<br>*Desenllaça* - desenllaça la plantilla, però conserva els seus elements, triggers i gràfics<br>*Desenllaça i esborra*: desenllaça la plantilla i esborra tots els seus elements, triggers i gràfics| |*Grups*|Equips/grups de plantilles als quals pertany la plantilla.| |*Descripció*|Introduïu la descripció de la plantilla.| La pestanya **Etiquetes** us permet definir [etiquetes] a nivell de plantilla (/manual/config/tagging). Tots els problemes dels equips vinculats a aquesta plantilla s'etiquetaran amb els valors introduïts aquí.  Les macros d'usuari i les macros {INVENTORY.\*}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} són compatibles amb les etiquetes. La pestanya **Macros** us permet definir les [macros d'usuari](/manual/config/macros/user_macros) a nivell de plantilla com a parelles nom-valor. Tingueu en compte que els valors de macro es poden mantindre com a text sense format, text secret o secret de Vault. També s'admet afegir una descripció.  També podeu veure aquí macros de plantilles enllaçades i macros globals si trieu l'opció *Macros heretades i de plantilla*. Aquí és on es mostren totes les macros d'usuari definides per a la plantilla amb el valor al qual es resolen, així com el seu origen.  Per comoditat, es proporcionen enllaços a les plantilles respectives i la configuració global de macros. També és possible editar una plantilla heretada/macro global a nivell de plantilla, creant una còpia de la macro a la plantilla. La pestanya **Mapa de valors** permet configurar una representació amigable per a les persones de les dades d'elements al [mapatge de valors](/manual/config/items/mapping). Botons: | | | |--|---------| ||Afegir la plantilla. La plantilla afegida hauria d'aparèixer a la llista.| ||Actualitzar les propietats d'una plantilla existent.| ||Crear una altra plantilla basada en les propietats de la plantilla actual, incloses les entitats (elements, triggers, etc) heretades de plantilles enllaçades.| ||Crear una altra plantilla basada en les propietats de la plantilla actual, incloses les entitats (elements, triggers, etc.) tant heretades de plantilles enllaçades com directament adjuntes a la plantilla actual.| ||Suprimir la plantilla; les entitats de la plantilla (elements, triggers, etc.) romanen amb els equips enllaçats.| ||Suprimir la plantilla i totes les seves entitats dels equips enllaçats.| ||Cancel·lar l'edició de les propietats de la plantilla.| Amb una plantilla creada, és hora d'afegir-hi algunes entitats. ::: nota important Primer s'han d'afegir elements a una plantilla. No es poden afegir triggers i gràfics sense l'element corresponent. ::: #### Creating a trigger Create a trigger with a single trigger dependency. Request: ```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 status", "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": "" } ] } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 1 } ``` #### Crear trigger Crear un trigger amb una sola dependència de trigger. Petició: ```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 status", "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": "" } ] } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17372" ] }, "id": 1 } ``` #### Crear un prototip de trigger Crear un prototip de trigger per detectar quan un sistema d'arxius disposi de menys del 20% d'espai lliure de disc. Petició: ```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}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Crear un usuari Crear un usuari nou, afegir-lo a un grup d'usuaris i crear un nou suport per a ell. Petició: ```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" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "userids": [ "12" ] }, "id": 1 } ``` #### Creating a user group Create a user group, which denies access to host group "2", and add a user to it. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "rights": { "permission": 0, "id": "2" }, "users": [ {"userid": "12"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20" ] }, "id": 1 } ``` #### Crear un grup d'usuaris Crear un grup d'usuaris que no permeti pas l'accés al grup d'equips "2", i afegir-hi un usuari. Petició: ```json { "jsonrpc": "2.0", "method": "usergroup.create", "params": { "name": "Operation managers", "rights": { "permission": 0, "id": "2" }, "users": [ {"userid": "12"} ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20" ] }, "id": 1 } ``` #### Creating a value map Create one value map with two mappings. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Service state", "mappings": [ { "type": "1", "value": "1", "newvalue": "Up" }, { "type": "5", "newvalue": "Down" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` #### Crear un mapa de valors Crear un mapa de valors amb dues correspondències. Petició: ```json { "jsonrpc": "2.0", "method": "valuemap.create", "params": { "hostid": "50009", "name": "Service state", "mappings": [ { "type": "1", "value": "1", "newvalue": "Up" }, { "type": "5", "newvalue": "Down" } ] }, "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1" ] }, "id": 1 } ``` #### Creating a webhook media type Create a new webhook media type. Request: ```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>" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "9" ] }, "id": 1 } ``` #### Crear un nou tipus de suport webhook Crear un nou tipus de suport webhook. Petició: ```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>" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Crear un escenari Web Crea un escenari Web monitorar la pàgina d'inici d'una empresa. L'escenari constarà de dues passes: verificar la pàgina d'inici i la pàgina "Quant a", i garantirà que reenvien el codi d'estat HTTP 200. Petició: ```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 / Quant a", "url": "http://example.com/quanta", "status_codes": "200", "no": 2 } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` ### Creating custom LLD rules It is also possible to create a completely custom LLD rule, discovering any type of entities - for example, databases on a database server. To do so, a custom item should be created that returns JSON, specifying found objects and optionally - some properties of them. The amount of macros per entity is not limited - while the built-in discovery rules return either one or two macros (for example, two for filesystem discovery), it is possible to return more. The required JSON 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"), but we still need to discover file systems. Here is a simple Perl script for Linux that discovers mounted file systems and outputs JSON, which includes both file system name and type. One way to use it would be as a 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 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 512 KB. For more details, see [data limits for LLD return values](/manual/discovery/low_level_discovery/notes#data_limits_for_return_values). ### Creació de regles LLD personalitzades També és possible crear una regla LLD completament personalitzada, descobrint qualsevol tipus d'entitats, per exemple, bases de dades en un servidor de bases de dades. Per fer-ho, s'ha de crear un element personalitzat que retorni JSON, especificant els objectes trobats i, opcionalment, algunes de les seves propietats. El nombre de macros per entitat no és limitat; encara que les regles de descoberta integrades retornen una o dues macros (per exemple, dues per a la descoberta del sistema de fitxers), és possible tornar-ne més. El format JSON requerit s'il·lustra millor amb un exemple. Suposem que som executant un antic agent Zabbix 1.8 (que no admet "vfs.fs.discovery"), però encara hem de descobrir sistemes de fitxers. Aquí hi ha un senzill script Perl per a Linux que descobreix sistemes de fitxers muntats i genera un JSON, que inclou tant el nom com el tipus del sistema de fitxers. Una manera d'emprar-lo seria com a UserParameter amb la clau "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 Els símbols permesos com a noms de macro LLD són **0-9** , **A-Z** , **\_** , **.**\ \ Les lletres minúscules no s'admeten als noms. ::: A continuació es mostra un exemple de la seva sortida (reformatat per a més claredat). El JSON per a comprovacions de descoberta personalitzades hauria de seguir el mateix 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" } ] ``` A l'exemple anterior, les claus han de coincidir amb els noms de macro LLD emprats als prototips, l'alternativa és extreure els valors de macro LLD mitjançant JSONPath `{#FSNAME}` → `$.fsname` i `{#FSTYPE} ` → `$.fstype` d'aquesta manera, fent possible aquest script: ``` {.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"; ``` A continuació es mostra un exemple de la seva sortida (reformatat per a més claredat). El JSON per a comprovacions de descoberta personalitzades hauria de seguir el mateix 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" } ] ``` Aleshores, al camp "Filtre" de la regla de descoberta, podríem especificar "{\#FSTYPE}" com a macro i "rootfs|ext3" com a expressió regular. :::noteclassic No cal que empreu els noms de macro FSNAME/FSTYPE amb regles LLD personalitzades, podeu emprar els noms que vulgueu. En cas que s'empri JSONPath, la línia LLD serà un element de matriu que pot ésser un objecte, però també pot ésser una altra matriu o un valor. ::: Tingueu en compte que si feu servir un paràmetre d'usuari, el valor de retorn és limitat a 512 Ko. Per obtindre més informació, consulteu els [límits de dades per als valors de retorn d'LLD](/manual/discovery/low_level_discovery/notes#data_limits_for_return_values). ##### Creating database [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy. Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name. ##### Creació de bases de dades [Creeu](/manual/appendix/install/db_scripts) una base de dades diferent per al proxy Zabbix. El servidor Zabbix i el proxy Zabbix no poden emprar la mateixa base de dades. Si són instal·lats al mateix equip, la base de dades proxy ha de tindre un nom diferent. ##### Creating database [Create](/manual/appendix/install/db_scripts) a separate database for Zabbix proxy. Zabbix server and Zabbix proxy cannot use the same database. If they are installed on the same host, the proxy database must have a different name. ##### Creació de bases de dades [Creeu](/manual/appendix/install/db_scripts) una base de dades diferent per al proxy Zabbix. El servidor Zabbix i el proxy Zabbix no poden emprar la mateixa base de dades. Si són instal·lats al mateix equip, la base de dades proxy ha de tindre un nom diferent. #### Creating database For Zabbix [server](/manual/concepts/server) and [proxy](/manual/concepts/proxy) daemons a database is required. It is not needed to run Zabbix [agent](/manual/concepts/agent). ::: notewarning Separate databases are needed for Zabbix server and Zabbix proxy; they cannot use the same database. Therefore, if they are installed on the same host, their databases must be created with different names! ::: Create the database using the provided instructions for [MySQL](/manual/appendix/install/db_scripts#mysql) or [PostgreSQL](/manual/appendix/install/db_scripts#postgresql). #### Creació de base de dades Per als dimonis Zabbix [servidor](/manual/concepts/server) i [proxy](/manual/concepts/proxy) cal una base de dades. No cal executar l'[agent](/manual/concepts/agent) Zabbix. ::: notadvert Calen bases de dades separades per al servidor Zabbix i el proxy Zabbix; no poden emprar la mateixa base de dades. Per tant, si són instal·lats al mateix equip, les seves bases de dades s'han de crear amb noms diferents! ::: Creeu la base de dades seguint les instruccions proporcionades per a [MySQL](/manual/appendix/install/db_scripts#mysql) o [PostgreSQL](/manual/appendix/install/db_scripts#postgresql). #### 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: ```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 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44211" ] }, "id": 1 } ``` #### Crear un element dependent Crear un element dependent per l'element principal amb ID 24759. Només es permeten les dependències sobre el mateix equip. Per tant, l'element principal i l'element dependent hauran de tindre el mateix hostid. Petició: ```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 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```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 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### Crear un prototipus d'element dependent Crea un prototipus d'element dependent pel prototipus d'element principal amb l'ID 44211. Només són permeses les dependències del mateix equip (plantilla / regla de descoberta). Per tant, l'element principal i el dependent hauran de tindre els mateixos ID d'equip i de regla. Petició: ```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 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "44212" ] }, "id": 1 } ``` #### Creating hosts from Monitoring It is now also possible to create new hosts from *Monitoring* → *[Hosts](/manual/web_interface/frontend_sections/monitoring/hosts)*.  The *Create host* button is available for Admin and Super Admin users. ##### Creació d'equips des de Monitoratge Es poden crear nous equips des de *Monitoratge* → *[Equips](/manual/web_interface/frontend_sections/monitoring/hosts)*.  El botó *Crear equip* és disponible per als usuaris administradors i superadministradors. #### Creating host subgroups A host subgroup (or nested host group) is a child of the parent host group that contains it. Nested representation of host groups is supported since Zabbix 3.2.0. 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. #### Creació de subgrups d'equips Un subgrup d'equips (o grup d'equips heretat) és un fill del grup d'equips principal que el conté. La representació niuada dels grups d'equips s'admet des de Zabbix 3.2.0. Es crea un subgrup emprant la barra inclinada '/' al camp d'entrada del nom del grup per indicar la seva relació amb els grups pare. Per exemple: - introduint `Europa/Letònia` es crea el subgrup `Europa/Letònia` del grup principal `Europa`. - introduir `Servers Europe/Latvia/Riga/Zabbix` crea el subgrup respectiu dins dels grups pares heretat `Europa`, `Europa/Letònia`, `Europa/Latvia/Riga`. Quan es crea un subgrup, no es permet l'ús de barres inclinades inicials o posteriors, o diverses barres inclinades seguides. L'escapament de "/" no és compatible. No cal crear cap grup d'equips pare abans de crear un subgrup. Podeu triar si voleu començar creant un subgrup (per exemple, "Europa/Letònia") o qualsevol grup d'equips pare (en el nostre exemple, "Europa"). Si comenceu creant un subgrup, els grups d'equips principal **no** es crearan automàticament. #### Creating interfaces Create an interface on two hosts. Request: ```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 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Crear interfície Crear una interfície a dos equips. Petició: ```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 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30069", "30070" ] }, "id": 1 } ``` #### Creating multiple triggers So if create methods accept arrays, we can add multiple [triggers](/manual/api/reference/trigger/object) like so: ```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", }, { "description": "Too many processes on {HOST.NAME}", "expression": "avg(/Linux server/proc.num[],5m)>300", } ], "auth": "0424bd59b807674191e7d77572075f33", "id": 4 } ``` A successful response will contain the IDs of the newly created triggers: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` #### Crear múltiples triggers Si els mètodes de creació admeten matrius, podem afegir diversos [triggers](/manual/api/reference/trigger/object), com ara: ```json { "jsonrpc": "2.0", "method": "trigger.create", "params": [ { "description": "La càrrega del processador és massa alta a {HOST.NAME}", "expression": "last(/Linux server/system.cpu.load[percpu,avg1])>5", }, { "description": "Massa processos a {HOST.NAME}", "expression": "avg(/Linux server/proc.num[],5m)>300", } ], "auth": "0424bd59b807674191e7d77572075f33", "id": 4 } ``` Una resposta correcta contindrà els identificadors dels triggers acabats de crear: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "17369", "17370" ] }, "id": 4 } ``` ##### Creating new secret The following procedure describes how to create a new secret using Openshift Console. **1.** Open the Workloads → Secrets section and switch project to the Zabbix Operator project (by default, "zabbix"). {width="600"} **2.** Create a new secret using the *From YAML* option. {width="600"} ##### Crear un nou secret El procediment següent descriu com crear un secret nou utilitzant Consola Openshift. **1.** Obriu la secció Càrregues de treball → Secrets i canvieu el projecte a Projecte de l'operador Zabbix (per defecte, "zabbix"). {width="600"} **2.** Creeu un secret nou amb l'opció *Des de YAML*. {width="600"} ##### 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. ::: ##### Credencials (login:password) Sistema: - root:zabbix Interfície Web Zabbix: - Admin:zabbix Base de dades: - root:<random> - zabbix:<random> ::: noteclassic Els mots de pas de la base de dades es generen de manera aleatòria durant el procés d'instal·lació.<br> El mot de pas root s'emmagatzema a l'arxiu /root/.my.cnf. No al pas inserir u mot de pas al compte "root". ::: Per modificar el mot de pas de l'usuari de la base de dades, heu de modificar-ho als següents llocs: - MySQL; - /etc/zabbix/zabbix\_server.conf; - /etc/zabbix/web/zabbix.conf.php. ::: noteclassic Els usuaris `zabbix_srv` i `zabbix_web` són per al servidor i la interfície Web, respectivament. ::: ### Critical To complete successful Zabbix server upgrade on MySQL and MariaDB, you may require to set `GLOBAL log_bin_trust_function_creators = 1` in MySQL if binary logging is enabled, there are no superuser privileges and `log_bin_trust_function_creators = 1` is not set in MySQL configuration file. To set the variable using the MySQL console, run: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Once the upgrade has been successfully completed, `log_bin_trust_function_creators` can be disabled: mysql> SET GLOBAL log_bin_trust_function_creators = 0; ### Crítica Per completar amb èxit l'actualització del servidor Zabbix a MySQL i MariaDB, és possible que calgui establir `GLOBAL log_bin_trust_function_creators = 1` a MySQL si el registre binari és habilitat, no hi ha privilegis de superusuari i `log_bin_trust_function_creators = 1` no és establert al fitxer de configuració de MySQL. Per configurar la variable mitjançant la consola MySQL, executeu: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Un cop l'actualització s'hagi completat amb èxit, `log_bin_trust_function_creators` es pot desactivar: mysql> SET GLOBAL log_bin_trust_function_creators = 0; #### 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 caducada o caducarà durant el funcionament del servidor [*OpenSSL*]{.underline}, al registre del servidor: - abans de caducar: ```{=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" - després de caducar: ```{=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" Cal apuntar que amb una CRL vàlida, un certificat revocat és marcat com a "certificat revocat". Quan la CRL caduqui, el missatge d'error esdevé "certificat caducat", que és força enganyós. [*GnuTLS*]{.underline}, al registre del servidor: - abans i després de caducar: ```{=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. ### Cryptography ### Criptografia ### Custom interface details The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - *(default)* - use bulk requests.| |community|string|SNMP community. Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<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 are:<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 are:<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.| ### Detalls de la interfície personalitzada L'objecte de detalls té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**version**<br>(obligatori)|integer|Versió de la interfície SNMP.<br><br>Els valors possibles són:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br> 3 - SNMPv3| |bulk|integer|Indica si s'han d'emprar consultes SNMP massives.<br><br>Els valors possibles són:<br>0 - no empreu consultes massives;<br>1 - *(per defecte )* - empreu sol·licituds massives.| |community|string|Comunitat SNMP. Només l'empren les interfícies SNMPv1 i SNMPv2.| |securityname|string|Nom de seguretat SNMPv3. Emprat només per interfícies SNMPv3.| |securitylevel|integer|Nivell de seguretat SNMPv3. Només l'empren les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|Mot de pas d'autenticació SNMPv3. Emprat només per interfícies SNMPv3.| |privpassphrase|string|Frase de pas de privadesa SNMPv3. Emprat només per interfícies SNMPv3.| |authprotocol|integer|Protocol d'autenticació SNMPv3. Només s'empra a les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|Protocol de privadesa SNMPv3. Només s'empra les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - *(per defecte)* - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |contextname|string|Nom de context SNMPv3. Emprat només per interfícies SNMPv3.| ### Custom interface The custom interface object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dns|string|DNS name used by the interface.<br><br>**Required** if the connection is made via DNS. Can contain macros.| |ip|string|IP address used by the interface.<br><br>**Required** if the connection is made via IP. Can contain macros.| |**main**<br>(required)|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 are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user and LLD macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.| |details|object|Additional object for interface. **Required** if interface 'type' is SNMP.| ### Interfície personalitzada L'objecte d'interfície personalitzada té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dns|string|Nom DNS emprat per la interfície.<br><br>**Obligatori** si us connecteu mitjançant DNS. Pot contenir macros.| |ip|string|adreça IP emprada per la interfície.<br><br>**Obligatori** si us connecteu mitjançant IP. Pot contenir macros.| |**main**<br>(obligatori)|integer|Indica si la interfície s'empra per defecte a l'equip. Només es pot establir una interfície d'un determinat tipus com a predeterminada en un equip.<br><br>Els valors possibles són:<br>0 - no per defecte;<br>1 - per defecte.| |**port**<br>(obligatori)|string|Nombre de port emprat per la interfície. Pot contenir macros d'usuari i LLD.| |**tipus**<br>(obligatori)|integer|Tipus d'interfície.<br><br>Els valors possibles són:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI ;<br>4 - JMX.<br>| |**useip**<br>(obligatori)|integer|Indica si la connexió s'ha d'establir mitjançant IP.<br><br>Els valors possibles són:<br>0 - connecteu-vos amb el nom DNS de l'equip;<br>1 - connecteu-vos mitjançant l'adreça IP de l'equip per a aquesta interfície d'equip.| |details|objecte|Objecte addicional per a la interfície. **Obligatori** si el "tipus" d'interfície és SNMP.| #### 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).| #### Macros personalitzades La pestanya **Macros LLD** us permet especificar macros personalitzades de descoberta de baix nivell. Les macros personalitzades són útils en els casos en què el JSON retornat no té les macros necessàries ja definides. Així, per exemple: - La clau nadiua `vfs.fs.discovery` per a la descoberta del sistema de fitxers retorna un JSON amb macros LLD predefinides com {\#FSNAME}, {\#FSTYPE}. Aquestes macros es poden emprar a l'element, activar prototips (vegeu les seccions següents de la pàgina) directament; no cal definir macros personalitzades; - L'element d'agent `vfs.fs.get` també retorna JSON amb [dades del sistema de fitxers](/manual/discovery/low_level_discovery/examples/mounted_filesystems), però sense macros LLD predefinides. En aquest cas, podeu definir les macros vosaltres mateixos i assignar-les als valors JSON mitjançant JSONPath:  Els valors extrets es poden emprar en elements descoberts, triggers, etc. Tingueu en compte que els valors es prendran del resultat de la descoberta i de totes les passes de preprocessament processades fins ara. |Paràmetre|Descripció| |--|---------| |*Macro LLD*|Nom de la macro de descoberta de baix nivell, emprant la sintaxi següent: {\#MACRO}.| |*JSONPath*|Ruta que s'empra per extreure el valor de la macro LLD d'una fila LLD, emprant la sintaxi JSONPath.<br>Els valors extrets del JSON retornats s'empren per substituir les macros LLD als camps del prototip d'element, trigger, etc. <br>JSONPath es pot especificar mitjançant la notació de punts o la notació de claudàtors. La notació de claudàtors s'ha d'emprar en cas de caràcters especials i Unicode, com ara `$['unicode + caràcters especials #1']['unicode + caràcters especials #2']`.<br><br>Per exemple, `$ .foo` extreu "bar" i "baz" d'aquest JSON: `[{"foo":"bar"}, {"foo":"baz"}]`<br>Tingueu en compte que `$.foo` extreu "bar" i "baz" també d'aquest JSON: `{"data":[{"foo":"bar"}, {"foo":"baz"}]}` perquè un únic objecte "data" és processat automàticament (per a [compatibilitat amv versions anteriors](#overview) amb la implementació de descoberta de baix nivell a les versions de Zabbix anteriors a la 4.2).| #### Custom script limit Available custom script length depends on the database used: |Database|Limit in characters|Limit in bytes| |---|---|---| |**MySQL**|65535|65535| |**Oracle Database**|2048|4000| |**PostgreSQL**|65535|not limited| |**SQLite (only Zabbix proxy)**|65535|not limited| #### Límit d'script personalitzat La longitud disponible d'script personalitzat depèn de la base de dades emprada: | | | | |---|---|---| |*Base de dades*|*Límit en caràcters*|*Límit en octets*| |**MySQL**|65535|65535| |**Base de dades Oracle**|2048|4000| |**PostgreSQL**|65535|no limitat| |**SQLite (només proxy Zabbix)**|65535|no limitat| #### dashboard Changes:<br> [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) added new widget type `slareport` and widget field types *(9 - Service, 10 - SLA)*.<br> [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) added new widget type `item`. #### tauler Canvis:<br> [ZBXNEXT-6999](https://support.zabbix.com/browse/ZBXNEXT-6999) afegit el nou giny `slareport` i els tipus de camps *(9 - Service, 10 - SLA)*.\ [ZBXNEXT-6966](https://support.zabbix.com/browse/ZBXNEXT-6966) afegit un nou tipus de giny `item`. # dashboard.create # dashboard.create # dashboard.delete # dashboard.delete # dashboard.get # dashboard.get # Dashboard object The following objects are directly related to the `dashboard` API. # Objecte de tauler Els objectes següents tenen relació directa amb l'API `dashboard`. ### Dashboard page The dashboard page object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboard\_pageid|string|*(readonly)* ID of the dashboard page.| |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.| ### Pàgina de tauler L'objecte de pàgina de tauler té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dashboard\_pageid|string|*(només lectura)* ID de la pàgina del tauler.| |name|string|Nom de la pàgina del tauler.<br><br>Per defecte: cadena buida.| |display\_period|integer|Temps de mostra de la pàgina del tauler (en segons).<br><br>Valors possibles: 0, 10, 30, 60, 120, 600, 1800, 3600.<br><br>Per defecte: 0 (empra el període de mostra de pàgina per defecte).| |widgets|array|Matriu dels objectes [ginys de tauler](object#dashboard_widget).| ##### 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. Technically the dashboard consists of 12 horizontal 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 up to 32 rows high. ##### Mida del tauler L'amplada mínima d'un tauler és de 1200 píxels. El tauler de comandament no es reduirà per sota d'aquesta amplada; en canvi, es mostra una barra de desplaçament horitzontal si la finestra del navegador és més petita que això. L'amplada màxima d'un tauler és l'amplada de la finestra del navegador. Els ginys del tauler s'estenen horitzontalment per adaptar-se a la finestra. Al mateix temps, un giny del tauler de control no es pot estirar horitzontalment més enllà dels límits de la finestra. Tècnicament, el tauler consta de 12 columnes horitzontals d'amplada sempre igual que s'estiren / s'arronssen dinàmicament (però no a menys de 1200 píxels en total). Verticalment, el tauler pot contindre un màxim de 64 files. Cada filera té una alçada fixa de 70 píxels. Un giny pot tenir fins a 32 fileres d'alçada. #### 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) #### Taulers Gestionar els taulers i crear informes planificats basats en aquests taulers. [API Tauler](/manual/api/reference/dashboard) | [API Model de tauler](/manual/api/reference/templatedashboard) | [API Informe](/manual/api/reference/report) ### Dashboard The dashboard object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |dashboardid|string|*(readonly)* ID of the dashboard.| |**name**<br>(required)|string|Name of the dashboard.| |userid|string|Dashboard owner user ID.| |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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Tauler L'objecte tauler té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dashboardid|string|*(només lectura)* ID del tauler.| |**name**<br>(obligatori)|string|Nom del tauler.| |userid|string|ID de l'usuari propietari del tauler.| |private|integer|Tipus de compartició del tauler.<br><br>Valors possibles:<br>0 - tauler públic;<br>1 - *(per defecte)* tauler privat.| |display\_period|integer|Període (en segons) de mstra de la pàgina per defecte.<br><br>Valors possibles: 10, 30, 60, 120, 600, 1800, 3600.<br><br>Per defecte: 30.| |auto\_start|integer|Iniciar presentació automàticament.<br><br>Valors possibles:<br>0 - no iniciar-la automàticament;<br>1 - *(per defecte)* iniciar-la automàticament.| Veieu que per alguns mètodes (actualitzar, esborrar) la combinació de paràmetres necessaris o opcionals és diferent. # 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](/manual/api/reference/dashboard/object#dashboard_user) - [Dashboard user group](/manual/api/reference/dashboard/object#dashboard_user_group) Available methods: - [dashboard.create](/manual/api/reference/dashboard/create) - creating new dashboards - [dashboard.delete](/manual/api/reference/dashboard/delete) - deleting dashboards - [dashboard.get](/manual/api/reference/dashboard/get) - retrieving dashboards - [dashboard.update](/manual/api/reference/dashboard/update) - updating dashboards # Tauler Aquesta classe és dissenyada per treballar amb taulers. Referències d'objectes: - [Tauler](/manual/api/reference/dashboard/object#dashboard) - [Pàgina de tauler ](/manual/api/reference/dashboard/object#dashboard_page) - [Giny de tauler](/manual/api/reference/dashboard/object#dashboard_widget) - [Camp de giny de tauler](/manual/api/reference/dashboard/object#dashboard_widget_field) - [Usuari del tauler](/manual/api/reference/dashboard/object#dashboard_user) - [Grup d'usuaris del tauler](/manual/api/reference/dashboard/object#dashboard_user_group) Mètodes disponibles: - [dashboard.create](/manual/api/reference/dashboard/create) - crear nous taulers - [dashboard.delete](/manual/api/reference/dashboard/delete) - esborrar taulers - [dashboard.get](/manual/api/reference/dashboard/get) - retrieving taulers - [dashboard.update](/manual/api/reference/dashboard/update) - actualitzar taulers # 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**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Grup d'usuaris del tauler Llistat dels permisos del tauler en funció dels grups d'usuaris. L'objecte té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**usrgrpid**<br>(obligatori)|string|ID del grup d'usuaris.| |**permission**<br>(obligatori)|integer|Tipus del nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;| ### Dashboard user List of dashboard permissions based on users. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Usuari de tauler Llista dels permisos del tauler en funció dels usuaris. L'objecte té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**userid**<br>(obligatori)|string|ID d'usuari.| |**permission**<br>(obligatori)|integer|Nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;| # Dashboard widget fields # Camps de giny de tauler ### Dashboard widget field The dashboard widget field object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|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.| |**name**<br>(required)|string|Widget field name.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(required)|mixed|Widget field value depending on the type.<br><br>Possible values: see [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| ### Camp del giny de tauler L'objecte de camp de giny del tauler té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**type**<br>(obligatori)|integer|Tipus de camp de giny.<br><br>Valors possibles:<br>0 - Enter;<br>1 - Cadena;<br>2 - Grup d'equips;<br>3 - Equip;<br>4 - Element;<br>5 - Prototipus d'elements;<br>6 - Gràfic;<br>7 - Prototipus de gràfics;<br>8 - Mapa;<br>9 - Servei;<br>10 - SLA.| |**name**<br>(obligatori)|string|Nom del camp de giny.<br><br>Valors possibles: veieu [Camps de giny de tauler](/manual/api/reference/dashboard/widget_fields).| |**value**<br>(obligatori)|mixed|Valor del camp de giny depenent segons el tipus.<br><br>Valors possibles: veieu [Camps de giny de tauler](/manual/api/reference/dashboard/widget_fields).| ### Dashboard widget The dashboard widget object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |widgetid|string|*(readonly)* ID of the dashboard widget.| |**type**<br>(required)|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>geomap - Geomap;<br>graph - Graph (classic);<br>graphprototype - Graph prototype;<br>hostavail - Host availability;<br>item - Item value;<br>map - Map;<br>navtree - Map Navigation Tree;<br>plaintext - Plain text;<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>trigover - Trigger overview;<br>url - URL;<br>web - Web monitoring.| |name|string|Custom widget name.| |x|integer|A horizontal position from the left side of the dashboard.<br><br>Valid values range from 0 to 23.| |y|integer|A vertical position from the top of the dashboard.<br><br>Valid values range from 0 to 62.| |width|integer|The widget width.<br><br>Valid values range from 1 to 24.| |height|integer|The widget height.<br><br>Valid values range from 2 to 32.| |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>Required for specific widgets; see individual widgets in [Dashboard widget fields](/manual/api/reference/dashboard/widget_fields).| ### Giny de tauler L'objecte giny de tauler té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |widgetid|string|*(només lectura)* ID del giny de tauler.| |**type**<br>(obligatori)|string|Tipus de giny de tauler.<br><br>Valors possibles:<br>actionlog - Registre d'acció;<br>clock - Rellotge;<br>*(obsolet)* dataover - Vista general d'informació;<br>discovery - Estat de descoberta;<br>favgraphs - Gràfics preferits;<br>favmaps - Mapes preferits;<br>geomap - Geomapa;<br>graph - Gràfic (clàssic);<br>graphprototype - Prototipus de gràfic;<br>hostavail - Disponibilitat de l'equip;<br>item - Valor d'element;<br>map - Mapa;<br>navtree - Arbre de navegació del mapa;<br>plaintext - Text pla;<br>problemhosts - Equips amb problemes;<br>problems - Problemes;<br>problemsbysv - Problemes per gravetat;<br>slareport - Informe d'SLA;<br>svggraph - Gràfic;<br>systeminfo - Informació del sistema;<br>tophosts - Millors equips;<br>trigover - Vista general dels triggers;<br>url - URL;<br>web - Monitoratge Web.| |name|string|Nom del giny personalitzat.| |x|integer|Posició horitzontal des de l'esquerra del tauler.<br><br>Interval vàlid des de 0 a 23.| |y|integer|Posició vertical des de dalt del tauler.<br><br>Valors vàlids entre 0 i 62.| |width|integer|Amplada del giny.<br><br>Valors vàlids entre 1 i 24.| |height|integer|Alçada del giny.<br><br>Valors vàlids entre 2 i 32.| |view\_mode|integer|Mode de vista del giny.<br><br>Valors possibles:<br>0 - *(per defecte)* vista del giny per defecte;<br>1 - amb capçalera oculta;| |fields|array|Taula dels objectes [camp del giny del tauler](object#dashboard-widget-field).<br><br>Obligatori per ginys concrets, Veieu els ginys individuals a [camps de giny de tauler](/manual/api/reference/dashboard/widget_fields).| #### 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. #### Canvis a la base de dades S'ha corregit un problema de clonació de plantilles lenta afegint índexs per al camp uuid. Aquest canvi pot provocar temps d'actualització llargs en conjunts de dades grans. ### 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. ::: ### Creació de la base de dades Suposem que existeix un usuari *zabbix* de la base de dades, amb paraula de pas *password*; i que té permisos necessaris per crear un objecte de base de dades al servei ORCL que és a l'equip del servidor de base de dades Oracle. A Zabbix li cal un joc de caràcters Unicode de base de dades, i un joc de caràcters nacional `UTF8`. Verifiqueu la configuració actual: sqlplus> select parameter,value from v$nls_parameters where parameter='NLS_CHARACTERSET' or parameter='NLS_NCHAR_CHARACTERSET'; Prepareu la base de dades: cd /path/to/zabbix-sources/database/oracle sqlplus zabbix/password@oracle_host/ORCL sqlplus> @schema.sql # arrêtez-vous ici si vous créez une base de données pour le proxy Zabbix sqlplus> @images.sql sqlplus> @data.sql ::: notetip Definiu el paràmetre d'inicialització CURSOR\_SHARING=FORCE per tindre més bon rendiment. ::: #### Database credentials It is supported to store database credentials used by Zabbix server, proxies and frontend secretly in Vault: - Vault-related parameters for retrieving database credentials can be optionally entered in the frontend [installation wizard](/manual/installation/frontend). Database credentials retrieved from Vault will be cached by the frontend. Note that the filesystem temporary file directory is used for database credential caching in frontend. You may use the ZBX\_DATA\_CACHE\_TTL [constant](/manual/web_interface/definitions) to control how often the data cache is refreshed/invalidated. - For server/proxy the VaultDBPath configuration parameter may be used to specify the path from where credentials for database will be retrieved by keys 'password' and 'username' (for example: secret/zabbix/database). The following commands may be used to set the values for the path mentioned in example: # 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 "secret/zabbix/database" vault kv put 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 #### Credencials de la base de dades És possible emmagatzemar en secret les credencials de la base de dades emprades pel servidor Zabbix, proxys i interfície a Vault: - La configuració relacionada amb el magatzem per recuperar les credencials de la base de dades es pot introduir opcionalment a la interfície [assistent d'instal·lació](/manual/installation/frontend). La interfície emmagatzemarà a la memòria cau les credencials de la base de dades recuperades de Vault. Tingueu en compte que el directori de fitxers temporals del sistema de fitxers s'empra per a la memòria cau de les credencials de la base de dades a la interfície. Podeu emprar la [constant](/manual/web_interface/definitions) ZBX\_DATA\_CACHE\_TTL per controlar amb quina freqüència s'actualitza/invalida la memòria cau de dades. - Per al servidor/proxy, el paràmetre de configuració VaultDBPath es pot emprar per especificar el camí des del qual es recuperaran les credencials de la base de dades mitjançant les claus "mot de pas" i "nom d'usuari" (per exemple: secret/zabbix/base de dades). Les ordres següents es poden emprar per establir els valors del camí esmentat a l'exemple: # Habiliteu el punt de muntatge "secret/" si encara no és habilitat, tingueu en compte que s'ha d'emprar "kv-v2" vault secrets enable -path=secret/ kv-v2 # Poseu nous secrets amb les claus de nom d'usuari i mot de pas al punt de muntatge "secret/" i al camí "secret/zabbix/base de dades" vault kv put secret/zabbix/database username=zabbix password=<mot_de_pas> # Comprova que el secret s'ha afegit correctament vault kv get secret/zabbix/database # Finalment, proveu amb Curl, tingueu en compte que les "dades" s'han d'afegir manualment després del punt de muntatge i "/v1" abans del punt de muntatge, vegeu també el paràmetre --capath curl --header "X-Vault-Token: <VaultToken>" https://127.0.0.1:8200/v1/secret/data/zabbix/database #### Database engine This is probably the most important part of Zabbix tuning. Zabbix heavily depends on the availability and performance of database engine. - use fastest database engine, i.e. MySQL or PostgreSQL - use stable release of a database engine - rebuild MySQL or PostgreSQL from sources to get maximum performance - follow performance tuning instructions taken from MySQL or PostgreSQL documentation - for MySQL, use InnoDB table structure - ZABBIX works at least 1.5 times faster (comparing to MyISAM) if InnoDB is used. This is because of increased parallelism. However, InnoDB requires more CPU power. - tuning the database server for the best performance is highly recommended. - keep database tables on different hard disks - 'history', 'history\_str, 'items' 'functions', triggers', and 'trends' are most heavily used tables. - for large installations keeping MySQL temporary files in tmpfs is: - MySQL >= 5.5: not recommended ([MySQL bug \#58421](https://bugs.mysql.com/bug.php?id=58421)) - MySQL < 5.5: recommended #### Motor de base de dades Aquesta és probablement la part més important de l'afinació de Zabbix. Zabbix depèn en gran mesura de la disponibilitat i el rendiment del motor de base de dades. - Empreu el motor de base de dades més ràpid (és a dir, MySQL o PostgreSQL) - Empreu la versió estable del motor de base de dades - Munteu MySQL o PostgreSQL des de la font per obtindre el màxim rendiment - Seguiu les instruccions d'ajustament del rendiment extretes de la documentació de MySQL o PostgreSQL - Amb MySQL, empreu una estructura de taula InnoDB - ZABBIX s'executa almenys 1,5 vegades més ràpid (en comparació amb MyISAM) si s'empra InnoDB. Això es deu a l'augment del paral·lelisme. Tanmateix, InnoDB requereix més potència de CPU. - Es recomana optimitzar el servidor de bases de dades per obtindre el millor rendiment. - Mantingueu les taules de bases de dades en diferents discs durs - 'history', 'history\_str, 'items' 'functions', triggers', i 'trends' són les taules més emprades. - Per a instal·lacions grans, mantindre els fitxers temporals de MySQL a tmpfs és: - MySQL >= 5.5: no recomanat ([error MySQL \#58421](https://bugs.mysql.com/bug.php?id=58421)) - MySQL < 5.5: recomanat ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades ## Databases ## Bases de dades #### 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 you 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 you would like to keep 30 days of history and you 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 this 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 you 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, you 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, you 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 you 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. #### Mida de la base de dades Les dades de configuració de Zabbix requereixen una quantitat fixa d'espai en disc i no creixen gaire. La mida de la base de dades Zabbix depèn principalment d'aquestes variables, que defineixen la quantitat de dades històriques emmagatzemades: - Nombre de valors processats per segon Aquest és el nombre mitjà de valors nous que rep el servidor Zabbix cada segon. Per exemple, si teniu 3000 elements per monitorar amb una freqüència d'actualització de 60 segons, el nombre de valors per segon es calcula com a 3000/60 = **50**. Significa que s'afegeixen 50 valors nous a la base de dades de Zabbix cada segon. - Configuració de la neteja de l'històric Zabbix manté els valors durant un període de temps determinat, normalment diverses setmanes o mesos. Cada valor nou requereix una certa quantitat d'espai de disc per a les dades i l'índex. Per tant, si voleu conservar 30 dies d'historial i rebeu 50 valors per segon, el nombre total de valors serà al voltant de (**30**\*24\*3600)\* **50** = 129.600 .000, o uns 130M de valors. Depenent del motor de base de dades emprat, del tipus de valors rebuts (flotants, nombres enters, cadenes, fitxers de registre, etc.), l'espai en disc per mantindre un valor únic pot variar des de 40 octets fins a centenars d'octets. Normalment és d'uns 90 octets per valor per als elements numèrics^**2**^. En aquest cas, vol dir que 130 M de valors requeriran 130 M \* 90 octets = **10,9 Go** d'espai en disc. ::: noteclassic La mida dels valors dels elements de text/registre és impossible de predir amb exactitud, però és possible que sigui d'uns 500 octets per valor. ::: - La netaja que marca tendències Zabbix manté un conjunt de valors màxim/min/mitjana/compte d'1 hora per a cada element de la taula **tendències**. Les dades s'empren per a gràfics de tendències i de períodes llargs. El període d'una hora no es pot personalitzar. La base de dades Zabbix, depenent del tipus de base de dades, requereix uns 90 octets per cada total. Suposem que voleu conservar les dades de tendències durant 5 anys. Els valors de 3.000 elements requeriran 3.000\*24\*365\* **90** = **2,2 Go** per any o **11 Go** durant 5 anys. - Configuració de neteaja per a esdeveniments Cada esdeveniment Zabbix requereix aproximadament 250 octets d'espai en disc^**1**^. És difícil estimar el nombre d'esdeveniments generats per Zabbix diàriament. En el pitjor dels casos, podeu suposar que Zabbix genera un esdeveniment per segon. Per a cada esdeveniment recuperat, es crea un registre `event_recovery`. Normalment, la majoria dels esdeveniments es recuperaran. Per tant, podeu suposar un registre `event_recovery` per esdeveniment. Això significa 80 octets addicionals per esdeveniment. Opcionalment, els esdeveniments poden tindre etiquetes, cada registre d'etiquetes requereix aproximadament 100 octets d'espai en disc^**1**^. El nombre d'etiquetes per esdeveniment (\#tags) depèn de la configuració. Per tant, cadascun necessitarà \#etiquetes \* 100 octets addicionals d'espai en disc. Vol dir que si voleu mantindre 3 anys d'esdeveniments, caldria 3\*365\*24\*3600\* (250+80+\#tags\*100) = **~30Go**+\ #etiquetes\*100o d'espai en disc^**2**^. ::: noteclassic ^**1**^ Més quan tens noms, etiquetes i valors d'esdeveniments que no són ASCII.\ ^**2**^ Les aproximacions de mida es basen en MySQL i poden ser diferents per a altres bases de dades. ::: La taula conté fórmules que es poden emprar per calcular l'espai de disc necessari per al sistema Zabbix: |Paràmetre|Fórmula per a l'espai de disc necessari (en octets)| |---------|---------------------------------------- ---| |*Configuració Zabbix*|Mida fixa. Normalment 10 Mo o menys.| |*Historial*|dies\*(elements/freqüència d'actualització)\*24\*3600\*octets<br>elements : nombre d'elements<br>dies : nombre de dies per mantindre l'historial<br>freqüència d'actualització : actualització mitjana taxa d'elements<br>octets : nombre d'octets necessaris per mantindre un valor únic, depèn del motor de base de dades, normalment ~90 octets.| |*Tendències*|dies\*(elements/3600)\*24\*3600\*octets<br>elements : nombre d'elements<br>dies : nombre de dies per conservar l'historial<br>octets : nombre d'octets necessaris per mantindre una tendència única, depèn del motor de base de dades, normalment ~90 octets.| |*Esdeveniments*|dies\*esdeveniments\*24\*3600\*octets<br>esdeveniments : nombre d'esdeveniments per segon. Un (1) esdeveniment per segon en el pitjor dels casos.<br>dies : nombre de dies per mantindre l'historial<br>octet : nombre d'octets necessaris per mantindre un esdeveniment únic, depèn del motor de base de dades, normalment ~330 + mitjana nombre d'etiquetes per esdeveniment \* 100 octets.| Per tant, l'espai total de disc necessari es pot calcular com:\ **Configuració + Historial + Tendències + Esdeveniments**\ L'espai de disc NO s'emprarà immediatament després de la instal·lació de Zabbix. La mida de la base de dades creixerà i després deixarà de créixer en algun moment, cosa que depèn de la configuració de la neteja. ## Databases #### Supported versions PostgreSQL **16** and MariaDB **11.1** are now supported. See also: [Requirements](/manual/installation/requirements#third-party-external-surrounding-software). ## Bases de dades #### Versions admeses Ara s'admeten PostgreSQL **16** i MariaDB **11.1**. Veieu també: [Requisits](/manual/installation/requirements#third-party-external-surrounding-software). ## Databases To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance. Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#required-software) versions are officially supported: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - 14.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy). ### Bases de dades Per crear l'experiència d'usuari òptima i garantir el millor rendiment de Zabbix en diversos entorns de producció, s'ha abandonat el suport d'algunes versions de bases de dades anteriors. Això s'aplica principalment a les versions de la base de dades que s'apropen al fi de vida útil i a les versions amb problemes no corregits que poden interferir amb el rendiment normal. Des de Zabbix 6.0, les versions següents de [bases de dades](/manual/installation/requirements#required-software) són oficialment compatibles: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - 14.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X De manera predeterminada, el servidor Zabbix i el proxy no s'iniciaran si es detecta una versió de base de dades no compatible. És possible, encara que no es recomana, desactivar la comprovació de la versió de la base de dades modificant el paràmetre de configuració AllowUnsupportedDBVersions al [servidor](/manual/appendix/config/zabbix_server) o [proxy](/manual/appendix/config/zabbix_proxy). ##### Databases To create the optimal user experience and ensure the best Zabbix performance in various production environments, the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance. Starting from Zabbix 6.0, the following [database](/manual/installation/requirements#required-software) versions are officially supported: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended, to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [server](/manual/appendix/config/zabbix_server) or [proxy](/manual/appendix/config/zabbix_proxy). ##### Bases de dades Per crear l'experiència d'usuari òptima i garantir el millor rendiment de Zabbix en diversos entorns de producció, s'ha tret el suport d'algunes versions de bases de dades anteriors. Això s'aplica principalment a les versions de la base de dades que s'apropen al final de vida útil i a les versions amb problemes no corregits que poden interferir amb el rendiment normal. A partir de Zabbix 6.0, les versions següents de [base de dades](/manual/installation/requirements#required-software) són oficialment compatibles: - *MySQL/Percona* 8.0.X - *MariaDB* 10.5.X - 10.6.X - *PostgreSQL* 13.X - *Oracle* 19c - 21c - *TimescaleDB* 2.0.1-2.3 - *SQLite* 3.3.5-3.34.X De manera predeterminada, el servidor Zabbix i el proxy no s'iniciaran si es detecta una versió de base de dades no compatible. Ara és possible, encara que no es recomana, desactivar la comprovació de la versió de la base de dades modificant el paràmetre de configuració AllowUnsupportedDBVersions per al [servidor](/manual/appendix/config/zabbix_server) o [proxy](/manual/appendix/config/zabbix_proxy). ##### Database storage All configuration information as well as the data gathered by Zabbix is stored in a database. ##### Emmagatzematge de dades Tota la informació de configuració així com les dades recollides per el Zabbix s'emmagatzemen a una base de dades. #### Database TLS connection for MySQL on SLES 12 The packages for server/proxy installation on SUSE Linux Enterprise Server version 12 are now built using MariaDB Connector/C library, thus enabling the encryption of connection to MySQL using the DBTLSConnect [parameter](/manual/appendix/config/zabbix_server). The supported encryption values are "required" and "verify\_full". #### Connexió TLS de base de dades per a MySQL a SLES 12 Els paquets per a la instal·lació de servidor/proxy a SUSE Linux Enterprise Server versió 12 es creen ara amb la biblioteca MariaDB Connector/C, permetent així el xifrat de la connexió a MySQL emprant el [paràmetre] DBTLSConnect (/manual/appendix/config/zabbix_server). Els valors de xifrat admesos són "required" i "verify\_full". #### 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. #### Connexió TLS a la base de dades amb MariaDB La connexió TLS a la base de dades no s'admet pas amb l'opció *verify\_ca* per al [paràmeetre](/manual/appendix/config/zabbix_server) DBTLSConnect si s'empra MariaDB. ##### 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); ``` ##### Recollida de dades amb paràmetres Recollir el contingut d'una pàgina específica i emprar els paràmetres: - Crear un element de tipus "Script" i dos paràmetres: - **url : {$DOMAIN}** (la macro d'usuari {$DOMAIN} s'ha de definir, preferiblement a nivell d'equip) - **subpage : /release_notes** {width=600} - Al camp *Script*, posar-hi el codi següent: ```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. #### Flux de dades A més, és important fer una passa enrere i fer una ullada al flux de dades general de Zabbix. Per crear un element que reculli dades, primer heu de crear un equip. Passant a l'altre extrem de l'espectre de Zabbix, primer heu de tindre un element per crear un triger. Heu de tindre un trigger per crear una acció. Per tant, si voleu rebre una alerta quan la vostra càrrega de CPU sigui massa alta al *Servidor X*, primer heu de crear una entrada d'equip per al *Servidor X* seguida d'un element per monitorar la seva CPU i, a continuació, un trigger que s'activarà si la CPU és massa enfeinada, seguida d'una acció que us envia un correu electrònic. Tot i que poden semblar moltes passes, amb l'ús de plantilles realment no ho són. Tanmateix, gràcies a aquest disseny, és possible crear una configuració molt flexible. #### 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. #### Límit de dades per els valors de retorn No hi ha límit per a les dades JSON de la regla de descoberta de baix nivell si es reben directament pel servidor Zabbix. Això és així perquè els valors de retorn es processen sense emmagatzemar-se en una base de dades. Tampoc hi ha límit per a les regles de descoberta de baix nivell personalitzades. Però si es pretén aconseguir dades LLD personalitzades mitjançant un paràmetre d'usuari, s'aplica el [valor límit](/manual/config/items/userparameters#command-result) de la configuració d'usuari. Si les dades han de passar pel proxy Zabbix, s'han d'emmagatzemar a la base de dades perquè s'hi apliquin els [límits de la base de dades](/manual/config/items/item#text_data_limits). #### Data set The following parameters are supported for configuring a *Data set*. ::: noteclassic The first number in the property name (e.g. ds.hosts.0.0, ds.items.0.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| |-----|-|-----|-------------------| |***Host pattern***<br>(required)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) name or pattern (e.g. `Zabbix*`).| |***Item pattern***<br>(required)|1|ds.items.0.0|[Item](/manual/api/reference/item/get) name or pattern (e.g. `*: Number of processed *values per second`).| |*Color*|1|ds.color.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `FF465C`.| |*Draw*|0|ds.type.0|0 - *(default)* Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Width*|0|ds.width.0|Valid values range from 1-10.<br><br>Default: 1.<br><br>Parameter *Width* not available if *Draw* is set to "Points" or "Bar".| |*Point size*|0|ds.pointsize.0|Valid values range from 1-10.<br><br>Default: 3.<br><br>Parameter *Point size* not available if *Draw* is set to "Line", "Staircase" or "Bar".| |*Transparency*|0|ds.transparency.0|Valid values range from 1-10.<br><br>Default: 5.| |*Fill*|0|ds.fill.0|Valid values range from 1-10.<br><br>Default: 3.<br><br>Parameter *Fill* not available if *Draw* is set to "Points" or "Bar".| |*Missing data*|0|ds.missingdatafunc.0|0 - *(default)* None;<br>1 - Connected;<br>2 - Treat as 0.<br><br>Parameter *Missing data* not available if *Draw* is set to "Points" or "Bar".| |*Y-axis*|0|ds.axisy.0|0 - *(default)* Left;<br>1 - Right.| |*Time shift*|1|ds.timeshift.0|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.aggregate_function.0|0 - *(default)* none;<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.aggregate_interval.0|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.aggregate_grouping.0|0 - *(default)* Each item;<br>1 - Data set.<br><br>Parameter *Aggregate* not available if *Aggregation function* is set to "none".| #### Conjunt de dades Els paràmetres següents són compatibles per configurar un *conjunt de dades*. ::: noteclassic El primer nombre del nom de la propietat (p. ex., ds.hosts.0.0, ds.items.0.0) representa el conjunt de dades concret. mentre que el segon nombre, si h iés present, representa l'equip o l'element configurat. ::: |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |***Patró d'equip***<br>(obligatori)|1|ds.hosts.0.0|[Host](/manual/api/reference/host/get) nom o patró (p. ex., `Zabbix*`). | |***Patró d'element***<br>(obligatori)|1|ds.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex. `*: Nombre de processats *valors per segon`).| |*Color*|1|ds.color.0|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `FF465C`.| |*Dibuix*|0|ds.type.0|0 - *(per defecte)* Línia;<br>1 - Punts;<br>2 - Escala;<br>3 - Barra.| |*Amplada*|0|ds.width.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 1.<br><br>El paràmetre *Amplada* no està disponible si *Dibuix* s'estableix a "Punts" o "Barra".| |*Mida del punt*|0|ds.pointsize.0|Els valors vàlids oscil·len entre 1 i 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Mida del punt* no està disponible si *Draw* és establir a "Línia", "Escala" o "Bar".| |*Transparència*|0|ds.transparency.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 5.| |*Fill*|0|ds.fill.0|Els valors vàlids van d'1 a 10.<br><br>Per defecte: 3.<br><br>El paràmetre *Fill* no està disponible si *Draw* està establert en "Punts" o "Barra".| |*Falten dades*|0|ds.missingdatafunc.0|0 - *(per defecte)* Cap;<br>1 - Connectat;<br>2 - Tracta com a 0.<br><br>Paràmetre *Falquen dades* no disponible si *Draw* està establert a "Punts" o "Barra".| |*Eix Y*|0|ds.axisy.0|0 - *(per defecte)* Esquerra;<br>1 - Dreta.| |*Time shift*|1|ds.timeshift.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu utilitzar [sufixos de temps](/manual/appendix/suffixes#time -sufixos). També es permeten valors negatius.<br><br>Per defecte: `""` (buida).| |*Funció d'agregació*|0|ds.aggregate_function.0|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte ;<br>5 - suma;<br>6 - primer;<br>7 - darrer.| |*Interval d'agregació*|1|ds.aggregate_interval.0|Cadena de temps vàlida (p. ex., `3600`, `1h`, etc.).<br>Podeu utilitzar [sufixos de temps](/manual/appendix/suffixes#time -sufixos).<br><br>Per defecte: `1h`.| |*Afegit*|0|ds.aggregate_grouping.0|0 - *(per defecte)* Cada element;<br>1 - Conjunt de dades.<br><br>El paràmetre *Afegit* no és pas disponible si la *funció d'agregació* és establerta a "cap".| #### Data types The Zabbix API supports the following data types as input: |Type|Description| |--|--------| |boolean|A boolean value, accepts either `true` or `false`.| |flag|The value is considered to be `true` if it is passed and not equal to `null`; otherwise, it 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, that is, a plain array.| |object|An associative array.| |query|A value which defines, what data should be returned.<br><br>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. ::: #### Tipus de dades L'API de Zabbix suporta, com a dades d'entrada, els següents tipus: |Tipus|Descripció| |--|--------| |boolean|Un valor booleà accepta tant `true` com `false`.| |flag|El valor es considera `true` si no és igual a `null`, i `false` en cas contrari.| |integer|Un nombre sencer.| |float|Un nombre de coma flotant.| |string|Una cadena de text.| |text|Una cadena llarga de text.| |timestamp|Una marca de temps de Unix.| |array|Una seqüència ordenada de valors; o sia, una matriu simple.| |object|Una matriu associativa.| |query|Un valor que defineix quina informació ha de retornar.<br><br>Es pot definir com una matriu de noms de propietats, per tal de retornar només propietats específiques; o com un dels valors predefinits:<br>`extend` - retorna totes les propietats de l'objecte;<br>`count` - retorna el nombre de registres recuperats, suportats només per algunes subseleccions.| ::: notaimportant L'API de Zabbix sempre retorna com a valors valors strings o arrays. ::: ### DB schema update A new column *name_upper* has been added to the database table **items**. The column contains a capitalized version of the item name or the LLD rule name. This change has been implemented to allow the use of the index with case-insensitive search for API query [optimization](#optimized-api-queries). ### Actualització de l'esquema de la BBDD S'ha afegit una nova columna *name_upper* a la taula de base de dades **elements**. La columna conté una versió en majúscula del nom de l'element o del nom de la regla LLD. Aquest canvi es va implementar per permetre l'ús de l'índex amb una cerca que no distingeix entre majúscules i minúscules per a les API de consulta [optimitzades](#optimized-api-queries). # dcheck.get # dcheck.get ### Debian/Ubuntu Open the `/etc/apt/sources.list.d/zabbix.list` and uncomment "Zabbix unstable repository". # Zabbix unstable repository deb https://repo.zabbix.com/zabbix/5.5/debian bullseye main deb-src https://repo.zabbix.com/zabbix/5.5/debian bullseye main ### Debian/Ubuntu Obriu l'arxiu `/etc/apt/sources.list.d/zabbix.list` i descomenteu la línia "Zabbix unstable repository". # Zabbix unstable repository deb https://repo.zabbix.com/zabbix/5.5/debian bullseye main deb-src https://repo.zabbix.com/zabbix/5.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.| ### Depuració Informació de depuració de l'script Webhook executat. L'objecte depuració té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |logs|array|Matriu d'[entrades de registre](/manual/api/reference/script/object#Log entry).| |ms|string|Temps d'execució de l'script en mil·lisegons.| #### 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. #### Depuració de la passarel·la Java En cas que hi hagi un problema amb la passarel·la de Java o si el missatge d'error sobre un element de la interfície no és prou descriptiu, potser voldreu fer una ullada al fitxer de registre de la passarel·la de Java. Per defecte, la passarel·la de Java registra les seves activitats al fitxer /tmp/zabbix\_java.log amb el nivell de registre "info". De vegades aquesta informació no és suficient i cal tindre informació de nivell "depuració". Per augmentar el nivell de registre, editeu el fitxer lib/logback.xml i canvieu l'atribut level de l'etiqueta <root> a "debug": <root level="debug"> <appender-ref ref="FILE" /> </root> Tingueu en compte que, a diferència del servidor Zabbix o el proxy Zabbix, no cal reiniciar Zabbix Java Gateway després d'editar el fitxer logback.xml. Els canvis fets a logback.xml es tenen en compte automàticament. Quan hagueu acabat de depurar, podeu tornar a canviar el nivell de registre a "informació". Si voleu iniciar sessió en un altre fitxer o en un suport completament diferent, com ara una base de dades, ajusteu el fitxer logback.xml segons les vostres necessitats. Consulteu el [manual de retrocés](http://logback.qos.ch/manual/) per obtindre més detalls. De vegades, amb finalitats de depuració, és útil iniciar la passarel·la de Java com una aplicació de consola en lloc d'un dimoni. Per fer-ho, comenteu la variable PID\_FILE a settings.sh. Si s'omet PID\_FILE, l'script startup.sh inicia la passarel·la Java com una aplicació de consola i obliga a Logback a emprar el fitxer lib/logback-console.xml, que no només retorna els seus registres a la consola, sinó que també té el nivell de registre "depuració". Finalment, tingueu en compte que, com Java Gateway utilitza SLF4J per al registre, podeu substituir Logback amb l'estructura que vulgueu col·locant un fitxer JAR adequat al directori lib. Consulteu el [manual SLF4J](http://www.slf4j.org/manual.html) per a més detalls. #### 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 `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> #### Depuració de la passarel·la Java L'arxiu de registre de la passarel·la Java Zabbix és: /var/log/zabbix/zabbix_java_gateway.log Si us cal augmentar el nivell de registre, editeu l'arxiu: /etc/zabbix/zabbix_java_gateway_logback.xml i modifiqueu `level="info"` a "debug" o encara "trace" (per un a revisió d'errades en profunditat): <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 `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> #### Depuració de la passarel·la Java L'arxiu de registre de la passarel·la Java Zabbix és: /var/log/zabbix/zabbix_java_gateway.log Si us cal augmentar el nivell de registre, editeu l'arxiu: /etc/zabbix/zabbix_java_gateway_logback.xml i modifiqueu `level="info"` a "debug" o encara "trace" (per un a revisió d'errades en profunditat): <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 `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> #### Depuració de la passarel·la Java L'arxiu de registre de la passarel·la Java Zabbix és: /var/log/zabbix/zabbix_java_gateway.log Si us cal augmentar el nivell de registre, editeu l'arxiu: /etc/zabbix/zabbix_java_gateway_logback.xml i modifiqueu `level="info"` a "debug" o encara "trace" (per un a revisió d'errades en profunditat): <configuration scan="true" scanPeriod="15 seconds"> [...] <root level="info"> <appender-ref ref="FILE" /> </root> </configuration> ### Default authentication By default, Zabbix uses internal Zabbix authentication for all users. It is possible to change the default method to [LDAP](#ldap_authentication) system-wide or enable LDAP authentication only for specific user groups. To set LDAP as default authentication method for all users, navigate to the *LDAP* tab and configure authentication parameters, then return to the *Authentication* tab and switch *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. Vice versa, if internal authentication is used globally, LDAP authentication details can be specified and used for specific user groups whose [frontend access](/manual/config/users_and_usergroups/usergroup#configuration) is 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 internal authentication method. [HTTP](#http_authentication) and [SAML 2.0](#saml_authentication) authentication methods can be used in addition to the default authentication method. ### Autenticació per defecte Per defecte, Zabbix empra l'autenticació interna de Zabbix per a tots els usuaris. És possible canviar el mètode predeterminat a [LDAP](#ldap_authentication) a tot el sistema o habilitar l'autenticació LDAP només per a grups d'usuaris específics. Per establir LDAP com a mètode d'autenticació predeterminat per a tots els usuaris, aneu a la pestanya *LDAP* i configureu l'autenticació, després torneu a la pestanya *Autenticació* i activeu l'interruptor *Autenticació predeterminada* a LDAP. Tingueu en compte que el mètode d'autenticació es pot perfeccionar al nivell [grup d'usuaris](/manual/config/users_and_usergroups/usergroup). Fins i tot si l'autenticació LDAP és configurada globalment, alguns grups d'usuaris encara poden ser autenticats per Zabbix. Aquests grups han de tindre [accés frontal](/manual/config/users_and_usergroups/usergroup#configuration) establert com a Intern. Per contra, si l'autenticació interna s'empra globalment, els detalls d'autenticació LDAP es poden especificar i emprar per a grups d'usuaris específics l'[accés frontal](/manual/config/users_and_usergroups/usergroup#configuration) és establert a LDAP. Si un usuari és inclòs en almenys un grup d'usuaris amb autenticació LDAP, aquest usuari no podrà emprar el mètode d'autenticació interna. Els mètodes d'autenticació [HTTP](#http_authentication) i [SAML 2.0](#saml_authentication) es poden emprar a més del mètode d'autenticació predeterminat. #### 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"| #### Expressions regulars globals per defecte Zabbix conté per defecte diverses expressions regulars globals. |Nom|Expressió|Correspondències| |--|-------|------| |*Sistemes de fitxers per a la descoberta*|`^(btrfs\|ext2\|ext3\|ext4\|jfs\|reiser\|xfs\|ffs\|ufs\|jfs\|jfs2\|vxfs\|hfs\| refs\|apfs\|ntfs\|fat32\|zfs)$`|"btrfs" o "ext2" o "ext3" o "ext4" o "jfs" o "reiser" o "xfs" o "ffs" o " ufs" o "jfs" o "jfs2" o "vxfs" o "hfs" o "refs" o "apfs" o "ntfs" o "fat32" o "zfs"| |*Interfícies de xarxa per a la descoberta*|`^Software Loopback Interface`|Cadenes que comencen per "Software Loopback Interface".| | |`^lo$`|"lo"| | |`^(In)?[Ll]oop[Bb]ack[0-9._]*$`|Cadenes que comencen opcionalment amb "In", després tenen "L" o "l", després "oop", després "B" o "b", després "ack", que pot anar seguit opcionalment de qualsevol nombre de dígits, punts o guions baixos.| | |`^NULL[0-9.]*$`|Cadenes que comencen per "NULL" seguides opcionalment per qualsevol nombre de dígits o punts.| | |`^[Ll]o[0-9.]*$`|Cadenes que comencen per "Lo" o "lo" i opcionalment seguides per qualsevol nombre de dígits o punts.| | |`^[Ss]ystem$`|"Sistema" o "sistema"| | |`^Nu[0-9.]*$`|Cadenes que comencen per "Nu" seguides opcionalment per qualsevol nombre de dígits o punts.| |*Dispositius d'emmagatzematge per a la descoberta d'SNMP*|`^(Memòria física\|Memòria virtual\|Buffers de memòria\|Memòria en memòria cau\|Espai d'intercanvi)$`|"Memòria física" o "Memòria virtual" o "Memòria intermèdia" o " Memòria a la memòria cau" o "Espai d'intercanvi"| |*Noms de serveis de Windows per a la descoberta*|`^(MMCSS\|gupdate\|SysmonLog\|clr_optimization_v2.0.50727_32\|clr_optimization_v4.0.30319_32)$`|"MMCSS" o "gupdate" o "SysmonLog like" o "SysmonLog" clr\_optimization\_v2.0.50727\_32" i "clr\_optimization\_v4.0.30319\_32" on en lloc de punts podeu posar qualsevol caràcter excepte la nova línia.| |*Estats d'inici del servei de Windows per a la descoberta*|`^(automàtic\|automàtic endarrerit)$`|"automàtic" o "automàtic endarrerit"| #### 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. ::: #### Nombres de port per defecte La següent llista de ports oberts per component s'aplica a la configuració predeterminada: |Component Zabbix|Nombre de port|Protocol|Tipus de connexió| |-------|--------|--------|--------| |Agent Zabbix|10050|TCP|a petició| |Agent Zabbix 2|10050|TCP|a petició| |Servidor Zabbix|10051|TCP|a petició| |Proxy Zabbix|10051|TCP|a petició| |Zabbix Java Gateway|10052|TCP|a petició| |Servei web Zabbix|10053|TCP|a petició| |Interfaz Zabbix|80|HTTP|a petició| |^|443|HTTPS|a petició| |Trapper Zabbix|10051 |TCP|a petició | :::noteclassic Els nombres de port s'han d'obrir al tallafocs per permetre les comunicacions de Zabbix. Les connexions TCP de sortida generalment no requereixen una configuració explícita del tallafocs. ::: #### Default user roles By default, Zabbix is configured with four user roles, which have a pre-defined set of permissions: - Admin role - Guest role - Super admin role - User role {width="600"} The list of all users assigned the respective role is displayed. The users included in disabled groups are stated in red. ::: noteclassic Default *Super admin role* cannot be modified or deleted, because at least one Super admin user with unlimited privileges must exist in Zabbix. ::: Zabbix users with type Super admins and proper permissions can modify or delete existing roles or create new custom roles. To create a new role, click on the *Create user role* button at the top right corner. To update an existing role, press on the role name to open the configuration form.  Available permission options along with default permission sets for pre-configured user roles in Zabbix are described below. | | | | | | | | |-|----------|--------------------------------------|----|----|----|----| |**Parameter**|<|**Description**|**Default user roles**|<|<|<| | |<|<|*Super admin role*|*Admin role*|*User role*|*Guest role*| |User type|<|Selected user type determines the list of available permissions.<br>Upon selecting a user type, all available permissions for this user type are granted by default.<br>Uncheck the checkbox(es) to revoke certain permissions for the user role.<br>Checkboxes for permissions not available for this user type are grayed out.|Super admin|Admin|User|User| |**Access to UI elements**|<|<|<|<|<|<| |*Monitoring*|<|<|<|<|<|<| | |Dashboard|Enable/disable access to a specific Monitoring menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Problems|^|^|^|^|^| |^|Hosts|^|^|^|^|^| |^|Latest data|^|^|^|^|^| |^|Maps|^|^|^|^|^| |^|Discovery|^|^|^|No|No| |*Services*|<|<|<|<|<|<| | |Services|Enable/disable access to a specific Services menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Service actions|^|^|^|No|No| |^|SLA|^|^|^|^|^| |^|SLA report|^|^|^|Yes|Yes| |*Inventory*|<|<|<|<|<|<| | |Overview|Enable/disable access to a specific Inventory menu section and underlying pages.|Yes|Yes|Yes|Yes| |^|Hosts|^|^|^|^|^| |*Reports*|<|<|<|<|<|<| | |System information|Enable/disable access to a specific Reports menu section and underlying pages.|Yes|No|No|No| |^|Availability report|^|^|Yes|Yes|Yes| |^|Triggers top 100|^|^|^|^|^| |^|Audit|^|^|No|No|No| |^|Action log|^|^|^|^|^| |^|Notifications|^|^|Yes|^|^| |^|Scheduled reports|^|^|^|^|^| |*Configuration*|<|<|<|<|<|<| | |Host groups|Enable/disable access to a specific *Configuration* menu section and underlying pages.|Yes|Yes|No|No| |^|Templates|^|^|^|^|^| |^|Hosts|^|^|^|^|^| |^|Maintenance|^|^|^|^|^| |^|Actions|^|^|^|^|^| |^|Event correlation|^|^|No|^|^| |^|Discovery|^|^|Yes|^|^| |*Administration*|<|<|<|<|<|<| | |General|Enable/disable access to a specific *Administration* menu section and underlying pages.|Yes|No|No|No| |^|Proxies|^|^|^|^|^| |^|Authentication|^|^|^|^|^| |^|User groups|^|^|^|^|^| |^|User roles|^|^|^|^|^| |^|Users|^|^|^|^|^| |^|Media types|^|^|^|^|^| |^|Scripts|^|^|^|^|^| |^|Queue|^|^|^|^|^| |*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 *Allow list* to allow only specified API methods or *Deny list* to restrict only specified API methods.<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|^|^|^|^|^| |^|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).|^|^|^|^| |^|Default access to new actions|This option specifies how new actions will be accessible after a Zabbix upgrade.|^|^|Yes|^| Notes: - Each user may have only one role assigned. - If an element is restricted, users will not be able to access it even by entering a direct URL to this element into the browser. - Users of type *User* or *Admin* cannot change their own role settings. - Users of type *Super admin* can modify settings of their own role (not available for the default *Super admin role*), but not the user type. - Users of all levels cannot change their own user type. See also: - [Configuring a user](/manual/config/users_and_usergroups/user) #### Rols d'usuari per defecte Per defecte, Zabbix es configura amb quatre rols d'usuari, que tenen el següent conjunt predefinit de permisos: - Rol d'administrador - Rol de convidat - Rol de superadministrador - Rol d'usuari {width="600"} Es mostra la llista de tots els usuaris assignats al rol respectiu. Els usuaris deshabilitats es marquen en vermell. ::: noteclassic El *rol de superadministrador* per defecte no es pot modificar ni suprimir, doncs com a mínim ha d'existir un usuari superadministrador amb privilegis il·limitats. ::: Els usuaris de Zabbix amb el tipus Superadministradors i els permisos adequats poden modificar o esborrar els rols existents o crear nous rols personalitzats. Per crear un rol nou, feu clic al botó *Crear un rol d'usuari* a la cantonada superior dreta. Per actualitzar un rol existent, feu clic al nom del rol per obrir el formulari de configuració.  Les opcions de permisos disponibles juntament amb els conjunts de permisos predeterminats dels rols d'usuari es descriuen tot seguit. | | | | | | | | |-|-----------|-------------------------------------- --|----|----|----|----| |**Paràmetre**|<|**Descripció**|**Rols d'usuari predeterminats**|<|<|<| | |<|<|*Rol de superadministrador*|*Rol d'administrador*|*Rol d'usuari*|*Rol de convidat*| |Tipus d'usuari|<|El tipus d'usuari seleccionat determina la llista de permisos disponibles.<br>En seleccionar un tipus d'usuari, tots els permisos disponibles per a aquest tipus d'usuari s'atorguen de manera predeterminada.<br>Desmarqueu les caselles de selecció per revocar determinats permisos. per al rol d'usuari.<br>Les caselles de selecció dels permisos no disponibles per a aquest tipus d'usuari estan atenuades.|Super administrador|Administrador|Usuari|Usuari| |**Accés als elements de la IU**|<|<|<|<|<|<| |*Vigilància*|<|<|<|<|<|<| | |Tauler|Activar/desactivar l'accés a una secció específica del menú de Monitoratge i pàgines subjacents.|Sí|Sí|Sí|Sí| |^|Problemes|^|^|^|^|^| |^|Equips|^|^|^|^|^| |^|Darreres dades|^|^|^|^|^| |^|Mapes|^|^|^|^|^| |^|Descoberta|^|^|^|No|No| |*Serveis*|<|<|<|<|<|<| | |Serveis|Activar/desactivar l'accés a una secció específica del menú Serveis i pàgines subjacents.|Sí|Sí|Sí|Sí| |^|Accions de servei|^|^|^|No|No| |^|SLA|^|^|^|^|^| |^|Informe SLA|^|^|^|Sí|Sí| |*Inventari*|<|<|<|<|<|<| | |Vista general|Activar/desactivar l'accés a una secció específica del menú d'Inventari i pàgines subjacents.|Sí|Sí|Sí|Sí| |^|Equips|^|^|^|^|^| |*Informes*|<|<|<|<|<|<| | |Informació del sistema|Activar/desactivar l'accés a una secció específica del menú Informes i pàgines subjacents.|Sí|No|No|No| |^|Informe de disponibilitat|^|^|Sí|Sí|Sí| |^|Activa els 100 primers|^|^|^|^|^| |^|Auditoria|^|^|No|No|No| |^|Registre d'accions|^|^|^|^|^| |^|Notificacions|^|^|Sí|^|^| |^|Informes programats|^|^|^|^|^| |*Configuració*|<|<|<|<|<|<| | |Grups d'equips|Activar/desactivar l'accés a una secció específica del menú *Configuració* i pàgines subjacents.|Sí|Sí|No|No| |^|Plantilles|^|^|^|^|^| |^|Equips|^|^|^|^|^| |^|Manteniment|^|^|^|^|^| |^|Accions|^|^|^|^|^| |^|Correlació d'esdeveniments|^|^|No|^|^| |^|Descoberta|^|^|Sí|^|^| |*Administració*|<|<|<|<|<|<| | |General|Activar/desactivar l'accés a una secció específica del menú *Administració* i pàgines subjacents.|Sí|No|No|No| |^|Proxies|^|^|^|^|^| |^|Autenticació|^|^|^|^|^| |^|Grups d'usuaris|^|^|^|^|^| |^|Rols d'usuari|^|^|^|^|^| |^|Usuaris|^|^|^|^|^| |^|Tipus de mitjans|^|^|^|^|^| |^|Guions|^|^|^|^|^| |^|Cua|^|^|^|^|^| |*Accés per defecte als nous elements de la IU*|<|Aquesta opció especifica com les noves seccions de menú seran accesibles després d'una actualització de Zabbix. Les seccions de menús existents dels mòduls no es veuran pas afectades.|Sí|Sí|Sí|Sí| |**Accés als serveis**|<|<|<|<|<|<| | |Accés de lectura i escriptura als serveis|Trieu l'accés de lectura i escriptura als serveis:<br>**Cap** - cap accés<br>**Tots** - l'accés a tots els serveis és de lectura i escriptura<br>**Llista de serveis** - trieu serveis per a l'accés de lectura i escriptura<br><br>L'accés de lectura i escriptura, si es concedeix, té prioritat sobre la configuració d'accés només de lectura i és heretat dinàmicament pels serveis secundaris.|Tots|Tots |Cap|Cap| |^|Accés de lectura i escriptura als serveis amb etiqueta|Especifiqueu el nom de l'etiqueta i, opcionalment, el valor per concedir, addicionalment, accés de lectura i escriptura als serveis que coincideixin amb l'etiqueta.<br>Aquesta opció està disponible si es tria "Llistat de serveis" a *Paràmetre d'accés de lectura i escriptura als serveis*.<br>L'accés de lectura i escriptura, si es concedeix, té prioritat sobre la configuració d'accés només de lectura i és heretat dinàmicament pels serveis secundaris.|^|^|^|^| |^|Accés de només lectura als serveis|Trieu l'accés només de lectura als serveis:<br>**Cap** - no hi ha accés en absolut<br>**Tots** - l'accés a tots els serveis és només de lectura<br >**Llista de serveis** - trieu serveis per a l'accés només de lectura<br><br>L'accés només de lectura no té prioritat sobre l'accés de lectura i escriptura i és heretat dinàmicament pels serveis secundaris.|^|^| Tots|Tots| |^|Accés de només lectura als serveis amb etiqueta|Especifiqueu el nom de l'etiqueta i, opcionalment, el valor per concedir, addicionalment, accés de només lectura als serveis que coincideixin amb l'etiqueta.<br>Aquesta opció està disponible si es tria "Llista de serveis" a *Paràmetre d'accés només de lectura als serveis*.<br>L'accés només de lectura no té prioritat sobre l'accés de lectura i escriptura i és heretat dinàmicament pels serveis secundaris.|^|^|^|^| |**Accés als mòduls**|<|<|<|<|<|<| ||<Nom del mòdul>|Permetre/denegar l'accés a un mòdul específic. En aquesta secció només es mostren els mòduls habilitats. No és possible concedir o restringir l'accés a un mòdul que actualment està desactivat.|Sí|Sí|Sí|Sí| |^|*Accés per defecte als mòduls nous*|Aquesta opció especifica com els nous mòduls i ginys seran accessibles després d'una actualització de Zabbix. Això també aplica als mòduls i mòduls i ginys aegits a la secció *Administració > General > Mòduls*.|^|^|^|^| |**Accés a l'API**|<|<|<|<|<|<| | |*Activat*|Activar/desactivar l'accés a l'API.|Sí|Sí|Sí|No| |^|*Mètodes API*|Seleccioneu *Permetre llista* per permetre només els mètodes API especificats o *Denegar llista* per restringir només els mètodes API especificats.<br><br>Al camp de cerca, comenceu a escriure el nom del mètode i, a continuació, seleccioneu el mètode de la llista d'emplenament automàtic.<br>També podeu prémer el botó Seleccionar i seleccionar mètodes de la llista completa disponible per a aquest tipus d'usuari. Tingueu en compte que si determinades accions del bloc Accés a les accions no estan marcades, els usuaris no podran emprar els mètodes de l'API relacionats amb aquesta acció.<br><br>S'admeten els comodins. Exemples: `tauler de control.*` (tots els mètodes del servei de l'API 'tauler de control') `*` (qualsevol mètode), `*.export' (mètodes amb el nom '.export' de tots els serveis de l'API).<br><br >Si no s'ha especificat cap mètode, s'ignorarà la regla de llista Permetre/Denegar.|^|^|^|^| |**Accés a les accions**|<|<|<|<|<|<| | |Crear i editar taulers de control|Si desactiveu aquesta casella de selecció també es revocaran els drets per emprar els mètodes API `.create`, `.update` i `.delete` per als elements corresponents.|Sí|Sí|Sí|No| |^|Crear i editar mapes|^|^|^|^|^| |^|Crear i editar manteniment|^|^|^|No|^| |^|Afegeix comentaris de problemes|Si s'esborra aquesta casella de selecció també es revocaran els drets per dur a terme l'acció corresponent mitjançant el mètode de l'API `event.acknowledge`.|^|^|Sí|^| |^|Canvia la gravetat|^|^|^|^|^| |^|Reconeix els problemes|^|^|^|^|^| |^|Tancar els problemes|^|^|^|^|^| |^|Executar scripts|Si desactiveu aquesta casella de selecció també es revocaran els drets per emprar el mètode API `script.execute`.|^|^|^|^| |^|Gestiona els testimonis de l'API|Si desactiveu aquesta casella de selecció també es revocaran els drets d'emprar tots els mètodes de l'API `token.|^|^|^|^| |^|Gestiona els informes programats|Si esborra aquesta casella de selecció també es revocaran els drets d'emprar tots els mètodes de l'API "informe".|^|^|No|^| |^|Gestiona SLA|Activa/desactiva els drets per gestionar [SLA](/manual/web_interface/frontend_sections/services/sla).|^|^|^|^| |^|Accés per defecte a accions noves||^|Aquesta opció especifica com seran d'accessibles les noves accions després d'una actualització de Zabbix.|^|^|Sí|^| Notes: - Cada usuari només pot tindre un rol assignat. - Si un element és restringit, els usuaris no hi podran accedir ni introduint una URL directa a aquest element al navegador. - Els usuaris del tipus *Usuari* o *Administrador* no poden canviar la configuració del seu propi rol. - Els usuaris del tipus *Super administrador* poden modificar la configuració de la seva pròpia funció (no disponible per al *rol de superadministrador* per defecte), però no el tipus d'usuari. - Els usuaris de tots els nivells no poden canviar el seu propi tipus d'usuari. Veieu també: - [Configuració d'usuari](/manual/config/users_and_usergroups/user) ### Default values for Zabbix agent 2 Zabbix agent 2 plugins now allow to define default values for connecting to monitoring targets in the configuration file. If no value is specified in an item key or a named session, the plugin will use the value defined in the corresponding default parameter. New parameters have the structure `Plugins.<PluginName>.Default.<Parameter>` - for example, `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. See for more info: - [Configuring plugins](/manual/config/items/plugins#configuring-plugins) - [Plugin configuration file parameters](/manual/appendix/config/zabbix_agent2_plugins) ### Valors per defecte de l'agent 2 de Zabbix Els plugins de l'agent 2 de Zabbix ara permeten definir valors predeterminats per connectar als destinataris de monitoratge al fitxer de configuració. Si no s'especifica cap valor en una clau d'element o una sessió amb nom, el plugin emprarà el valor definit al paràmetre predeterminat corresponent. Els nous paràmetres tenen l'estructura `Plugins.<PluginName>.Default.<Parameter>` - per exemple, `Plugins.MongoDB.Default.Uri=tcp://localhost:27017`. Per veure més informació: - [Configurant plugins](/manual/extensions/plugins#configuring-plugins) - [Paràmetres d'arxiu de configuració de plugin](/manual/appendix/config/zabbix_agent2_plugins) ##### Default values Since Zabbix 6.0.18, you can set default values for the connection-related parameters (URI, username, password, etc.) in the configuration file in the format: *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. ::: ##### Valors per defecte Des de Zabbix 6.0.18, podeu establir els valors per defecte per als paràmetres relatius a les connexions (URI, usuari, mot de pas, etc.) a l'arxiu de configuració, en aquest format: *Plugins.<PluginName>.Default.<Parameter>=<Value>* Per exemple, *Plugins.Mysql.Default.Username=zabbix*, *Plugins.MongoDB.Default.Uri=tcp://127.0.0.1:27017*, etc. Si no es proporciona un valor de cada paràmetre a una clau d'element dels paràmetres de la [sessió anomenada](#named-sessions), el plugin emprarà el valor per defecte. Si algun paràmetre no s'ha definit, s'empraran els valors en brut. :::noteclassic Si una clau d'element no té paràmetres, l'agent 2 de Zabbix provarà a collir la mètrica emprant valors definits a la secció de paràmetres per defecte. ::: ##### 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. ##### Definició d'elements Cada element es defineix en una estructura ZBX\_METRIC: ``` {.c} typedef struct { char *key; unsigned flags; int (*function)(); char *test_param; } ZBX_METRIC; ``` Aquí **key** és la clau de l'element (per exemple, "dummy.random"), **flags** és CF\_HAVEPARAMS o 0 (segons si l'element admet paràmetres o no), **function** és una funció en C que implementa l'element (per exemple, "zbx\_module\_dummy\_random"), i **test\_param** és el llistat de paràmetres que s'emprarà quan l'agent Zabbix s'inicia amb l'opció "-p" (p. "1.1000", pot ser NULL). Un exemple de definició podria semblar-se a: ``` {.c} static ZBX_METRIC keys[] = { { "dummy.random", CF_HAVEPARAMS, zbx_module_dummy_random, "1,1000" }, { NULL } } ``` Cada funció que implementa un element ha d'acceptar dos paràmetres de punter, el primer de tipus AGENT\_REQUEST i el segon de tipus 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; } ``` Aquestes funcions haurien de retornar SYSINFO\_RET\_OK, si el valor de l'element s'ha obtingut correctament. En cas contrari, haurien de retornar SYSINFO\_RET\_FAIL. Veieu el mòdul "dummy" d'exemple a continuació amb detalls sobre com obtindre informació d'AGENT\_REQUEST i com configurar la informació a AGENT\_RESULT. #### 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; it may contain hosts and templates. Hosts and templates within a host group are not in any way linked to each other. 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. ***[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/acknowledges#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.* ***[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.* ***[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. ***[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/monitoring/dashboard)*** \- *customizable section of the web interface displaying summaries and visualizations* of important information in visual units called widgets. ***[widget](/manual/web_interface/frontend_sections/monitoring/dashboard/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. ***[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. ***[agent autoregistration](/manual/discovery/auto_registration)*** \- *automated process whereby a Zabbix agent itself is registered* as a host and started to monitor. #### Definicions ***[equip](/manual/config/hosts)*** \- *qualsevol dispositiu físic o virtual, aplicació, servei, o qaulsevol altra col·lecció lògica de paràmetres monitorats.* ***[grup d'equips](/manual/config/hosts)*** \- **una agrupació lògica d'equips; pot contindre equips i plantilles. Els equips i les plantilles d'un grup d'equips no cap relació entre ells. Els grups d'equip s'empren quan s'assignen drets d'accés als equips per a diferents grups d'usuaris.* ***[element](/manual/config/items)*** \- *una dada concreta que voleu rebre d'un equip, una mètrica de dades.* ***[preprocessament del valor](/manual/config/items/item#item_value_preprocessing)*** \- *una transformació del valor d'una mètrica rebuda abans de desar-la a la base de dades.* ***[trigger](/manual/config/triggers)*** \- *una expressió lògica que defineix un llindar de problema i que s'empra per "avaluar" les dades rebudes en els elements.* Quan les dades rebudes superen el llindar, els triggers passen de "D'acord" a "Problema". Quan les dades rebudes estan per sota del llindar, els triggers romanen o tornen a l'estat "D'acord". ***[esdeveniment](/manual/config/events)*** \- *una única ocurrència d'alguna cosa que mereix atenció, com ara un canvi d'estat d'activació, un registre automàtic d'un agent o un descoberta d'agent.* ***[etiqueta d'esdeveniment](/manual/config/tagging)*** \- *una etiqueta predefinida per a l'esdeveniment.* Es pot emprar en la correlació d'esdeveniments, la granularitat dels permisos, etc. ***[correlació d'esdeveniments](/manual/config/event_correlation)*** \- *un mètode per correlacionar problemes amb la seva resolució d'una manera flexible i precisa.* Per exemple, podeu definir que un problema notificat per un trigger es pot resoldre mitjançant un altre trigger, que fins i tot pot emprar un mètode de recollida de dades diferent. ***[problema](/manual/web_interface/frontend_sections/monitoring/problems)*** \- *un disparador en estat "Problema"* ***[Actualització del problema](/manual/acknowledges#issue-update)*** \- *opcions de gestió de problemes proporcionades per Zabbix, com ara afegir comentaris, reconèixer, canviar la gravetat o tancar manualment.* ***[acció](/manual/config/notificacions/acció)*** \- *una manera predefinida de reaccionar davant un esdeveniment.* Una acció consta d'operacions (per exemple, enviar una notificació) i condicions (*quan* es realitza l'operació) ***[escalada](/manual/config/notifications/action/escalations)*** \- *un escenari personalitzat per realitzar operacions en una acció; una seqüència d'enviament de notificacions/execució d'ordres remotes.* ***[suport](/manual/config/notifications/media)*** \- *una manera de lliurar notificacions; canal de lliurament.* ***[notificació](/manual/config/notifications/action/operation/message)*** \- *un missatge sobre un esdeveniment enviat a un usuari a través del canal escollit (mitjans de comunicació).* ***[comanda remota](/manual/config/notifications/action/operation/remote_command)*** \- *una ordre predefinida que s'executa automàticament en un equip monitorat en determinades condicions.* ***[plantilla](/manual/config/templates)*** \- *un conjunt d'entitats (elements, triggers, gràfics, pantalles, aplicacions, regles de descoberta de baix nivell, escenaris web) llestes per aplicar-se a un o més equips.* L'objectiu de les plantilles és accelerar el desplegament de tasques de monitoratge en un equip; també per facilitar l'aplicació de modificacions col·lectives a les tasques de seguiment. Les plantilles són directament vinculades a equips individuals. ***[escenari web](/manual/web_monitoring)*** \- *una o més peticions HTTP per comprovar la disponibilitat d'un lloc web.* ***[interfície web](/manual/introduction/overview#architecture)*** \- *la interfície web proporcionada amb Zabbix.* ***[tauler](/manual/web_interface/frontend_sections/monitoring/dashboard)*** \- *secció personalitzable de la interfície web que mostra resums i vistes* d'informació important en unitats visuals anomenades ginys. ***[giny](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets)*** \- *unitat visual que mostra informació d'un determinat tipus i de fonts* (un resum, un mapa, un gràfic, el rellotge, etc.), emprada en un tauler. ***[API Zabbix](/manual/api)*** \- * L'API Zabbix us permet emprar el protocol JSON RPC per crear, actualitzar i recuperar objectes Zabbix (com ara equips, elements, gràfics i altres) o realitzar altres tasques personalitzades* ***[Servidor Zabbix](/manual/concepts/server)*** \- *un procés central del programari Zabbix que realitza el monitoratge, interactua amb proxys i agents de Zabbix, calcula triggers i envia notificacions; es pot entendre com un dipòsit central de dades.* ***[proxy Zabbix](/manual/concepts/proxy)*** \- *un procés que pot recopilar dades en nom del servidor Zabbix, traient part de la càrrega de processament del servidor.* ***[agent Zabbix](/manual/conceptes/agent)*** \- *un procés desplegat als objectius per monitorar activament els recursos i les aplicacions locals.* ***[Zabbix agent 2](/manual/concepts/agent2)*** \- *una nova generació d'agents Zabbix per monitorar activament els recursos i aplicacions locals, permetent emprar connectors personalitzats per al monitoratge.* ::: noteimportant Com que l'agent Zabbix 2 comparteix moltes característiques amb l'agent Zabbix, el terme "agent Zabbix" a la documentació es refereix tant a l'agent Zabbix com a l'agent Zabbix 2, si el comportament funcional és el mateix. L'agent Zabbix 2 només s'anomena específicament quan difereix la seva funcionalitat. ::: ***[xifrat](/manual/encryption)*** \- *suport per a la comunicació xifrada entre components Zabbix (servidor, proxy, agent, utilitats zabbix\_sender i zabbix\_get)* Emprant el protocol TLS (Transport Layer Security). ***[descoberta de xarxa](/manual/discovery/network_discovery)*** \- *descoberta automàtica de dispositius de xarxa*. ***[descoberta de baix nivell](/manual/discovery/low_level_discovery)*** \- *descoberta automàtica d'entitats de baix nivell en un dispositiu concret* (per exemple: sistemes de fitxers, interfícies de xarxa, etc.). ***[regla de descoberta de baix nivell](/manual/discovery/low_level_discovery#discovery-rule)*** \- *conjunt de definicions per a la descoberta automàtica d'entitats de baix nivell* en un dispositiu ***[prototip d'element](/manual/discovery/low_level_discovery#item_prototypes)*** \- *una mètrica amb alguns paràmetres com a variables, preparada per a la descoberta de baix nivell*. Després de la descoberta de baix nivell, les variables es substitueixen automàticament pels paràmetres descoberts reals i la mètrica comença a recollir dades automàticament. ***[prototip de trigger](/manual/discovery/low_level_discovery#trigger_prototypes)*** \- *un trigger amb alguns paràmetres com a variables, llest per a la descoberta de baix nivell*. Després de la descoberta de baix nivell, les variables es substitueixen automàticament amb els paràmetres descoberts reals i el trigger comença automàticament a avaluar les dades. Els *prototips* d'algunes altres entitats Zabbix també s'empren a la descoberta de baix nivell: prototips de gràfics, prototips d'equip, prototips de grups d'equip. ***[registre automàtic de l'agent](/manual/discovery/auto_registration)*** \- *procés automatitzat pel qual un agent Zabbix es registra* com a equip i comença a ser monitorat. #### Delete a host interface Delete the host interface with ID 30062. Request: ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Esborrar la interfície d'un equip Esborrar l'interfície amb ID 30062 d'un equip. Petició: ```json { "jsonrpc": "2.0", "method": "hostinterface.delete", "params": [ "30062" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "interfaceids": [ "30062" ] }, "id": 1 } ``` #### Delete multiple actions Delete two actions. Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Esborrar múltiples accions Esborrar dues accions. Request: ```json { "jsonrpc": "2.0", "method": "action.delete", "params": [ "17", "18" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "17", "18" ] }, "id": 1 } ``` #### Delete multiple correlations Delete two correlations. Request: ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### Esborrar múltiples correlacions. Esborra dues dorrelacions. Petició: ```json { "jsonrpc": "2.0", "method": "correlation.delete", "params": [ "1", "2" ], "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1", "2" ] }, "id": 1 } ``` #### Delete multiple discovery rules Delete two discovery rules. Request: ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### Esborrar diverses regles de descobriment Esborar dues regles de descobriment. Petició: ```json { "jsonrpc": "2.0", "method": "drule.delete", "params": [ "4", "6" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "druleids": [ "4", "6" ] }, "id": 1 } ``` #### Delete multiple icon maps Delete two icon maps. Request: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Esborrar múltiples mapes d'icones Esborrar dos mapes d'icones. Petició: ```json { "jsonrpc": "2.0", "method": "iconmap.delete", "params": [ "2", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "iconmapids": [ "2", "5" ] }, "id": 1 } ``` #### Delete multiple images Delete two images. Request: ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### Esborrar múltiples imatges Esborra dues imatges. Petició: ```json { "jsonrpc": "2.0", "method": "image.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "imageids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple maps Delete two maps. Request: ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### Esborrar diversos mapes Esborrar dos mapes. Petició: ```json { "jsonrpc": "2.0", "method": "map.delete", "params": [ "12", "34" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "12", "34" ] }, "id": 1 } ``` #### Delete multiple proxies Delete two proxies. Request: ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` #### Esborrar diversos proxys Esborrar dos proxys. Petició: ```json { "jsonrpc": "2.0", "method": "proxy.delete", "params": [ "10286", "10285" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "proxyids": [ "10286", "10285" ] }, "id": 1 } ``` #### Delete multiple scripts Delete two scripts. Request: ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### Esborrar diversos scripts Esborrar dos scripts. Petició: ```json { "jsonrpc": "2.0", "method": "script.delete", "params": [ "3", "4" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "scriptids": [ "3", "4" ] }, "id": 1 } ``` #### Delete multiple tokens Delete two tokens. Request: ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` #### Esborrar diversos tokens Esborrar dos tokens. Petició: ```json { "jsonrpc": "2.0", "method": "token.delete", "params": [ "188", "192" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "tokenids": [ "188", "192" ] }, "id": 1 } ``` #### Delete multiple triggers Delete two triggers. Request: ```json { "jsonrpc": "2.0", "method": "trigger.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Esborrar diversos triggers Esborrar dos triggers. Petició: ```json { "jsonrpc": "2.0", "method": "trigger.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Deleting dependencies from multiple triggers Delete all dependencies from two triggers. Request: ```json { "jsonrpc": "2.0", "method": "trigger.deleteDependencies", "params": [ { "triggerid": "14544" }, { "triggerid": "14545" } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "14544", "14545" ] }, "id": 1 } ``` #### Esborrar les dependències de diversos triggers Esborrar totes les dependències de dos triggers. Petició: ```json { "jsonrpc": "2.0", "method": "trigger.deleteDependencies", "params": [ { "triggerid": "14544" }, { "triggerid": "14545" } ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "14544", "14545" ] }, "id": 1 } ``` #### Deleting multiple dashboards Delete two dashboards. Request: ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### Esborrar múltiples taulers Esborrar dos taulers. Petició: ```json { "jsonrpc": "2.0", "method": "dashboard.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "2", "3" ] }, "id": 1 } ``` #### Deleting multiple global macros Delete two global macros. Request: ```json { "jsonrpc": "2.0", "method": "usermacro.deleteglobal", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Esborrar diverses macros globals Esborrar dues macros globals. Petició: ```json { "jsonrpc": "2.0", "method": "usermacro.deleteglobal", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "globalmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Deleting multiple global regular expressions. Request: ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### Esborrar diverses expressions regulars globals. Petició: ```json { "jsonrpc": "2.0", "method": "regexp.delete", "params": [ "16", "17" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "regexpids": [ "16", "17" ] }, "id": 1 } ``` #### Deleting multiple graph prototypes Delete two graph prototypes. Request: ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Esborrar diversos prototips de gràfics Esborrar dos prototips de gràfics. Petició: ```json { "jsonrpc": "2.0", "method": "graphprototype.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple graphs Delete two graphs. Request: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Esborrar múltiples gràfics Esborrar dos gràfics. Petició: ```json { "jsonrpc": "2.0", "method": "graph.delete", "params": [ "652", "653" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "graphids": [ "652", "653" ] }, "id": 1 } ``` #### Deleting multiple host groups Delete two host groups. Request: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Esborrar diversos grups d'equips Esborra dos grups d'equips. Petició: ```json { "jsonrpc": "2.0", "method": "hostgroup.delete", "params": [ "107824", "107825" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "groupids": [ "107824", "107825" ] }, "id": 1 } ``` #### Deleting multiple host macros Delete two host macros. Request: ```json { "jsonrpc": "2.0", "method": "usermacro.delete", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Esborrar diverses macros d'equips Esborrar dues macros d'equips. Petició: ```json { "jsonrpc": "2.0", "method": "usermacro.delete", "params": [ "32", "11" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "hostmacroids": [ "32", "11" ] }, "id": 1 } ``` #### Deleting multiple host prototypes Delete two host prototypes. Request: ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### Esborrar diversos prototips d'equips Esborra dos prototips d'equips. Petició: ```json { "jsonrpc": "2.0", "method": "hostprototype.delete", "params": [ "10103", "10105" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10103", "10105" ] }, "id": 1 } ``` #### Deleting multiple hosts Delete two hosts. Request: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "13", "32" ] }, "id": 1 } ``` #### Esborrar diversos equips Esborrar dos equips. Petició: ```json { "jsonrpc": "2.0", "method": "host.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "itemprototype.delete", "params": [ "27352", "27356" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "prototypeids": [ "27352", "27356" ] }, "id": 1 } ``` #### Esborrar diversos prototips d'element Esborrar dos prototipus d'elements.<br> Els prototipus d'elements dependents s'esborren automàticament si l'element principal o el prototipus d'element és esborrat. Petició: ```json { "jsonrpc": "2.0", "method": "itemprototype.delete", "params": [ "27352", "27356" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "item.delete", "params": [ "22982", "22986" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22982", "22986" ] }, "id": 1 } ``` #### Esborrar diversos elements Esborra dos elements.<br> Els elements dependents i els prototips d'element s'esborren automàticament si s'esborra l'element principal. Petició: ```json { "jsonrpc": "2.0", "method": "item.delete", "params": [ "22982", "22986" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "22982", "22986" ] }, "id": 1 } ``` #### Deleting multiple LLD rules Delete two LLD rules. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### Esborrar diverses regles LLD Esborrar dues regles LLD. Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.delete", "params": [ "27665", "27668" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "ruleids": [ "27665", "27668" ] }, "id": 1 } ``` #### Deleting multiple maintenance periods Delete two maintenance periods. Request: ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### Esborrar múltiples períodes manteniments Esborrar dos períodes de manteniment. Petició: ```json { "jsonrpc": "2.0", "method": "maintenance.delete", "params": [ "3", "1" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "maintenanceids": [ "3", "1" ] }, "id": 1 } ``` #### Deleting multiple media types Delete two media types. Request: ```json { "jsonrpc": "2.0", "method": "mediatype.delete", "params": [ "3", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "3", "5" ] }, "id": 1 } ``` #### Esborrar diversos tipus de suport Esborrar dos tipus de suport. Petició: ```json { "jsonrpc": "2.0", "method": "mediatype.delete", "params": [ "3", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "3", "5" ] }, "id": 1 } ``` #### Deleting multiple scheduled reports Delete two scheduled reports. Request: ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### Esborrar diversos informes planificats Esborrar dos informes planificats. Petició: ```json { "jsonrpc": "2.0", "method": "report.delete", "params": [ "1", "2" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1", "2" ] }, "id": 1 } ``` #### Deleting multiple services Delete two services. Request: ```json { "jsonrpc": "2.0", "method": "service.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4", "5" ] }, "id": 1 } ``` #### Esborrar diversos serveis Esborrar dos serveis. Petició: ```json { "jsonrpc": "2.0", "method": "service.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "serviceids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple SLAs Delete two SLA entries. Request: ```json { "jsonrpc": "2.0", "method": "sla.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "4", "5" ] }, "id": 1 } ``` #### Esborrar diversos SLA Esborrar dos SLAs. Petició: ```json { "jsonrpc": "2.0", "method": "sla.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "slaids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple template dashboards Delete two template dashboards. Request: ```json { "jsonrpc": "2.0", "method": "templatedashboard.delete", "params": [ "45", "46" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "45", "46" ] }, "id": 1 } ``` #### Esborrar dieversos taulers de plantilles Esborar dos taulers de plantilles. Petició: ```json { "jsonrpc": "2.0", "method": "templatedashboard.delete", "params": [ "45", "46" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "dashboardids": [ "45", "46" ] }, "id": 1 } ``` #### Deleting multiple templates Delete two templates. Request: ```json { "jsonrpc": "2.0", "method": "template.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "13", "32" ] }, "id": 1 } ``` #### Esborrar diverses plantilles Esborrar dues plantilles. Petició: ```json { "jsonrpc": "2.0", "method": "template.delete", "params": [ "13", "32" ], "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "13", "32" ] }, "id": 1 } ``` #### Deleting multiple trigger prototypes Delete two trigger prototypes. Request: ```json { "jsonrpc": "2.0", "method": "triggerprototype.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Esborrar diversos prototips de triggers Esborrar dos prototips de triggers. Petició: ```json { "jsonrpc": "2.0", "method": "triggerprototype.delete", "params": [ "12002", "12003" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "12002", "12003" ] }, "id": 1 } ``` #### Deleting multiple user groups Delete two user groups. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.delete", "params": [ "20", "21" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20", "21" ] }, "id": 1 } ``` #### Esborrar diversos grups d'usuaris Esborrar dos grups d'usuaris. Petició: ```json { "jsonrpc": "2.0", "method": "usergroup.delete", "params": [ "20", "21" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "20", "21" ] }, "id": 1 } ``` #### Deleting multiple user roles Delete two user roles. Request: ```json { "jsonrpc": "2.0", "method": "role.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "4", "5" ] }, "id": 1 } ``` #### Esborrar diversos rols d'usuari Esborrar dos rols d'usuari. Petició: ```json { "jsonrpc": "2.0", "method": "role.delete", "params": [ "4", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "4", "5" ] }, "id": 1 } ``` #### Deleting multiple users Delete two users. Request: ```json { "jsonrpc": "2.0", "method": "user.delete", "params": [ "1", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "userids": [ "1", "5" ] }, "id": 1 } ``` #### Esborrar diversos usuaris Esborrar dos usuaris. Petició: ```json { "jsonrpc": "2.0", "method": "user.delete", "params": [ "1", "5" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "userids": [ "1", "5" ] }, "id": 1 } ``` #### Deleting multiple value maps Delete two value maps. Request: ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### Esborrar diversos mapes de valors Esborrar dos mapes de valors. Petició: ```json { "jsonrpc": "2.0", "method": "valuemap.delete", "params": [ "1", "2" ], "auth": "57562fd409b3b3b9a4d916d45207bbcb", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "valuemapids": [ "1", "2" ] }, "id": 1 } ``` #### Deleting multiple web scenarios Delete two web scenarios. Request: ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` #### Esborrar múltiples escenaris Web Esborra dos escenaris Web. Petició: ```json { "jsonrpc": "2.0", "method": "httptest.delete", "params": [ "2", "3" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "2", "3" ] }, "id": 1 } ``` ##### Deny specific check - Blacklist a specific check with DenyKey parameter. Matching keys will be disallowed. All non-matching keys will be allowed, except system.run\[\] items. For example: # Deny secure data access DenyKey=vfs.file.contents[/etc/passwd,*] ::: noteimportant A blacklist may not be a good choice, because a new Zabbix version may have new keys that are not explicitly restricted by the existing configuration. This could cause a security flaw. ::: ##### Denegar validacions específiques - Posar a la llista negra una comprovació específica amb el paràmetre DenyKey. Les claus coincidents no es permetran. Es permetran totes les claus que no coincideixen, excepte els elements system.run\[\]. ##### Denegar una verificació específica - Posar a la llista negra una comprovació específica amb el paràmetre DenyKey. Les claus coincidents seran rebutjades. Es permetran totes les claus que no coincideixin excepte system.run\[\]. Per exemple: # Denegueu l'accés segur a les dades DenyKey=vfs.file.contents[/etc/passwd,*] ::: notemportant Pot ser que una llista negra no sigui una bona opció, perquè una versió nova de Zabbix pot tindre claus noves que no siguin restringides explícitament per la configuració existent. Això podria provocar una violació de seguretat. ::: ##### Deny specific command, allow others - Blacklist a specific command with DenyKey parameter. Whitelist all other commands, with the AllowKey parameter. ```{=html} <!-- --> ``` # Disallow specific command DenyKey=system.run[ls -l /] # Allow other scripts AllowKey=system.run[*] ##### Denegar una ordre específica, permetent-ne d'altres - Afegir a la llista negra una ordre específica amb el paràmetre DenyKey. Posar a la llista blanca totes les altres ordres, amb el paràmetre AllowKey. ```{=html} <!-- --> ``` # Prohibir una ordre específica DenyKey=system.run[ls -l /] # Permetre altres scripts AllowKey=system.run[*] ##### 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. ##### Prototip d'element dependent Creeu un prototip d'element amb el tipus "Item dependent" en aquesta regla de LLD. Com a element mestre d'aquest prototip, trieu l'element `ipmi.get` que hem creat.  Tingueu en compte l'ús de la macro {\#SENSOR\_ID} al nom i la clau del prototip de l'element: - *Nom*: valor IPMI per al sensor {\#SENSOR\_ID} - *Clau*: ipmi\_sensor\[{\#SENSOR\_ID}\] Com a tipus d'informació, *Numèric (sense signe)*. A la pestanya "Preprocessament" del prototip d'element, trieu JSONPath i empreu l'expressió JSONPath següent com a paràmetre: $.[?(@.id=='{#SENSOR_ID}')].value.first()  Quan comença la descoberta, es crea un element per sensor IPMI. Aquest element retornarà el valor sencer del sensor donat. ##### 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: $.[?(@.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. ##### Prototip d'element dependent Creeu un prototip d'element amb el tipus "Article dependent" en aquesta regla de LLD. Com a element mestre d'aquest prototip, escolliu l'element `vfs.fs.get` que hem creat.  Tingueu en compte l'ús de macros personalitzades al nom i la clau del prototip de l'element: - *Nom*: Espai lliure al disc a {\#FSNAME}, escriviu: {\#FSTYPE} - *Clau*: Free\[{\#FSNAME}\] Com a tipus d'informació, empreu: - *Numèric (sense signe)* per a mètriques com ara "lliure", "total", "utilitzat" - *Numèric (flotant)* per a mètriques com "pfree", "pused" (percentatge) A la pestanya "Preprocessament" del prototip d'element, trieu JSONPath i empreu l'expressió JSONPath següent com a paràmetre: $.[?(@.fsname=='{#FSNAME}')].bytes.free.first()  Quan comenci la descoberta, es crearà un element per punt de muntatge. Aquest element retornarà el nombre d'octets lliures per al punt de muntatge donat. ##### 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:  ##### Regla LLD dependent Creeu una regla de descoberta de baix nivell com a tipus "Element dependent":  Com a element principal, seleccioneu l'element `vs.fs.get` que hem creat. A la pestanya "Macros LLD", definiu macros personalitzades amb el JSONPath corresponent:  ##### 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:  ##### Regla LLD dependent Creeu una regla de descoberta de baix nivell com a tipus "Element dependent":  Com a element principal, seleccioneu l'element `ipmi.get` que hem creat. A la pestanya "Macros LLD", definiu una macro personalitzada amb el JSONPath corresponent:  #### 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 \ --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-6.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-6.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-6.0-latest ``` After the containers are up and running, Zabbix server is started and the web interface is available at `http://localhost`. ::: 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-6.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-6.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-6.0-latest ``` After the containers are up and running, Zabbix server is started and the web interface is available at `http://localhost`. ::: 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-6.0: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-60 ``` 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-60 ``` 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-60 ``` ::: 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, Zabbix server is started and the web interface is available at `http://localhost`. ::: 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>`. ::: #### Implementar el servidor Zabbix (MySQL) amb la passarel·la Java Aquest exemple mostra com implementar un servidor Zabbix amb un MySQL, una passarel·la Java per a [monitorar JMX](/manual/config/itemtypes/jmx_monitoring) i una interfície web basada en Nginx. 1\. Creeu una xarxa Docker dedicada, de manera que tots els contenidors de components de Zabbix puguin arribar entre si pel nom del contenidor: ``bash xarxa docker create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net ``` 2\. Executeu un contenidor de servidor MySQL buit (substituïu `zabbix_pwd` i `root_pwd` per mots de pas segurs): ```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 \ --character-set-server=utf8mb4 --collation-server=utf8mb4_bin \ --default-authentication-plugin=mysql_native_password ``` ::: nota important Si utilitzeu una imatge Docker per a MySQL 8.4 o posterior, substituïu `--default-authentication-plugin=mysql_native_password` per `--authentication-policy=caching_sha2_password`. <br><br> MySQL ha d'estar completament inicialitzat abans d'executar el contenidor del servidor Zabbix en el pas 4, en cas contrari l'esquema de Zabbix pot no carregar-se correctament. Per confirmar que MySQL és a punt, executeu `docker logs mysql-server` i procediu només quan veieu `/usr/sbin/mysqld: llest per a connexions`. :: 3\. Executeu un contenidor de passarel·la de Java de Zabbix: ```bash docker run --name zabbix-java-gateway -t \ --network=zabbix-net \ --restart unless-stopped \ -d zabbix/zabbix-java-gateway:alpine-6.0-latest ``` 4\. Executeu un contenidor de servidor Zabbix i enllaceu-lo al contenidor del servidor MySQL (substituïu `zabbix_pwd` i `root_pwd` amb els mateixos mots de pas emprats a la passa 2): ```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 MYSQL_ROOT_PASSWORD="root_pwd" \ -e ZBX_JAVAGATEWAY="zabbix-java-gateway" \ --network=zabbix-net \ -p 10051:10051 \ --restart unless-stopped \ -d zabbix/zabbix-server-mysql:alpine-6.0-latest ``` ::: nota important Després d'executar el contenidor del servidor Zabbix, espereu que el servidor Zabbix acabi d'inicialitzar l'esquema de la base de dades. Per confirmar que és a punt, executeu `docker logs zabbix-server-mysql` i procediu només quan ja no veieu 'Creant d'esquema 'zabbix' a MySQL `. :: 5\. Executeu un contenidor d'interfície web de Zabbix i enllaceu amb el servidor Zabbix i els contenidors del servidor MySQL (substituïu `zabbix_pwd` i `root_pwd` per els mateixos mots de pas emprats a la passa 2): ```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 MYSQL_ROOT_PASSWORD="root_pwd" \ --network=zabbix-net \ -p 80:8080 \ --restart unless-stopped \ -d zabbix/zabbix-web-nginx-mysql:alpine-6.0-latest ``` Després que els contenidors sigui engegat (normalment en 1-3 minuts), s'inicia el servidor Zabbix i la interfície web és disponible a `http://localhost`. #### Desplegar el servidor Zabbix (PostgreSQL) amb trampes SNMP Aquest exemple ensenya com implementar un servidor Zabbix amb un dorsal PostgreSQL, [snMP traps](/manual/config/itemtypes/snmptrap) i una interfície web basada en Nginx. 1\. Creeu una xarxa Docker dedicada, de manera que tots els contenidors de components de Zabbix puguin arribar entre si pel nom del contenidor: ``bash docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 zabbix-net ``` 2\. Executeu un contenidor de servidor PostgreSQL buit (substituïu `zabbix_pwd` amb un mot de pas segur): ```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\. Executeu un contenidor de trampes SNMP de Zabbix: ```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-6.0-latest ``` 4\. Executeu un contenidor de servidor Zabbix, enllaceu-lo al contenidor del servidor PostgreSQL i al contenidor de trampes SNMP (substituïu `zabbix_pwd` amb el mateix mot de pas emprat a la passa 2): ```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 \ -d zabbix/zabbix-server-pgsql:alpine-6.0-latest ``` ::: nota important Després d'executar el contenidor del servidor Zabbix, espereu que el servidor Zabbix acabi d'inicialitzar l'esquema de la base de dades. Per confirmar que està llest, executar `docker logs zabbix-server-pgsql` i procedir només quan ja no vegi `Creant l'esquema 'zabbix' a PostgreSQL`. :: 5\. Executeu un contenidor d'interfície web de Zabbix i enllaceu-lo amb el servidor Zabbix i els contenidors del servidor PostgreSQL (substituïu `zabbix_pwd`` per el mateix mot de pas emprat a la passa 2): ```bash docker run --name zabbix-web-nginx-pgsql -t \ -e ZBX_SERVER_HOST="zabbix-server-pgsql" \ -e DB_SERVER_HOST="postgres-server" \ -e POSTGRES_USER="zabbix" \ -e POSTGRES_PASSWORD="zabbix_pwd" \ -e POSTGRES_DB="zabbix" \ --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-6.0-latest ``` Després que els contenidors siguin en marxa (normalment en 1-3 minuts), s'engega el servidor Zabbix i la interfície web és disponible a `http://localhost`. #### Desplegueu el servidor Zabbix (MySQL) amb la passarel·la Java a RHEL 8-10 Aquest exemple mostra com implementar un servidor Zabbix amb un dorsal MySQL, una passarel·la Java per a [monitoratge JMX](/manual/config/itemtypes/jmx_monitoring), i una interfície web basada en Nginx, tot executant-se a Red Hat Enterprise Linux 8, 9, o 10. A Red Hat Enterprise Linux, el temps d'execució del contenidor recomanat és Podman en lloc de Docker. Podman funciona de manera similar a Docker, però no requereix un servei de fons que s'executa com a arrel, el que fa que sigui un millor ajust per als entorns de Red Hat. 1\. Creeu un nou pod amb el nom `zabbix` i ports exposats per a la interfície web de Zabbix i el trap del servidor Zabbix: ``bash podman pod create --name zabbix -p 80:8080 -p 10051:10051 ``` 2\. (Opcional) Executar un contenidor d'agent Zabbix a la ubicació de la beina `zabbix`: ```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-6.0:latest ``` 3\. Creeu un directori `./mysql/` a l'equip RHEL: ``bash mkdir -p ./mysql ``` 4\. Executeu un contenidor de servidor MySQL buit (substituïu `zabbix_pwd` i `root_pwd` per mots de pas segurs): ```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 \ --default-authentication-plugin=mysql_native_password ``` ::: nota important Si utilitzeu una imatge Docker per a MySQL 8.4 o posterior, substituïu `--default-authentication-plugin=mysql_native_password` per `--authentication-policy=caching_sha2_password`. <br><br> MySQL ha de ser engegat del tot abans d'executar el contenidor del servidor Zabbix a la passa 6; en cas contrari l'esquema de Zabbix podria no carregar correctament. Per confirmar que MySQL és llest, executar `podman logs mysql-server` i procedir només quan veieu `/usr/sbin/mysqld: llest per a connexions`. :: 5\. Executeu un contenidor de passarel·la de Java de Zabbix: ```bash podman run --name zabbix-java-gateway -t \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-java-gateway-60 ``` 6\. Executeu un contenidor del servidor Zabbix (substituïu `zabbix_pwd` i `root_pwd` amb els mateixos mots de pas emprats a la passa 4): ```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 MYSQL_ROOT_PASSWORD="root_pwd" \ -e ZBX_JAVAGATEWAY="127.0.0.1" \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-server-mysql-60 ``` 7\. Executeu un contenidor d'interfície web de Zabbix (substituïu `zabbix_pwd` i `root_pwd` amb els mateixos mots de pas emprats a la passa 4): ```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 MYSQL_ROOT_PASSWORD="root_pwd" \ --restart=always \ --pod=zabbix \ -d registry.connect.redhat.com/zabbix/zabbix-web-mysql-60 ``` ::: noteclassic Pod `zabbix` exposa `80/TCP` port (HTTP) a l'equip de `8080/TCP` del contenidor `zabbix-web-mysql`. ::: :::: noteclassic Empreu `docker ps` per comprovar l'estat del contenidor. Tots els contenidors han de tenir l'estat `Up`. Si algun mostra `Exited`, comproveu els seus registres d'errors amb `docker logs -f <container-name>`. ::: ##### Deprecated internal items for history/trends The following internal items are now deprecated and will be removed in a future major release: - `zabbix[history]` - `zabbix[history_log]` - `zabbix[history_str]` - `zabbix[history_text]` - `zabbix[history_uint]` - `zabbix[trends]` - `zabbix[trends_uint]` ##### Elements interns obsolets per a la història/tendències Els elements interns següents són obsolets i s'esborraran en una futura versió principal: - `zabbix[history]` - `zabbix[history_log]` - `zabbix[history_str]` - `zabbix[history_text]` - `zabbix[history_uint]` - `zabbix[trends]` - `zabbix[trends_uint]` Deprecated widgets: - [Data overview](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) Ginys obsolets: - [Vista genreal de dades](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) ### 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/administration/user_roles) for more information. ::: ### Descripció `array configuration.importcompare(object parameters)` Aquest mètode permet comparar l'arxiu importat amb els elements de sistema actuals, i mostra quins canvis hi haurà en cas d'importar l'arxiu. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol tipus. Els permisos per fer la crida al mètode es poden revocar a la configuració de rol d'usuaris. Per tindre més informació, veieu els [rols d'usuaris](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `boolean configuration.import(object parameters)` El mètode permet importar la configuració des d'una cadena en sèrie. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu els [rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array action.get(object parameters)` El mètode permet recuperar accions segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array alert.get(object parameters)` El mètode permet recuperar alertes segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array auditlog.get(object parameters)` El mètode permet recuperar els objectes de registre d'auditoria segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible només per a usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array correlation.get(object parameters)` El mètode permet recuperar correlacions segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array dashboard.get(object parameters)` El mètode permet recuperar taulers segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array dcheck.get(object parameters)` El mètode permet recuperar verificacions de descoberta segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array dhost.get(object parameters)` El mètode permet recuperar equips descoberts segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `integer/array discoveryrule.get(object parameters)` El mètode permet recuperar regles LLD segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array drule.get(object parameters)` El mètode permet recuperar regles de descoberta segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array dservice.get(object parameters)` El mètode permet recuperar serveis descoberts segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array event.get(object parameters)` El mètode permet recuperar esdeveniments segons els paràmetres proveïts. ::: noteimportant Aquest mètode retorna esdeveniments d'una entitat esborrada si aquests esdeveniments no han estat esborrat per el procés de neteja. ::: ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array graph.get(object parameters)` El mètode permet recuperar gràfics segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array graphitem.get(object parameters)` El mètode permet recuperar elements gràfics segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array graphprototype.get(object parameters)` El mètode permet recuperar prototipus de gràfics segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array hanode.get(object parameters)` El mètode permet recuperar una llista de nodes de clusters d'alta disponibilitat segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible només per a usuaris de tipus *Super admin*. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array history.get(object parameters)` El mètode permet recuperar informació històrica segons els paràmetres proveïts. Veieu també: [problemes coneguts](/manual/installation/known_issues#api) ::: noteimportant Aquest mètode retorna informació històrica d'una entitat esborrada si aquesta informació no ha estat esborrada per el procés de neteja. ::: ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array host.get(object parameters)` El mètode permet recuperar equips segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array hostgroup.get(object parameters)` El mètode permet recuperar grups d'equips segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array hostinterface.get(object parameters)` El mètode permet recuperar interfícies d'equips segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array hostprototype.get(object parameters)` El mètode permet recuperar prototipus d'equips segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array httptest.get(object parameters)` El mètode permet recuperar escenaris web segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array iconmap.get(object parameters)` El mètode permet recuperar mapes d'icones els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array image.get(object parameters)` El mètode permet recuperar imatges segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array item.get(object parameters)` El mètode permet recuperar elements segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `integer/array itemprototype.get(object parameters)` El mètode permet recuperar prototipus d'elements segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array maintenance.get(object parameters)` El mètode permet recuperar manteniments segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array map.get(object parameters)` El mètode permet recuperar mapes segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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 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/administration/user_roles) for more information. ::: ### Descripció `integer/array mediatype.get(object parameters)` El mètode permet recuperar tipus de suport segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible només per a usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array problem.get(object parameters)` El mètode recupera problemes en funció dels paràmetres donats. Aquest mètode ajuda a recuperar problemes no resolts. També és possible, si s'especifica, recuperar els problemes acabats de resoldre. El període que determina el període per "recentment" es defineix a *Administració* → *[General](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*. Els problemes resolts abans d'aquesta hora no es conserven a la taula de problemes. Per recuperar problemes resolts en el passat, empreu el mètode [event.get](/manual/api/reference/event/get) :::noteclassic Aquest mètode pot retornar problemes d'una entitat esborrada si el manteniment encara no ha esborrat aquests problemes. ::: :::noteclassic Aquest mètode és disponible per a tot tipus d'usuaris. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu els [rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `integer/array proxy.get(object parameters)` El mètode permet recuperar proxys segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array regexp.get(object parameters)` El mètode permet recuperar expressions regulars globals segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible només per a usuaris *Super Admin*. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array report.get(object parameters)` El mètode permet recuperar informes programats segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array role.get(object parameters)` El mètode permet recuperar rols segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array script.get(object parameters)` El mètode permet recuperar scripts segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array service.get(object parameters)` El mètode permet recuperar serveis segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array sla.get(object parameters)` El mètode permet recuperar objectes SLA segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `integer/array task.get(object parameters)` The method allows to retrieve tasks according to the given parameters. Method returns details only about 'diagnostic information' tasks. ::: 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/administration/user_roles) for more information. ::: ### Descripció `integer/array task.get(object parameters)` El mètode permet recuperar tasques en funció dels paràmetres donats. El mètode només retorna detalls sobre les tasques de 'informació de diagnòstic'. :::noteclassic Aquest mètode només és disponible per a usuaris del tipus *Super adminin*. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `integer/array templatedashboard.get(object parameters)` El mètode permet recuperar taulers de plantilles segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array template.get(object parameters)` El mètode permet recuperar plantilles segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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. ::: ### Descripció `integer/array token.get(object parameters)` El mètode permet recuperar tokens segons els paràmetres donats. :::noteclassic Només el tipus d'usuari *Super admin* té permisos per veure els tokens d'altres usuaris. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `integer/array trend.get(object parameters)` El mètode permet recuperar dades de tendències segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array trigger.get(object parameters)` El mètode permet recuperar triggers segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array triggerprototype.get(object parameters)` El mètode permet recuperar prototipus de triggers segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `integer/array user.get(object parameters)` El mètode permet recuperar usuaris segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array usergroup.get(object parameters)` El mètode permet recuperar grups d'usuaris segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array usermacro.get(object parameters)` El mètode permet recuperar equips i macros globals segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `integer/array valuemap.get(object parameters)` El mètode permet recuperar mapes de valors segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object action.create(object/array actions)` Aquest mètode permet crear accions noves. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object action.delete(array actionIds)` Aquest mètode permet esborrar accions. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object action.update(object/array actions)` Aquest mètode permet actualitzar les accions. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object authentication.get(object parameters)` El mètode permet recuperar els objectes d'autenticació segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible només per a usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object authentication.update(object authentication)` Aquest mètode permet actualitzar la configuració d'autenticació. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object autoregistration.get(object parameters)` El mètode permet recuperar els objectes d'autoregistre segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible només per a usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object autoregistration.update(object autoregistration)` Aquest mètode permet actualitzar la configuració d'autoregistre. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `objecte correlació.crear(correlacions d'objecte/matriu)` Aquest mètode permet crear noves correlacions. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object correlation.delete(array correlationids)` Aquest mètode permet esborrar noves correlacions. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `objecte correlació.actualitzar(correlacions d'objecte/matriu)` Aquest mètode permet actualitzar noves correlacions. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object dashboard.create(object/array dashboards)` Aquest mètode permet crear taulers nous. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object dashboard.delete(object/array dashboards)` Aquest mètode permet esborrar taulers. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object dashboard.update(object/array dashboards)` Aquest mètode permet actualitzar taulers ja existents. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object discoveryrule.copy(object parameters)` Aquest mètode permet copiar regles LLD amb tots els prototips dels equips proporcionats. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object discoveryrule.create(array lldRuleIds)` Aquest mètode permet crear noves regles LLD. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object discoveryrule.delete(array lldRuleIds)` Aquest mètode permet esborrar regles LLD. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object discoveryrule.update(array lldRuleIds)` Aquest mètode permet actualitzar les regles LLD ja existents. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object drule.create(object/array discoverydRuleIds)` Aquest mètode permet crear les noves regles de descoberta. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object drule.delete(array discoverydRuleIds)` Aquest mètode permet esborrar regles de descoberta. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object drule.update(object/array discoverydRuleIds)` Aquest mètode permet actualitzar les regles de descoberta existents. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object event.acknowledge(object/array parameters)` This method allows to update events. Following update actions can be performed: - Close event. If event is already resolved, this action will be skipped. - Acknowledge event. If event is already acknowledged, this action will be skipped. - Unacknowledge event. If event is not acknowledged, this action will be skipped. - Add message. - Change event severity. If event already has same severity, 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/administration/user_roles) for more information. ::: ### Descripció `object event.acknowledge(object/array parameters)` Aquest mètode s'empra per actualitzar esdeveniments. Es poden realitzar les següents accions d'actualització: - Tancar l'esdeveniment. Si l'esdeveniment ja és resolt, aquesta acció s'ignorarà. - Reconeixement de l'esdeveniment. Si ja s'ha reconegut l'esdeveniment, aquesta acció s'ignorarà. - S'ha eliminat el reconeixement de l'esdeveniment. Si no es reconeix l'esdeveniment, aquesta acció s'ignorarà. - Afegir missatge. - Canviar la gravetat de l'esdeveniment. Si l'esdeveniment ja té la mateixa gravetat, aquesta acció s'ignorarà. ::: nota important Només es poden actualitzar els esdeveniments triggers.<br> Només es poden actualitzar els esdeveniments problemàtics.<br> Es necessiten permisos de lectura/escriptura per al trigger per tancar l'esdeveniment o canviar-ne la gravetat.<br> Per tancar un esdeveniment, s'ha de permetre al trigger. ::: :::noteclassic Aquest mètode és disponible per a tot tipus d'usuaris. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtenir més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object graph.create(object/array graphs)` Aquest mètode permet crear nous gràfics. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object graph.delete(array graphIds)` Aquest mètode permet esborrar gràfics. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object graphprototype.create(object/array graphPrototypes)` Aquest mètode permet crear nous prototips de gràfics. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object graphprototype.delete(array graphPrototypeIds)` Aquest mètode permet esborrar prototips de gràfics. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object graphprototype.update(object/array graphPrototypes)` Aquest mètode permet actualitzar prototips de gràfics. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object graph.update(object/array graphs)` Aquest mètode permet actualitzar gràfics. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object history.clear(array itemids)` Aquest mètode permet netejar l'històric d'elements. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object host.create(object/array hosts)` Aquest mètode permet crear nous equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object host.delete(array hosts)` Aquest mètode permet esborrar equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostgroup.create(object/array hostGroups)` Aquest mètode permet crear nous grups d'equips. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object hostgroup.delete(array hostGroupIds)` This method allows to delete host groups. A host group can not 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/administration/user_roles) for more information. ::: ### Descripció `object hostgroup.delete(array hostGroupIds)` Aquest mètode us permet esborrar grups d'equips. No es pot pas esborrar un grup d'equips si: - conté equips que només pertanyen a aquest grup; - és marcat com a intern; - l'empra un prototip d'equips; - s'empra a un script global; - s'empra a una condició de correlació. :::noteclassic Aquest mètode només és disponible per als usuaris del tipus *Admin* i *Super Admin*. Els permisos de crida de mètodes es poden revocar a la configuració del rol d'usuari. Consulteu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object hostgroup.massadd(object parameters)` Aquest mètode permet afegir simultàniament diversos objectes relacionats a tots els grups d'equips donats. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostgroup.massremove(object parameters)` Aquest mètode esborrar els objectes associats a diversos grups d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostgroup.massupdate(object parameters)` Aquest mètode permet reemplaçar equips i plantilles per aquells especificats a diversos grups d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostgroup.update(object/array hostGroups)` Aquest mètode permet actualitzar els grups d'equips existents. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostinterface.create(object/array hostInterfaces)` Aquest mètode permet crear noves interfícies d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostinterface.delete(array hostInterfaceIds)` Aquest mètode permet esborrar interfícies d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostinterface.massadd(object parameters)` Aquest mètode permet afegir simultàniament interfícies d'equips a diversos equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostinterface.massremove(object parameters)` Aquest mètode permet esborrar interfícies dels equips donats. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostinterface.replacehostinterfaces(object parameters)` Aquest mètode permet moure totes les interfícies de l'equip donat. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostinterface.update(object/array hostInterfaces)` Aquest mètode permet actualitzar les interfícies d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object host.massadd(object parameters)` Aquest mètode permet afegir simultàniament diversos objectes relacionats a tots els equips donats. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object host.massremove(object parameters)` Aquest mètode esborrar els objectes associats a diversos equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object host.massupdate(object parameters)` Aquest mètode permet substituir o esborrar simultàniament els objectes associats i actualitzar les propietats sobre diversos equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostprototype.create(object/array hostPrototypes)` Aquest mètode permet crear nous prototips d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostprototype.delete(array hostPrototypeIds)` Aquest mètode permet esborrar prototips d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object hostprototype.update(object/array hostPrototypes)` Aquest mètode permet actualitzar els prototips d'equips. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object host.update(object/array hosts)` Aquest mètode permet actualitzar els equips existents. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object housekeeping.get(object parameters)` El mètode permet recuperar objectes de neteja segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object housekeeping.update(object housekeeping)` Aquest mètode permet actualitzar la configuració del manteniment. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object httptest.create(object/array webScenarios)` Aquest mètode permet crear nous escenaris web. :::noteclassic La creació d'un escenari web crearà automàticament un conjunt d'[elements de supervisió web](/manual/web_monitoring/items). ::: :::noteclassic Aquest mètode només és disponible per als tipus d'usuari *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració del rol d'usuari. Consulteu els [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object httptest.delete(array webScenarioIds)` Aquest mètode permet esborrar escenaris Web. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object httptest.update(object/array webScenarios)` Aquest mètode permet actualitzar escenaris Web. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object iconmap.create(object/array iconMaps)` Aquest mètode permet crear nous mapes d'icones. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object iconmap.delete(array iconMapIds)` Aquest mètode permet esborrar mapes d'icones. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object iconmap.update(object/array iconMaps)` Aquest mètode permet actualitzar mapes d'icones. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object image.create(object/array images)` Aquest mètode permet crear noves imatges. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object image.delete(array imageIds)` Aquest mètode permet esborrar imatges. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object image.update(object/array images)` Aquest mètode permet actualitzar imatges. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object item.create(object/array items)` Aquest mètode permet crear nous elements. ::: noteclassic Els elements Web no es poden crear emprant l'API Zabbix. ::: ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object item.delete(array itemIds)` Aquest mètode permet esborrar elements. ::: noteclassic Els elements Web no es poden esborrar emprant l'API Zabbix. ::: ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object itemprototype.create(object/array itemPrototypes)` Aquest mètode permet crear nous prototips d'elements. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object itemprototype.delete(array itemPrototypeIds)` Aquest mètode permet esborrar prototips d'elements. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object itemprototype.update(object/array itemPrototypes)` Aquest mètode permet actualitzar els prototips d'elements. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object item.update(object/array items)` Aquest mètode permet actualitzar elements. ::: noteclassic Els elements Web no es poden actualitzar emprant l'API Zabbix. ::: ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object maintenance.create(object/array maintenances)` Aquest mètode permet crear nous manteniments. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object maintenance.delete(array maintenanceIds)` Aquest mètode permet esborrar períodes de manteniment. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object maintenance.update(object/array maintenances)` Aquest mètode permet actualitzar manteniments. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object map.create(object/array maps)` Aquest mètode permet crear mapes nous. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object map.delete(array mapIds)` Aquest mètode permet esborrar mapes. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object map.update(object/array maps)` Aquest mètode permet actualitzar mapes ja existents. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object mediatype.create(object/array mediaTypes)` Aquest mètode permet crear nous tipus de suport. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object mediatype.delete(array mediaTypeIds)` Aquest mètode permet esborrar tipus de suport. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object mediatype.update(object/array mediaTypes)` Aquest mètode permet actualitzar tipus de suport existents. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object proxy.create(object/array proxies)` Aquest mètode permet crear nous proxys. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object proxy.delete(array proxies)` Aquest mètode permet esborrar proxys. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object proxy.update(object/array proxies)` Aquest mètode permet actualitzar proxys. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object regexp.create(object/array regularExpressions)` Aquest mètode permet crear noves expressions globals regulars. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object regexp.delete(array regexpids)` Aquest mètode permet esborrar expressions globals regulars. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object regexp.update(object/array regularExpressions)` Aquest mètode permet actualitzar expressions globals regulars. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object report.create(object/array reports)` Aquest mètode permet crear nous informes programats. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object report.delete(array reportids)` Aquest mètode permet esborrar informes programats. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object report.update(object/array reports)` Aquest mètode permet actualitzar informes programats. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object role.create(object/array roles)` Aquest mètode permet crear nous rols. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object role.delete(array roleids)` Aquest mètode permet esborrar rols. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object role.update(object/array roles)` Aquest mètode permet actualitzar rols. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object script.create(object/array scripts)` Aquest mètode permet crear nous scripts. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object script.delete(array scriptIds)` Aquest mètode permet esborrar scripts. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object script.execute(object parameters)` This method allows to run a script on a host or event. ::: 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/administration/user_roles) for more information. ::: ### Descripció `object script.execute(object parameters)` Aquest mètode permet executar un script a un equip o esdeveniment. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object script.getscriptsbyhosts(array hostIds)` This method allows to retrieve scripts available on the given hosts. ::: 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/administration/user_roles) for more information. ::: ### Descripció `object script.getscriptsbyhosts(array hostIds)` Aquest mètode permet recuperar scripts disponibles a l'equip donat. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object script.update(object/array scripts)` Aquest mètode permet actualitzar scripts existents. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object service.create(object/array services)` Aquest mètode permet crear serveis nous. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object service.delete(array serviceIds)` Aquest mètode permet esborrar serveis. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object service.update(object/array services)` Aquest mètode permet actualitzar serveis existents. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object settings.get(object parameters)` El mètode permet recuperar configuracions segons els paràmetres proveïts. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object settings.update(object settings)` Aquest mètode permet actualitzar les configuracions comunes. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object sla.create(object/array SLAs)` Aquest mètode permet crear nous objectes SLA. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object sla.delete(array slaids)` Aquest mètode permet esborrar entrades SLA. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object sla.getsli(object parameters)` Aquest mètode permet calcular les dades de l'indicador de nivell de servei (SLI) per al Service Level Agreement (SLA). ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object sla.update(object/array slaids)` Aquest mètode permet actualitzar les entrades SLA existents. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object task.create(object/array tasks)` This method allows to create a new task (such as collect diagnostic data or check items or low-level discovery rules without config reload). ::: 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/administration/user_roles) for more information. ::: ### Descripció `object task.create(object/array tasks)` Aquest mètode permet crear una tasca nova (com ara recopilar dades de diagnòstic o verificar elements o regles de descoberta de baix nivell) sense tornar a carregar la configuració. :::noteclassic Aquest mètode només és disponible per a usuaris del tipus *Super admin*. Els permisos per invocar el mètode es poden revocar a la configuració del rol d'usuari. Consulteu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object template.create(object/array templates)` Aquest mètode permet crear noves plantilles. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object templatedashboard.create(object/array templatesDashboards)` Aquest mètode permet crear nous taulers. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object templatedashboard.delete(array templateDashboardIds)` Aquest mètode permet esborrar taulers. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object templatedashboard.update(object/array templateDashboards)` Aquest mètode permet actualitzar taulers. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object template.delete(array templateIds)` Aquest mètode permet esborrar plantilles. Si esborreu un model, s'esborraran totes les entitats del model (elements, triggers, gràfics, etc.). Per deixar les entitats de plantilla als equips però esborrar la pròpia plantilla, primer desenllaçeu la plantilla dels equips requerits mitjançant un d'aquests mètodes: [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 Aquest mètode només està disponible per als usuaris del tipus *Administrador* i *Superadministrador*. Els permisos de crida a mètodes es poden revocar a la configuració del rol d'usuari. Consulteu [rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object template.massadd(object parameters)` Aquest mètode permet afegir simultàniament diversos objectes relacionats a les plantilles donades. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object template.massremove(object parameters)` Aquest mètode esborrar els objectes associats a diverses plantilles. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object template.massupdate(object parameters)` Aquest mètode permet substituir o esborrar simultàniament els objectes associats i actualitzar les propietats sobre diverses plantilles. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object template.update(object/array templates)` Aquest mètode permet actualitzar plantilles. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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. ::: ### Descripció `object token.create(object/array tokens)` Aquest mètode crea nous tokens. :::noteclassic Cal el [permís](/manual/web_interface/frontend_sections/users/user_roles#configuration) de *Gestionar els testimonis de l'API* perquè el rol d'usuari pugui gestionar els testimonis d'altres usuaris. ::: :::noteclassic Un token creat per aquest mètode ha d'esser [generat](generate) abans que es pugui emprar. ::: ### 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. ::: ### Descripció `object token.delete(array ids)` Aquest mètode esborra tokens. :::noteclassic Cal el [permís](/manual/web_interface/frontend_sections/users/user_roles#configuration) de *Gestionar els testimonis de l'API* perquè el rol d'usuari pugui gestionar els testimonis d'altres usuaris. ::: ### 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). ::: ### Descripció `object token.generate(array ids)` Aquest mètode permet generar tokens. :::noteclassic Cal el [permís](/manual/web_interface/frontend_sections/users/user_roles#configuration) de *Gestionar els testimonis de l'API* perquè el rol d'usuari pugui gestionar els testimonis d'altres usuaris. ::: :::noteimportant Es pot generar un token amb aquest mètode només si s'ha [creat](generate). ::: ### 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. ::: ### Descripció `object token.update(object/array tokens)` Aquest mètode permet actualitzar tokens. :::noteclassic Cal el [permís](/manual/web_interface/frontend_sections/users/user_roles#configuration) de *Gestionar els testimonis de l'API* perquè el rol d'usuari pugui gestionar els testimonis d'altres usuaris. ::: ### Description `object trigger.adddependencies(object/array triggerDependencies)` This method allows to create new trigger dependencies. ::: 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/administration/user_roles) for more information. ::: ### Descripció `object trigger.adddependencies(object/array triggerDependencies)` Aquest mètode permet crear noves dependències de triggers. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object trigger.create(object/array triggers)` Aquest mètode permet crear nous triggers. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object trigger.delete(array triggerIds)` Aquest mètode permet esborrar triggers. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object trigger.deletedependencies(string/array triggers)` This method allows to delete all trigger dependencies from the given 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/administration/user_roles) for more information. ::: ### Descripció `object trigger.deletedependencies(string/array triggers)` Aquest mètode permet esborrar totes les dependències del triggers donats. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object triggerprototype.create(object/array triggerPrototypes)` Aquest mètode permet crear nous prototips de triggers. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object triggerprototype.delete(array triggerPrototypeIds)` Aquest mètode permet esborrar prototips de triggers. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object triggerprototype.update(object/array triggerPrototypes)` Aquest mètode permet actualitzar els prototips de triggers. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object trigger.update(object/array triggers)` Aquest mètode permet actualitzar els triggers. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object user.checkAuthentication` This method checks and prolongs user session. ::: noteimportant Calling the **user.checkAuthentication** method with the parameter `sessionid` set prolongs user session by default. ::: ### Descripció `object user.checkAuthentication` Aquest mètode verifica i perllonga la sessió d'usuari. ::: noteimportant La crida al mètode **user.checkAuthentication** amb el paràmetre establert `sessionid`perllonga per defecte la sessió d'usuari. ::: ### 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/administration/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. ::: ### Descripció `object user.create(object/array users)` Aquest mètode permet crear nous usuaris. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ::: noteclassic La fortalesa del mot de pas de l'usuari es valida d'acord amb les regles de la política de mots de pas definida per l'API d'autenticació. Veieu [API d'autenticació](/manual/api/reference/authentication) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object user.delete(array users)` Aquest mètode permet esborrar usuaris. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object usergroup.create(object/array userGroups)` Aquest mètode permet crear nous grups d'usuaris. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### Description `object usergroup.delete(array userGroupIds)` This method allows to delete 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/administration/user_roles) for more information. ::: ### Descripció `object usergroup.delete(array userGroupIds)` Aquest mètode permet esborrar grups d'usuaris. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object usergroup.update(object/array userGroups)` Aquest mètode permet actualitzar grups d'usuaris. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object usermacro.createglobal(object/array globalMacros)` Aquest mètode permet crear noves macros globals. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object usermacro.create(object/array hostMacros)` Aquest mètode permet crear noves macros d'equips. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object usermacro.delete(array hostMacroIds)` Aquest mètode permet esborrar macros d'equips. ::: noteclassic Tenim aquest mètode disponible només per als usuaris *Admin* i *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object usermacro.deleteglobal(array globalMacroIds)` Aquest mètode permet esborrar macros globals. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object usermacro.updateglobal(object/array globalMacros)` Aquest mètode permet actualitzar macros globals. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object usermacro.update(object/array hostMacros)` Aquest mètode permet actualitzar les macros d'equips. ::: noteclassic Aquest mètode és disponible només per als usuaris de tipus *Admin* i *Super admin*. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/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/administration/user_roles) for more information. ::: ### Descripció `object user.unblock(array userids)` Aquest mètode permet desblocar usuaris. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/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. ::: ### Descripció `object user.update(object/array users)` Aquest mètode permet actualitzar usuaris. ::: noteclassic Aquest mètode és disponible per als usuaris de qualsevol tipus. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ::: noteclassic La fortalesa del mot de pas de l'usuari es valida d'acord amb les regles de la política de mots de pas definida per l'API d'autenticació. Veieu [API d'autenticació](/manual/api/reference/authentication) per obtindre més informació. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object valuemap.create(object/array valuemaps)` Aquest mètode permet crear nous mapes de valors. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object valuemap.delete(array valuemapids)` Aquest mètode permet esborrar mapes de valors. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `object valuemap.update(object/array valuemaps)` Aquest mètode permet actualitzar mapes de valors. ::: noteclassic Tenim aquest mètode disponible només per a l'usuari *Super admin*. Els permisos per cridar el mètode es poden revocar a la configuració dels rols d'usuari. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ### 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. ::: ### Descripció `string apiinfo.version(array)` Aquest mètode permet recuperar la versió de l'API de Zabbix. ::: noteimportant Aquest mètode només és disponible per a usuaris no autenticats i s'ha de cridar sense el paràmetre `auth` a la petició JSON-RPC. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `string configuration.export(object parameters)` El mètode permet exportar la configuració com una cadena en sèrie. ::: noteclassic Aquest mètode és disponible per a usuaris de qualsevol mena. Els permisos per cridar al mètode es poden revocar a les configuracions de rols d'usuari. Per a més informació, veieu [Rols d'usuari]](/manual/web_interface/frontend_sections/administration/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 and must be called without the `auth` parameter in the JSON-RPC request. ::: ### Descripció `string/object user.login(object parameters)` Aquest mètode permet connectar a l'API i generar un token d'autenticació. ::: notewarning Quan empreu aquest mètode, haureu de fer [user.logout](/manual/api/reference/user/logout) per previndre la generació d'un llarg nombre de registres de sessió oberts. ::: ::: noteimportant Aquest mètode només és disponible per usuaris no autenticats i se l'ha de cridar amb el paràmetre "auth" a una petició JSON-RPC. ::: ### 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/administration/user_roles) for more information. ::: ### Descripció `string/object user.logout(array)` Aquest mètode permet desconnectar de l'API i invalidar el token d'autenticació actual. ::: noteclassic Aquest mètode és disponible per a qualsevol mena d'usuaris. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu [Rols d'usuari](/manual/web_interface/frontend_sections/administration/user_roles). ::: ##### Description The following parameters are supported if *Advanced configuration* is set to "Enabled", and *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|Valid 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).| ##### Descripció Els paràmetres següents s'admeten si la *Configuració avançada* és establerta a "Habilitada" i *Veure* és establert a "Descripció". |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Descripció*|1|descripció|Qualsevol valor de cadena, incloses les macros.<br>Macros admeses: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros d'usuari.<br>< br>Per defecte: {ITEM.NAME}.| |*Posició horitzontal*|0|desc_h_pos|0 - Esquerra;<br>1 - *(per defecte)* Centre;<br>2 - Dreta.<br><br>Dos o més elements (Descripció, Valor, Temps) no pot compartir la mateixa *Posició horitzontal* i *Posició vertical*.| |*Posició vertical*|0|desc_v_pos|0 - Amunt;<br>1 - Centrat;<br>2 - *(per defecte)* Avall.<br><br>Dos o més elements (Descripció, Valor, Temps) no pot compartir la mateixa *Posició horitzontal* i *Posició vertical*.| |*Mida*|0|desc_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 15.| |*Negreta*|0|desc_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Color*|1|desc_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buida).| ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Rellotge*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/clock) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Rellotge*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny de [*visualització de dades*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/data_overview) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Visualització de dades*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Mapa geogràfic*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Mapa geogràfic*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Gràfic (clàssic)*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_classic) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Gràfic (clàssic)*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Gràfic*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Gràfic*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Prototipus de gràfic*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/graph_prototype) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Prototipus de gràfic*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Valor d'element*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_element) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Valor d'element*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Mapa*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Mapa*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Arbre de navegació del mapa*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Arbre de navegació del mapa*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### Description These parameters and the possible property values for the respective dashboard widget field objects allow to configure the [*Plain text*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) 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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), but also introduces the risk of creating or updating widgets incorrectly. To ensure the successful creation or update of the *Plain text* widget, please refer to the parameter requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Text pla*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Text pla*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Equips amb problemes*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problem_hosts) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Equips amb problemes*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Problemes per gravetat*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems_severity) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Problemes per gravetat*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Problemes*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/problems) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Problemes*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Informe SLA*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/sla_report) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Informe SLA*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Equips principals*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `fields` del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Equips principals*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny de [*visualització de triggers*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/trigger_overview) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Visualització de triggers*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*URL*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `fields` del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/url) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *URL*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ### 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/monitoring/dashboard/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/monitoring/dashboard/widgets) and create [custom widgets](/manual/modules#developing-modules), 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 requirements outlined in the tables below. ::: ### Descripció Aquests paràmetres i els possibles valors de propietat per als objectes de camp del giny del tauler de control respectius permeten configurar el giny [*Monitoratge web*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/web_monitoring) als mètodes `dashboard.create` i `dashboard.update`. ::: noteimportant Les propietats dels `camps' del giny no es validen pas durant la creació o actualització d'un tauler. Això permet als usuaris modificarels [ginys integrats](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) i crear [ginys personalitzats](/manual/modules#developing-modules), però també afegeix el risc de creació o actualització incorrectes dels ginys. Per garantir la creació o actualització correcta del giny *Monitoratge web*, consulteu els requisits dels paràmetres que es descriuen a les taules següents. ::: ## DESCRIPTION **zabbix\_agent2** is an application for monitoring parameters of various services.\ \ [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_agent2** és una aplicació per monitortzar paràmetres de diferents serveis.\ \ [ ]{#lbAE} ## DESCRIPTION **zabbix\_agentd** is a daemon for monitoring various server parameters. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_agentd** és un procés per monitorar diferents paràmetres d'un servidor. [ ]{#lbAE} ## DESCRIPTION **zabbix\_get** is a command line utility for getting data from Zabbix agent. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_get** és una utilitat de línia de comandes per obtindre dades d'un agent de Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_js** is a command line utility that can be used for embedded script testing. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_js** és una utilitat e línia de comandes que es pot fer anar per provar els scripts incorporats. [ ]{#lbAE} ## DESCRIPTION **zabbix\_proxy** is a daemon that collects monitoring data from devices and sends it to Zabbix server. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_proxy** és un dimoni que recull dades de monitoratge dels dispositius i els envia cap al servidor de Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_sender** is a command line utility for sending monitoring data to Zabbix server or proxy. On the Zabbix server an item of type **Zabbix trapper** should be created with corresponding key. Note that incoming values will only be accepted from hosts specified in **Allowed hosts** field for this item. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_sender** és una utilitat de línia de comandes per enviar dades de monitoratge al servidor o proxy Zabbix. Al servidor de Zabbix s'hi ha de crear un item del tipus **Zabbix trapper**, amb la clau corresponent. Veieu que a l'entrada de valors només s'acceptaran els equips especificats al camp **Allowed hosts** per a aquest element. [ ]{#lbAE} ## DESCRIPTION **zabbix\_server** is the core daemon of Zabbix software. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_server** és el dimoni principal del programari Zabbix. [ ]{#lbAE} ## DESCRIPTION **zabbix\_web\_service** is an application for providing web services to Zabbix components. [ ]{#lbAE} ## DESCRIPCIÓ **zabbix\_web\_service** és una aplicació per proveir serveis web per a components de Zabbix. [ ]{#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. #### Detalls sobre l'exportació - Tots els elements compatibles s'exporten a un fitxer. - Les entitats d'equip i model (elements, triggers, gràfics, regles de descoberta) heretades dels models enllaçats no s'exporten. Qualsevol canvi fet a aquestes entitats a nivell d'equip (com ara canviar l'interval d'elements, canviar l'expressió regular o els prototips afegits a la regla de descoberta de baix nivell) es perdran en exportar. En importar, totes les entitats dels models enllaçats es tornen a crear com al model enllaçat original. - Les entitats creades per descoberta de baix nivell i les entitats que en depenen no s'exporten. Per exemple, un trigger creat per a un element generat per una regla LLD no s'exportarà pas. #### 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. - 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. #### Detalls sobre la importació - La importació s'atura al primer error. - En actualitzar imatges existents en importar imatges, el camp "tipus d'imatge" s'ignora, és a dir, no és possible canviar el tipus d'imatge mitjançant la importació. - En importar equips o plantilles amb l'opció "Esborrar el que manca", també s'esborraran les macros de l'equip o de la plantilla que no són presents al fitxer importat. - Les etiquetes buides per a elements, triggers, gràfics, aplicacions d'equips o plantilles, regles de descoberta, prototips d'elements, prototips de triggers i prototips de gràfics no tenen sentit, és a dir, són idèntics als que falten. Altres etiquetes, per exemple, les aplicacions d'elements, són significatives, és a dir, les etiquetes buides signifiquen que no hi ha aplicacions per a l'element, les etiquetes que manquen impedeixen que les aplicacions s'actualitzin. - La importació és compatible amb YAML, XML i JSON, el fitxer d'importació ha de tindre l'extensió de fitxer correcta: .yaml i .yml per a YAML, .xml per a XML i .json per a JSON. Veieu [informació de compatibilitat](/manual/appendix/compatibility) sobre les versions XML compatibles. - La importació només admet fitxers de configuració en codificació UTF-8 (amb o sense [BOM](https://en.wikipedia.org/wiki/Byte_order_mark)); altres codificacions (UTF16LE, UTF16BE, UTF32LE, UTF32BE, etc.) provocaran un error de conversió d'importació. ### Details tag The details object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**version**<br>(required)|integer|SNMP interface version.<br><br>Possible values are:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br>3 - SNMPv3| |bulk|integer|Whether to use bulk SNMP requests.<br><br>Possible values are:<br>0 - don't use bulk requests;<br>1 - (default) - use bulk requests.| |community|string|SNMP community (required). Used only by SNMPv1 and SNMPv2 interfaces.| |securityname|string|SNMPv3 security name. Used only by SNMPv3 interfaces.| |securitylevel|integer|SNMPv3 security level. Used only by SNMPv3 interfaces.<br><br>Possible values are:<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 are:<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 are:<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.| ### Etiqueta de detalla L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**version**<br>(obligatori)|integer|Versió de la interfície SNMP.<br><br>Els valors possibles són:<br>1 - SNMPv1;<br>2 - SNMPv2c;<br> 3 - SNMPv3| |bulk|integer|Si s'han d'emprar consultes SNMP massives o no.<br><br>Els valors possibles són:<br>0 - no emprar consultes massives;<br>1 - (per defecte) - emprar consultes massives. | |community|string|Comunitat SNMP (obligatori). Només l'empren les interfícies SNMPv1 i SNMPv2.| |securityname|string|nom de seguretat SNMPv3. Emprat només per interfícies SNMPv3.| |securitylevel|integer|nivell de seguretat SNMPv3. Només s'empra a les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - (per defecte) - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |authpassphrase|string|frase de pas d'autenticació SNMPv3. Emprat només per interfícies SNMPv3.| |privpassphrase|string|frase de contrasenya de privadesa SNMPv3. Emprat només per interfícies SNMPv3.| |authprotocol|integer|Protocol d'autenticació SNMPv3. Només l'empren les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - (per defecte) - MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256 ; <br>4 - SHA384;<br>5 - SHA512.| |privprotocol|integer|Protocol de privadesa SNMPv3. Només s'empren les interfícies SNMPv3.<br><br>Els valors possibles són:<br>0 - (per defecte) - DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256 ; <br>4 - AES192C;<br>5 - AES256C.| |contextname|string|nom de context SNMPv3. Emprat només per interfícies SNMPv3.| #### Details The virtual machine monitoring is done in two steps. First, virtual machine data is gathered by *vmware collector* Zabbix processes. Those processes obtain necessary information from VMware web services over the SOAP protocol, pre-process it and store into Zabbix server shared memory. Then, this data is retrieved by pollers using Zabbix simple check [VMware keys](/manual/config/items/itemtypes/simple_checks/vmware_keys). Starting with Zabbix version 2.4.4 the collected data is divided into 2 types: VMware configuration data and VMware performance counter data. Both types are collected independently by *vmware collectors*. Because of this it is recommended to enable more collectors than the monitored VMware services. Otherwise retrieval of VMware performance counter statistics might be delayed by the retrieval of VMware configuration data (which takes a while for large installations). Currently only datastore, network interface and disk device statistics and custom performance counter items are based on the VMware performance counter information. #### Detalls el monitoratge de la màquina virtual es fa en dues passes. En primer lloc, els processos de Zabbix *vmware collector* recullen les dades de les màquines virtuals. Aquests processos obtenen la informació necessària dels serveis web de VMware mitjançant el protocol SOAP, la processen prèviament i l'emmagatzemen a la memòria compartida del servidor Zabbix. Tot seguit, els enquestadors recuperen aquesta informació mitjançant les [claus VMware](/manual/config/items/itemtypes/simple_checks/vmware_keys) de comprovacions simples de Zabbix. A partir de la versió 2.4.4 de Zabbix, les dades recollides es divideixen en 2 tipus: dades de configuració de VMware i dades de comptadors de rendiment de VMware. Tots dos tipus es recullen de manera independent pels *col·lectors de vmware*. Per aquest motiu, es recomana habilitar més col·lectors que els serveis de VMware monitorats. En cas contrari, es podria endarrerir la recuperació de les estadístiques del comptador de rendiment de VMware recuperant les dades de configuració de VMware (que triga un temps per a instal·lacions grans). Actualment, només el magatzem de dades, la interfície de xarxa, les estadístiques del dispositiu de disc i els elements del comptador de rendiment personalitzats es basen en la informació del comptador de rendiment de VMware. #### 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. #### Detalls Per evitar càlculs amb nombres grans, considereu la marca de temps del primer valor del període especificat més 1 ns com un nou temps zero (el temps actual és al voltant de 10^9^, l'època al quadrat és 10^18^, la precisió doble és d'uns 10^ -16^). S'afegeix 1 ns per proporcionar tots els valors de temps positius per als ajustaments *logarítmics* i els ajustaments de *potència* que impliquen el càlcul de log(t). El desplaçament de temps no afecta els càlculs *lineals*, *polinomis*, *exponencials* (excepte càlculs més fàcils i precisos), però canvia la forma de les funcions *logarítmiques* i *potència*. #### Developing modules Modules are written in PHP language. Model-view-controller (MVC) software pattern design is preferred, as it is also used in Zabbix frontend and will ease the development. PHP strict typing is also welcome but not mandatory. Please note that with modules you can easily add new menu items and respective views and actions to Zabbix frontend. Currently it is not possible to register new API or create new database tables through modules. #### Desenvolupar mòduls Els mòduls són escrits en llenguatge PHP. Es prefereix el disseny de patró de programari Model-View-Controller (MVC), ja que també s'empra a la interfície Zabbix i facilitarà el desenvolupament. L'estricta mecanografia PHP també és benvinguda, però no és necessària. Tingueu en compte que amb els mòduls podeu afegir fàcilment nous elements de menú i vistes i accions respectives a la interfície de Zabbix. Actualment, no és possible registrar una nova API ni crear taules de bases de dades noves mitjançant mòduls. #### 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| |*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| |*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| |*Huawei VRP 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| |*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| |*QTech QSW SNMP*|QTech|Qtech devices|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Performance<br>Inventory| |*Ubiquiti AirOS SNMP*|Ubiquiti|Ubiquiti AirOS wireless devices|NanoBridge,NanoStation,Unifi|AirOS|FROGFOOT-RESOURCES-MIB,IEEE802dot11-MIB|Performance| |*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| |*TP-LINK SNMP*|TP-LINK|TP-LINK|T2600G-28TS v2.0| |TPLINK-SYSMONITOR-MIB,TPLINK-SYSINFO-MIB|Performance<br>Inventory| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G| |FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Fault<br>Inventory| #### Dispositius Llistat de famílies de dispositius per als models disponibles: |Nom del model|Fabricant|Família de dispositius|Models coneguts|OS|MIB emprades|**[Etiquetes](/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|Certificat| |*Brocade FC SNMP*|Brocade|Commutadors Brocade FC|Commutador Brocade 300 SAN-|\-|SW-MIB,ENTITY-MIB|Rendiment<br>error| |*Brocat\_Foundry Stackable SNMP*|Brocat|Brocat ICX|Brocat ICX6610, Brocat ICX7250-48, Brocat ICX7450-48F| |FOUNDRY-SN-AGENT-MIB, FOUNDRY-SN-STACKING-MIB|Certificat| |*Brocade\_Foundry No apilable SNMP*|Brocade, Foundry|Brocade MLX, Foundry|Brocade MLXe, Foundry FLS648, Foundry FWSX424| |FOUNDRY-SN-AGENT-MIB|Rendiment<br>error| |*Check Point Next Generation Firewall per SNMP*|Check Point|Next Generation Firewall|-|Gaia|HOST-RESOURCES-MIB, CHECKPOINT-MIB, UCD-SNMP-MIB, SNMPv2-MIB, IF-MIB|Certificat| |*Cisco Catalyst 3750<model de dispositiu> SNMP*|Cisco|Cisco Catalyst 3750|Cisco Catalyst 3750V2-24FS, Cisco Catalyst 3750V2-24PS, Cisco Catalyst 3750V2-24TS, Cisco Catalyst 3750V2-24TS, Cisco Catalyst SN, Cisco Catalyst| |CISCO-MEMORY-POOL-MIB, IF-MIB, EtherLike-MIB, SNMPv2-MIB, CISCO-PROCESS-MIB, CISCO-ENVMON-MIB, ENTITY-MIB|Certificat| |*Cisco IOS SNMP*|Cisco|Cisco IOS ver > 12.2 3.5|Cisco C2950|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB,CISCO-ENVMON-MIB|Certificat| |*Versions de Cisco IOS 12.0\_3\_T-12.2\_3.5 SNMP*|Cisco|Cisco IOS > 12.0 3 T i <12.2 3.5|\-|IOS|CISCO-PROCESS-MIB,CISCO-MEMORY-POOL-MIB ,CISCO-ENVMON-MIB|Certificat| |*Cisco IOS anterior a 12.0\_3\_T SNMP*|Cisco|Cisco IOS <12.0 3 T|\-|IOS|OLD-CISCO-CPU-MIB,CISCO-MEMORY-POOL-MIB|Certificat| |*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|Certificat| |*D-Link DES 7200 SNMP*|D-Link|DES-7xxx|D-Link DES 7206|\-|ENTITY-MIB,MY-SYSTEM-MIB,MY-PROCESS-MIB,MY-MEMORY-MIB|Per defecte<br>Error<br>Interfícies| |*Dell Force S-Series SNMP*|Dell|Dell Force S-Series|S4810| |F10-S-SERIES-XASIS-MIB|Certificat| |*Extreme Exos SNMP*|Extreme|Extreme EXOS|X670V-48x|EXOS|EXTREME-SYSTEM-MIB,EXTREME-SOFTWARE-MONITOR-MIB|Certificat| |*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|Rendiment<br>Inventari| |*Huawei VRP SNMP*|Huawei|Huawei VRP|S2352P-EI|\-|ENTITY-MIB,HUAWEI-ENTITY-EXTENT-MIB|Certificat| |*Intel\_Qlogic Infiniband SNMP*|Intel/QLogic|Dispositius Intel/QLogic Infiniband|Infiniband 12300| |ICS-XASIS-MIB|Error<br>Inventari| |*Juniper SNMP*|Models Juniper|MX,SRX,EX|Juniper MX240, Juniper EX4200-24F|JunOS|JUNIPER-MIB|Certificat| |*Mellanox SNMP*|Mellanox|Dispositius Mellanox Infiniband|SX1036|MLNX-OS|HOST-RESOURCES-MIB,ENTITY-MIB,ENTITY-SENSOR-MIB,MELLANOX-MIB|Certificat| |*MikroTik CCR<model de dispositiu> SNMP*|MikroTik|MikroTik Cloud Core Routers (sèrie CCR)|Hi ha plantilles dedicades separades disponibles per a MikroTik CCR1009-7G-1C-1S+, MikroTik CCR1009-7G-1C-1S+CCR10kro -7G-1C-PC, MikroTik CCR1016-12G, MikroTik CCR1016-12S-1S+, MikroTik CCR1036-12G-4S-EM, MikroTik CCR1036-12G-4S, MikroTik CCR1036-12S-1S+, MikroTik CCR1036-12G-4S-EM, MikroTik CCR1036-12S-1036+8 , MikroTik CCR1072-1G-8S+, MikroTik CCR2004-16G-2S+, MikroTik CCR2004-1G-12S+2XS|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certificat| |*MikroTik CRS<model de dispositiu> SNMP*|MikroTik|MikroTik Cloud Router Switches (sèrie CRS)|Hi ha plantilles dedicades separades disponibles per a MikroTik CRS106-1C-5S, MikroTik CRS109-8G-1S-2HnD-IN, MikroTik CRS112-8 -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 CRS-309-1 8S+IN, MikroTik CRS312-4C+8XG-RM, MikroTik CRS317-1G-16S+RM, MikroTik CRS326-24G-2S+IN, MikroTik CRS326-24G-2S+RM, MikroTik CRS326-24G-2S+RM, MikroTik CRS326-24G-2S+RM, MikroTik CRS326Tik+2 CRS328-24P-4S+RM, MikroTik CRS328-4C-20S-4S+RM, MikroTik CRS354-48G-4S+2Q+RM, MikroTik CRS354-48P-4S+2Q+RM|RouterOS/SwitchOS|MIKROHOST -RECURSOS-MIB|Certificat| |*MikroTik CSS<model de dispositiu> SNMP*|MikroTik|MikroTik Cloud Smart Switches (sèrie CSS)|Hi ha plantilles dedicades separades disponibles per a MikroTik CSS326-24G-2S+RM, MikroTik CSS610-8G-2S+IN|RouterOS|MIKROTIK MIB,HOST-RESOURCES-MIB|Certificat| |*MikroTik FiberBox SNMP*|MikroTik|MikroTik FiberBox|MikroTik FiberBox|RouterOS|MIKROTIK-MIB,HOST-RESOURCES-MIB|Certificat| |*MikroTik hEX <model de dispositiu> SNMP*|MikroTik|MikroTik hEX|Hi ha plantilles dedicades separades disponibles per a MikroTik hEX, MikroTik hEX lite, MikroTik hEX PoE, MikroTik hEX PoE lite, MikroTik hEX S|ROUTEROS-| RECURSOS-MIB|Certificat| |*MikroTik netPower <model de dispositiu> SNMP*|MikroTik|MikroTik netPower|Hi ha plantilles dedicades separades disponibles per a MikroTik netPower 15FR, MikroTik netPower 16P SNMP, MikroTik netPower Lite 7R|RouterOS/SwitchOUR, MIKROOSTIKRES,-|MIKROOSTIKRES-| -MIB|Certificat| |*MikroTik PowerBox <model de dispositiu> SNMP*|MikroTik|MikroTik PowerBox|Hi ha plantilles dedicades separades disponibles per a MikroTik PowerBox, MikroTik PowerBox Pro|RouterOS|MIKROTIK-MIB, HOST-RESOURCES-MIB|Certificat| |*MikroTik RB<model de dispositiu> SNMP*|MikroTik|Encaminadors de la sèrie MikroTik RB|Hi ha plantilles dedicades separades disponibles per a MikroTik RB1100AHx4, MikroTik RB1100AHx4 Dude Edition, MikroTik RB2011iL-IN, MikroTik RB2011iL-RM, MikroTik RB2011iLS-IN, MikroTik RB2011UiAS-IN, MikroTik RB2011UiAS-RM, MikroTik RB260GS, MikroTik RB3011iLS-IN, MikroTik RB3011UiAS-IN,+MIkroTik RB2011UiAS-RM,+MIkroTik-RMKRO1| HOST-RECURSOS-MIB|Certificat| |*MikroTik SNMP*|MikroTik|Dispositius MikroTik RouterOS|MikroTik CCR1016-12G, MikroTik RB2011UAS-2HnD, MikroTik 912UAG-5HPnD, MikroTik 941-2nD, MikroTik 941-2nD, MikroTik 941-2nD, MikroTik 1011UAS-2HnD, MikroTik 912UAG-5HPnD | |Certificat| |*QTech QSW SNMP*|QTech|Dispositius Qtech|Qtech QSW-2800-28T|\-|QTECH-MIB,ENTITY-MIB|Rendiment<br>Inventari| |*Ubiquiti AirOS SNMP*|Ubiquiti|Dispositius sense fil Ubiquiti AirOS|NanoBridge,NanoStation,Unifi|AirOS|FROGFOOT-RESOURCES-MIB,IEEE802dot11-MIB|Rendiment| |*HP Comware HH3C SNMP*|HP|HP (H3C) Comware|HP A5500-24G-4SFP HI Commutadors - AliExpress |HH3C-ENTITY-EXT-MIB,ENTITY-MIB|Certificat| |*HP Enterprise Switch SNMP*|HP|HP Enterprise Switch|HP ProCurve J4900B Switch 2626, HP J9728A 2920-48G Commutadors - AliExpress |ESTADÍSTIQUES-MIB,NETSWITCH-MIB,HP-ICF-XASSIS,ENTITY-MIB,SEMI-MIB|Certificat| |*TP-LINK SNMP*|TP-LINK|TP-LINK|T2600G-28TS v2.0| |TPLINK-SYSMONITOR-MIB,TPLINK-SYSINFO-MIB|Rendiment<br>Inventari| |*Netgear Fastpath SNMP*|Netgear|Netgear Fastpath|M5300-28G| |FASTPATH-SWITCHING-MIB,FASTPATH-BOXSERVICES-PRIVATE-MIB|Error<br>Inventari| # 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.| ### Objecte de consulta 'Informació de diagnòstic' L'objecte té les propietats següents. L'objecte de consulta estadística per a tots els tipus de propietat és [descrit en detall a continuació](/manual/api/reference/task/object#statistic_request_object). |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |historycache|object|Consulta estadístiques de la memòria cau de l'historial. Disponible al servidor i al proxy.| |valuecache|object|Consulta estadístiques de la memòria cau d'elements. Disponible al servidor.| |preprocessing|objecte|Consulta estadístiques del gestor de preprocessament. Disponible al servidor i al proxy.| |alert|object|Consulta estadístiques del gestor d'alertes. Disponible al servidor.| |lld|object|Consulta estadístiques del gestor de LLD. Disponible al servidor.| #### Disable action Disable an action, that is, set its status to "1". Request: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Desactivar una acció Desactivar accions; és a dir: establir el seu estat a "1". Consulta: ```json { "jsonrpc": "2.0", "method": "action.update", "params": { "actionid": "2", "status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "actionids": [ "2" ] }, "id": 1 } ``` #### Disable correlation Request: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Desactivar la correlació Petició: ```json { "jsonrpc": "2.0", "method": "correlation.update", "params": { "correlationid": "1", "status": "1" }, "auth": "343baad4f88b4106b9b5961e77437688", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "correlationids": [ "1" ] }, "id": 1 } ``` #### Disable trapping Disable LLD trapping for discovery rule. Request: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### Desactivar traps Desactivar traps LLD d'una regla de descoberta. Petició: ```json { "jsonrpc": "2.0", "method": "discoveryrule.update", "params": { "itemid": "28336", "allow_traps": 0 }, "id": 36, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "28336" ] }, "id": 36 } ``` #### Disabling ability to execute scripts Update role with ID "5", disable ability to execute scripts. Request: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "actions": [ { "name": "execute_scripts", "status": "0" } ] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Desactivar la possibilitat d'executar scripts Actualitzar el rol amb l'ID "5", desactivant-t'hi la possibilitat d'executar els scripts. Petició: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "actions": [ { "name": "execute_scripts", "status": "0" } ] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Desactivar un prototip d'equip Desactiva un prototip d'equip; és a dir, establir el seu estat a 1. Petició: ```json { "jsonrpc": "2.0", "method": "hostprototype.update", "params": { "hostid": "10092", "status": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10092" ] }, "id": 1 } ``` #### Disabling a user group Disable a user group. Request: ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` #### Deshabilitar un grup d'usuaris Deshabilitar un grup d'usuaris. Petició: ```json { "jsonrpc": "2.0", "method": "usergroup.update", "params": { "usrgrpid": "17", "users_status": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "usrgrpids": [ "17" ] }, "id": 1 } ``` #### Disabling default web server error pages It is recommended to disable default error pages to avoid information exposure. Web server is using built-in error pages by default:  Default error pages should be replaced/removed as part of the web server hardening process. The "ErrorDocument" directive can be used to define a custom error page/text for Apache web server (used as an example). Please refer to documentation of your web server to find help on how to replace/remove default error pages. #### Desactivar de les pàgines d'error predeterminades del servidor web Es recomana desactivar les pàgines d'error predeterminades per evitar l'exposició de la informació. El servidor web empra les pàgines d'error integrades de manera predeterminada:  Les pàgines d'error predeterminades s'han de substituir/esborrar com a part del procés de securització del servidor web. La directiva "ErrorDocument" es pot emprar per definir una pàgina/text d'error personalitzat per al servidor web Apache (emprat com a exemple). Consulteu la documentació del vostre servidor web per obtindre ajuda sobre com anul·lar/esborrar les pàgines d'error predeterminades. ### Disabling high availability To disable a high availability cluster: - make backup copies of configuration files - stop standby nodes - remove the HANodeName parameter from the active primary server - restart the primary server (it will start in standalone mode) ### Desactivació de l'alta disponibilitat Per desactivar un clúster d'alta disponibilitat: - teu còpies de seguretat dels fitxers de configuració - tanqueu els nodes de còpia de seguretat - esborreu el paràmetre HANodeName del servidor principal actiu - reinicieu el servidor principal (iniciarà en mode autònom) #### Disabling scheduled report Request: ```json { "jsonrpc": "2.0", "method": "report.update", "params": { "reportid": "1", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Desactivar l'informe programat Petició: ```json { "jsonrpc": "2.0", "method": "report.update", "params": { "reportid": "1", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "reportids": [ "1" ] }, "id": 1 } ``` #### Disabling web server information exposure It is recommended to disable all web server signatures as part of the web server hardening process. The web server is exposing software signature by default:  The signature can be disabled by adding two lines to the Apache (used as an example) configuration file: ```ini ServerSignature Off ServerTokens Prod ``` PHP signature (X-Powered-By HTTP header) can be disabled by changing the php.ini configuration file (signature is disabled by default): ```ini expose_php = Off ``` Web server restart is required for configuration file changes to be applied. Additional security level can be achieved by using the mod\_security (package libapache2-mod-security2) with Apache. mod\_security allows to remove server signature instead of only removing version from server signature. Signature can be altered to any value by changing "SecServerSignature" to any desired value after installing mod\_security. Please refer to documentation of your web server to find help on how to remove/change software signatures. #### Desactivar de l'exposició de la informació del servidor web Es recomana que desactiveu totes les signatures del servidor web com a part del procés de securització del servidor web. El servidor web exposa la signatura del programari predeterminat:  La signatura es pot desactivar afegint dues línies al fitxer de configuració d'Apache (emprat com a exemple): ```ini ServerSignature Off ServerTokens Prod ``` La signatura PHP (capçalera X-Powered-By HTTP) es pot desactivar editant el fitxer de configuració php.ini (la signatura és desactivada per defecte): ```ini expose_php= Off ``` Cal reiniciar el servidor web perquè els canvis al fitxer de configuració tinguin efecte. Es pot aconseguir un nivell addicional de seguretat emprant mod\_security (paquet libapache2-mod-security2) amb Apache. mod\_security permet esborrar la signatura del servidor en lloc d'esborrar només la versió de la signatura del servidor. La signatura es pot canviar a qualsevol valor modificant "SecServerSignature" després d'instal·lar mod\_security. Consulteu la documentació del vostre servidor web per obtindre ajuda sobre com esborrar/modificar signatures de programari. ### 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. Items (similarly, triggers and graphs) created by a low-level discovery rule will be deleted automatically if a discovered entity (file system, interface, etc) stops being discovered (or does not pass the filter anymore). In this case the items, triggers and graphs will be deleted after the days defined in the *Keep lost resources period* field pass. When discovered entities become 'Not discovered anymore', a lifetime indicator is displayed in the item list. Move your mouse pointer over it and a message will be displayed indicating how many days are left until the item is deleted.  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"} ### Entitats descobertes Les captures de pantalla següents il·lustren com són els elements, triggers i gràfics descoberts a la configuració de l'equip. Les entitats descobertes van precedides d'un enllaç carbassa a la regla de descoberta de la qual es van originar. {width="600"} Tingueu en compte que les entitats descobertes no es crearan si ja hi ha entitats existents amb els mateixos criteris d'unicitat, per exemple, un element amb la mateixa clau o un gràfic amb el mateix nom. En aquest cas, es mostra un missatge d'error a la interfície que indica que la regla de descoberta de baix nivell no ha pogut crear determinades entitats. La regla de descoberta en si, però, no quedarà sense suport perquè algunes entitats no es van poder crear i s'han hagut de descartar. La regla de descoberta continuarà creant/actualitzant altres entitats. Els elements (juntament amb triggers i gràfics) creats per una regla de descoberta de baix nivell s'esborraran automàticament si una entitat descoberta (sistema de fitxers, interfície, etc.) deixa d'ésser descoberta (o ja no passa el filtre). En aquest cas, els elements, triggers i gràfics s'esborraran un cop hagin passat els dies definits al camp *Període de retenció per a recursos perduts*. Quan les entitats descobertes passen a ésser "Ja no es descobreixen", es mostra un indicador de vida útil a la llista d'elements. Mou el punter del ratolí per sobre i apareixerà un missatge que indicarà quants dies queden perquè s'esborri l'element.  Si s'han marcat les entitats per esborrar-les, però no s'han esborrat quan s'esperava (regla de descoberta o elements d'equip desactivades), s'esborraran el proper cop que es processi la regla de descoberta. Les entitats que contenen altres entitats, que són marcades per a esborrar, no s'actualitzaran si es modifiquen a nivell de regla de descoberta. Per exemple, els triggers basats en LLD no s'actualitzaran si contenen elements marcats per esborrar-los.   #### 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"} #### Entitats descobertes Quan el servidor s'executa, crea elements reals, triggers i gràfics basats en els valors que retorna la regla de descoberta SNMP. A la configuració de l'equip, van precedits per un enllaç carbassa a una regla de descoberta d'origen. {width="600"} {width="600"} {width="600"} ### 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|string|ID of the discovered host.| |druleid|string|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.| ### Equip descobert ::: noteclassic Els equips descoberts són creats per el servidor Zabbix i no poden pas ésser modificats mitjançant l'API. ::: L'objecte d'equip descobert conté informació sobre un equip descobert per una regla de descoberta de xarxa. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dhostid|string|ID de l'equip descobert.| |druleid|string|ID de la regla de descoberta que ha detectat l'equip.| |lastdown|timestamp|Hora en que l'equip descobert era desactivat el darrer cop.| |lastup|timestamp|Hora en que l'equip descobert era actiu per darrer cop.| |status|integer|Indica si l'equip descobert és actiu o apagat. L'equip és actiu si té, com a mínim, un servei descobert actiu.<br><br>Valors possibles:<br>0 - equip actiu;<br>1 - equip inactiu.| # Discovered host object The following objects are directly related to the `dhost` API. # Objecte d'equip trobat Els següents objectes són relacionats amb l'API `dhost`. # 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 # Equip trobat Aquesta classe és dissenyada per treballar amb equips trobats. Referències d'objectes: - [Equip trobat](/manual/api/reference/dhost/object#discovered_host) Mètodes disponibles: - [dhost.get](/manual/api/reference/dhost/get) - recuperar els equips trobats ### 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|string|ID of the discovered service.| |dcheckid|string|ID of the discovery check used to detect the service.| |dhostid|string|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.| ### Servei descobert ::: noteclassic Els serveis descoberts són creats pel servidor de Zabbix i no poden pas ésser modificat via l'API. ::: L'objecte de servei descobert conté informació d'un servei descobert per una regla de descoberta de xarxa sobre un equip. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dserviceid|string|ID del servei descobert.| |dcheckid|string|ID del test de descoberta emprat per detectar el servei.| |dhostid|string|ID de l'equip descobert que fa anar el servei.| |dns|string|DNS de l'equip que fa anar el servei.| |ip|string|Adreça IP de l'equip que fa anar el servei.| |lastdown|timestamp|Hora en que el servei descobert es va tancar.| |lastup|timestamp|Hora en que el servei descobert va engegar.| |port|integer|Nombre del port de servei.| |status|integer|Estat del servei.<br><br>Valors possibles:<br>0 - servei actiu;<br>1 - servei caigut.| |value|string|Valor retornat pel servei quan es fa un test de descoberta dels agents SNMPv1, SNMPv2 or SNMPv3 de Zabbix.| # Discovered service object The following objects are directly related to the `dservice` API. # Objecte de servei de descoberta Els següents objectes són vinculats directament a l'API `dservice`. # 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 # Servei trobat Aquesta classe és definida per treballar amb els serveis trobats. Referències d'objectes: - [Servei trobat](/manual/api/reference/dservice/object#discovered_service) Mètodes disponibles: - [dservice.get](/manual/api/reference/dservice/get) - recuperar els serveis trobats ##### 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 } } ] ``` ##### Descoberta dels atributs MBean Element de descoberta: `jmx.get[attributes,"com.example:type=*,*"]` Resposta: ``` {.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" } } ] ``` ##### Descoberta dels MBeans Element de descoberta: `jmx.get[beans,"com.example:type=*,*"]` Resposta: ``` {.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 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. ::: #### Accions de descoberta Les condicions següents es poden emprar en esdeveniments basats en descoberta: |Tipus de condició|Operadors admesos|Descripció| |--|--|------| |*La IP de l'equip*|és igual a<br>no és igual|Especifiqueu un interval o un interval d'adreces IP per excloure per a un equip descobert.<br>**igual** - l'adreça IP de l'equip és dins l'interval.<br>**no igual** - l'IP de l'equip no és dins l'interval.<br>Pot tenir els formats següents:<br>IP única: 192.168.1.33<br>Interval d'adreces IP: 192.168.1-10.1-254<br>Màscara IP: 192.168.4.0/24<br>Llista: 192.168.1.1-254, 192.168.2.1-100, 192.168.2.200, 192.168.4.0/24<br>S'ofereix suport per a espais en format llista de Zabbix 3.0. |*Tipus de servei*|igual a<br>no és igual|Especifiqueu un tipus de servei d'un servei descobert o un tipus de servei a excloure.<br>**igual** - coincideix amb el servei descobert.< br>**no és igual** - no coincideix amb el servei descobert.<br>Tipus de serveis disponibles: SSH, LDAP, SMTP, FTP, HTTP, HTTPS *(disponible des de la versió 2.2 de Zabbix)*, POP, NNTP, IMAP, TCP, agent Zabbix, agent SNMPv1, agent SNMPv2, agent SNMPv3, ping ICMP, telnet *(disponible des de la versió 2.2 de Zabbix)*.| |*Port de servei*|és igual a<br>no és igual|Especifiqueu un interval de ports TCP d'un servei descobert o un interval per excloure.<br>**igual** - el port de servei es troba dins l'interval.<br>**no és igual** - el port de servei no és dins l'abast.| |*La regla de descoberta*|es igual a<br>no és igual|Especifiqueu una regla de descoberta o una regla de descoberta per excloure.<br>**igual** - emprant aquesta regla de descoberta.<br>**no és igual** - emprant qualsevol altra regla de descoberta excepte aquesta.| |*Prova de descoberta*|és igual a<br>no és igual|Especifiqueu una comprovació de descoberta o una comprovació de descoberta per excloure.<br>**igual** - emprant aquesta comprovació de descoberta.<br>**no és igual** - emprant qualsevol altre control de descoberta excepte aquest.| |*Objecte de descoberta*|igual a|Especifiqueu l'objecte descobert.<br>**igual a** - és igual a l'objecte descobert (un dispositiu o servei).| |*Estat de descoberta*|igual a|**En execució** - coincideix amb els esdeveniments "Executant l'equip" i "Executant el servei"<br>**Aturat** - coincideix amb els esdeveniments "Equip caigut" i "Servei caigut"< br>**Descobert** - coincideix amb els esdeveniments 'Host Discovered' i 'Service Discovered'<br>**Perdut** - coincideix amb els esdeveniments 'Host Lost' i 'Service Lost'| |*En execució/Aturat*|és superior o igual<br>és menor o igual|El temps de funcionament dels esdeveniments "L'equip s'és executant" i el "El servei s'és executant". El temps d'inactivitat dels esdeveniments "Host Down" i "Service Down".<br>**és superior o igual a** - és superior o igual a. El paràmetre es dóna en segons.<br>**és menor o igual que** - és menor o igual que. El paràmetre es dóna en segons.| |*El valor rebut*| és igual a<br>no és igual<br>és major o igual a<br>és menor o igual a<br>conté<br>no conté|Especifiqueu el valor rebut d'un agent (Zabbix, SNMP) comproveu una regla de descoberta. Comparació de cadenes. Si es configuren diversos agents Zabbix o comprovacions SNMP per a una regla, es comproven els valors rebuts per a cadascun d'ells (cada control genera un nou esdeveniment que coincideix amb totes les condicions).<br>**igual a** - és igual al valor. <br>**no és igual** - no és igual al valor.<br>**és més gran o igual que** - més gran o igual que el valor.<br>**és menor o igual que** - inferior o igual al valor.<br>**conté** - conté la subcadena. El paràmetre es dóna com a cadena.<br>**no conté** - no conté la subcadena. El paràmetre es dóna com a cadena.| |*Proxy*|igual<br>no igual|Especifiqueu un proxy per excloure.<br>**igual** - emprant aquest proxy.<br>**no igual** - epra un altre proxy excepte aquest. | :::noteclassic Les comprovacions de servei en una regla de descoberta, que donen lloc a esdeveniments de descoberta, no es produeixen simultàniament. Per tant, si es configuren **diversos** valors per a les condicions de "Tipus de servei", "Port de servei" o "Valor rebut" a l'acció, es comprovaran amb un esdeveniment de descoberta alhora, però **no** a diversos esdeveniments simultàniament. Per tant, les accions amb diversos valors per als mateixos tipus de control poden no executar-se correctament. ::: # Discovery check object The following objects are directly related to the `dcheck` API. # Objecte test de descoberta Els següents objectes són relacionats amb l'API `dcheck`. ### 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|string|*(readonly)* ID of the discovery check.| |druleid|string|*(readonly)* ID of the discovery rule that the check belongs to.| |key\_|string|The value of this property differs depending on the type of the check:<br>- key to query for Zabbix agent checks, required;<br>- SNMP OID for SNMPv1, SNMPv2 and SNMPv3 checks, required.| |ports|string|One or several port ranges to check separated by commas. Used for all checks except for ICMP.<br><br>Default: 0.| |snmp\_community|string|SNMP community.<br><br>Required for SNMPv1 and SNMPv2 agent checks.| |snmpv3\_authpassphrase|string|Authentication passphrase used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.| |snmpv3\_authprotocol|integer|Authentication protocol used for SNMPv3 agent checks with security level set to *authNoPriv* or *authPriv*.<br><br>Possible values:<br>0 - *(default)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|SNMPv3 context name. Used only by SNMPv3 checks.| |snmpv3\_privpassphrase|string|Privacy passphrase used for SNMPv3 agent checks with security level set to *authPriv*.| |snmpv3\_privprotocol|integer|Privacy protocol used for SNMPv3 agent checks with security level set to *authPriv*.<br><br>Possible values:<br>0 - *(default)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Security level used for SNMPv3 agent checks.<br><br>Possible values:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Security name used for SNMPv3 agent checks.| |**type**<br>(required)|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.| |uniq|integer|Whether to use this check as a device uniqueness criteria. Only a single unique check can be configured for a discovery rule. Used for Zabbix agent, SNMPv1, SNMPv2 and SNMPv3 agent checks.<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.| |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.| ### Test de descoberta L'objecte de test de descoberta defineix una verificació específica feta per una regla de descoberta de xarxa. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |dcheckid|string|*(només lectura)* ID del test de descoberta.| |druleid|string|*(només lectura)* ID de la regla de descoberta al qui pertany el test.| |key\_|string|El valor d'aquesa propietat difereix segons el tipus de test:<br>- clau per demanar els tests d'agent de Zabbix, obligatori;<br>- SNMP OID per als tests SNMPv1, SNMPv2 i SNMPv3, obligatori.| |ports|string|Un o més rangs de ports per testar, separats per comes. Emprat per tots els tests excepte ICMP.<br><br>Per defecte: 0.| |snmp\_community|string|Comunitat SNMP.<br><br>obligatori per als tests d'agents SNMPv1 i SNMPv2.| |snmpv3\_authpassphrase|string|Frase de pas d'autenticació emprat per als tests d'agents SNMPv3 amb nivell de seguretat definit a *authNoPriv* o *authPriv*.| |snmpv3\_authprotocol|integer|Protocol d'autenticació emprat pels tests d'agent SNMPv3 amb nivell de seguretat establert a *authNoPriv* o *authPriv*.<br><br>Valors possibles:<br>0 - *(per defecte)* MD5;<br>1 - SHA1;<br>2 - SHA224;<br>3 - SHA256;<br>4 - SHA384;<br>5 - SHA512.| |snmpv3\_contextname|string|Nom de context SNMPv3. Emprat només pels tests SNMPv3.| |snmpv3\_privpassphrase|string|Frase de pas de privacitat emprada pels tests d'agent SNMPv3 amb nivell de seguretat establert a *authPriv*.| |snmpv3\_privprotocol|integer|Protocol de privacitat emprat pels tests d'agent SNMPv3 amb el nivell de seguretat establert a *authPriv*.<br><br>Valors possibles:<br>0 - *(per defecte)* DES;<br>1 - AES128;<br>2 - AES192;<br>3 - AES256;<br>4 - AES192C;<br>5 - AES256C.| |snmpv3\_securitylevel|string|Nivell de seguretat emprat pels tests d'agent SNMPv3.<br><br>Valors possibles:<br>0 - noAuthNoPriv;<br>1 - authNoPriv;<br>2 - authPriv.| |snmpv3\_securityname|string|Nom de seguretat emprat pels tests d'agent SNMPv3.| |**type**<br>(obligatori)|integer|Tipus de test.<br><br>Valors possibles:<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 - Agent de Zabbix;<br>10 - SNMPv1 agent;<br>11 - SNMPv2 agent;<br>12 - ICMP ping;<br>13 - SNMPv3 agent;<br>14 - HTTPS;<br>15 - Telnet.| |uniq|integer|Indica si hem de fer ús aquest test com a criteri d'unicitat del dispositiu. Una única verificació pot ésser configurada per la regla de descoberta. Emprat per les verificacions d'agent de Zabbix, SNMPv1, SNMPv2 i SNMPv3.<br><br>Valors possibles:<br>0 - *(per defecte)* no emprar pas aquest test com a criteri únic;<br>1 - emprar aquest test com a criteri únic.| |host\_source|integer|Origen per al nom d'equip.<br><br>Valors possibles:<br>1 - *(per defecte)* DNS;<br>2 - IP;<br>3 - valor de descoberta d'aquest test.| |name\_source|integer|Origen per al nom visible.<br><br>Valors possibles:<br>0 - *(per defecte)* no definit;<br>1 - DNS;<br>2 - IP;<br>3 - valor de descoberta per aquest test.| # 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 # Verificació de descoberta Aquesta classe és dissenyada per treballar amb verificacions de descoberta. Referència d'objectes: - [Verificació de descoberta](/manual/api/reference/dcheck/object#discovery_check) Mètodes disponibles: - [dcheck.get](/manual/api/reference/dcheck/get) - recupera les verificacions de descoberta #### 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.| #### Esdeveniments de descoberta Zabbix analitza periòdicament els intervals IP definits a les regles de descoberta de xarxa. La freqüència de la comprovació es pot configurar per a cada regla individualment. Un cop es descobreix un equip o servei, es genera un esdeveniment de descoberta (o diversos esdeveniments). Zabbix genera els esdeveniments següents: |Esdeveniment|Quan es genera| |--|---------| |Servei aixecat|Sempre que Zabbix detecta un servei actiu.| |Servei caigut|Sempre que Zabbix no pot detectar el servei.| |Equip actiu|Si almenys un dels serveis és actiu per a la IP.| |Equip caigut|Si no responen tots els serveis de l'equip.| |Servei descobert|Si el servei torna després d'un temps d'inactivitat o si s'ha descobert per primer cop.| |Servei perdut|Si el servei es perd després d'haver-se activat.| |Equip descobert|Si l'equip ha tornat després del temps d'inactivitat o si s'ha descobert per primer cop.| |Equip perdut|Si l'equip es perd després d'haver-se activat.| ### Discovery of disabled systemd units It is now also possible to discover **disabled** systemd units using the *systemd.unit.discovery* item key, supported by Zabbix agent 2. Note that to have items and triggers created from prototypes for disabled systemd units, it may be necessary to adjust (or remove) prohibiting LLD filters for the {#UNIT.ACTIVESTATE} and {#UNIT.UNITFILESTATE} macros. For more details, see [Discovery of systemd services](/manual/discovery/low_level_discovery/examples/systemd). ### Descoberta d'unitats de sistema desactivades Ara també és possible descobrir unitats systemd **desactivades** mitjançant la clau d'element *systemd.unit.discovery*, admesa per l'agent Zabbix 2. Tingueu en compte que per crear elements i triggers a partir de prototips per a unitats de sistema desactivades, pot ser que calgui ajustar (o eliminar) els filtres LLD no permesos per a les macros {#UNIT.ACTIVESTATE} i {#UNIT.UNITFILESTATE}. Per obtindre més informació, veieu [Descoberta dels serveis de systemd](/manual/discovery/low_level_discovery/examples/systemd). ##### 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}. ::: ##### Descoberta de les unitats de systemd desactivades Des de Zabbix 6.0.1 també és possible descobrir unitats systemd **desactivades**. En aquest cas, es retornen tres macros al JSON resultant: - {#UNIT.PATH} - {#UNIT.ACTIVESTATE} - {#UNIT.UNITFILESTATE}. ::: noteimportant Per crear elements i triggers a partir de prototips per a unitats de sistema desactivades, assegureu-vos d'ajustar (o esborrar) els filtres LLD que no permeten {#UNIT.ACTIVESTATE} i {#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. ### Descoberta dels serveis de Windows Windows La [descoberta de baix nivell](/manual/discovery/low_level_discovery/windows_services) ofereix una manera de crear automàticament elements, triggers i gràfics per a diferents entitats en un ordinador. Zabbix pot començar automàticament a monitorar els serveis de Windows a la vostra màquina, sense necessitat de sabre el nom exacte d'un servei ni de crear elements per a cada servei manualment. Es pot emprar un filtre per generar elements reals, triggers i gràfics només per als serveis que us interessen. #### discoveryrule Bug fixes:<br> [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `discoveryrule.create`, `discoveryrule.update`: property `interfaceid` is no longer required to create/update a HTTP agent type LLD rule. #### regla de descobriment Correcció d'errades:<br> [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `discoveryrule.create`, `discoveryrule.update`: La propietat `interfaceid`ja no és necessària per a crear o actualitzar una regla LLD del tipus d'agent HTTP. #### discoveryrule Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `discoveryrule.update`: the parameter `uuid` can now be updated. #### regla de descoberta Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `discoveryrule.update`: el paràmetre `uuid` ara es pot actualitzar. # 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. # Objecte de regla de descoberta Els següents objectes són relacionats amb l'API `drule`. #### 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):  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 and their types.<br>Note that another option for filesystem discovery is using discovery results by the "vfs.fs.get" agent key, supported since Zabbix 4.4.5 (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, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.<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 for an existing discovery rule the discovery can be performed immediately by pushing the *Check 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). Scheduling is supported since Zabbix 3.0.0.| |*Keep lost resources period*|This field allows you to specify the duration for how long the discovered entity will be retained (won't be deleted) once its discovery status becomes "Not discovered anymore" (between 1 hour to 25 years; or "0").<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.<br>*Note:* If set to "0", entities will be deleted immediately. Using "0" is not recommended, since just wrongly editing the filter may end up in the entity being deleted with all the historical data.| |*Description*|Enter a description.| |*Enabled*|If checked, the rule will be processed.| ::: noteclassic Discovery rule history is not preserved. ::: #### Regla de descoberta El formulari de regla de descoberta conté cinc pestanyes que representen, d'esquerra a dreta, el flux de dades durant la descoberta: - *Regla de descoberta* - especifica, sobretot, l'element integrat o l'script personalitzat per recuperar les dades de descoberta - *Preprocessament* - aplica el preprocessament a les dades descobertes - *LLD Macros* - extreu determinats valors de macro per emprar-los a elements descoberts, triggers, etc. - *Filtres* - permet filtrar els valors descoberts - *Anul·lació* - permet modificar elements, triggers, gràfics o prototips d'equips quan s'aplica a objectes descoberts específics La pestanya **Regla de descoberta** conté la clau de l'element que cal emprar per a la descoberta (a més d'alguns atributs generals de la regla de descoberta):  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| | *Nom* | Nom de la regla de descoberta. | | *Tipus* | El tipus de comprovació per realitzar la descoberta<br>En aquest exemple, som emprant una clau d'element *agent Zabbix*.<br>La regla de descoberta també pot ser un [element dependent](/manual/config/items/itemtypes/dependent_items). No pot dependre d'una altra regla de descoberta. Per a un element dependent, seleccioneu el tipus corresponent (*Element dependent*) i especifiqueu l'element mestre al camp "Element mestre". L'element mestre ha d'existir.| | *Clau* | Introduïu la clau d'element de descoberta (fins a 2048 caràcters).<br>Per exemple, podeu emprar la clau d'element integrada "vfs.fs.discovery" per retornar una cadena JSON amb la llista de fitxers de sistemes de descoberta presents a l'ordinador, i els seus tipus.<br>Tingueu en compte que una altra opció per a la descoberta del sistema de fitxers empra els resultats de la descoberta mitjançant la clau de l'agent "vfs.fs.get", compatible des de Zabbix 4.4.5 (veieu l'[exemple](/manual/discovery/low_level_discovery/examples/mounted_filesystems)).| | *Interval d'actualització* | Aquest camp especifica amb quina freqüència Zabbix realitza la descoberta. Al principi, quan només sou configurant la descoberta del sistema de fitxers, podeu establir un petit interval, però un cop sabeu que funciona, podeu configurar-ho en 30 minuts o més perquè els sistemes de fitxers normalment no canvien gaire sovint.<br>Els [sufixos de temps](/manual/appendix/sufixos), com ara 30s, 1m, 2h, 1d, s'admeten des de Zabbix 3.4.0.<br>S'admeten [macros d'usuari](/manual/config/macros/usermacros) des de Zabbix 3.4.0.<br>*Nota*: L'interval d'actualització només es pot establir a '0' si hi ha intervals personalitzats amb un valor diferent de zero. Si s'estableix a "0" i existeix un interval personalitzat (flexible o programat) amb un valor diferent de zero, l'element es consultarà durant la durada de l'interval personalitzat.<br>*Tingueu en compte* que per a una regla de descoberta existent, la descoberta es pot fer de seguida prement el [botó](/manual/discovery/low_level_discovery#form-buttons) *Comprovar ara*. | | *Interval personalitzat* | Podeu crear regles personalitzades per comprovar l'element:<br>**Flexible** - crear una excepció a l'*interval d'actualització* (interval amb una freqüència diferent)<br>**Programació** - crear un programa d'enquesta personalitzat.<br> Per obtindre més informació, veieu els [intervals personalitzats](/manual/config/items/item/custom_intervals). La programació és compatible des de Zabbix 3.0.0. | | *Període de retenció de recursos perduts* | Aquest camp us permet especificar quant de temps es conservarà l'entitat descoberta (no s'esborrarà) després que el seu estat de descoberta es converteixi a "No descobert" (entre 1 hora i 25 anys; o "0").<br>Els [Sufixos de temps](/manual/appendix/sufixos), com ara 2h, 1d, són compatibles des de Zabbix 3.4.0.<br>S'admeten [macros d'usuari](/manual/config/macros/usermacros) des de Zabbix 3.4.0. <br>*Nota:* Si el valor és "0", les entitats s'esborraran de seguida. No es recomana emprar "0", perquè canviar el filtre de manera incorrecta pot acabar amb la supressió de l'entitat amb totes les dades històriques. | | *Descripció* | Introduïu una descripció. | | *Activat* | Si es marca, es processarà la regla. | :::noteclassic La història de les regles de descoberta no es conserva. ::: ### 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|string|*(readonly)* ID of the discovery rule.| |**iprange**<br>(required)|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.| |**name**<br>(required)|string|Name of the discovery rule.| |delay|string|Execution interval of the discovery rule. Accepts seconds, time unit with suffix and user macro.<br><br>Default: 1h.| |nextcheck|timestamp|*(readonly)* Time when the discovery rule will be executed next.| |proxy\_hostid|string|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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### regla de desecoberta L'objecte de regla de descoberta defineix una regla de descobriment de xarxa. Té les propietat següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció |--|--|------| |druleid|string|*(només lectura)* ID de la regla de descoberta.| |**iprange**<br>(obligatori)|string|Uno diversos rangs d'IP per cercar, separats per comes.<br><br>Veieu la secció [configuració de descoberta de xarxa](/manual/discovery/network_discovery/rule) per tindre més informació sobre els formats de rangs IP suportats.| |**name**<br>(obligatori)|string|Name of the discovery rule.| |delay|string|Interval d'execució de la regla de descoberta. Accepta segons, unitat de temps amb sufixe i macros d'usuari.<br><br>Per defecte: 1h.| |nextcheck|timestamp|*(només lectura)* Hora en que s'executarà de nou la regla de descoberta.| |proxy\_hostid|string|ID del proxy emprat per la descoberta.| |status|integer|Diu si la regla de descoberta és activa.<br><br>Valors possibles:<br>0 - *(per defecte)* actiu;<br>1 - desactivat.| Veieu que per alguns mètodes (actualitzar, esborrar) la combinació de paràmetres requerits o opcionals és diferent. # Discovery rule This class is designed to work with network discovery rules. ::: notetip This API is meant to work with network discovery rules. For the low-level discovery rules see the [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 discovery rules - [drule.delete](/manual/api/reference/drule/delete) - delete discovery rules - [drule.get](/manual/api/reference/drule/get) - retrieve discovery rules - [drule.update](/manual/api/reference/drule/update) - update discovery rules # Regla de descoberta Aquesta classe és dissenyada per treballar amb les regles de descoberta de xarxa. ::: notetip Aquesta API és dissenyada per funcionar amb les regles de descoberta de xarxa. Per les regles de descoberta de baix nivell de xarxa, veieu l'[API regla de descoberta de baix nivell](discoveryrule). ::: Referències dels objectes: - [Regla de descoberta](/manual/api/reference/drule/object#discovery_rule) Mètodes disponibles: - [drule.create](/manual/api/reference/drule/create) - crear una nova regla de descoberta - [drule.delete](/manual/api/reference/drule/delete) esborrar una regla de descoberta - [drule.get](/manual/api/reference/drule/get) - recuperar una regla de descoberta - [drule.update](/manual/api/reference/drule/update) - actualitzar una regla de descoberta # discoveryrule.update # discoveryrule.update #### Discovery Zabbix can use a low-level discovery rule to automatically discover VMware hypervisors and virtual machines.  All mandatory input fields are marked with a red asterisk. The discovery rule key in the above screenshot is *vmware.hv.discovery\[{$VMWARE.URL}\]*. #### Descoberta Zabbix pot emprar una regla de descoberta de baix nivell per trobar automàticament hipervisors i màquines virtuals de VMware.  Tots els camps obligatoris són marcats amb un asterisc vermell. La clau de la regla de descoberta de la captura de pantalla anterior és *vmware.hv.discovery\[{$VMWARE.URL}\]* #### 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. Note that one discovery rule will always be processed by a single discoverer process. The IP range will not be split between multiple discoverer processes. Each rule has a set of service checks defined to be performed for the IP range. ::: noteclassic 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. ::: 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'.| #### Descoberta Zabbix explora periòdicament els intervals d'IP definits a [regles de descoberta de xarxa](/manual/discovery/network_discovery/rule). La freqüència de la comprovació es pot configurar per a cada regla individualment. Tingueu en compte que una regla de descoberta sempre es processarà mitjançant un únic procés de descoberta. L'interval d'adreces IP no es dividirà entre diversos processos de descoberta. Cada regla té un conjunt de comprovacions de servei per executar-se per a l'interval d'IP. :::noteclassic Les comprovacions de descoberta es processen independentment d'altres comprovacions. Si alguna comprovació no troba cap servei (o falla), les altres comprovacions encara es processaran. ::: Cada comprovació de servei i host (IP) realitzada pel mòdul de descoberta de xarxa genera un esdeveniment de descoberta. | Esdeveniment | Verificació de resultats del servei | | --- | --- | | *Servei descobert* | El servei s'"inicia" després d'ésser "aturat" o quan es descobreix per primer cop. | | *Servei activat* | El servei és 'iniciat'. | | *Servei perdut* | El servei és "aturat" després d'ésser "iniciat". | | *Servei baixa* | El servei és "aturat". | | *Equip descobert* | Almenys un dels serveis d'un equip s'"inicia" després que tots els serveis d'aquest equip s'hagin "aturat" o s'ha descobert un servei que pertany a un equip no registrat. | | *Allotjament* | Almenys un servei d'un equip és "iniciat". | | *Equip perdut* | Tots els serveis d'un equip són "aturats" després que almenys un dels serveis s'hagi "aturat". | | *Host Down* | Tots els serveis d'un equip són "aturats". | #### Display #### Visualització #### 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/monitoring/dashboard##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. #### Visualització A partir de la informació de confirmació, és possible configurar com es mostra al tauler o als mapes el recompte de problemes. Per fer-ho, hem de fer tries a l'opció *Problem display*, disponible a totes dues [map configuration](/manual/config/visualization/maps/map#creating_a_map) i el *Problems by severity* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard##adding_widgets). Es pot mostrar tot el recompte de problemes, problemes no reconeguts, comptar per separat de recompte de problemes totals o només els no reconeguts. En funció de la informació d'actualització del problema (reconeixement, etc.), és possible configurar operacions d'actualització: enviar missatges o fer córrer ordres remotes. ##### Displaying hosts in maintenance An orange wrench icon  next to the host name indicates that this host is in maintenance in: - *Monitoring → Dashboard* - *Monitoring → Problems* - *Inventory → Hosts → Host inventory details* - *Configuration → 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*. ##### Visualització d'equips en manteniment Una icona de clau anglesa carbassa  al costat del nom de l'equip vol dir que aquest equip és en manteniment a: - *Monitoratge → Tauler de control* - *Monitoratge → Problemes* - *Inventari → Equips → Detalls de l'inventari de l'equip* - *Configuració → Equips* (veieu la columna "Estat")  Els detalls de manteniment es mostren quan el punter del ratolí es posa damunt la icona. A més, els equips en manteniment tenen un fons carbassa a *Monitoratge → Mapes*. ##### 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: - *Monitoring* → *Dashboard* (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:  ##### Visualització dels problemes esborrats Normalment, els problemes dels equips en manteniment s'esborren, és a dir, no es veuen pas a la interfície. Tanmateix, és possible configurar la visualització dels problemes esborrats triant l'opció *Veure els problemes esborrats* en aquestes ubicacions: - *Monitoratge* → *Tauler de control* (a la configuració del giny *Equips problemàtics*, *Problemes*, *Problemes per gravetat*, *Visió general del trigger*) - *Monitoratge* → *Problemes* (al filtre) - *Monitoratge* → *Mapes* (a la configuració del mapa) - [Notificacions](/manual/web_interface/user_profile/global_notifications) globals (a la configuració del perfil d'usuari) Quan es veuen els problemes esborrats, es mostra la icona següent: . Passeu el cursor per sobre de la icona per veure més detalls:  #### Displaying trigger status With a trigger defined, you might be interested to see its status. If the CPU load has exceeded the threshold level you defined in the trigger, the problem will be displayed in *Monitoring → Problems*. {width="600"} The flashing in the status column indicates a recent change of trigger status, one that has taken place in the last 30 minutes. #### Veient l'estat dels triggers Amb un trigger definit, us interessarà veure el seu estat. Si la càrrega de la CPU ha superat el llindar que heu establert per al trigger, el problema es veurà a *Monitoratge → Problemes*. {width="600"} Si fa pampallugues vol dir que hi ha hagut un canvi recent d'estat en els darrers 30 minuts. #### 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. ::: #### Visualització A *Monitoratge → Mapes*, el color corresponent es mostrarà a l'enllaç si el trigger entra en un estat problemàtic.  :::noteclassic Si diversos triggers entren en un estat problemàtic, el problema amb la gravetat més alta determinarà l'estil i el color de l'enllaç. Si s'assignen diversos triggers amb la mateixa gravetat al mateix enllaç del mapa, té prioritat el que tingui l'identificador més baix. Tingueu en compte també que: 1. La configuració de *Gravetat mínima del trigger* i *Mostra el problema esborrat* a la configuració del mapa afecten els problemes que es tenen en compte. 2. En el cas dels triggers amb diversos problemes (generació de diversos problemes), cada problema pot tindre una gravetat diferent de la gravetat del trigger (canviat manualment), pot tindre etiquetes diferents (a causa de les macros) i es pot esborrar. ::: ##### 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. ##### Mostra A la llista d'elements, els elements dependents es mostren amb el seu nom d'element principal com a prefixe. {width="600"} Si s'esborra un element principal, tots els seus elements dependents s'esborren també. #### 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.| #### Opcions de visualització Els paràmetres següents són compatibles per configurar les *Opcions de visualització*. |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Selecció de dades de l'historial*|0|font|0 - *(per defecte)* Automàtic;<br>1 - Historial;<br>2 - Tendències.| #### Display The following screen will be displayed when trying to access the 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 always. #### Visualització La pantalla següent es mostra quan s'intenta accedir a la interfície Zabbix en mode de manteniment. La pantalla s'actualitza cada 30 segons per tornar a un estat normal sense la intervenció de l'usuari un cop finalitzat el manteniment.  Les adreces IP definides a ZBX\_GUI\_ACCESS\_IP\_RANGE podran accedir a la interfície com de costum. ##### Display This is the result in *Monitoring → Latest data*: {width="600"} Note that if a single numeric value is sent in, the data graph will show a horizontal line to the left and to the right of the time point of the value. ##### Vista Aquest és el resultat de *Monitoratge → Darreres dades*: {width="600"} Veieu que si s'envia un únic valor numèric, el gràfic de dades afegirà una línia horitzontal a l'esquerra i a la dreta del punt temporal del valor. #### 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 *Monitoring → Dashboard* by a Web monitoring widget. Recent results of the web scenario execution are available in the *Monitoring → Latest data* section. #### Visualització Per veure els escenaris web configurats per a un equip, aneu a *Monitoratge → Equips*, localitzeu l'equip a la llista i feu clic a l'hiperenllaç *Web* de la darrera columna. Feu clic al nom de l'escenari per obtindre informació detallada. {width="600"} També es pot veure una visió general dels escenaris web a *Monitoratge → Tauler* mitjançant un giny de monitoratge web. Els resultats recents de l'execució de l'escenari web estan disponibles a la secció *Monitoratge → Dades més recents*. #### Docker base images Zabbix components are provided on Ubuntu, Alpine Linux and CentOS base images: |Image|Version| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.16| |[ubuntu](https://hub.docker.com/_/ubuntu/)|22.04 (jammy)| |[centos](https://hub.docker.com/_/centos/)|8| All images are configured to rebuild latest images if base images are updated. #### Imatges base de Docker Es proporcionen components Zabbix amb Ubuntu, Alpine Linux i CentOS: |Imatge|Versió| |---|---| |[alpine](https://hub.docker.com/_/alpine/)|3.16| |[ubuntu](https://hub.docker.com/_/ubuntu/)|22.04 (jammy)| |[centos](https://hub.docker.com/_/centos/)|8| Totes les imatges són configurades per reconstruir les darreres imatges si s'actualitzen les imatges base. ### 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 6.0: ```bash git clone https://github.com/zabbix/zabbix-docker.git cd zabbix-docker git checkout 6.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), Zabbix server is started and the web interface is available at `http://localhost`. ::: 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 és la manera més ràpida de desplegar Zabbix. Llegeix un fitxer de configuració (composeu un fitxer) i gestiona tota la configuració: estireu les imatges de l'acoblador, creeu una xarxa interna entre contenidors, configureu l'emmagatzematge, inicialitzeu la base de dades i inicieu-ho tot en l'ordre correcte. El repositori [oficial Zabbix Dockerfiles](https://github.com/zabbix/zabbix-docker) proporciona fitxers Docker Compose preparats per utilitzar i un sistema de configuració basat en `.env` que suporta diferents sistemes operatius, backends de bases de dades i configuració de components de Zabbix. 1\. Cloneu el repositori, navegueu-hi i canvieu a la versió 6.0: ``bash git clone https://github.com/zabbix/zabbix-docker.git cd zabbix-docker git checkout 6.0 ``` 2\. (Opcional) Personalitzar el desplegament amb [variables d'entorn](#environment-variables). Aquesta passa es pot saltar per a una configuració per defecte. 3\. Desplegueu la configuració per defecte: servidor Zabbix, interfície web (executant a Nginx) i un backend de base de dades (MySQL o PostgreSQL), cadascun executant-se en el seu propi contenidor a Alpine Linux. ``bash # Amb MySQL com a base de dades: docker compose -f ./compose.yaml up -d # Amb PostgreSQL com a base de dades: docker compose -f ./compose_pgsql.yaml up -d ``` Després que els contenidors siguin engegats (normalment en 1-3 minuts), s'engega el servidor Zabbix i la interfície web és disponible a `http://localhost`. ::: noteclassic Utilitzeu `docker compose ps` per comprovar l'estat del contenidor. Tots els contenidors (excepte el contenidor `zabbix-docker-server-db-init-1`) haurien de tenir l'estat `Up`. Si s'ensenya alguna `Sortida`, comproveu els seus registres amb `acoblador logs <container-name>`. :: #### 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. #### Font dels arxius Docker Hom pot fer un seguiment dels canvis dels fitxers de Docker mitjançant el [repositori oficial] de Zabbix (https://github.com/zabbix/zabbix-docker) a [github.com](https://github.com/). Podeu bifurcar el projecte o crear les vostres pròpies imatges basades en els fitxers oficials de Docker. ### Docker |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |docker.container\_info\[<ID>,<info>\]|<|<|<| |Low-level information about a container.|An output of the [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) API call serialized as JSON|**ID** - ID or name of the container.<br>**info** - the amount of information returned. Supported values: *short* (default) or *full*.|The Agent2 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>\]|<|<|<| |Container resource usage statistics.|An output of the [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) API call and CPU usage percentage serialized as JSON|**ID** - ID or name of the container.| The Agent2 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|<|<|<| |A list of containers.|An output of the [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) API call serialized as JSON|\-| The Agent2 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>\]|<|<|<| |A list of containers. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object |**options** - specifies whether all or only running containers should be discovered. Supported values:<br>*true* - return all containers;<br>*false* - return only running containers (default).| The Agent2 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|<|<|<| |Information about current data usage.|An output of the [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) API call serialized as JSON|\-| The Agent2 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|<|<|<| |A list of images.|An output of the [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) API call serialized as JSON|\-| The Agent2 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|<|<|<| |A list of images. Used for [low-level discovery](/manual/discovery/low_level_discovery/).|JSON object |\-| The Agent2 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|<|<|<| |System information.|An output of the [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) API call serialized as JSON|\-| The Agent2 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|<|<|<| |Test if a Docker daemon is alive or not.|1 - connection is alive<br><br>0 - connection is broken|\-| The Agent2 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 |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |docker.container\_info \[\<ID\>,\<info\>\]|<|<|<| |Informació de baix nivell sobre un contenidor.|Una sortida de la crida a l'API [ContainerInspect](https://docs.docker.com/engine/api/v1.28/#operation/ContainerInspect) serialitzada en format JSON |** ID** - identificador o nom del contenidor.<br>**informació** - quantitat d'informació retornada. Valors admesos: *resum* (per defecte) o *llarga*.|User Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux -postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.container\_stats \[\<ID\>\]|<|<|<| |Estadístiques d'ús de recursos del contenidor.|Una sortida de la crida a l'API [ContainerStats](https://docs.docker.com/engine/api/v1.28/#operation/ContainerStats) i el percentatge serialitzat com a JSON|**ID** - ID o nom del contenidor| L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.containers|<|<|<| |Una llista de contenidors.|Una sortida de la crida a l'API [ContainerList](https://docs.docker.com/engine/api/v1.28/#operation/ContainerList) serialitzada en format JSON|\- | L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.containers.discovery\[\<opcions\>\]|<|<|<| |Una llista de contenidors. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/).|Objecte JSON |**opcions** - especifica si s'han de descobrir tots els contenidors o només els que s'executen. Valors admesos:<br>*cert* - retorna tots els contenidors;<br>*fals* - només retorna els contenidors en execució (per defecte).| L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre prou privilegis. En cas contrari, el control fallarà.| |docker.data\_usage|<|<|<| |Informació sobre l'ús actual de dades.|Una sortida de la crida a l'API [SystemDataUsage](https://docs.docker.com/engine/api/v1.28/#operation/SystemDataUsage) serialitzada en el format JSON|\- | L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.images|<|<|<| |Una llista d'imatges.|Una sortida de la crida a l'API [ImageList](https://docs.docker.com/engine/api/v1.28/#operation/ImageList) serialitzada en format JSON|\ -| L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.images.discovery|<|<|<| |Una llista d'imatges. S'utilitza per a [descobriment de baix nivell](/manual/discovery/low_level_discovery/).|Objecte JSON|\-| L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.info|<|<|<| |Informació del sistema.||Informació del sistema.|Una sortida de la crida a l'API [SystemInfo](https://docs.docker.com/engine/api/v1.28/#operation/SystemInfo) serialitzada en format JSON |\- | L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| |docker.ping|<|<|<| |Prova si un dimoni Docker és actiu o no.|1 - la connexió és activa<br><br>0 - la connexió no és activa|\-| L'usuari de l'Agent2 ('zabbix') s'ha d'afegir al [grup](https://docs.docker.com/engine/install/linux-postinstall/#manage-docker-as-a-non-root-user) 'docker' per tindre privilegis suficients. En cas contrari, el control fallarà.| ### 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.0 \ -e ZBX_PROXYMODE=0 \ -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \ -v zabbix-proxy-data:/var/lib/zabbix/db_data \ -d \ zabbix/zabbix-proxy-sqlite3:alpine-6.0-latest ``` :::noteimportant Zabbix must not be run as `PID1`/`init` process in containers. ::: This command: - Pulls the `zabbix/zabbix-proxy-sqlite3:alpine-6.0-latest` [Docker image](#available-docker-images). - Creates and starts a `zabbix-proxy-sqlite3` container based on the Docker image (with the [`-d`](https://docs.docker.com/reference/cli/docker/container/run/#detach) flag). - 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 (desplegament manual) Utilitzeu la implementació manual quan vulgueu implementar Zabbix pas a pas, executar components individuals, integrar-los amb un entorn existent o utilitzar un temps d'execució de contenidors alternatiu com Podman. Per exemple, per desplegar un proxy de Zabbix, executeu l'ordre següent: ```bash docker run --name zabbix-proxy-sqlite3 \ -e ZBX_SERVER_HOST=192.0.2.0 \ -e ZBX_PROXYMODE=0 \ -e ZBX_HOSTNAME=zabbix-proxy-sqlite3 \ -v zabbix-proxy-data:/var/lib/zabbix/db_data \ -d \ zabbix/zabbix-proxy-sqlite3:alpine-6.0-latest ``` :::noteimportant Zabbix no s'ha d'executar com a procés `PID1`/`init` a contenidors. ::: Aquesta ordre: - Tira de la `zabbix/zabbix-proxy-sqlite3:alpine-6.0-latst` [Imatge de l'acoblador](#available-docer-images). - Crea i inicia un contenidor `zabbix-proxy-sqlite3` basat en la imatge de l'acoblador (amb la marca [`-d`](https://docs.docker.com/reference/cli/docker/container/run/#detach). - Configura el paràmetre Zabbix proxy [`Server`](/manual/appendix/config/zabbix_proxy#server) mitjançant la variable d'entorn `ZBX_SERVER_HOST`. Aquest paràmetre especifica l'adreça IP del servidor Zabbix des del qual el servidor intermediari recuperarà les dades de configuració i a la qual enviarà dades recollides. Tingueu en compte que altres variables necessàries per a l'operació de proxy actiu utilitzen valors per defecte i es poden ometre. ::: noteclassic Les variables d'entorn corresponen a paràmetres de configuració de components de Zabbix utilitzant un estil de denominació diferent (per exemple, `ZBX_SERVER_HOST` correspon a [`Server`](/manual/appendix/config/zabbix_proxy#server)). Algunes variables són específiques de Docker, i alguns paràmetres de configuració no es poden canviar (per exemple, 'PIDFile` i `LogType`). Quan utilitzeu variables d'entorn, consulteu la secció *Variables de medi ambient* a la descripció de cada component [Imatge de l'acoblador](#available-docker-images) a Docker Hub. :: - Connecta una ubicació d'emmagatzematge gestionada per Docker (per exemple, `/var/lib/docker/volumes/zabbix-proxy-data/`) al directori `/var/lib/zabbix` del contenidor de manera que les dades del proxy de Zabbix s'emmagatzemen permanentment, fins i tot si el contenidor s'esborra. ::: noteclassic Per obtenir més informació sobre cada volum, veieu la secció *Permès volums* a la descripció de cada component [Imatge de docker](#available-docker-images) a Docker Hub. :: Després de desplegar el contenidor de proxy de Zabbix, podeu procedir a [afegir el servidor intermediari](/manual/distributed_monitoring/proxies#configuration) al vostre frontend de Zabbix i [configurar equips](/manual/config/hosts/host#configuration) per ser monitoritzat per aquest proxy. Els exemples següents cobreixen tres escenaris de desplegament addicionals: - Servidor Zabbix (MySQL) amb passarel·la Java - Servidor Zabbix (PostgreSQL) amb trampes SNMP - Servidor Zabbix (MySQL) amb passarel·la Java a RHEL 8 - 10 Per a més exemples, consulteu la descripció de cada component [Docker image](#available-docker-images) a Docker Hub. ### 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. ::: noteimportant Since Zabbix 6.0, deterministic triggers need to be created during the installation. If binary logging is enabled for MySQL/MariaDB, this requires superuser privileges or setting the variable/configuration parameter *log_bin_trust_function_creators = 1*. See [Database creation scripts](/manual/appendix/install/db_scripts#mysql) for instructions how to set the variable.<br> Note that if executing from a console, the variable will only be set temporarily and will be dropped when a Docker is restarted. In this case, keep your SQL service running, only stop zabbix-server service by running 'docker compose down zabbix-server' and then 'docker compose up -d zabbix-server'.<br> Alternatively, you can set this variable in the configuration file. ::: ### Docker Zabbix proporciona imatges [Docker](https://www.docker.com) per a cada component Zabbix com a contenidors portàtils i autosuficients per accelerar el desplegament i el procediment d'actualització. Els components Zabbix inclouen suport de bases de dades MySQL i PostgreSQL, compatibilitat amb el servidor web Apache2 i Nginx. Aquestes imatges són separades en diferents imatges. ::: noteimportant Des de Zabbix 6.0, s'han de crear triggers deterministes durant la instal·lació. Si el registre binari és habilitat per a MySQL/MariaDB, això requereix privilegis de superusuari o establir la variable/paràmetre de configuració *log_bin_trust_function_creators = 1*. Vegeu [Scripts de creació de bases de dades(/manual/appendix/install/db_scripts#mysql) per obtindre instruccions sobre com configurar la variable.\ Tingueu en compte que si s'executa des d'una consola, la variable només s'establirà temporalment i s'esborrarpa quan es reiniciï un Docker. En aquest cas, mantingueu el vostre servei SQL en funcionament, atureu el servei zabbix-server executant "docker compose down zabbix-server" i després "docker compose up -d zabbix-server".<br> Alternativament, podeu establir aquesta variable al fitxer de configuració. ::: # drule.create # drule.create # drule.delete # drule.delete # drule.get # drule.get # drule.update # drule.update # dservice.get # dservice.get #### Dummy module Zabbix includes a sample module written in C language. The module is located under src/modules/dummy: 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]` #### Mòdul fictici Zabbix inclou un mòdul d'exemple escrit en llenguatge C. El mòdul es troba a src/modules/dummy: 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 El mòdul està ben documentat, es pot emprar com a plantilla per als vostres mòduls. Després d'executar l'ordre ./configure a l'arrel de l'arbre de fonts de Zabbix tal com es descriu anteriorment, executeu **make** per construir **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; } ``` El mòdul exporta tres nous elements: - `dummy.ping` retorna sempre '1' - `dummy.echo[param1]` - retorna el primer paràmetre tal com és; per exemple, `dummy.echo[ABC]` retornarà ABC - `dummy.random[param1, param2]` - retorna un nombre aleatori en l'interval de param1-param2; per exemple, `dummy.random[1,1000000]` #### Dynamic widgets When [configuring](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) some of the widgets: - Classic graph - Graph prototype - Item value - Plain text - URL there is an extra option called *Dynamic item*. You can check this box to make the widget dynamic - i.e. capable of displaying different content based on the selected host. Now, when saving the dashboard, you will notice that a new host selection field has appeared atop the dashboard for selecting the host (while the *Select* button allows selecting the host group in a popup):  Thus you have a widget, which can display content that is based on the data from the host that is selected. The benefit of this is that you do not need to create extra widgets just because, for example, you want to see the same graphs containing data from various hosts. #### Ginys dinàmics Quan es [configuren](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) determinats ginys - Gràfic clàssic - Prototip gràfic - Valor de l'article - Text simple - URL hi ha una nova opció anomenada *Element dinàmic*. Podeu marcar aquesta casella per fer que el giny sigui dinàmic, és a dir, capaç de mostrar contingut diferent en funció de l'equip seleccionat. Ara, quan deseu el tauler, notareu que ha aparegut un camp de selecció d'equip nou a la part superior del tauler per triar l'equip (mentre que el botó *Tria* s'empra per triar els equips del grup en una finestra emergent):  Així que teniu un giny, que pot mostrar contingut basat en dades de l'equip seleccionat. L'avantatge d'això és que no cal que creeu ginys addicionals només perquè, per exemple, voleu veure els mateixos gràfics que contenen dades de diferents equips. #### 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 empra els paràmetres següents per connectar-se a la base de dades: - *Host* - nom d'equip o adreça IP del servidor de base de dades (paràmetres DBHost a l'arxiu de configuració). - *Port* - el port d'escolta del servidor de base de dades (paràmetre DBPort a l'arxiu de configuració; si no és pas definit, s'emprarà el port 1521 per defecte). - <service\_name> - el nom de servei de la base de dades on voleu accedir (paràmetre DBName dins l'arxiu de configuració). **Exemple:** Paràmetres de la base de dades definits a l'arxiu de configuració del servidor o del proxy (zabbix\_server.conf et zabbix\_proxy.conf): DBHost=localhost DBPort=1521 DBUser=myusername DBName=ORCL DBPassword=mypassword Cadena de connexió emprada per Zabbix per establir la connexió: DBUser/DBPassword@DBHost:DBPort/DBName Durant la instal·lació de la interfície Zabbix, definiu els paràmetres corresponents a la fase *Configurar la connexió a la base de dades* de l'assistent d'instal·lació: - Database host: localhost - Database port: 1521 - Database name: ORCL - User: myusername - Password: mypassword {width="600"} Alternativament, aquests paràmetres es poden definir a l'arxiu de configuració frontal (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = 'localhost'; $DB["PORT"] = '1521'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; ##### Editing linked entities If you try to edit an item or 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 one-touch manner on the template level. However, you still can, for example, enable/disable an item on the individual host and set the update interval, history length and some other parameters. ::: noteimportant Any customizations to the entities implemented on a template-level will override the previous customizations of the entities on a host-level. ::: 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. ##### Editant les entitats vinculades Si intenteu editar un element enllaçat o trigger des de la plantilla, és possible que trobeu que moltes opcions clau són desactivades per editar-les. Això té sentit perquè la idea de les plantilles és que les coses es canvien alhora a nivell de plantilla. Tanmateix, encara podeu, per exemple, activar/desactivar un element a l'equip individual i establir l'interval d'actualització, la durada de l'historial i altres paràmetres. ::: noteimportant Qualsevol personalització d'entitats implementada al nivell de plantilla anul·larà les personalitzacions d'entitats anteriors al nivell d'equip. ::: Si voleu modificar l'entitat completament, l'heu de modificar a nivell de plantilla (la drecera a nivell de plantilla es mostra al nom del formulari), tinguent en compte que aquestes modificacions afectaran tots els equips amb els quals és relacionada aquesta plantilla. ### 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. ### Edició dels serveis Feu clic al botó *Editar* per entrar al mode d'edició. En el mode d'edició, la llista es completa amb caselles de selecció abans de les entrades i també amb aquestes opcions addicionals: -  - afegir un servei fill a aquest servei -  - editar aquest servei -  - esborrar aquest servei {width="600"} Per [configurar](#service_configuration) un servei nou, feu clic al botó *Crear un servei* a la part superior dreta. ### 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. ### Edició dels serveis Feu clic al botó *Editar* per entrar al mode d'edició. En el mode d'edició, la llista es completa amb caselles de selecció abans de les entrades i també amb aquestes opcions addicionals: -  - afegir un servei fill a aquest servei -  - editar aquest servei -  - esborrar aquest servei {width="600"} Per [configurar](#service_configuration) un servei nou, feu clic al botó *Crear un servei* a la part superior dreta. Dos botons a sota de la llista ofereixen opcions d'edició massiva: - *Actualització massiva* - actualització massiva de les propietats del servei - *ESborrar* - esborra serveis Per emprar aquestes opcions, marqueu les caselles davant dels serveis respectius i feu clic al botó requerit. ##### Element configuration #### Configuració d'element #### Element tags Element tag values are explained in the table below. #### Etiquetes d'elements Els valors de les etiquetes d'elements es detallen a la taula d'aquí sota. #### Element tags Element tag values are explained in the table below. #### Etiquetes d'elements Els valors de les etiquetes d'elements es detallen a la taula d'aquí sota. #### Element tags Element tag values are explained in the table below. |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |media\_types| |\-| | |Root element for media\_types.| | |name|x|`string`| |Media type name.| | |type|x|`string`|0 - EMAIL<br>1 - SMS<br>2 - SCRIPT<br>4 - WEBHOOK|Transport used by the media type.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Whether the media type is enabled.| | |max\_sessions|\-|`integer`|Possible values for SMS: 1 - (default)<br><br>Possible values for other media types: 0-100, 0 - unlimited|The maximum number of alerts that can be processed in parallel.| | |attempts|\-|`integer`|1-10 (default: 3)|The maximum number of attempts to send an alert.| | |attempt\_interval|\-|`string`|0-60s (default: 10s)|The interval between retry attempts.<br><br>Accepts seconds and time unit with suffix.| | |description|\-|`string`| |Media type description.| |message\_templates| |\-| | |Root element for media type message templates.| | |event\_source|x|`string`|0 - TRIGGERS<br>1 - DISCOVERY<br>2 - AUTOREGISTRATION<br>3 - INTERNAL<br>4 - SERVICE|Event source.| | |operation\_mode|x|`string`|0 - PROBLEM<br>1 - RECOVERY<br>2 - UPDATE|Operation mode.| | |subject|\-|`string`| |Message subject.| | |message|\-|`string`| |Message body.| |*Used only by email media type*|<|<|<|<|<| | |smtp\_server|x|`string`| |SMTP server.| | |smtp\_port|\-|`integer`|Default: 25|SMTP server port to connect to.| | |smtp\_helo|x|`string`| |SMTP helo.| | |smtp\_email|x|`string`| |Email address from which notifications will be sent.| | |smtp\_security|\-|`string`|0 - NONE (default)<br>1 - STARTTLS<br>2 - SSL\_OR\_TLS|SMTP connection security level to use.| | |smtp\_verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|SSL verify host for SMTP. Optional if smtp\_security is STARTTLS or SSL\_OR\_TLS.| | |smtp\_verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|SSL verify peer for SMTP. Optional if smtp\_security is STARTTLS or SSL\_OR\_TLS.| | |smtp\_authentication|\-|`string`|0 - NONE (default)<br>1 - PASSWORD|SMTP authentication method to use.| | |username|\-|`string`| |Username.| | |password|\-|`string`| |Authentication password.| | |content\_type|\-|`string`|0 - TEXT<br>1 - HTML (default)|Message format.| |*Used only by SMS media type*|<|<|<|<|<| | |gsm\_modem|x|`string`| |Serial device name of the GSM modem.| |*Used only by script media type*|<|<|<|<|<| | |script name|x|`string`| |Script name.| |parameters| |\-| | |Root element for script parameters.| |*Used only by webhook media type*|<|<|<|<|<| | |script|x|`string`| |Script.| | |timeout|\-|`string`|1-60s (default: 30s)|Javascript script HTTP request timeout interval.| | |process\_tags|\-|`string`|0 - NO (default)<br>1 - YES|Whether to process returned tags.| | |show\_event\_menu|\-|`string`|0 - NO (default)<br>1 - YES|If {EVENT.TAGS.\*} were successfully resolved in event\_menu\_url and event\_menu\_name fields, this field indicates presence of entry in the event menu.| | |event\_menu\_url|\-|`string`| |URL of the event menu entry. Supports {EVENT.TAGS.\*} macro.| | |event\_menu\_name|\-|`string`| |Name of the event menu entry. Supports {EVENT.TAGS.\*} macro.| |parameters| |\-| | |Root element for webhook media type parameters.| | |name|x|`string`| |Webhook parameter name.| | |value|\-|`string`| |Webhook parameter value.| #### Etiquetes d'elements Els valors de l'etiqueta d'element s'expliquen a la taula següent. |Element|Propietat de l'element|Obligatori|Tipus|Interval^**[1](#notes al peu)**^|Descripció| |-------|----------------|--------|----|--------------------------|-----------| |media\_types|<|\-| | |Element arrel per media\_types.| | |name|x|`cadena`| |Nom del tipus de suport.| | |type|x|`cadena`|0 - EMAIL<br>1 - SMS<br>2 - SCRIPT<br>4 - WEBHOOK|Transport emprat pel tipus de suport.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Indica si el tipus de suport és actiu.| | |max\_sessions|\-|`enter`|Valors possibles per SMS : 1 - (per defecte)<br><br>Valors possibles ​​per a altres tipus de suports: 0-100, 0 - il·limitat|El nombre màxim d'alertes que es poden processar en paral·lel.| | |attempts|\-|`enter`|1-10 (per defecte: 3)|El nombre màxim d'intents per enviar una alerta.| | |attempt\_interval|\-|`cadena`|0-60s (per defecte: 10s)|Interval entre cada reintent.<br><br>Accepta segons unitats de temps com a sufix.| | |description|\-|`cadena`| |Descripció del tipus de suport.| |message\_templates|<|\-| | |Element arrel per a plantilles de missatges de tipus multimèdia.| | |event\_source|x|`cadena`|0 - TRIGGERS<br>1 - DESCOBERTA<br>2 - AUTOREGISTRE<br>3 - INTERN|Origen de l'esdeveniment.| | |operation\_mode|x|`cadena`|0 - PROBLEMA<br>1 - RECUPERACIÓ<br>2 - ACTUALITZACIÓ|Mode de funcionament.| | |subject|\-|`cadena`| |Assumpte del missatge.| | |message|\-|`cadena`| |Cos del missatge.| |Ús només pel tipus de suport correu electrònic.|<|<|<|<|<| | |smtp\_server|x|`cadena`| |Servidor SMTP.| | |smtp\_port|\-|`enter`|Per defecte: 25|Port del servidor SMTP on connectar-se.| | |smtp\_helo|x|`cadena`| |SMTP helo.| | |smtp\_email|x|`cadena`| |Adreça de correu-e des d'on s'enviaran les notificacions.| | |smtp\_security|\-|`cadena`|0 - CAP (per defecte)<br>1 - STARTTLS<br>2 - SSL\_OR\_TLS|Nivell de seguretat de la connexió SMTP a emprar.| | |smtp\_verify\_host|\-|`cadena`|0 - NO (per defecte)<br>1 - SÍ|Verificació SSL de l'equip per l'SMTP. Opcional si smtp\_security s'estableix a STARTTLS o SSL\_OR\_TLS.| | |smtp\_verify\_peer|\-|`cadena`|0 - NO (per defecte)<br>1 - SÍ|Verificació de iguals SSL per a SMTP. Opcional si smtp\_security és establert a STARTTLS o SSL\_OR\_TLS.| | |smtp\_authentication|\-|`cadena`|0 - CAP (per defecte)<br>1 - MOT DE PAS|Mètode d'autenticació SMTP a emprar.| | |username|\-|`cadena`|<|Nom d'usuari.| | |password|\-|`cadena`|<|Mot de pas d'autenticació.| | |content\_type|\-|`cadena`|0 - TEXT<br>1 - HTML (per defecte)|Format dels missatges.| |Emprat només pel tipus de suport SMS.|<|<|<|<|<| | |gsm\_modem|x|`cadena`|<|Nom del dispositiu sèrie del mòdem GSM.| |Emprat només pel tipus de suport script.|<|<|<|<|<| | |script name|x|`cadena`|<|Nom du script.| |parameters|<|\-|<|<|Element arrel per als paràmetres de l'script.| |Emprat només pel tipus de suport Webhook.|<|<|<|<|<| | |script|x|`cadena`| |Script.| | |timeout|\-|`cadena`|1-60s (par défaut : 30s)|Interval de temps d'espera de la petició HTTP de JavaScript.| | |process\_tags|\-|`cadena`|0 - NO (per defecte)<br>1 - SÍ|S'han de processar les etiquetes retornades?| | |show\_event\_menu|\-|`cadena`|0 - NO per defecte)<br>1 - SÍ|Si {EVENT.TAGS.\*} s'han resolt correctament als camps event\_menu\_url i event\_menu\_name, aquest camp indica la presència d'una entrada al menú d'esdeveniments.| | |event\_menu\_url|\-|`cadena`|<|URL de l'entrada del menú d'esdeveniments. Admet la macro {EVENT.TAGS.\*}.| | |event\_menu\_name|\-|`cadena`|<|Nom de l'entrada del menú d'esdeveniments. Admet la macro {EVENT.TAGS.\*}.| |parameters|<|\-|<|<|Element arrel per als paràmetres de tipus de suport webhook.| | |name|x|`cadena`|<|Nom del paràmetre Webhook.| | |value|\-|`cadena`|<|Valor del paràmetre Webhook.| #### Element tags Element tag values are explained in the table below. |Element|Element property|Type|Range|Description| |--|--|--|----|--------| |images| | | |Root element for images.| | |name|`string`| |Unique image name.| | |imagetype|`integer`|1 - image<br>2 - background|Image type.| | |encodedImage| | |Base64 encoded image.| |maps| | | |Root element for maps.| | |name|`string`| |Unique map name.| | |width|`integer`| |Map width, in pixels.| | |height|`integer`| |Map height, in pixels.| | |label\_type|`integer`|0 - label<br>1 - host IP address<br>2 - element name<br>3 - status only<br>4 - nothing|Map element label type.| | |label\_location|`integer`|0 - bottom<br>1 - left<br>2 - right<br>3 - top|Map element label location by default.| | |highlight|`integer`|0 - no<br>1 - yes|Enable icon highlighting for active triggers and host statuses.| | |expandproblem|`integer`|0 - no<br>1 - yes|Display problem trigger for elements with a single problem.| | |markelements|`integer`|0 - no<br>1 - yes|Highlight map elements that have recently changed their status.| | |show\_unack|`integer`|0 - count of all problems<br>1 - count of unacknowledged problems<br>2 - count of acknowledged and unacknowledged problems separately|Problem display.| | |severity\_min|`integer`|0 - not classified<br>1 - information<br>2 - warning<br>3 - average<br>4 - high<br>5 - disaster|Minimum trigger severity to show on the map by default.| | |show\_suppressed|`integer`|0 - no<br>1 - yes|Display problems which would otherwise be suppressed (not shown) because of host maintenance.| | |grid\_size|`integer`|20, 40, 50, 75 or 100|Cell size of a map grid in pixels, if "grid\_show=1"| | |grid\_show|`integer`|0 - yes<br>1 - no|Display a grid in map configuration.| | |grid\_align|`integer`|0 - yes<br>1 - no|Automatically align icons in map configuration.| | |label\_format|`integer`|0 - no<br>1 - yes|Use advanced label configuration.| | |label\_type\_host|`integer`|0 - label<br>1 - host IP address<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as host label, if "label\_format=1"| | |label\_type\_hostgroup|`integer`|0 - label<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as host group label, if "label\_format=1"| | |label\_type\_trigger|`integer`|0 - label<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as trigger label, if "label\_format=1"| | |label\_type\_map|`integer`|0 - label<br>2 - element name<br>3 - status only<br>4 - nothing<br>5 - custom label|Display as map label, if "label\_format=1"| | |label\_type\_image|`integer`|0 - label<br>2 - element name<br>4 - nothing<br>5 - custom label|Display as image label, if "label\_format=1"| | |label\_string\_host|`string`| |Custom label for host elements, if "label\_type\_host=5"| | |label\_string\_hostgroup|`string`| |Custom label for host group elements, if "label\_type\_hostgroup=5"| | |label\_string\_trigger|`string`| |Custom label for trigger elements, if "label\_type\_trigger=5"| | |label\_string\_map|`string`| |Custom label for map elements, if "label\_type\_map=5"| | |label\_string\_image|`string`| |Custom label for image elements, if "label\_type\_image=5"| | |expand\_macros|`integer`|0 - no<br>1 - yes|Expand macros in labels in map configuration.| | |background|`id`| |ID of the background image (if any), if "imagetype=2"| | |iconmap|`id`| |ID of the icon mapping (if any).| |urls| | | |Used by maps or each map element.| | |name|`string`| |Link name.| | |url|`string`| |Link URL.| | |elementtype|`integer`|0 - host<br>1 - map<br>2 - trigger<br>3 - host group<br>4 - image|Map item type the link belongs to.| |selements| | | | | | |elementtype|`integer`|0 - host<br>1 - map<br>2 - trigger<br>3 - host group<br>4 - image|Map element type.| | |label|`string`| |Icon label.| | |label\_location|`integer`|-1 - use map default<br>0 - bottom<br>1 - left<br>2 - right<br>3 - top| | | |x|`integer`| |Location on the X axis.| | |y|`integer`| |Location on the Y axis.| | |elementsubtype|`integer`|0 - single host group<br>1 - all host groups|Element subtype, if "elementtype=3"| | |areatype|`integer`|0 - same as whole map<br>1 - custom size|Area size, if "elementsubtype=1"| | |width|`integer`| |Width of area, if "areatype=1"| | |height|`integer`| |Height of area, if "areatype=1"| | |viewtype|`integer`|0 - place evenly in the area|Area placement algorithm, if "elementsubtype=1"| | |use\_iconmap|`integer`|0 - no<br>1 - yes|Use icon mapping for this element. Relevant only if iconmapping is activated on map level.| | |selementid|`id`| |Unique element record ID.| | |evaltype|`integer`| |Evaluation type for tags.| |tags| | | |Problem tags (for host and host group elements). If tags are given, only problems with these tags will be displayed on the map.| | |tag|`string`| |Tag name.| | |value|`string`| |Tag value.| | |operator|`integer`| |Operator.| |elements| | | |Zabbix entities that are represented on the map (host, host group, map etc).| | |host| | | | |icon\_off| | | |Image to use when element is in 'OK' status.| |icon\_on| | | |Image to use when element is in 'Problem' status.| |icon\_disabled| | | |Image to use when element is disabled.| |icon\_maintenance| | | |Image to use when element is in maintenance.| | |name|`string`| |Unique image name.| |shapes| | | | | | |type|`integer`|0 - rectangle<br>1 - ellipse|Shape type.| | |x|`integer`| |X coordinates of the shape in pixels.| | |y|`integer`| |Y coordinates of the shape in pixels.| | |width|`integer`| |Shape width.| | |height|`integer`| |Shape height.| | |border\_type|`integer`|0 - none<br>1 - bold line<br>2 - dotted line<br>3 - dashed line|Type of the border for the shape.| | |border\_width|`integer`| |Width of the border in pixels.| | |border\_color|`string`| |Border color represented in hexadecimal code.| | |text|`string`| |Text inside of shape.| | |font|`integer`|0 - Georgia, serif<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif<br>2 - "Times New Roman", Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - "Arial Black", Gadget, sans-serif<br>5 - "Comic Sans MS", cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - "Trebuchet MS", Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - "Courier New", Courier, monospace<br>12 - "Lucida Console", Monaco, monospace|Text font style.| | |font\_size|`integer`| |Font size in pixels.| | |font\_color|`string`| |Font color represented in hexadecimal code.| | |text\_halign|`integer`|0 - center<br>1 - left<br>2 - right|Horizontal alignment of text.| | |text\_valign|`integer`|0 - middle<br>1 - top<br>2 - bottom|Vertical alignment of text.| | |background\_color|`string`| |Background (fill) color represented in hexadecimal code.| | |zindex|`integer`| |Value used to order all shapes and lines (z-index).| |lines| | | | | | |x1|`integer`| |X coordinates of the line point 1 in pixels.| | |y1|`integer`| |Y coordinates of the line point 1 in pixels.| | |x2|`integer`| |X coordinates of the line point 2 in pixels.| | |y2|`integer`| |Y coordinates of the line point 2 in pixels.| | |line\_type|`integer`|0 - none<br>1 - bold line<br>2 - dotted line<br>3 - dashed line|Line type.| | |line\_width|`integer`| |Line width in pixels.| | |line\_color|`string`| |Line color represented in hexadecimal code.| | |zindex|`integer`| |Value used to order all shapes and lines (z-index).| |links| | | |Links between map elements.| | |drawtype|`integer`|0 - line<br>2 - bold line<br>3 - dotted line<br>4 - dashed line|Link style.| | |color|`string`| |Link color (6 symbols, hex).| | |label|`string`| |Link label.| | |selementid1|`id`| |ID of one element to connect.| | |selementid2|`id`| |ID of the other element to connect.| |linktriggers| | | |Link status indicators.| | |drawtype|`integer`|0 - line<br>2 - bold line<br>3 - dotted line<br>4 - dashed line|Link style when trigger is in the 'Problem' state.| | |color|`string`| |Link color (6 symbols, hex) when trigger is in the 'Problem' state.| |trigger| | | |Trigger used for indicating link status.| | |description|`string`| |Trigger name.| | |expression|`string`| |Trigger expression.| | |recovery\_expression|`string`| |Trigger recovery expression.| #### Etiquetes d'elements Els valors de l'etiqueta d'element s'expliquen a la taula següent. |Element|Propietat de l'element|Tipus|Rang|Descripció| |--|--|--|----|--------| |images| | | |Element arrel per a imatges.| | |name|`cadena`| |Nom únic de la imatge.| | |imagetype|`enter`|1 - imatge<br>2 - fons|Tipus d'imatge.| | |encodedImage| | |Imatge codificada en Base64.| |maps| | | |Element arrel per als mapes.| | |name|`cadena`| |Nom únic del mapa.| | |width|`enter`| |Amplada del mapa, en píxels.| | |height|`enter`| |Alçada del mapa, en píxels.| | |label\_type|`enter`|0 - etiqueta<br>1 - adreça IP de l'equip<br>2 - nom de l'element<br>3 - només estat<br>4 - res| etiqueta de l'element del mapa. | |label\_location|`enter`|0 - inferior<br>1 - esquerra<br>2 - dreta<br>3 - superior|Ubicació predeterminada de l'etiqueta de l'element del mapa.| | |highlight|`enter`|0 - no<br>1 - sí|Activa el ressaltat d'icones per als triggers actius i els estats de l'equip.| | |expandproblem|`enter`|0 - no<br>1 - sí|Mostrael trigger del problema per als elements amb només un problema.| | |markelements|`enter`|0 - no<br>1 - sí|Resalta els elements del mapa l'estat dels quals ha canviat recentment.| | |show\_unack|`enter`|0 - recompte de tots els problemes<br>1 - recompte de problemes no reconeguts<br>2 - recompte de problemes reconeguts i no reconeguts per separat|Mostra els problemes.| | |severity\_min|`enter`|0 - sense classificar<br>1 - informació<br>2 - advertència<br>3 - mitjana<br>4 - alta<br>5 - desastre|Gravetat mínima deel trigger per mostrar al mapa predeterminat.| | |show\_suppressed|`enter`|0 - no<br>1 - sí|Mostra problemes que d'altra manera s'esborrarien (no es mostren) a causa del manteniment de l'equip.| | |grid\_size|`enter`|20, 40, 50, 75 o 100|Mida de la cel·la d'una quadrícula de mapa en píxels, si "grid\_show=1"| | |grid\_show|`enter`|0 - sí<br>1 - no|Mostra una graella en la configuració del mapa.| | |grid\_align|`enter`|0 - sí<br>1 - no|Alinea les icones automàticament a la configuració del mapa.| | |label\_format|`enter`|0 - no<br>1 - sí|Empra la configuració avançada d'etiquetes.| | |label\_type\_host|`enter`|0 - etiqueta<br>1 - adreça IP de l'equip<br>2 - nom de l'element<br>3 - només estat<br>4 - res<br>5 - etiqueta personalitzada| Mostra com a etiqueta d'equip, si "label\_format=1"| | |label\_type\_hostgroup|`enter`|0 - etiqueta<br>2 - nom de l'element<br>3 - només estat<br>4 - res<br>5 - etiqueta personalitzada|Mostra com a equips d'etiquetes de grup, si " label\_format=1"| | |label\_type\_trigger|`enter`|0 - etiqueta<br>2 - nom de l'element<br>3 - només estat<br>4 - res<br>5 - etiqueta personalitzada|Mostra com a etiqueta de trigger, si "label\_format=1"| | |label\_type\_map|`enter`|0 - etiqueta<br>2 - nom de l'element<br>3 - només estat<br>4 - res<br>5 - etiqueta personalitzada|Mostra com a etiqueta de mapa , si "label\_format=1"| | |label\_type\_image|`enter`|0 - etiqueta<br>2 - nom de l'element<br>4 - res<br>5 - etiqueta personalitzada|Mostra com a etiqueta d'imatge, si "label\_format =1"| | |label\_string\_host|`cadena`| |Etiqueta personalitzada per als elements d'equip, si "label\_type\_host=5"| | |label\_string\_hostgroup|`cadena`| |Etiqueta personalitzada per als elements del grup equip, si "label\_type\_hostgroup=5"| | |label\_string\_trigger|`cadena`| |Etiqueta personalitzada per als triggers, si "label\_type\_trigger=5"| | |label\_string\_map|`cadena`| |Etiqueta personalitzada per als elements del mapa, si "label\_type\_map=5"| | |label\_string\_image|`cadena`| |Etiqueta personalitzada per a recursos d'imatge, si "label\_type\_image=5"| | |expand\_macros|`enter`|0 - no<br>1 - sí|Amplieu les macros a etiquetes a la configuració del mapa.| | |background|`id`| |Identificador de la imatge de fons (si n'hi ha), si "typetype=2"| | |iconmap|`id`| |Identificador de mapatge d'icones (si n'hi ha).| |urls| | | |Emprat pels mapes o per cada element del mapa.| | |name|`cadena`| |Nom de l'enllaç.| | |url|`cadena`| |URL de l'enllaç.| | |elementtype|`enter`|0 - host<br>1 - mapa<br>2 - trigger<br>3 - hostgroup<br>4 - imatge|Tipus d'element del mapa al qual pertany l'enllaç.| |selements| | | | | | |elementtype|`enter`|0 - host<br>1 - mapa<br>2 - trigger<br>3 - grup equip<br>4 - imatge|Tipus d'element del mapa.| | |label|`cadena`| |Títol de la icona.| | |label\_location|`enter`|-1 - empra el mapa predeterminat<br>0 - inferior<br>1 - esquerra<br>2 - dreta<br>3 - superior| | | |x|`enter`| |Ubicació a l'eix X.| | |y|`enter`| |Ubicació a l'eix Y.| | |elementsubtype|`enter`|0 - grup d'equip únic<br>1 - tots els grups d'equip|Subtipus d'element, si "elementtype=3"| | |areatype|`enter`|0 - igual que el mapa sencer<br>1 - mida personalitzada|Mida de l'àrea, si "elementsubtype=1"| | |width|`enter`| |Amplada de l'àrea, si "areatype=1"| | |height|`enter`| |Alçada de l'àrea, si "areatype=1"| | |viewtype|`enter`|0 - col·loca uniformement a l'àrea|Algorisme de col·locació d'àrea, si "elementsubtype=1"| | |use\_iconmap|`enter`|0 - no<br>1 - yes|Empra l'assignació d'icones per a aquest element. Rellevant només si el mapatge d'icones és habilitat a nivell del mapa.| | |selementid|`id`| |ID de registre d'element únic.| | |evaltype|`enter`| |Tipus de valoració de les etiquetes.| |tags| | | |Etiquetes de problema (per a elements d'equip i de grup d'equip). Si es donen etiquetes, només es mostraran els problemes amb aquestes etiquetes al mapa.| | |tag| | |Nom de l'etiqueta.| | |value| | |Valor de l'etiqueta.| | |operator| | |Operador.| |elements| | | |Entitats Zabbix representades al mapa (equip, grup d'equip, mapa, etc.).| | |equip| | | | |icon\_off| | | |Imatge que s'emprarà quan l'element estigui en estat "D'acord".| |icon\_on| | | |Imatge per emprar quan l'element és en estat "Problema".| |icon\_disable| | | |Imatge per emprar quan l'element és desactivat.| |icon\_maintenance| | | |Imatge per emprar quan l'article és en manteniment.| | |name|`cadena`| |Nom únic de la imatge.| |shapes| | | | | | |type|`enter`|0 - rectangle<br>1 - el·lipse|Tipus de forma.| | |x|`enter`| |Coordenades X de la forma en píxels.| | |y|`enter`| |Coordenades Y de la forma en píxels.| | |width|`enter`| |Amplada de la forma.| | |height|`enter`| |Alçada de la forma.| | |border\_type|`enter`|0 - cap<br>1 - línia en negreta<br>2 - línia puntejada<br>3 - línia discontínua|Tipus de vora per a la forma.| | |border\_width|`enter`| |Amplada de la vora en píxels.| | |border\_color|`cadena`| |Color de la vora representat en codi hexadecimal.| | |text|`cadena`| |Text dins de la forma.| | |font|`enter`|0 - Georgia, serif<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif<br>2 - "Times New Roman", Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - "Arial Black", Gadget, sans-serif<br>5 - "Comic Sans MS", cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - "Trebuchet MS", Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - "Courier New", Courier, monospace<br>12 - "Lucida Console", Monaco, monospace|Estil de lletra del text.| | |font\_size|`enter`| |Mida del tipus de lletra en píxels.| | |font\_color|`cadena`| |Color de lletra representat en codi hexadecimal.| | |text\_halign|`enter`|0 - centre<br>1 - esquerra<br>2 - dreta|Alineació horitzontal del text.| | |text\_valign|`enter`|0 - mig<br>1 - superior<br>2 - inferior|Alineació vertical del text.| | |background\_color|`cadena`| |Color de fons (emplenament) representat en codi hexadecimal.| | |zindex|`enter`| |Valor emprat per classificar totes les formes i línies (índex z).| |lines| | | | | | |x1|`enter`| |Coordenades X del punt de línia 1 en píxels.| | |y1|`enter`| |Coordenades Y del punt de línia 1 en píxels.| | |x2|`enter`| |Coordenades X del punt de línia 2 en píxels.| | |y2|`enter`| |Coordenades Y del punt de línia 2 en píxels.| | |line\_type|`enter`|0 - cap<br>1 - línia en negreta<br>2 - línia puntejada<br>3 - línia discontínua|Tipus de línia.| | |line\_width|`enter`| |Ample de línia en píxels.| | |line\_color|`cadena`| |Color de línia representat en codi hexadecimal.| | |zindex|`enter`| |Valor emprat per classificar totes les formes i línies (índex z).| |linktriggers| | | |Enllaços entre elements cartogràfics.| | |drawtype|`enter`|0 - línia<br>2 - línia en negreta<br>3 - línia discontínua<br>4 - línia discontínua|Estil d'enllaç.| | |color|`cadena`| |Color de l'enllaç (6 símbols, hexadecimal).| | |tag|`cadena`| |Títol de l'enllaç.| | |selementid1|`id`| |ID d'un element a connectar.| | |selementid2|`id`| |ID de l'altre element a connectar.| |linktriggers| | | |Indicador d'estat de l'enllaç.| | |drawtype|`enter`|0 - línia<br>2 - línia en negreta<br>3 - línia puntejada<br>4 - línia discontínua|Estil d'enllaç quan el trigger és en estat "Problema". | |color|`cadena`| |Color de l'enllaç (6 símbols, hexadecimal) quan el trigger està en estat "Problema".| |trigger| | | |Trigger emprat per indicar l'estat de l'enllaç.| | |description|`cadena`| |Nom del trigger.| | |expression|`cadena`| |Expressió trigger.| | |recovery\_expression|`cadena`| |Activar l'expressió de recuperació.| #### Email settings Initially there are several predefined notification [delivery methods](/manual/config/notifications/media) in Zabbix. [Email](/manual/config/notifications/media/email) is one of those. To configure email settings, go to *Administration → Media types* and click on *Email* in the list of pre-defined media types.  This will present us with the email settings configuration form.  All mandatory input fields are marked with a red asterisk. In the *Media type* tab, set the values of SMTP server, SMTP helo and SMTP email to the appropriate for your environment. ::: noteclassic 'SMTP email' will be used as the 'From' address for the notifications sent from Zabbix. ::: Next, it is required to define the content of the problem message. The content is defined by means of a message template, configured in the *Message templates* tab. Click on *Add* to create a message template, and select *Problem* as the message type.  Click on *Add* when ready and save the form. Now you have configured 'Email' as a working media type. The media type must also be linked to users by defining specific delivery addresses (like we did when [configuring a new user](login#adding_user)), otherwise it will not be used. #### Paràmetres de correu-e Inicialment, hi ha diversos [mètodes de lliurament](/manual/config/notifications/media) de notificacions predefinides a Zabbix. El [correu-e](/manual/config/notifications/media/email) és un d'ells. Per configurar el correu electrònic, aneu a *Administració →Tipus de suport* i feu clic a *Correu electrònic* a la llista de tipus de suports predefinits.  Això ens presentarà el formulari per definir la configuració del correu electrònic.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. A la pestanya *Tipus de suport*, configureu els valors per al servidor SMTP, l'helo SMTP i el correu electrònic SMTP segons el vostre entorn. :::noteclassic El correu electrònic "SMTP" s'emprarà com a adreça "De" per a les notificacions enviades per Zabbix. ::: A continuació, cal definir el contingut del missatge del problema. El contingut es defineix mitjançant una plantilla de missatges, configurada a la pestanya *Plantilles de missatges*. Feu clic a *Afegir* per crear una plantilla de missatge i seleccioneu *Problema* com a tipus de missatge.  Feu clic a *Afegir* quan estigui llest i deseu el formulari. Ja teniu configurat "Correu electrònic" com a tipus de suport de treball. El tipus de suport també s'ha d'enllaçar als usuaris establint adreces de lliurament específiques (com vam fer quan [configurava un usuari nou](login#adding_user)), en cas contrari, no s'emprarà pas. #### 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?at=refs%2Fheads%2Frelease%2F6.0) - [Agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember) - [Ember+ plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Agent 2 installation](/manual/concepts/agent2#installation) #### Ember+ S'ha afegit un nou connector per al monitoratge directe de Ember+ per part de l'agent Zabbix 2. Per a més informació, consulteu: - [Llegeix-me del plugin Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0) - [Elements de l'agent 2](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#ember) - [Paràmetres del plugin Ember+](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin) - [Instal·lació de l'agent 2](/manual/concepts/agent2#installation) ### Ember+ |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |ember.get\[<uri>,<path>\]|<|<|<| |Returns the result of the required device.|JSON object|**uri** - Ember+ device URI. Default: 127.0.0.1:9998<br>**path** - OID path to device. Empty by default, returns root collection data.| | ### Ember+ |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor retornat**|**Paràmetres**|**Comentaris**| |ember.get\[<uri>,<path>\]|<|<|<| |Retorna el resultat del dispositiu necessitat.|Objecte JSON|**uri** - URI del dispositiu Ember+. Per defecte: 127.0.0.1:9998<br>**path** - ruta OID al dispositiu. Buit per defecte, retorna les dades de la col·lecció arrel.| | #### Enabling a host Enable host monitoring, i.e. set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10126" ] }, "id": 1 } ``` #### Activar un equip Activar el monitoratge d'un equip; és a dir, definir el seu estat a 0. Petició: ```json { "jsonrpc": "2.0", "method": "host.update", "params": { "hostid": "10126", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` #### Activar un tipus de suport Activa un tipus de suport; és a dir, establir el seu estat a "0". Petició: ```json { "jsonrpc": "2.0", "method": "mediatype.update", "params": { "mediatypeid": "6", "status": "0" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "mediatypeids": [ "6" ] }, "id": 1 } ``` #### Enabling an item Enable an item, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### Activar un element Activar un element; és a dir, establir el seu estat a "0". Petició: ```json { "jsonrpc": "2.0", "method": "item.update", "params": { "itemid": "10092", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "itemids": [ "10092" ] }, "id": 1 } ``` #### Enabling a trigger Enable a trigger, that is, set its status to 0. Request: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Activar un trigger Activar un trigger; és a dir, establir el seu estat a 0. Petició: ```json { "jsonrpc": "2.0", "method": "trigger.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Activar protips de triggers Activar un prototip de trigger; és a dir, definir el seu estat a 0. Petició: ```json { "jsonrpc": "2.0", "method": "triggerprototype.update", "params": { "triggerid": "13938", "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "triggerids": [ "13938" ] }, "id": 1 } ``` #### Enabling a web scenario Enable a web scenario, that is, set its status to "0". Request: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "httptestids": [ "5" ] }, "id": 1 } ``` #### Activar un escenari Web Activar un escenari Web; és a dir, establir el seu estat a "0". Petició: ```json { "jsonrpc": "2.0", "method": "httptest.update", "params": { "httptestid": "5", "status": 0 }, "auth": "700ca65537074ec963db7efabda78259", "id": 1 } ``` Resposta: ```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. ::: 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 ``` #### Habilitació de la política de seguretat de contingut (CSP) al servidor web Per protegir la interfície de Zabbix contra Cross Site Scripting (XSS), la injecció de dades i atacs similars, us recomanem que activeu la Política de seguretat de contingut al servidor web. Per fer-ho, configureu el servidor web perquè retorni la [capçalera HTTP](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy). ::: noteimportant La següent configuració de la capçalera del CSP només és per a la instal·lació d'interfície predeterminada de Zabbix i per als casos en què tot el contingut prové del domini del lloc (excepte els subdominis). És possible que calgui una configuració de capçalera CSP diferent si, per exemple, esteu configurant el giny [*URL*](/manual/web_interface/frontend_sections/dashboards/widgets/url) per mostrar contingut dels subdominis o dominis externs del lloc, canviant de *OpenStreetMap* a un altre motor de mapes o afegint CSS o widgets externs. ::: Per habilitar CSP per a la vostra interfície Zabbix a la configuració d'Apache, seguiu aquestes passes: 1\. Localitzeu el fitxer de configuració del vostre host virtual: - `/etc/httpd/conf/httpd.conf` a sistemes basats en RHEL - `/etc/apache2/sites-available/000-default.conf` a Debian/Ubuntu 2\. Afegiu la directiva següent al fitxer de configuració del vostre host virtual: ```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\. Reinicieu el servei Apache per aplicar els canvis: ```bash # A sistemes basats en RHEL: systemctl restart httpd.service # A Debian/Ubuntu systemctl restart apache2.service ``` ### Enabling high availability ### Activació de l'alta disponibilitat #### Enabling HTTP Strict Transport Security (HSTS) on the web server To protect Zabbix frontend against protocol downgrade attacks, we recommend enabling [HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security) policy on the web server. To enable 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 ``` #### Activar HTTP Strict Transport Security (HSTS) al servidor web Per protegir la interfície de Zabbix dels atacs de baixada de nivell de protocol, us recomanem que habiliteu la política [HSTS](https://en.wikipedia.org/wiki/HTTP_Strict_Transport_Security) al servidor web. Per exemple, per habilitar la política HSTS per a la vostra interfície Zabbix a la configuració d'Apache: 1\. Busqueu l'arxiu de configuració de l'equip virtual: - `/etc/httpd/conf/httpd.conf`a sistemes basats en RHEL - `/etc/apache2/sites-available/000-default.conf`a Debian/Ubuntu 2\. Afegiu la següent directiva a l'arxiu de configuració del vostre equip virtual: ```ini <VirtualHost *:*> Header set Strict-Transport-Security "max-age=31536000" </VirtualHost> ``` 3\. Reinicieu el servei Apache per aplicar els canvis: ```bash # A sistemes basats en RHEL: systemctl restart httpd.service # A Debian/Ubuntu systemctl restart httpd.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 : #### Activació d'arxius MIB Sota sistemes basats en RedHat, els arxius MIB s'han d'activar per defecte. Sota sistemes basats en Debian, hem d'editar l'arxiu `/etc/snmp/snmp.conf` i treure el comentari a la línia on hi diu `mibs :` # As the snmp packages come without fichiers MIB due to license reasons, loading # of MIBs is disabled by default. If you added the MIBs you can reenable # loading them by commenting out the following line. mibs : #### Enabling multiple hosts Enable monitoring of two hosts, i.e., set their status to 0. Request: ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "hostids": [ "69665", "69666" ] }, "id": 1 } ``` #### Habilitar múltiples equips Habilitar el monitoratge de d's equips; és a dir, definir el seu estat a 0. Petició: ```json { "jsonrpc": "2.0", "method": "host.massupdate", "params": { "hosts": [ { "hostid": "69665" }, { "hostid": "69666" } ], "status": 0 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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 /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.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 /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar Most (if not all) of these settings can be specified in `/etc/java-6-openjdk/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. #### Activació del monitoratge JMX remot per l'aplicació Java Una aplicació Java no requereix la instal·lació de programari addicional, però s'ha d'iniciar amb les opcions de línia de comandes que s'especifiquen a continuació per admetre el monitoratge remot de JMX. Com a mínim, si només voleu començar a monitorar una aplicació Java senzilla en un equip local sense seguretat, executeu-la amb les opcions següents: 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 /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar Això fa que Java escolti les connexions JMX entrants al port 12345, només des de l'equip local, i li diu que no demani autenticació o SSL. Si voleu permetre connexions a una altra interfície, configureu el paràmetre -Djava.rmi.server.hostname a l'adreça IP d'aquesta interfície. Si voleu ser més estrictes en seguretat, hi ha moltes altres opcions de Java disponibles. L'exemple següent inicia l'aplicació amb un conjunt d'opcions més versàtil i l'obre a una xarxa més àmplia, no només a l'equip local. 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 /usr/share/doc/openjdk-6-jre-headless/demo/jfc/Notepad/Notepad.jar La majoria (si no tots) d'aquests paràmetres es poden especificar a /etc/java-6-openjdk/management/management.properties (o allà on es trobi aquest fitxer al vostre sistema). Tingueu en compte que si voleu emprar SSL, heu de modificar l'script startup.sh afegint opcions `-Djavax.net.ssl.*` a la passarel·la java, de manera que sàpiga on trobar la clau i els magatzems de confiança. Consulteu el [monitoratge i gestió mitjançant JMX](http://download.oracle.com/javase/1.5.0/docs/guide/management/agent.html) per obtindre una descripció detallada. #### Enabling Zabbix on root directory of URL On RHEL-based systems, add a virtual host to Apache configuration (`/etc/httpd/conf/httpd.conf`) and set 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 ``` #### Activació de Zabbix sota un directori root de l'URL Afegiu l'equip virtual a la configuració d'Apache (`/etc/httpd/conf/httpd.conf`) i configureu la redirecció permanent per al document arrel a l'URL SSL de Zabbix. No oblideu substituir *exemple.com* pel nom real del servidor. ```ini #Afegiu les línies: <VirtualHost *:*> ServerName exemple.cat Redirect permanent / https://exemple.cat </VirtualHost> ``` Reinicieu el servei Apache per aplicar les modificacions: ```bash systemctl restart httpd.service ``` #### 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". 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. #### Paràmetres de codificació Per assegurar-vos que les dades adquirides no siguin malmeses, podeu especificar la codificació correcta per al processament de verificació (per exemple, "vfs.file.contents") al paràmetre "encoding". La llista de codificacions admeses (identificadors de pàgines de codi) es pot trobar a la documentació de [libiconv](http://www.gnu.org/software/libiconv/) (Projecte GNU) o a la documentació de l'SDK de Microsoft Windows per a "Codi Identificadors de pàgina". Si no s'especifica cap codificació al paràmetre "codificació", s'apliquen les estratègies de resolució següents: - Si no s'especifica la codificació (o si és una cadena buida), se suposa que és UTF-8, les dades es tracten "tal com són"; - Anàlisi de BOM: aplicable als elements "vfs.file.contents", "vfs.file.regexp", "vfs.file.regmatch". S'intenta determinar la codificació correcta emprant la marca d'ordre d'octets (BOM) al començament del fitxer. Si la BOM no és pas present, s'aplica la resolució estàndard (veieu més amunt). ##### 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| ##### Xifrat La pestanya **Xifrat** us permet requerir connexions [xifrades](/manual/encryption) amb l'equip. |Paràmetre|Descripció| |--|---------| |*Connexions a l'equip*|Com es connecta el servidor o proxy Zabbix a l'agent Zabbix d'un equip: sense xifrat (per defecte), emprant PSK (clau prèviament compartida) o certificat.| |*Connexions des de l'equip*|Seleccioneu el tipus de connexions permeses des de l'equip (és a dir, des de l'agent Zabbix i el remitent de Zabbix). Es poden seleccionar diversos tipus de connexió al mateix temps (útil per provar i canviar a un altre tipus de connexió). El valor predeterminat és "Sense xifrat".| |*Emissor*|Emissor autoritzat del certificat. El certificat es valida primer amb la CA (Certificate Authority). Si és vàlid, signat per l'AC, el camp *Emissor* es pot emprar per restringir encara més l'AC autoritzada. Aquest camp és pensat per emprar-se si la vostra instal·lació de Zabbix empra certificats de diverses CA. Si aquest camp està buit, s'admet qualsevol autoritat de certificació.| |*Assumpte*|Subjecte autoritzat del certificat. El certificat es valida primer amb CA. Si és vàlid, signat per l'AC, el camp *Assumpte* es pot emprar per permetre només un valor de cadena *Assumpte*. Si aquest camp està en blanc, s'admet qualsevol certificat vàlid signat per la CA configurada.| |*Identitat PSK*|Cadena d'identitat de clau prèviament compartida.<br>No introduïu informació sensible a la identitat PSK, es transmet sense xifrar per la xarxa per informar al receptor quina PSK ha d'emprar.| |*PSK*|Clau precompartida (cadena hexadecimal). Longitud màxima: 512 dígits hexadecimals (PSK de 256 bytes) si Zabbix empra la biblioteca GnuTLS o OpenSSL, 64 dígits hexadecimals (PSK de 32 bytes) si Zabbix empra la biblioteca Mbed TLS (PolarSSL). Exemple: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952| ### Encryption with certificate authority verification ### Xifrat amb verificació de l'autoritat de certificació ### 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. ::: ### Xifrat amb verificació de l'entitat certificadora Copieu la CA de MySQL necessària al servidor frontal de Zabbix, assigneu permisos per permetre que el servidor web llegeixi aquest fitxer. :::noteclassic Aquest mode no funciona pas amb SLES 12 i RHEL 7 a causa de les antigues biblioteques de MySQL. ::: ### Encryption with full verification ### Xifrat amb verificació completa ### Encryption with full verification ### Xifrat amb verificació completa #### 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 #### Millorant la sessió de seguretat i SameSite a Zabbix Quan es configura Zabbix, és essencial millorar la seguretat i SameSite per a les galetes de sessió, per evitar atacs de falsificació de peticions entre llocs (CSRF). Tanmateix, fer complir ``SameSite=Strict`` pot donar problemes en determinats escenaris, com ara: - Ginys d'URL del tauler de control que mostren "usuari sense sessió iniciada" quan s'incorporen iframes del mateix domini. - Els usuaris que accedeixen al tauler mitjançant HTTP en lloc d'HTTPS poden tindre problemes d'inici de sessió. - Incapacitat per compartir URL amb seccions o equips específics del menú de Zabbix. Per mitigar aquests problemes, els usuaris haurien de tindre una manera d'ajustar la política de SameSite. 1\. Cookies segures L'establiment de la marca ``segura`` garanteix que les galetes només es transmetin a través d'HTTPS, evitant l'exposició a les connexions sense xifrar. Per habilitar les galetes segures a Zabbix, afegiu o modifiqueu la configuració següent a la configuració del servidor web: Per a Apache: La capçalera sempre edita Set-Cookie ^(.*)$ $1;Secure Per a Nginx: proxy_cookie_path / "/; Secure"; Assegureu-vos que s'accedeix a la vostra interfície Zabbix mitjançant HTTPS; en cas contrari, no s'enviaran galetes amb l'etiqueta ``Segur``. 2\. Configuració de l'atribut SameSite La configuració del servidor web també pot aplicar l'atribut SameSite: Per a Apache: <IfModule mod_headers.c> Encapçalament en edició correcta Set-Cookie (.*) "$1; SameSite=Strict" </IfModule> Per a Nginx (versió 1.19.3+): proxy_cookie_flags ~ samesite=Estricte; # Substituïu ~ per 'zbx_session' per a l'especificitat #### Entity count New [functions](/manual/appendix/functions) have been added to simplify the counting of specific hosts, items, or values, returned by [foreach functions](/manual/appendix/functions/aggregate/foreach). Aggregate functions: - **count** - total number of values in an array returned by a foreach function (returns an integer); - **item\_count** - total number of currently enabled items that match filter criteria (returns an integer). Foreach function: - **exists\_foreach** - number of currently enabled items that match filter criteria (returns an array). ##### Recompte d'entitats S'han afegit noves [funcions](/manual/appendix/functions) per simplificar el recompte d'equips, elements o valors específics retornats per les [funcions foreach](/manual/appendix/functions/agregate/foreach). Funcions d'afegit: - **count** - nombre total de valors en una matriu retornats per una funció foreach (retorna un nombre enter); - **item\_count** - nombre total d'elements activats actualment que coincideixen amb els criteris de filtre (retorna un nombre enter). Funció Foreach: - **exists\_foreach** - nombre d'elements activats actualment que coincideixen amb els criteris de filtre (retorna una matriu). ##### Entity uniqueness criteria When adding entities (items, triggers, graphs 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 ##### Criteri d'unicitat de l'entitat Quan s'afegeixen entitats (elements, triggers, gràfics, etc.) d'una plantilla, és important saber quines entitats ja existeixen a l'equip i s'han d'actualitzar, així com quines entitats són diferents. Els criteris d'unicitat per decidir la semblança/diferència són els següents: - per als elements - la clau de l'element - per a triggers - nom i expressió del trigger - per a gràfics personalitzats - nom del gràfic i els seus elements #### Environment files In the same directory with compose files on github.com you can find files with default environment variables for each component in compose file. These environment files are named like `.env_<type of component>`. #### Arxius d'entorn Al mateix directori amb els fitxers de redacció a github.com, podeu trobar fitxers amb variables d'entorn predeterminades per a cada component del fitxer de composició. Aquests fitxers d'entorn s'anomenen així: `.env_<tipus de component>`. #### 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/6.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/6.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. ::: #### Variables d'entorn El comportament de Docker Compose i la configuració del component Zabbix es poden personalitzar mitjançant variables d'entorn. **Compose-level variables** (definit en el fitxer [`.env`](https://github.com/zabbix/zabbix-docker/blob/6.0/.env)) controlen quins rangs de Docker imatges, ports i xarxa IP s'utilitzen. Podeu utilitzar aquestes variables en línia abans de l'ordre `docker compose`, o editar el fitxer `.env`. Per exemple, l'ordre següent desplega una configuració completa de Zabbix multi-contenidor utilitzant una imatge basada en Ubuntu (en lloc de la Linux Alpine per defecte) i exposant la interfície web a través de Nginx en ports HTTP (8282) i HTTPS (8443): ``bash OS=ubuntu \ ZABBIX_WEB_NGINX_HTTP_PORT=8282 \ ZABBIX_WEB_NGINX_HTTPS_PORT=8443 \ docker compose -f ./compose.yaml up -d ``` **Variables a nivell de component** (definits en els fitxers [`env_vars/.env_<component>`](https://github.com/zabbix/zabbix-docker/blob/6.0/env_vars/)) controlen la configuració del component Zabbix. Editeu el fitxer respectiu `.env_<component>` abans d'executar l'ordre `docker compose`. Per exemple, podeu ajustar el recompte de sondejos passius del servidor Zabbix i la configuració de la memòria cau, així com configurar la zona horària de la interfície web editant les variables següents: ``·lícia # env_vars/.env_srv ZBX_STARTPOLLERS=20 ZBX_CACHESIZE=64M ZBX_HISTORYCACHESIZE = 32M # env_vars/.env_web PHP_TZ=Europa/París ``` ::: noteclassic Les variables d'entorn de nivell de component corresponen a paràmetres de configuració de components de Zabbix utilitzant un estil de denominació diferent (per exemple, `ZBX_STARTPOLLERS` correspon a [`StartPollers`](/manual/appendix/config/zabbix_server#startpollers). Algunes variables són específiques de Docker, i alguns paràmetres de configuració no es poden canviar (per exemple, 'PIDFile` i `LogType`). Quan utilitzeu variables d'entorn, consulteu la secció *Variables de medi ambient* a la descripció de cada component [Imatge de l'acoblador](#available-docker-images) a Docker Hub. :: #### Error handling Up to that point everything we've tried has worked fine. But what happens if we try to make an incorrect call to the API? Let's try to create another host by calling [host.create](/manual/api/reference/host/create) but omitting the mandatory `groups` parameter. ```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" } ] }, "id": 7, "auth": "0424bd59b807674191e7d77572075f33" } ``` 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 occurred, instead of the `result` property, the response object will contain an `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 different cases, such as, using incorrect input values, a session timeout or trying to access unexisting objects. Your application should be able to gracefully handle these kinds of errors. #### Gestió d'errors Fins ara, tot el que hem provat ha funcionat bé. Però, què passa si provem a fer una crida incorrecta de l'API? Provem de crear un altre equip cridant al mètode [host.create](/manual/api/reference/host/create) però ometent el paràmetre necessari `groups`. ```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" } ] }, "id": 7, "auth": "0424bd59b807674191e7d77572075f33" } ``` La resposta contindrà, doncs, un missatge d'error: ```json { "jsonrpc": "2.0", "error": { "code": -32602, "message": "Paràmetres incorrectes.", "data": "No hi ha grups per l'equip \"Linux server\"." }, "id": 7 } ``` Si es produeix un error, en lloc de la propietat `result`, l'objecte de resposta contindrà una propietat `error` amb les dades següents: - `code` - un codi d'error; - `message` - un breu resum de l'error; - `data` - un missatge d'error més detallat. Es poden produir errors en diferents casos, com ara emprar valors d'entrada incorrectes, esgotar el temps d'espera d'una sessió o provar d'accedir a objectes que no existeixen. La vostra aplicació ha d'ésser capaç de gestionar aquests errors. #### 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. #### Missatges d'error Els missatges d'error ODBC s'estructuren en camps per proporcionar informació detallada. Per exemple, un missatge d'error pot tindre aquesta apareça: Cannot execute ODBC query: [SQL_ERROR]:[42601][7][ERROR: syntax error at or near ";"; Error while executing the query] - "`Cannot execute ODBC query`" - Missatge de Zabbix - "`[SQL_ERROR]`" - Codi de retorn ODBC - "`[42601]`" - SQLState - "`[7]`" - Codi d'error nadiu - "`[ERROR: syntax error at or near ";"; Error while executing the query]`" - Missatge d'error nadiu Veieu que la longitud del missatge d'error és limitada a 2048 octets, de manera que el missatge es pot truncar. Si hi ha diversos registres de diagnòstic ODBC, Zabbix prova de concatenar-los (separats per `|`) sempre que el límit de longitud ho permeti. #### 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.: 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). #### Errors amb l'execució d'fping a contenidors sense arrel Quan els contenidors s'executen en mode sense arrel o en un entorn de restriccions específiques, és possible que us trobeu amb errors relacionats amb l'execució d'fping quan feu comprovacions ICMP, com ara "fping: operació no permesa" o es perdin tots els paquets de tots els recursos. Per solucionar aquest problema, afegiu `--cap-add=net_raw` a les ordres "docker run" o "podman run". A més, l'execució d'fping en entorns no root pot menester modificacions de sysctl, és a dir: sudo sysctl -w "net.ipv4.ping_group_range=0 1995" on "1995" és el GID zabbix. Per obtindre més informació, consulteu [ZBX-22833](https://support.zabbix.com/browse/ZBX-22833). #### Escalation examples #### Exemples d'escalada #### 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: - To consider all values between "now-time period" and "now" (or, with time shift, between "now-time shift-time period" and "now-time\_shift") - To consider no more than the num count of values from the past, up to "now" - If there are 0 available values for the time period or num count specified - then the trigger or calculated item that uses 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() 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. #### Període d'avaluació S'empra un període d'avaluació en funcions que fan referència a l'historial de l'element. Permet especificar l'interval que ens interessa. Es pot especificar com un període de temps (30 s, 10 m, 1 h) o com un rang de valors (\#5 - per als cinc darrers valors). El període d'avaluació es mesura fins a "ara" - on "ara" és el darrer moment de recàlcul del trigger (veieu [Temps de càlcul](#temps_càlcul) més amunt); "ara" no és l'hora "actual" del servidor. El període d'avaluació especifica: - Considerar tots els valors entre "ara-temps-període" i "ara" (o, endarrerit, entre "now-time-lag-time-period" i "now-time-lag") - No considerar més que el nombre de valors del passat, fins "ara" - Si no hi ha cap valor disponible per al període o recompte especificat, el trigger o l'element calculat que empra aquesta funció ja no s'admetrà Tingueu en compte que: - Si només s'empra una funció (que fa referència a dades històriques) al trigger, "ara" sempre serà el darrer valor rebut. Per exemple, si el darrer valor es va rebre fa una hora, el període d'avaluació es considerarà fins a el darrer valor fa una hora. - Un nou trigger es calcula en rebre el primer valor (funcions de l'historial); es calcularà en 30 segons per a les funcions basades en [data i hora](/manual/appendix/functions/time). Així, el trigger es calcularà encara que el període d'avaluació definit (per exemple, una hora) encara no hagi passat des de la creació del trigger. El trigger també es calcularà després del primer valor, encara que l'interval d'avaluació s'hagi establert, per exemple, als deu darrers valors. # event.acknowledge # event.acknowledge #### Event correlation Create custom event correlation rules. [Correlation API](/manual/api/reference/correlation) #### Correlació d'esdeveniments Crear regles personalitzades de correlació d'esdeveniments. [API Correlació](/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 ##### Correlació d'esdeveniments La correlació d'esdeveniments (també coneguda com a correlació d'esdeveniments global) us permet configurar regles de tancament d'esdeveniments personalitzades (que resulta en la creació d'esdeveniments OK). Les regles defineixen com s'associen els nous esdeveniments problemàtics amb els esdeveniments problemàtics existents i permeten tancar el nou esdeveniment o els esdeveniments coincidents generant esdeveniments OK coincidents. Tanmateix, la correlació d'esdeveniments s'ha de configurar amb molta cura, ja que pot afectar negativament el rendiment del processament d'esdeveniments o, si es configura incorrectament, tancar més esdeveniments dels esperats (en el pitjor dels casos, es poden tancar tots els problemes). Alguns consells de configuració: 1. Reduïu sempre l'abast de la correlació definint una etiqueta única per a la verificació d'esdeveniments (l'esdeveniment associat a esdeveniments antics) i emprant la condició de correlació "etiqueta d'esdeveniment nova" 2. No us oblideu d'afegir una condició basada en l'esdeveniment antic quan feu servir l'operació "tanca l'esdeveniment antic", o bé es podrien tancar tots els problemes existents 3. eviteu emprar noms d'etiquetes idèntics emprats per diferents configuracions de correlació # event.get # event.get #### Event menu Clicking on the problem name brings up the event menu:  The event menu allows to: - filter the problems of the trigger - access the trigger configuration - access a simple graph/item history of the underlying item(s) - access an external ticket of the problem (if configured, see the *Include event menu entry* option when configuring [webhooks](/manual/config/notifications/media/webhook)) - execute global [scripts](/manual/web_interface/frontend_sections/administration/scripts) (these scripts need to have their scope defined as 'Manual event action'). This feature may be handy for running scripts used for managing problem tickets in external systems. #### Menú de l'esdeveniment Si feu clic al nom del problema, apareixerà el menú d'esdeveniments:  El menú d'esdeveniments us permet: - fitlrar els problemes del trigger - accedir a la configuració del trigger - accedir a un gràfic/historial d'elements senzills dels elements subjacents - Accedeix a un tiquet de problema extern (si és configurat, veieu l'opció *Inclou l'entrada del menú d'esdeveniments* quan configureu [webhooks](/manual/config/notifications/media/webhook)) - executeu [scripts globals](/manual/web_interface/frontend_sections/administration/scripts) (aquests scripts han de tindre el seu abast definit com a 'Acció d'esdeveniment manual'). Aquesta característica pot ser útil per executar scripts que s'empren per gestionar els tiquets de problemes a sistemes externs. ### 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|string|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 for trigger events:<br>0 - trigger.<br><br>Possible values for discovery events:<br>1 - discovered host;<br>2 - discovered service.<br><br>Possible values for autoregistration events:<br>3 - auto-registered host.<br><br>Possible values for internal events:<br>0 - trigger;<br>4 - item;<br>5 - LLD rule.<br><br>Possible values for service events:<br>6 - service.| |objectid|string|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 for trigger and service events:<br>0 - OK;<br>1 - problem.<br><br>Possible values for discovery events:<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 for internal events:<br>0 - "normal" state;<br>1 - "unknown" or "not supported" state.<br><br>This parameter is not used for active agent autoregistration events.| |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|string|Recovery event ID| |c\_eventid|string|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.| |correlationid|string|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|string|User ID if the event was manually closed.| |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).| ### Esdeveniment ::: noteclassic Els esdeveniments els crea el servidor Zabbix i no es poden modificar mitjançant l'API. ::: L'objecte d'esdeveniment té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |eventid|string|ID d'esdeveniment.| |source|integer|Tipus de l'esdeveniment.<br><br>Valors possibles:<br>0 - esdeveniment creat per un trigger;<br>1 - esdeveniment creat per una regla de descobriment;<br>2 - esdeveniment creat per un autoregistre actiu;<br>3 - esdeveniment intern;<br>4 - esdeveniment creat en actualitzar l'estat d'un servei.| |objecte|integer|Tipus d'objecte relacionat amb l'esdeveniment.<br><br>Valors possibles per a esdeveniments de descobriment:<br>0 - trigger.<br><br>Valors possibles per a esdeveniments de descobriment: <br >1 - equip descobert;<br>2 - servei descobert.<br><br>Valors possibles per a esdeveniments d'autoregistre:<br>3 - equip auto-registrat.<br><br>Valors possibles ​​per a esdeveniments interns:<br>0 - trigger;<br>4 - element;<br>5 - regla de descobriment de baix nivell.<br><br>Valors possibles per a esdeveniments de servei:<br>6 - servei.| |objectid|string|Id de l'objecte relacionat amb l'esdeveniment.| |acknowledged|integer|Indica si l'esdeveniment s'ha reconegut.| |clock|timestamp|Hora en què es va crear l'esdeveniment.| |ns|integer|Nanosegons en crear l'esdeveniment.| |name|string|Nom de l'esdeveniment resolt.| |value|integer|Estat de l'objecte relacionat.<br><br>Possibles valors per a esdeveniments d'activació i servei:<br>0 - D'acord;<br>1 - problema.<br><br>Valors possibles per a esdeveniments de descobriment :<br>0 - equip o servei actiu;<br>1 - equip o servei inactiu;<br>2 - equip o servei descobert;<br>3 - equip o servei perdut.<br> <br>Valors possibles ​​per a esdeveniments interns:<br>0 - estat "normal";<br>1 - estat "desconegut" o "no compatible".<br><br>Aquest paràmetre no s'empra per a esdeveniments d'autoregistre.| |severity|integer|Gravetat actual de l'esdeveniment.<br><br>Valors possibles:<br>0 - sense classificar;<br>1 - informació;<br>2 - advertiment;<br>3 - mitjana; <br> >4 - alta;<br>5 - desastre.| |r\_eventid|string|ID d'esdeveniment de recuperació.| |c\_eventid|string|ID d'esdeveniment problemàtic que ha generat l'esdeveniment OK.| |correlationid|string|ID de correlació.| |userid|string|ID d'usuari si l'esdeveniment s'ha tancat manualment.| |suppressed|integer|Si l'esdeveniment s'ha esborrat.<br><br>Valors possibles:<br>0 - l'esdeveniment és en estat normal;<br>1 - l'esdeveniment s'ha esborrat.| |opdata|string|Dades operacionals amb macros ampliades.| |urls|matriu d'[URL de tipus de suport](/manual/api/reference/problem/object#URL de tipus de suport)|URL de tipus de suport actiu.| # Event object The following objects are directly related to the `event` API. # Objecte esdeveniment Els següents objectes són vinculats a l'API `event`. #### 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) #### Esdeveniments Recuperar els esdeveniments generats per els triggers, descoberta de xarxa i altres sistemes de Zabbix per una gestió més flexible de les situacions o una integració de les eines de tercers. [API Esdeveniment](/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.| ### Etiqueta d'esdeveniment L'objecte d'etiqueta d'esdeveniment té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |tag|string|Nom de l'etiqueta d'esdeveniment.| |value|string|Valor de l'etiqueta d'esdeveniment.| # Event This class is designed to work with events. Object references: - [Event](/manual/api/reference/event/object#host) Available methods: - [event.get](/manual/api/reference/event/get) - retrieving events - [event.acknowledge](/manual/api/reference/event/acknowledge) - acknowledging events # Esdeveniment Aquesta classe és dissenyada per treballar amb esdeveniments. Referèncie dels objectes: - [Esdeveniment](/manual/api/reference/event/object#host) Mètodes disponibles: - [event.get](/manual/api/reference/event/get) - recuperar els esdeveniments - [event.acknowledge](/manual/api/reference/event/acknowledge) - reconèixer els esdeveniments ### Example ### Exemple ##### Example 10 CPU activity at any time with exception. Use of function time() and **not** operator: 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). ##### Exemple 10 Activitat de la CPU en tot moment excepte excepcions. Emprant la funció time() i l'operador **no**: min(/zabbix/system.cpu.load[all,avg1],5m)>2 i no (dia de la setmana()=7 i hora()>230000) i no (dia de la setmana()=1 i hora()<010000) El trigger pot canviar el seu estat a problema en qualsevol moment, excepte durant 2 hores durant un canvi de setmana (diumenge, 23:00 - dilluns, 01:00). ##### Example 11 Check if client local time is in sync with Zabbix server time. Use of function fuzzytime(): 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). ##### Exemple 11 Comproveu si l'hora del client local és sincronitzada amb l'hora del servidor Zabbix. Emprant la funció fuzzytime(): fuzzytime(/MySQL_DB/system.localtime,10s)=0 El trigger passarà a l'estat del problema si l'hora local al servidor MySQL\_DB i al servidor Zabbix difereixen més de 10 segons. Tingueu en compte que 'system.localtime' s'ha de configurar com a [comprovació passiva](/manual/appendix/items/activepassive#passive_checks). ##### Example 12 Comparing average load today with average load of the same time yesterday (using time shift as `now-1d`). avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 This trigger will fire if the average load of the last hour tops the average load of the same hour yesterday more than two times. ##### Exemple 12 Comparació de la càrrega mitjana d'avui amb la càrrega mitjana de la mateixa hora d'ahir (emprant el desplaçament de temps com a "ara-1d"). avg(/server/system.cpu.load,1h)/avg(/server/system.cpu.load,1h:now-1d)>2 Aquest trigger s'activarà si la càrrega mitjana de la darrera hora supera la càrrega mitjana de la mateixa hora d'ahir més del doble. ##### Example 13 Using the value of another item to get a trigger threshold: last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 The trigger will fire if the free storage drops below 10 percent. ##### Exemple 13 Empreu el valor d'un altre element per obtindre un llindar d'activació: last(/Template PfSense/hrStorageFree[{#SNMPVALUE}])<last(/Template PfSense/hrStorageSize[{#SNMPVALUE}])*0.1 El trigger es dispararà si l'espai lliure baixa per sota del 10%. ##### Example 14 Using [evaluation result](#operators) to get the number of triggers over a threshold: (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. ##### Exemple 14 Emprant [resultat de l'avaluació](#operators) per obtindre el nombre de triggers per sobre d'un llindar: (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 El trigger s'activarà si almenys dos dels triggers de l'expressió són en estat problemàtic. ##### 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 last(/NY Zabbix server/vfs.file.contents[/etc/os-release])<>last(/LA Zabbix server/vfs.file.contents[/etc/os-release]) ##### Exemple 15 Comparant els valors de cadenes de dos elements: els operands aquí són funcions que retornen cadenes. Problema: creeu una alerta si la versió d'Ubuntu és diferent a diferents equips 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: net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] with macros defined as {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX and normally returns: example.com MX 0 mail.example.com So our trigger expression to detect if the DNS query result deviated from the expected result is: last(/Zabbix server/net.dns.record[8.8.8.8,{$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. ##### Exemple 16 Comparació de dos valors de cadena. Els operands són: - una funció que retorna una cadena - una combinació de macros i cadenes Problema: detectar canvis en la consulta de DNS La clau de l'element és: net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1] amb macros definides com {$WEBSITE_NAME} = example.com {$DNS_RESOURCE_RECORD_TYPE} = MX i normalment retorna: example.com MX 0 mail.example.com Per tant, la nostra expressió trigger per detectar si el resultat de la consulta DNS es desvia del resultat esperat és: last(/Zabbix server/net.dns.record[8.8.8.8,{$WEBSITE_NAME},{$DNS_RESOURCE_RECORD_TYPE},2,1])<>"{$WEBSITE_NAME} {$DNS_RESOURCE_RECORD_TYPE} 0 mail.{$WEBSITE_NAME}" Observeu les cometes al segon operand. ##### 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: \" //hello ?\" Option 1) write the string directly 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 {$HELLO_MACRO} = \" //hello ?\" in the expression: last(/Zabbix server/vfs.file.contents[/tmp/hello])={$HELLO_MACRO} ##### Exemple 17 Comparació de dos valors de cadena. Els operands són: - una funció que retorna una cadena - una cadena constant amb caràcters especials \\ i " Problema: detecteu si el contingut del fitxer `/tmp/hello` és igual a: \" //Hola ?\" Opció 1) escriure la cadena directament last(/Zabbix server/vfs.file.contents[/tmp/hello])="\\\" //hola ?\\\"" Observeu com s'escapen els caràcters \\ i " quan es compara directament la cadena. Opció 2) emprar una macro {$HELLO_MACRO} = \" //hola?\" a l'expressió: 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 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: 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. ##### Exemple 18 Compara llargs períodes de temps. Problema: la càrrega del servidor Exchange ha pujat més d'un 10% durant el darrer mes trendavg(/Exchange/system.cpu.load,1M:now/M)>1.1*trendavg(/Exchange/system.cpu.load,1M:now/M-1M) També podeu emprar el camp [Nom de l'esdeveniment](/manual/config/triggers/trigger#configuration) a la configuració del trigger per crear un missatge d'alerta significatiu, per exemple per rebre alguna cosa com ara `"La càrrega del servidor Exchange va pujar un 24% al juliol (0,69) en comparació amb el juny (0,56)"` el nom de l'esdeveniment s'ha de definir com: La càrrega del servidor {HOST.HOST} ha pujat un {{?100*trendavg(//system.cpu.load,1M:now/M)/trendavg(//system.cpu.load,1M:now/M-1M) }.fmtnum(0)}% en {{TIME}.fmttime(%B,-1M)} ({{?trendavg(//system.cpu.load,1M:now/M)}.fmtnum(2)}) en comparació amb {{TIME}.fmttime(%B,-2M)} ({{?trendavg(//system.cpu.load,1M:now/M-1M)}.fmtnum(2)}) També és útil permetre el tancament manual de la configuració del trigger per a aquest tipus de problema. ##### 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. ##### Exemple 1 Càlcul del percentatge d'espai lliure de disc a '/'. Ús de la funció **last**: 100*last(//vfs.fs.size[/,free])/last(//vfs.fs.size[/,total]) Zabbix prendrà els darrers valors per l'espai en disc lliure i el total, i calcularà el percentatge segons la fòrmula donada. ##### 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"} ##### Exemple 1 : Descobrir els MBeans Aquesta regla retornarà 3 objectes: la filera superior de la columna: MBean1, MBean2, MBean3. Per obtindre més informació sobre els objectes, consulteu la taula de [macros compatibles](/manual/discovery/low_level_discovery/examples/jmx#supported_macros), secció *Descoberta de MBeans*. La configuració de la regla de descoberta que recull els MBeans (sense els atributs) té aquest aspecte:  La clau emprada aquí: jmx.discovery[beans,"*:type=GarbageCollector,name=*"] Es descobriran tots els recol·lectors d'escombraries sense atributs. Com que els col·lectors d'escombraries tenen el mateix conjunt d'atributs, podem emprar els atributs desitjats als prototips d'elements de la següent manera:  Claus emprades aquí: jmx[{#JMXOBJ},CollectionCount] jmx[{#JMXOBJ},CollectionTime] jmx[{#JMXOBJ},Valid] La regla de descoberta d'LLD donarà lloc a alguna cosa semblant a això (es descobreixen elements per a dos col·lectors d'escombraries): {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: snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ##### Exemple 1 Exemple general: |Paràmetre|Descripció| |--|--------| |**OID**|1.2.3.45.6.7.8.0 (or .1.2.3.45.6.7.8.0)| |**Key**|<Cadena única per emprar com a referència per als triggers <br>Per exemple, "el meu\_param".| Tingueu en compte que l'OID es pot donar en forma numèrica o com a cadena. Tanmateix, en alguns casos, la cadena OID s'ha de convertir a representació numèrica. La utilitat snmpget es pot emprar per a aquest propòsit: snmpget -On localhost public enterprises.ucdavis.memory.memTotalSwap.0 ##### 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 ##### Exemple 1 Objecte del missatge: Problema: {TRIGGER.NAME} Quan rebeu el missatge, l'assumpte del missatge canviarà a alguna cosa com: Problema: la càrrega de la CPU és massa alta al servidor Zabbix ##### 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.0: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]`. ###### Exemple 1 Monitoratge de dues instàncies “MySQL1” i “MySQL2”. Paràmetres de configuració: ```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.0:3306 Plugins.Mysql.Sessions.MySQL2.User=mysql2_user Plugins.Mysql.Sessions.MySQL2.Password=different_password ``` Com a resultat d'aquesta configuració, cada nom de sessió es pot emprar com a connString a una [clau d'element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2), com ara `mysql.ping[MySQL1]` o `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| ##### Exemple 1 Reiniciar de Windows sota determinades condicions. Per tal de reiniciar automàticament Windows en cas de problema detectat per Zabbix, definiu el següent script: |Paràmetre d'script|Valor| |--|--------| |*Àmbit*|'Acció d'operació'| |*Tipus*|'Script'| |*Comanda*|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 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. ::: ##### Exemple 1 Enviament d'una notificació repetida cada 30 minuts (5 vegades en total) a un grup "Administradors de MySQL". Per configurar-lo: - A la pestanya Operacions, establiu la *durada predeterminada de la passa de l'operació* a '30 m' (30 minuts) - Estableix les passes d'escalada a *De* '1' *A* '5' - Seleccioneu el grup "Administradors de MySQL" com a destinataris del missatge {width="600"} Les notificacions s'enviaran a les 0:00, 0:30, 1:00, 1:30, 2:00 hores després de l'inici del problema (tret que, per descomptat, el problema es resolgui abans). Si el problema es resol i es configura un missatge de recuperació, s'enviarà a aquells que hagin rebut almenys un missatge de problema en aquest escenari d'escalada. :::noteclassic Si el trigger que va generar una escalada activa és desactivat, Zabbix envia un missatge informatiu al respecte a tothom que ja hagi rebut notificacions. ::: ##### 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: ```{=html} <!-- --> ``` { "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` ##### Exemple 1 Envieu peticions GET simples per extreure les dades de serveis com ara Elasticsearch: - Crear un element GET amb l'URL : `localhost:9200/?pretty` - Veieu la resposta: ```{=html} <!-- --> ``` { "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" } - Extreure ara el nombre de versió emprant una etapa de pre-processament JSONPath: `$.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' ##### Exemple 1 Una cosa molt senzilla: UserParameter=ping[*], echo $1 Podem definir un nombre il·limitat d'elements per al seguiment de tots els formats ping\[alguna cosa\]. - ping\[0\] - sempre retornarà '0' - ping\[aaa\] - sempre retornarà "aaa" ##### Example 1 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. ##### Exemple 1 Aturar els esdeveniments de problemes repetitius a partir d'un mateix port de xarxa.  Aquesta regla de correlació global correlarà els problemes si els valors de les etiquetes *Equip* i *Port* existeixen al trigger i són idèntiques tant a l'esdeveniment original com al nou. L'operació tancarà els nous esdeveniments de problemes sota el mateix port de xarxa, deixant només el problema original obert.. ##### Example 1 Temperature in server room is too high. Problem expression: last(/server/temp)>20 Recovery expression: last(/server/temp)<=15 ##### Exemple 1 La temperatura a la sala de servidors és massa alta. Expressió del problema: last(/server/temp)>20 Expressió de recuperació: last(/server/temp)<=15 ##### Example 1 The processor load is too high on Zabbix server. 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. ##### Exemple 1 La càrrega de la CPU és massa alta al servidor Zabbix. last(/Zabbix server/system.cpu.load[all,avg1])>5 Mitjançant la funció 'last()', ens referim al valor més nou. `/Zabbix server/system.cpu.load[all,avg1]` dóna un nom curt del paràmetre monitorat. Especifica que l'equip és "servidor Zabbix" i la clau monitorada és "system.cpu.load\[all,avg1\]". Finalment, ">5" significa que el trigger és en estat PROBLEMA sempre que la mesura de càrrega de CPU més nova del servidor Zabbix sigui superior a 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. ##### Exemple 1 Per crear un trigger "Error de l'escenari web", podeu definir una expressió trigger: last(/host/web.test.fail[Escenari])<>0 Assegureu-vos de substituir "Escenari" pel nom real del vostre escenari. ##### Example 1 Total disk space of host group 'MySQL Servers'. sum(last_foreach(/*/vfs.fs.size[/,total]?[group="MySQL Servers"])) ##### Exemple 1 Espai total de disc del grup d'equips 'MySQL Servers'. 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. ##### Exemple 1 Ús d'una macro a nivell d'equip a la clau d'element "estat del dimoni SSH": `net.tcp.service[ssh,,{$SSH_PORT}]` Aquest element es pot atribuir a diferents equips, amb la condició que el valor d'**{$SSH\_PORT}** sigui definit a aquests equips. ##### Example 1 Use of the following expression in low-level discovery to discover databases except a database with a specific name: ^TESTDATABASE$  Chosen *Expression type*: "Result is FALSE". Doesn't match name, containing string "*TESTDATABASE*". ##### Exemple 1 Ús de l'expressió següent a la descoberta de baix nivell per trobarbases de dades, excepte una base de dades amb un nom específic: ^ BASE DE DADES DE TEST$  *Tipus d'expressió* triada: "El resultat és FALS". No coincideix amb el nom, que conté la cadena "*TESTDATABASE*". ##### Example 1 Using host metadata to distinguish between Linux and Windows hosts. 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. ##### Exemple 1 Ús de metadades de l'equip per distingir els equips Linux i Windows. Suposem que voleu que els equips es registrin automàticament pel servidor Zabbix. Teniu agents Zabbix actius (veieu la secció "Configuració" més amunt) a la vostra xarxa. Hi ha equips Windows i equips Linux a la vostra xarxa i teniu plantilles "Template OS Linux" i "Template OS Windows" disponibles a la vostra interfície Zabbix. Per tant, quan registreu l'equip, voleu que s'apliqui la plantilla correcta de Linux/Windows a l'equip que s'és registrant. Per defecte, només s'envia el nom d'equip al servidor durant l'autoregistre, cosa que pot ser que no sigui suficient. Per assegurar-vos que s'aplica la plantilla correcta a l'equip, heu d'emprar les metadades de l'equip. ##### 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. ##### Exemple 2 Càlcul de la mitjana sobre 10 minuts del nombre de valors tractats per Zabbix. Ús de la funció **avg**: avg(/Zabbix Server/zabbix[wcache,values],10m) Veieu que un ús intensiu d'elements calculats amb períodes llargs pot afectar el rendiment del servidor Zabbix. ##### 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. ##### Exemple 2 : Descoberta dels atributs Mbean Aquesta regla retornarà 9 objectes amb els següents camps: MBean1Attribute1, MBean2Attribute1, MBean3Attribute1, MBean1Attribute2, MBean2Attribute2, Mbean3Attribute2, MBean1Attribute3, MBean2Attribute3, Mbean3Attribute3. Per obtindre més informació sobre els objectes, consulteu la taula de [macros compatibles](/manual/discovery/low_level_discovery/examples/jmx#supported_macros), secció *Descoberta d'atributs MBean*. La configuració de la regla de descoberta que recull els atributs Mbean té aquest aspecte:  La clau emprada aquí: jmx.discovery[atributs,"*:type=GarbageCollector,name=*"] Es descobriran tots els recol·lectors d'escombraries amb un únic atribut d'element.  En aquest cas particular, es crearà un element a partir del prototip per a cada atribut MBean. El principal desavantatge d'aquesta configuració és que la creació de triggers a partir de prototips de triggers no és possible perquè només hi ha un prototip d'element per a tots els atributs. Per tant, aquesta configuració es pot emprar per a la recollida de dades, però no es recomana per al monitoratge automàtic. ##### Example 2 Free disk space is too low. Problem expression: it is less than 10GB for last 5 minutes max(/server/vfs.fs.size[/,free],5m)<10G Recovery expression: it is more than 40GB for last 10 minutes min(/server/vfs.fs.size[/,free],10m)>40G ##### Exemple 2 L'espai lliure de disc és molt baix. Expressió del problema: menys de 10 Go durant els darrers 5 minuts max(/server/vfs.fs.size[/,free],5m)<10G Expressió de recuperació: més de 40Go durant els 10 darrers minuts 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] ##### Exemple 2 Afegim una mica de significat! UserParameter=mysql.ping[*],mysqladmin -u$1 -p$2 ping | grep -c alive Aquest paràmetre es pot emprar per controlar la disponibilitat de la base de dades MySQL. Podem passar nom d'usuari i mot de pas: mysql.ping[zabbix,el_nostre_mot_de_pas] ##### 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 ##### Exemple 2 Missatge: La càrrega del processador és: {?last(/zabbix.zabbix.com/system.cpu.load[,avg1])} Després de rebre el missatge, el missatge es canviarà per quelcom com ara: La càrrega del processador és: 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| ##### Exemple 2 Monitoratge de la disponibilitat: |Paràmetre|Descripció| |--|--------| |**OID**|MIB::sysUpTime.0| |**Key**|router.uptime| |**Value type**|Float| |**Units**|uptime| |**Passa de pretractament: multiplicador personalitzat**|0.01| ##### Example 2 Providing some of the parameters in the item key (supported since Zabbix 6.0.17). 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* ###### Exemple 2 Proporcionant alguns paràmetres a la clau d'element (admès des de Zabbix 6.0.17). Paràmetres de configuració: ```bash Plugins.Postgres.Sessions.Session1.Uri=tcp://192.0.2.234:5432 Plugins.Postgres.Sessions.Session1.User=old_username Plugins.Postgres.Sessions.Session1.Password=session_password ``` [Clau d'element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[session1,new_username,,postgres]` Com a resultat de la configuració, l'agent es connectarà a PostgreSQL emprant els paràmetres següents: - Paràmetre URI de la sessió: *192.0.2.234:5432* - Usuari de la clau d'element: *new_username* - Mot de pas del paràmetre de la sessió (des que s'ha omès a la clau d'element): *session_password* - Nom de la base de dades per la clau d'element: *postgres* **Example 2** Restart the host by using IPMI control. |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'IPMI'| |*Command*|reset| ##### Exemple 2 Reiniciar l'equip emprant un control IPMI. |Paràmetre de l'script|Valor| |--|--------| |*Àmbit*|'Acció d'operació'| |*Tipus*|'IPMI'| |*Comanda*|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'. ##### Exemple 2 Enviament d'una notificació amb endarreriment sobre un problema de llarga data. Configura: - A la pestanya Operacions, establiu la *durada predeterminada de la passa de l'operació* a "10 h" (10 hores) - Estableix les passes d'escalada a *De* '2' *A* '2' {width="600"} No s'enviarà una notificació fins a l'etapa 2 de l'escenari d'escalada o 10 hores després de l'inici del problema. Podeu personalitzar el text del missatge amb alguna cosa com "El problema té més de 10 hores". ##### 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) ```{=html} <!-- --> ``` { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } - Received: ```{=html} <!-- --> ``` { "_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` ##### Exemple 2 Enviar les peticions POST simples per extreure les dades de serveis com ara Elasticsearch: - Crear un element POST amb l'URL : `http://localhost:9200/str/values/_search?scroll=10s` - Configurar el cos POST seguint per obtindre la càrrega del processador (mitjana 1 min per nucli) ```{=html} <!-- --> ``` { "query": { "bool": { "must": [{ "match": { "itemid": 28275 } }], "filter": [{ "range": { "clock": { "gt": 1517565836, "lte": 1517566137 } } }] } } } - Reçu : ```{=html} <!-- --> ``` { "_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 } }] } } - Emprem ara una etapa de pre-tractament JSONPath per obtindre el valor de l'element: `$.hits.hits[0]._source.value` ##### Example 2 ***Step 1*** Using host metadata to allow some basic protection against unwanted hosts registering. ##### Exemple 2 ***Passa 1*** Emprar metadades d'equip per permetre una protecció de base contra l'enregistrament dels equips que no volem pas. ##### Example 2 Sum of latest values of all items matching net.if.in\[\*\] on the host. sum(last_foreach(/host/net.if.in[*])) ##### Exemple 2 Suma dels darrers valors de tots els elements que corresponen a net.if.in\[\*\] sota l'equip. 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. ##### Exemple 2 Per crear un trigger "Error de l'escenari web" amb una descripció útil del problema al nom del trigger, podeu definir un trigger amb el nom següent: Escenari web fallit "Escenari": {ITEM.VALUE} I l'expressió trigger: length(last(/host/web.test.error[Scenario]))>0 and last(/host/web.test.fail[Scenario])>0 Assegureu-vos de substituir "Escenari" pel nom real del vostre escenari. ##### 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 ::: ##### Exemple 2 Ús d'una macro d'equip al trigger "La càrrega del processador és molt alta": `last(/ca_001/system.cpu.load[,avg1])>{$MAX_CPULOAD}` Aquest trigger es crearia a la plantilla, no es modificaria en equips individuals. ::: notetip Si voleu emprar la quantitat de valors com a paràmetre de funció (per exemple, **max(/host/key,\#3)**), incloeu el signe de lletra a la definició de macro com aquesta: SOME\_PERIOD => \#3 ::: ##### Example 2 www.example.com is overloaded. 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. ##### Exemple 2 www.example.com és sobrecarregat. last(/www.example.com/system.cpu.load[all,avg1])>5 o min(/www.example.com/system.cpu.load[all,avg1],10m)>2 L'expressió és certa quan la càrrega actual de la CPU és superior a 5 o la càrrega de la CPU ha estat superior a 2 en els darrers 10 minuts. ##### Example 3 Average processor load of host group 'MySQL Servers'. avg(last_foreach(/*/system.cpu.load[,avg1]?[group="MySQL Servers"])) ##### Exemple 3 Càrrega mitjana de processador del grup d'equips 'MySQL Servers'. 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]) ##### Exemple 3 Càlcul de l'amplada de banda total de l'eth0. Suma de dues funcions: 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:  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"} ##### Exemple 3 Verificar si l'API Zabbix és viva, emprant [apiinfo.version](/manual/api/reference/apiinfo/version). - Configuració de l'element:  Veieu que l'ús del mètode POST amb les dades JSON, la definició de les capçaleres de petició i l'enviament només de les capçaleres: - Pre-tractament del valor d'element amb una expressió regular per obtindre el codi HTTP:  - Verificació del resultat a *Darreres dades*: {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* ###### Exemple 3 Recollint una mètrica emprant els paràmetres de configuració per defecte. Paràmetres de configuració: ```bash Plugins.Postgres.Default.Uri=tcp://192.0.2.234:5432 Plugins.Postgres.Default.User=zabbix Plugins.Postgres.Default.Password=password ``` [Clau d'element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2): `pgsql.ping[,,,postgres]` Com a resultat de la configuració, l'agent es connectarà a PostgreSQL emprant els paràmetres següents: - URI per defecte: *192.0.2.234:5432* - Usuari per defecte: *zabbix* - Mot de pas per defecte: *password* - Nom de la base de dades per la clau d'element: *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:  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. ##### Exemple 3 Escala el problema al cap. En el primer exemple anterior, hem configurat l'enviament de missatges programats als administradors de MySQL. En aquest cas, els administradors rebran quatre missatges abans que el problema s'escali al gestor de bases de dades. Tingueu en compte que el gestor només rebrà un missatge si encara no s'ha reconegut el problema, és a dir, ningú hi treballa. {width="600"} Detalls de l'operació 2:  Tingueu en compte l'ús de la macro {ESC.HISTORY} al missatge personalitzat. La macro contindrà informació sobre totes les passes executades prèviament en aquesta escalada, com ara les notificacions enviades i les ordres executades. ##### Example 3 /etc/passwd has been changed. 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. ##### Exemple 3 /etc/passwd ha estat modificat. last(/www.example.com/vfs.file.cksum[/etc/passwd],#1)<>last(/www.example.com/vfs.file.cksum[/etc/passwd],#2) L'expressió és certa quan el valor de la suma de comprovació /etc/passwd anterior difereix del més recent. Expressions similars poden ésser útils per monitorar els canvis en fitxers importants, com ara /etc/passwd, /etc/inetd.conf, /kernel, etc. ##### 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] ##### Exemple 3 Quantes línies coincideixen amb una expressió regular d'un fitxer? UserParameter=wc[*],grep -c "$2" $1 Aquest paràmetre es pot emprar per calcular el nombre de línies d'un fitxer. 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 ##### Exemple 3 Missatge: Darrer valor: {?last(/{HOST.HOST}/{ITEM.KEY})} MAX per 15 minuts: {?max(/{HOST.HOST}/{ITEM.KEY},15m)} MIN per 15 minuts: {?min(/{HOST.HOST}/{ITEM.KEY},15m)} Després de rebre el missatge, aquest es canviarà per quelcom com ara: Darrer valor: 1.45 MAX per 15 minuts: 2.33 MIN per 15 minuts: 1.01 **Example 3** Power off the host by using IPMI control. |Script parameter|Value| |--|--------| |*Scope*|'Action operation'| |*Type*|'IPMI'| |*Command*|power off| **Exemple 3** Apagar l'equip emprant un control IPMI. |Paràmetre de l'script|Valor| |--|--------| |*Àmbit*|'Acció d'operació'| |*Tipus*|'IPMI'| |*Comanda*|power off| ##### 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. ##### Exemple 3 Per crear un trigger "Aplicació web lenta", podeu definir una expressió trigger: last(/host/web.test.in[Scenario,,bps]) <10000 Assegureu-vos de substituir "Escenari" pel nom real del vostre escenari. ##### 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()**. ##### Exemple 3 Ús de dues macros al trigger "La càrrega de CPU és molt alta": `min(/ca_001/system.cpu.load[,avg1],{$CPULOAD_PERIOD})>{$MAX_CPULOAD}` Veieu que una macro es pot emprar com a paràmetre de la funció de trigger; en aquest exemple, la funció **min()**. ##### Example 4 5-minute average of the number of queries per second for host group 'MySQL Servers'. avg(avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)) ##### Exemple 4 Mitjana de 5 minuts del nombre de peticions per segon del grup d'equips 'MySQL Servers'. 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"} ##### Exemple 4 Un escenari més complex. Després de diversos missatges als administradors de MySQL i una escalada al responsable, Zabbix intentarà reiniciar la base de dades MySQL. Això passarà si el problema ha existit durant les 2:30 i no s'ha reconegut. Si el problema persisteix, després de 30 minuts més, Zabbix enviarà un missatge a tots els usuaris convidats. Si això no resol el problema, després d'una hora més Zabbix reiniciarà el servidor amb la base de dades MySQL (segona ordre remota) mitjançant ordres IPMI. {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) ##### Exemple 4 Càlcul del percentatge de tràfic entrant. Expressió més complexa: 100*last(//net.if.in[eth0,bytes])/(last(//net.if.in[eth0,bytes])+last(//net.if.out[eth0,bytes])) Veieu també: [Exemples de càlculs agregats](/manual/config/items/itemtypes/calculated/aggregate#usage_examples) ##### 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. ##### Exemple 4 Missatge: http://<ip_o_nom_del_servidor>/zabbix/tr_events.php?triggerid={TRIGGER.ID}&eventid={EVENT.ID} Quan rebeu el missatge, aquest conté un enllaç a la pàgina *Detalls de l'esdeveniment*, que proporciona informació sobre l'esdeveniment, el seu trigger i una llista d'esdeveniments recents generada pel mateix trigger. ##### Example 4 Retrieving weather information by connecting to the Openweathermap public service. - Configure a master item for bulk data collection in a single JSON:  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"} ##### Exemple 4 Recuperació dels informes meteorològics connectant al servei públic Openweathermap. - Configurar un element principal per la recollida de dades en bloc en un sol JSON:  Veieu que emprem macros als camps de petició. Veieu l'API [Openweathermap](https://openweathermap.org/current) per sapiguer com omplir-les. Exemple de codi JSON retornat en resposta a l'agent HTTP: ``` {.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 } } ``` La següent tasca consisteix en configurar els elements dependents que extreuen les dades del JSON. - Configureu un element dependent per la humitat:  Altres mètriques meteorológiques com ara la 'Temperatura' s'afegeixen de la mateixa manera. - Exemple de pre-tractament del valor de l'element dependent amb JSONPath:  - Verifiqueu el resultat de les dades meteorològiques a *Darreres dades*: {width="600"} ##### Example 4 Someone is downloading a large file from the Internet. Use of function min: 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. ##### Exemple 4 Algú baixa un fitxer gran d'Internet. Emprant la funció min: min(/www.example.com/net.if.in[eth0,bytes],5m)>100K L'expressió és certa quan el nombre d'octets rebuts a eth0 és superior a 100 Ko en els darrers 5 minuts. ##### 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` ##### Exemple 4 Sincronització de la condició de no disponibilitat de l'agent amb l'interval d'actualització de l'element: - definit la macro {$INTERVAL} i emprar-la a l'interval d'actualització de l'element; - emprar {$INTERVAL} com a paràmetre del trigger de no disponibilitat de l'agent : `nodata(/ca_001/agent.ping,{$INTERVAL})=1` ##### Example 5 An escalation with several operations assigned to one step and custom intervals used. 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, 1:30 after the problem starts - to Database manager at 2:00 and 2:10 (and not at 3:00; seeing that steps 5 and 6 overlap with the next operation, the shorter custom step duration of 10 minutes in the next operation overrides the longer step duration of 1 hour tried to set here) - to Zabbix administrators at 2:00, 2:10, 2:20 after the problem starts (the custom step duration of 10 minutes working) - to guest users at 4:00 hours after the problem start (the default step duration of 30 minutes returning between steps 8 and 11) ##### Exemple 5 Una escalada amb múltiples operacions assignades a una passa i intervals personalitzats emprats. La durada predeterminada de la passa d'operació és de 30 minuts. {width="600"} Les notificacions s'enviaran de la següent manera: - als administradors de MySQL 0:00, 0:30, 1:00, 1:30 després de l'inici del problema - al gestor de bases de dades a les 2:00 i a les 2:10 després de l'inici del problema (no a les 3:00; com que les passes 5 i 6 es superposen amb la següent operació, la durada de la passa personalitzada més curta de 10 minuts a l'operació següent anul·la la més llarga. La durada de la passa d'1 hora s'ha intentat establir aquí) - als administradors de Zabbix 2:00, 2:10, 2:20 després de l'inici del problema (la durada de la passa personalitzada de 10 minuts de feina) - als usuaris convidats 4:00 hores després de l'inici de l'emissió (la durada de l'etapa predeterminada de 30 minuts es revertirà entre les etapes 8 i 11) ##### Example 5 Average CPU load on all hosts in multiple host groups that have the specific tags. avg(last_foreach(/*/system.cpu.load?[(group="Servers A" or group="Servers B" or group="Servers C") and (tag="Service:" or tag="Importance:High")])) ##### Exemple 5 Càrrega mitjana de CPU de tots els equips a diversos grups d'equips que tenen unes etiquetes concretes. 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: 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. ##### Exemple 5 Els dos nodes del servidor SMTP agrupats són aturats. Tingueu en compte l'ús de dos equips diferents en una expressió: last(/smtp1.example.com/net.tcp.service[smtp])=0 i last(/smtp2.example.com/net.tcp.service[smtp])=0 L'expressió és certa quan els dos servidors SMTP siguin aturats a smtp1.example.com i 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 *Administration* → *Users* → *Media*; - 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* → *General* → *Macros*, if needed. ##### Exemple 5 Centralitzar la configuració de les hores de feina: - crear una macro global {$WORKING\_HOURS} igual a `1-5,09:00-18:00`; - emprar-la al camp *Horari laboral* a *Administració* → *General* → *GUI*; - emprar-la al camp *Quan sigui actiu* a *Administració* → *Usuaris* → *Suports*; - emprar-la per configurar una consulta més freqüent d'elements durant l'horari laboral:  - emprar-la an la condició d'acció *Període*; - ajustar el temps de treball a *Administració* → *General* → *Macros*, si cal. ##### 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). ```{=html} <!-- --> ``` - Configure a master item for bulk data collection:  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"} ##### Exemple 5 Connexió a la pàgina d'estat d'Nginx i obtindre les seves mètriques de forma massiva. - Configureu Nginx seguint la [guia oficial] (https://nginx.ru/en/docs/http/ngx_http_stub_status_module.html). ```{=html} <!-- --> ``` - Configureu un element principal per la recollida massiva de les dades:  Exemple de sortida d'estat de l'stub Nginx: Active connections: 1 Active connections: server accepts handled requests 52 52 52 Reading: 0 Writing: 1 Waiting: 0 La següent tasca consisteix en configurar els elements dependents que extreuen les dades. - Configureu un exemple d'element dependent per les peticions per segon:  - Exemple de pre-tractament del valor de l'element dependent amb una expressió regular `el servidor accepta les peticions tractades\s+([0-9]+) ([0-9]+) ([0-9]+)`: {width="600"} - Verifiqueu el resultat complet del mòdul stub a *Darreres dades*: {width="600"} ##### 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)) ##### Exemple 5 Informar sobre els valors de diversos equips en un trigger. Missatge: Nom del problema: {TRIGGER.NAME} Expressió trigger: {TRIGGER.EXPRESSION} 1. Valor de l'element a {HOST.NAME1}: {ITEM.VALUE1} ({ITEM.NAME1}) 2. Valor de l'element a {HOST.NAME2}: {ITEM.VALUE2} ({ITEM.NAME2}) Quan rebeu el missatge, el missatge es canviarà per alguna cosa com ara: Nom del problema: la càrrega del processador és massa alta en un equip local Expressió trigger: last(/Myhost/system.cpu.load[percpu,avg1])>5 o last(/Myotherhost/system.cpu.load[percpu,avg1])>5 1. Valor de l'article a Myhost: 0,83 (càrrega del processador (1 min de mitjana per nucli)) 2. Valor de l'element a Myotherhost: 5.125 (càrrega del processador (1 min de mitjana per nucli)) ##### Example 6 Calculation used on the latest item value sums of a whole host group. sum(last_foreach(/*/net.if.out[eth0,bytes]?[group="video"])) / sum(last_foreach(/*/nginx_stat.sh[active]?[group="video"])) ##### Exemple 6 Càlcul emprat sota les darreres sumes de valor d'element d'un grup d'equips sencer. 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 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 ::: noteimportant Separate notification macros for the original problem event and recovery event are supported since Zabbix 2.2.0. ::: ##### Exemple 6 Es reben els detalls de l'esdeveniment problema i l'esdeveniment de recuperació en un missatge de [recuperació](/manual/config/notifications/action/recovery_operations): Missatge: Assumpte: Identificador de l'esdeveniment: {EVENT.ID} Valor de l'esdeveniment: {EVENT.VALUE} Estat de l'esdeveniment: {EVENT.STATUS} Hora de l'esdeveniment: {EVENT.TIME} Data de l'esdeveniment: {EVENT.DATE} Edat de l'esdeveniment: {EVENT.AGE} Confirmació de l'esdeveniment: {EVENT.ACK.STATUS} Historial d'actualitzacions d'esdeveniments: {EVENT.UPDATE.HISTORY} Recuperació: Identificador de l'esdeveniment: {EVENT.RECOVERY.ID} Valor de l'esdeveniment: {EVENT.RECOVERY.VALUE} Estat de l'esdeveniment: {EVENT.RECOVERY.STATUS} Hora de l'esdeveniment: {EVENT.RECOVERY.TIME} Data de l'esdeveniment: {EVENT.RECOVERY.DATE} Dades operatives: {EVENT.OPDATA} Quan rebeu el missatge, les macros es canviaran per alguna cosa com ara: Assumpte: Identificador de l'esdeveniment: 21874 Valor de l'esdeveniment: 1 Estat de l'esdeveniment: PROBLEMA Hora de l'esdeveniment: 13:04:30 Data de l'esdeveniment: 02/01/2018 Edat de l'esdeveniment: 5m Reconeixement de l'esdeveniment: Sí Historial d'actualitzacions d'esdeveniments: 02.01.2018 13:05:51 "John Smith (administrador)" Accions: reconegudes. Recuperació: Identificador de l'esdeveniment: 21896 Valor de l'esdeveniment: 0 Estat de l'esdeveniment: OK Hora de l'esdeveniment: 13:10:07 Data de l'esdeveniment: 02/01/2018 Dades operatives: el valor actual és 0,83 ::: noteimportant Des de Zabbix 2.2.0 s'admeten macros de notificació separades per a l'esdeveniment de problema original i l'esdeveniment de recuperació. ::: ##### 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. ##### Exemple 6 Emprar la macro del prototip d'equip per configurar coses per als equips descoberts: - en un prototip d'equip, establiu la macro d'usuari {$SNMPVALUE} amb la macro {\#SNMPVALUE} de [descoberta de baix nivell](/manual/config/macros/lld_macros) com a valor:  - assigneu la plantilla *Generic SNMPv2* al prototip d'equip; - empreu {$SNMPVALUE} al camp *SNMP OID* dels elements de plantilla *Generic SNMPv2*. ##### Example 6 Zabbix agent needs to be upgraded. Use of function find(): find(/example.example.com/agent.version,,"like","beta8")=1 The expression is true if Zabbix agent has version beta8. ##### Exemple 6 S'ha d'actualitzar l'agent Zabbix. Emprant la funció find(): find(/example.example.com/agent.version,,"like","beta8")=1 L'expressió és certa si l'agent de Zabbix és a la versió beta8. ##### Example 7 Server is unreachable. 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. ##### Exemple 7 El servidor és inaccessible. count(/example.example.com/icmpping,30m,,"0")>5 L'expressió és certa si l'equip "example.example.com" no és accessible després de 5 cops durant els darrers 30 minuts. ##### Example 7 The total number of unsupported items in host group 'Zabbix servers'. sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ##### Exemple 7 Nombre total d'elements no admesos al grup d'equips 'Zabbix servers'. sum(last_foreach(/*/zabbix[host,,items_unsupported]?[group="Zabbix servers"])) ##### Example 8 No heartbeats within last 3 minutes. Use of function nodata(): 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. ##### Exemple 8 Cap heartbeat durant els darrers 3 minuts. Emprant la funció nodata(): nodata(/example.example.com/tick,3m)=1 Per emprar aquest trigger, "tick" s'ha de definir com un element Zabbix [trapper](/manual/config/items/itemtypes/trapper). L'equip hauria d'enviar periòdicament dades d'aquest element mitjançant zabbix\_sender. Si no es reben dades en 180 segons, el valor trigger es converteix en PROBLEMA. *Tingueu en compte* que "nodata" es pot emprar per a qualsevol tipus d'element. ##### Example 9 CPU activity at night time. Use of function time(): 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). ##### Exemple 9 Activitat de la CPU a la nit. Emprant la funció time(): min(/Zabbix server/system.cpu.load[all,avg1],5m)>2 and time()<060000 El trigger només pot canviar el seu estat a problema en horari nocturn (00:00-06:00). ##### Example configuration for Apache # .. ProxyPass "/" http://host/zabbix/ ProxyPassReverse "/" http://host/zabbix/ ProxyPassReverseCookiePath /zabbix / ProxyPassReverseCookieDomain host zabbix.example.com # .. ##### Exemple de configuració per a Apache # .. 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/; # .. ##### Exemple de configuració per a nginx # .. 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: HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"] the index number will be looked up here: ... 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: HOST-RESOURCES-MIB::hrSWRunPerfMem.5388 = INTEGER: 31468 KBytes #### Exemple Obtindre l'ús de la memòria dels processos *apache*. Si emprem aquesta sintaxi d'OID : HOST-RESOURCES-MIB::hrSWRunPerfMem["index","HOST-RESOURCES-MIB::hrSWRunPath", "/usr/sbin/apache2"] El nombre d'índex es cercarà aquí: ... 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" ... Ja tenim l'index, 5388. L'index s'afegirà a l'OID de dades per tal de rebre el valor que ens interessa: 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. 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: 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. ##### Exemple de dependències múltiples Per exemple, un equip (equip) és darrere d'un encaminador (encaminador2) i l'encaminador2 és darrere d'un altre encaminador (encaminador1). Zabbix - Router1 - Router2 - Equip Si l'encaminador 1 és caigut, òbviament, l'equip i l'encaminador 2 també no són accessibles, però no volem rebre les tres notificacions de que l'equip, l'encaminador 1 i l'encaminador 2 estan caigudes. Per tant, en aquest cas, definim dues dependències: El trigger "L'equip és caigut" depèn del trigger "L'encaminador 2 és apagat". El trigger "L'encaminador 2 és caigut" depèn del trigger "L'encaminador 1 és caigut". Abans de canviar l'estat del trigger "L'equip és caigut", Zabbix comprovarà les dependències de trigger corresponents. Si en troba i un d'aquests triggers és en estat "Problema", l'estat del trigger no canviarà i, per tant, no s'executaran accions i no s'enviaran notificacions. Zabbix realitza aquesta comprovació de forma recursiva. Si l'encaminador1 o l'encaminador2 no és accessible, el trigger de l'equip no s'actualitzarà. Example of using runtime control to reload the server configuration cache: zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload Examples of using runtime control to gather diagnostic information: # 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: zabbix_server -R snmp_cache_reload Example of using runtime control to trigger execution of housekeeper: zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute Examples of using runtime control to change log level: # 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: zabbix_server -R ha_set_failover_delay=10s Exemple d'ús del control en temps d'execució per tornar a carregar la memòria cau de configuració del servidor: zabbix_server -c /usr/local/etc/zabbix_server.conf -R config_cache_reload Exemples d'ús del control en temps d'execució per recopilar informació de diagnòstic: Recollir tota la informació de diagnòstic disponible al fitxer de registre del servidor: zabbix_server -R diaginfo Recollir les estadístiques de la memòria cau de l'historial al fitxer de registre del servidor: zabbix_server -R diaginfo=historycache Exemple d'ús del control de temps d'execució per tornar a carregar la memòria cau SNMP: zabbix_server -R snmp_cache_reload Exemple d'ús del control d'execució per activar l'execució de neteja: zabbix_server -c /usr/local/etc/zabbix_server.conf -R housekeeper_execute Exemples d'ús del control d'execució per canviar el nivell de registre: Pujar el nivell de registre de tots els processos: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase Pujar el nivell de registre del segon procés d'enquesta: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=poller,2 Pujar el nivell de registre del procés amb PID 1234: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_increase=1234 Baixar el nivell de registre de tots els processos de sondeig http: zabbix_server -c /usr/local/etc/zabbix_server.conf -R log_level_decrease="http poller" Exemple de configuració del retard de la migració per error d'HA a un mínim de 10 segons: zabbix_server -R ha_set_failover_delay=10s *Example:* Problem *Web camera 3 is down* has tags `type:video surveillance`, `floor:1st` and `name:webcam 3` and status *Warning* The service **Web camera 3** has the only problem tag specified: `name:webcam 3` {width=600} 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:2nd`, its status would not be changed, when the problem is detected, because the conditions are only partially met. *Exemple:* Problema *La càmera web 3 ha caigut* té les etiquetes `type:videosurveillance`, `floor:1st` i `name:webcam 3` i un estat *Avís* El servei **webcam 3** té l'única etiqueta de problema especificada: `name:webcam 3` {width=600} L'estat del servei canviarà de *Correcte* a *Avís* quan es detecti aquest problema. Si el servei **Càmera web 3** tingués etiquetes de problema `name:webcam 3` i `floor:2nd`, el seu estat no canviaria, quan es detecti el problema, perquè les condicions només es compleixen parcialment. ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples ### Examples ### Exemples #### Examples #### Exemples #### Examples #### Exemples #### Examples #### Exemples #### Examples #### Exemples #### Examples #### Exemples #### 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)` #### Exemples i tractament d'errades Per rebre un avís quan sou a punt de quedar-vos sense espai al disc lliure al vostre equip, podeu emprar un trigger com aquest: timeleft(/host/vfs.fs.size[/,free],1h,0)<1h Tanmateix, el codi d'error -1 pot activar-se i posar el trigger en un estat problemàtic. En general, és bo perquè rebeu un avís que les vostres prediccions no funcionen correctament i hauríeu d'investigar-les més per esbrinar per què. Però de vegades això pot ser problemàtic perquè -1 només pot significar que no hi havia dades sobre l'espai lliure de disc de l'equip obtingudes durant l'última hora. Si obteniu massa falsos positius, penseu a emprar un trigger més complexe ^[5](#footnotes)^: timeleft(/host/vfs.fs.size[/,free],1h,0)<1h i timeleft(/host/vfs.fs.size[/,free],1h,0)<>-1 La situació és una mica més difícil amb **forecast**. Primer, -1 pot o no posar el trigger en un estat problemàtic depenent de si teniu o no una expressió com `forecast(/host/item,(...))<...` o com `forecast(/ host/element,(...))>...` A més, -1 pot ser una predicció vàlida si és normal que el valor de l'element sigui negatiu. Però la probabilitat d'això en una situació real és insignificant (veieu com funciona l'[operador **=**](/manual/config/triggers/expression)). Així que afegiu `... o forecast(/host/item,(...))=-1` o `... i forecast(/host/item,(...))<>-1` respectivament si o no voleu tractar -1 com un problema. #### Notes al peu ^**1**^ Per exemple, un trigger simple com `timeleft(/host/item,1h,X) <1h` pot entrar en un estat problemàtic quan el valor de l'element s'acosta a X i, de sobte, recuperar-se un cop arribat al valor X. Si el problema és que el valor de l'element és inferior a X, empreu: `last(/host/item) < X o timeleft(/host/item,1h,X) <1h`. Si el problema és que el valor de l'element és superior a X, empreu: `last(/host/item) > X o timeleft(/host/item,1h,X) <1h` ^**2**^ el grau del polinomi pot ésser entre 1 i 6, *polinomi1* equival a *lineal*. Tanmateix, empreu polinomis de grau superior [amb compte](https://ca.wikipedia.org/wiki/Fenomen_de_Runge). Si el període d'avaluació conté menys punts dels necessaris per determinar els coeficients del polinomi, el grau del polinomi es reduirà (per exemple, es demana *polinomi5*, però només hi ha 4 punts, per tant, *polinomi3* s'ajustarà). ^**3**^ per exemple, ajustar funcions *exponencial* o *potència* implica calcular el log() dels valors dels elements. Si les dades contenen zeros o nombres negatius, obtindreu un error perquè log() només es defineix per a valors positius. ^**4**^ Per als ajustos *lineal*, *exponencial*, *logarítmic* i *potència*, tots els càlculs necessaris es poden escriure de manera explícita. Per a *polinomi*, només el *valor* es pot calcular sense cap passa addicional. Calcular *mitjana* implica calcular el polinomi antiderivat (de manera analítica). Calcular *max*, *min* i *delta* implica calcular la derivada polinomial (analíticament) i trobar-ne les arrels (numèricament). La resolució de f(t) = 0 implica trobar arrels polinomials (numèricament). ^**5**^ però en aquest cas -1 pot fer que el vostre trigger es recuperi de l'estat problema. Per ésser totalment protegit, empreu:`timeleft(/host/vfs.fs.size[/,free],1h,0)<1h i ({TRIGGER.VALUE}=0 i timeleft(/host/vfs.fs.size) [/,free],1h,0)<>-1 o {TRIGGER.VALUE}=1)` #### Examples Examples here illustrate how you can use macros in messages. #### Exemples Els exemples ensenyen com podeu emprar les macros dins els missatges. #### Examples Examples of [global scripts](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) that may be used as remote commands in action operations. #### Exemples Es poden emprar exemples d'[scripts globals](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) com a comandes remotes dins l'operació d'acció. #### 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" ``` #### Exemples Aquí hi ha alguns extractes de codi que ensenyen com afegir una capçalera de protocol Zabbix a les dades que volem enviar dins l'ordre per obtindre el paquet que hem d'enviar a Zabbix, per tal que sigui interpretat correctament. Aquestes mostres de codi suposen que les dades no són superiors a 1Go i, per tant, el format de paquet gros no s'empra pas. ##### 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" ``` ##### 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| ##### Exemples Passem per dos exemples més pràctics de creació de regles LLD amb l'ús de Mbean. Per entendre millor la diferència entre una regla LLD que recull Mbeans i una regla LLD que recull atributs Mbean, consulteu la taula següent: | | | | |---|---|---| |**MBean1**|**MBean2**|**MBean3**| |MBean1Attribute1|MBean2Attribute1|MBean3Attribute1| |MBean1Attribute2|MBean2Attribute2|MBean3Attribute2| |MBean1Attribute3|MBean2Attribute3|MBean3Attribute3| #### Examples :::noteclassic The commands listed below are for Docker Compose V2. If you are using Docker Compose V1, replace `docker compose -f` with `docker-compose -f` ::: **Example 1** # git checkout 6.0 # docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d The command will download latest Zabbix 6.0 images for each Zabbix component and run them in detach mode. ::: noteimportant Do not forget to download `.env_<type of component>` files from github.com official Zabbix repository with compose files. ::: **Example 2** # git checkout 6.0 # docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d The command will download base image Ubuntu 20.04 (focal), then build Zabbix 6.0 components locally and run them in detach mode. #### Exemples :::noteclassic Les ordres que es mostren a continuació són per a Docker Compose V2. Si empreu Docker Compose V1, substituïu "docker compose -f" per "docker-compose -f" ::: **Exemple 1** # git checkout 6.0 # docker compose -f ./docker-compose_v3_alpine_mysql_latest.yaml up -d L'ordre descarregarà les darreres imatges de Zabbix 6.0 per a cada component Zabbix i les executarà en mode de separació. ::: noteimportant No us oblideu de descarregar els fitxers `.env_<tipus de component>` del dipòsit oficial de Zabbix de github.com amb fitxers de redacció. ::: **Exemple 2** # git checkout 6.0 # docker compose -f ./docker-compose_v3_ubuntu_mysql_local.yaml up -d L'ordre descarregarà la imatge base Ubuntu 20.04 (focal), després crearà components de Zabbix 6.0 localment i els executarà en mode de separació. ##### Examples Numeric (unsigned) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"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"],"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"],"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"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2} ##### Exemples Valor numèric (no signat): {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519304285,"ns":123456789,"value":1,"type":3} Valor numèric (flotant): {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":4,"name":"CPU Load","clock":1519304285,"ns":123456789,"value":0.1,"type":0} Caràcter, valor de text: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":2,"name":"Agent version","clock":1519304285,"ns":123456789,"value":"3.4.4","type":4} Valor de registre: {"host":{"host":"Host A","name":"Host A visible"},"groups":["Group X","Group Y","Group Z"],"itemid":1,"name":"Messages in log file","clock":1519304285,"ns":123456789,"timestamp":1519304285,"source":"","severity":0,"eventid":0,"value":"log file message","type":2} ##### Examples Numeric (unsigned) value: {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"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"],"itemid":4,"name":"CPU Load","clock":1519311600,"count":60,"min":0.01,"avg":0.15,"max":1.5,"type":0} ##### Exemples Valor numèric (sense signe): {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"itemid":3,"name":"Agent availability","clock":1519311600,"count":60,"min":1,"avg":1,"max":1,"type":3} Valor numèric (flotant): {"host":{"host":"Host B","name":"Host B visible"},"groups":["Group X","Group Y","Group Z"],"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: 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. ##### Exemples de sintaxi correcta/incorrecta Les expressions (incloses les crides a funcions) no es poden pas emprar com a paràmetres d'històric, de tendència o de la [funció](/manual/appendix/functions) foreach. Tanmateix, les pròpies funcions poden emprar-se dins d'altres paràmetres de funció (no històriques). |Expressió|Exemple| |-|---------| |Vàlid|`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)))`| |No vàlid|`sum(/host/key,10+2)`<br>`sum(/host/key, avg(10,2))`<br>`sum(/host/key,last(/host/key2))`| Veieu que en una expressió com ara: sum(sum_foreach(//resptime[*],5m))/sum(count_foreach(//resptime[*],5m)) no es pot garantir que les dues parts de l'equació tinguin sempre el mateix conjunt de valors. Mentre una part de l'expressió és avaluada, pota arribar un valor nou per al període demanat, i llavors l'altra part de l'expressió tindrà un conjunt de valors diferent. #### 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. ::: #### Exemples de configuració de maquinari La taula proporciona exemples de configuració de maquinari, assumint una plataforma **Linux/BSD/Unix**. Aquests són exemples de mida i configuració de maquinari per començar. Cada instal·lació de Zabbix és única. Assegureu-vos de comparar el rendiment del vostre sistema Zabbix en un entorn de preparació o desenvolupament, de manera que pugueu entendre completament els vostres requisits abans d'implementar la instal·lació de Zabbix entorn de producció. |Mida de la instal·lació|Mètriques monitorades^**1**^|Nuclis de CPU/vCPU|Memòria<br>(Go)|Base de dades|Amazon EC2^**2**^| |-|-|-|-|-|-| |Small|1 000|2|8|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.large/m6g.large| |Mitjana|10 000|4|16|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL|m6i.xlarge/m6g.xlarge| |Gran|100 000|16|64|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.4xlarge/m6g.4xlarge| |Molt gran|1 000 000|32|96|MySQL Server,<br>Percona Server,<br>MariaDB Server,<br>PostgreSQL,<br>Oracle|m6i.8xlarge/m6g.8xlarge| ^**1**^ 1 mètrica = 1 element + 1 activador + 1 gràfic<br> ^**2**^ Exemple amb instàncies EC2 de propòsit general d'Amazon, emprant l'arquitectura ARM64 o x86_64. El tipus d'instància adequat com ara Càlcul/Memòria/Emgatzematge optimitzat s'hauria de triar durant l'avaluació i prova de la instal·lació de Zabbix abans de la instal·lació a l'entorn de producció. ::: noteclassic La configuració real depèn molt del nombre d'elements actius i les taxes d'actualització (veieu la secció [mida de la base de dades](#database-size) d'aquesta pàgina per obtindre més informació). És molt recomanable executar la base de dades en un espai separat per a instal·lacions grans. ::: ##### 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. ##### Exemples de paràmetres senzills d'usuaris Una comanda senzilla: UserParameter=ping,echo 1 L'agent retornarà sempre '1' per un element amb la clau 'ping'. Un exemple més complicat: UserParameter=mysql.ping,mysqladmin -uroot ping | grep -c alive L'agent retornarà '1', si el servidor MySQL és actiu, '0' - si no ho és. #### Examples of triggers #### Exemples de triggers ##### 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} ##### Exemples Problema: {"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"}]} Recuperació: {"clock":1519304345,"ns":987654321,"value":0,"eventid":43,"p_eventid":42} Problema (generació de diversos esdeveniments problemàtics): {"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"}]} Recuperació: {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":43} {"clock":1519304346,"ns":987654321,"value":0,"eventid":44,"p_eventid":42} ### Examples Request: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Exemples Petició: ``` {.java} { "jsonrpc": "2.0", "method": "autoregistration.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "tls_accept": "3" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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_configured": "0", "ldap_host": "", "ldap_port": "389", "ldap_base_dn": "", "ldap_search_attribute": "", "ldap_bind_dn": "", "ldap_case_sensitive": "1", "ldap_bind_password": "", "saml_auth_enabled": "0", "saml_idp_entityid": "", "saml_sso_url": "", "saml_slo_url": "", "saml_username_attribute": "", "saml_sp_entityid": "", "saml_nameid_format": "", "saml_sign_messages": "0", "saml_sign_assertions": "0", "saml_sign_authn_requests": "0", "saml_sign_logout_requests": "0", "saml_sign_logout_responses": "0", "saml_encrypt_nameid": "0", "saml_encrypt_assertions": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "8" }, "id": 1 } ``` ### Exemple Petició: ```json { "jsonrpc": "2.0", "method": "authentication.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "authentication_type": "0", "http_auth_enabled": "0", "http_login_form": "0", "http_strip_domains": "", "http_case_sensitive": "1", "ldap_configured": "0", "ldap_host": "", "ldap_port": "389", "ldap_base_dn": "", "ldap_search_attribute": "", "ldap_bind_dn": "", "ldap_case_sensitive": "1", "ldap_bind_password": "", "saml_auth_enabled": "0", "saml_idp_entityid": "", "saml_sso_url": "", "saml_slo_url": "", "saml_username_attribute": "", "saml_sp_entityid": "", "saml_nameid_format": "", "saml_sign_messages": "0", "saml_sign_assertions": "0", "saml_sign_authn_requests": "0", "saml_sign_logout_requests": "0", "saml_sign_logout_responses": "0", "saml_encrypt_nameid": "0", "saml_encrypt_assertions": "0", "saml_case_sensitive": "0", "passwd_min_length": "8", "passwd_check_rules": "8" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "authentication.update", "params": { "http_auth_enabled": 1, "http_case_sensitive": 0, "http_login_form": 1 }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": [ "http_auth_enabled", "http_case_sensitive", "http_login_form" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "autoregistration.update", "params": { "tls_accept": "3", "tls_psk_identity": "PSK 001", "tls_psk": "11111595725ac58dd977beef14b97461a7c1045b9a1c923453302c5473193478" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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": "365d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "90d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "housekeeping.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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": "365d", "hk_sessions_mode": "1", "hk_sessions": "365d", "hk_history_mode": "1", "hk_history_global": "0", "hk_history": "90d", "hk_trends_mode": "1", "hk_trends_global": "0", "hk_trends": "365d", "db_extension": "", "compression_status": "0", "compress_older": "7d" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "housekeeping.update", "params": { "hk_events_mode": "1", "hk_events_trigger": "200d", "hk_events_internal": "2d", "hk_events_discovery": "2d" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": [ "hk_events_mode", "hk_events_trigger", "hk_events_internal", "hk_events_discovery" ], "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "settings.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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", "ha_failover_delay": "1m", "geomaps_tile_provider": "OpenStreetMap.Mapnik", "geomaps_tile_url": "", "geomaps_max_zoom": "0", "geomaps_attribution": "" }, "id": 1 } ``` ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "settings.get", "params": { "output": "extend" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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", "ha_failover_delay": "1m", "geomaps_tile_provider": "OpenStreetMap.Mapnik", "geomaps_tile_url": "", "geomaps_max_zoom": "0", "geomaps_attribution": "" }, "id": 1 } ``` ### Examples Request: ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "settings.update", "params": { "login_attempts": "1", "login_block": "1m" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": [ "login_attempts", "login_block" ], "id": 1 } ``` ### Examples Request: ```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", "type": 3, "sessionid": "673b8ba11562a35da902c66cf5c23fa2" "debug_mode": 0, "userip": "127.0.0.1", "gui_access": 0 }, "id": 1 } ``` ::: noteclassic Response is similar to [User.login](/manual/api/reference/user/login) call response with "userData" parameter set to true (the difference is that user data is retrieved by session id and not by username / password). ::: ### Exemples Petició: ```json { "jsonrpc": "2.0", "method": "user.checkAuthentication", "params": { "sessionid": "673b8ba11562a35da902c66cf5c23fa2" }, "id": 1 } ``` Resposta: ```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", "type": 3, "sessionid": "673b8ba11562a35da902c66cf5c23fa2" "debug_mode": 0, "userip": "127.0.0.1", "gui_access": 0 }, "id": 1 } ``` ::: noteclassic La resposta és similar a la resposta de la crida [User.login](/manual/api/reference/user/login) amb el paràmetre "userData" establert a cert (amb la diferpencia que les dades d'usuari són retornades per l'ID de la sesió i no pas per nom d'usuari i paraula de pas). ::: ### 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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Rellotge*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Vista general de dades*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Geomapa*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Gràfic (clàssic)*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Prototip de gràfic*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Gràfic*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Valor d'element*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Arbre de navegació del mapa*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Mapa*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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 *Plain text* widget. For more information on configuring a dashboard, see [`dashboard.create`](/manual/api/reference/dashboard/create). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Text pla*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Equips amb problemes*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Problemes per gravetat*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Problemes*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Informe SLA*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Equips top*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Vista general de triggers*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *URL*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`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). ### Exemples Els exemples següents només tenen com a objectiu descriure la configuració dels objectes de camp del giny del tauler de control per al giny *Monitoratge Web*. Per obtindre més informació sobre la configuració d'un tauler, veieu [`dashboard.create`](/manual/api/reference/dashboard/create). #### Examples The following examples show common configuration patterns for `AllowKey` and `DenyKey`. #### Exemples Els exemples següents mostren patrons de configuració comuns per a `AllowKey` i `DenyKey`. #### Examples The ways in which macro functions can be used to customize macro values is illustrated in the following examples on received values: |Received value|Macro|Output| |----|----|----| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(2)}`|`24.34`| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(0)}`|`24`| |`12:36:01`|`{{TIME}.fmttime(%B)}`|`October`| |`12:36:01`|`{{TIME}.fmttime(%d %B,-1M/M)}`|`1 September`| |`123Log line`|`{{ITEM.VALUE}.regsub(^[0-9]+, Problem)}`|`Problem`| |`123 Log line`|`{{ITEM.VALUE}.regsub("^([0-9]+)", "Problem")}`|`Problem`| |`123 Log line`|`{{ITEM.VALUE}.regsub("^([0-9]+)", Problem ID: \1)}`|`Problem ID: 123`| |`Log line`|`{{ITEM.VALUE}.regsub(".*", "Problem ID: \1")}`|''Problem ID: ''| |`MySQL crashed errno 123`|`{{ITEM.VALUE}.regsub("^(\w+).*?([0-9]+)", " Problem ID: \1_\2 ")}`|'' Problem ID: MySQL\_123 ''| |`123 Log line`|`{{ITEM.VALUE}.regsub("([1-9]+", "Problem ID: \1")}`|`*UNKNOWN*` (invalid regular expression)| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}`|`customername`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}`|`1`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}` (invalid regular expression)| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}"}`|`{$MACRO:"customername"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \2)}"}`|`{$MACRO:"1"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}`|`{$MACRO:"{{#M}.regsub(\"(.*)_([0-9]+\", \1)}"}` (invalid regular expression)| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \1)}\"}"`|`"{$MACRO:\"customername\"}"`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \2)}\"}"`|`"{$MACRO:\"1\"}")`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \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.: `{{ITEM.VALUE}.regsub("(.*)", \1)}`<br> `{{ITEM.LASTVALUE}.regsub("(.*)", \1)}` See also: {ITEM.VALUE} and {ITEM.LASTVALUE} [macro details](/manual/appendix/macros/supported_by_location). #### Exemples Les maneres en què es poden emprar les funcions de macro per personalitzar els valors de macro s'il·lustra als exemples següents sobre valors rebuts: |Valor rebut|Macro|Sortida| |----|----|----| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(2)}`|`24.34`| |`24.3413523`|`{{ITEM.VALUE}.fmtnum(0)}`|`24`| |`12:36:01`|`{{TIME}.fmttime(%B)}`|`Octubre`| |`12:36:01`|`{{TIME}.fmttime(%d %B,-1M/M)}`|`1 de setembre`| |`123Línia de registre`|`{{ITEM.VALUE}.regsub(^[0-9]+, problema)}`|`Problema`| |`123 Línia de registre`|`{{ITEM.VALUE}.regsub("^([0-9]+)", "Problema")}`|`Problema`| |`123 Línia de registre`|`{{ITEM.VALUE}.regsub("^([0-9]+)", ID del problema: \1)}`|`ID del problema: 123`| |`Línia de registre`|`{{ITEM.VALUE}.regsub(".*", "ID del problema: \1")}`|''ID del problema: ''| |`MySQL ha fallat l'errno 123`|`{{ITEM.VALUE}.regsub("^(\w+).*?([0-9]+)", " ID del problema: \1_\2 ")}`| '' ID del problema: MySQL\_123 ''| |`123 Línia de registre`|`{{ITEM.VALUE}.regsub("([1-9]+", "ID del problema: \1")}`|`*DESCONEGUT*` (expressió regular no vàlida)| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \1)}`|`customername`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+)", \2)}`|`1`| |`customername_1`|`{{#IFALIAS}.regsub("(.*)_([0-9]+", \1)}`|`{{#IFALIAS}.regsub("(.*)_ ([0-9]+", \1)}` (expressió regular no vàlida)| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \1)}"}`|`{$MACRO: "nom del client"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+)\", \2)}"}`|`{$MACRO: "1"}`| |`customername_1`|`{$MACRO:"{{#IFALIAS}.regsub(\"(.*)_([0-9]+\", \1)}"}`|`{$MACRO:" {{#M}.regsub(\"(.*)_([0-9]+\", \1)}"}` (expressió regular no vàlida)| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \1)}\"}"` |`"{$MACRO:\"nom del client\"}"`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+)\\", \2)}\"}"` |`"{$MACRO:\"1\"}")`| |`customername_1`|`"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}"`| `"{$MACRO:\"{{#IFALIAS}.regsub(\\"(.*)_([0-9]+\\", \1)}\"}")` (expressió regular no vàlida) | ##### Visualitzant els valors complets dels elements Els valors llargs de les macros resoltes {ITEM.VALUE} i {ITEM.LASTVALUE} per als elements de text/registre es trunquen a 20 caràcters en algunes ubicacions de la interfície. Per veure els valors complets d'aquestes macros, podeu emprar funcions de macro, com ara: `{{ITEM.VALUE}.regsub ("(.*)", \1)}`<br> `{{ITEM.LASTVALUE}.regsub ("(.*)", \1)}` Veieu també els [detalls de les macros](/manual/appendix/macros/supported_by_location) {ITEM.VALUE} i {ITEM.LASTVALUE}. #### 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,,"{{ITEM.VALUE}.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 non-history function** String content: `\.+\"[a-z]+`<br> Expression: `concat("abc", "\\.\\\"[a-z]+")` Notice: - String parameters require escaping both for backslashes and quotation marks. **String parameter of history function** String content: `\.+\"[a-z]+`<br> Expression: `find(__ITEM_KEY__,,"regexp","\.+\\"[a-z]+")` Notice: - backslashes are not escaped; - quotation marks are escaped. **LLD macro function inside string parameter of non-history 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; **LLD macro function inside string parameter of history function** Regular expression: `\.+\"([a-z]+)`<br> LLD macro: `{{#MACRO}.iregsub("\.+\\"([a-z]+)", \1)}`<br> Expression: `find(__ITEM_KEY__,,"eq","{{#MACRO}.iregsub(\"\.+\\\"([a-z]+)\", \1)}")` Notice: - backslashes are not escaped; - quotation marks are escaped. **User macro with context inside string parameter of non-history 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). **User macro with context inside string parameter of history function** Regular expression: `\.+\"[a-z]+`<br> User macro with context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Expression: `find(__ITEM_KEY__,,"eq","{$MACRO:regex:\"\.+\\\"[a-z]+\"}")` Notice: - backslashes are not escaped; - quotation marks are escaped. **LLD macro function inside user macro context inside non-history 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. **LLD macro function inside user macro context inside history 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: `find(__ITEM_KEY__,,"eq","{$MACRO:\"{{#MACRO}.iregsub(\\"\.+\\\\"([a-z])+\\", \1)}\"}")` Notice: - backslashes are not escaped; - quotation marks are escaped. **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. #### Exemples **Macro d'usuari amb context** Expressió regular: `\.+\"[a-z]+`<br> Macro d'usuari amb context: `{$MACRO:regex:"\.+\\"[a-z]+"}` Avís: - Les barres invertides [no escapen](/manual/config/macros/user_macros_context#important-notes); - Les cometes escapen. **Funció macro dins del paràmetre clau de l'element** Expressió regular: `.+:(\d+)$`<br> Clau d'element: `net.tcp.service[tcp,,"{{ITEM.VALUE}.regsub(\".+:(\d+)$\",\1)}"]` Avís: - L'expressió regular dins de la funció macro `regsub` està entre cometes dobles (perquè conté parèntesis de tancament); - Les cometes al voltant de l'expressió regular s'escapen (perquè tot el tercer paràmetre d'element està entre cometes); - El tercer paràmetre clau d'element està entre cometes dobles perquè conté una coma. **Funció macro LLD** Expressió regular: `\.+\"[a-z]+`<br> Macro LLD: `{{#MACRO}.iregsub("\.+\\"[a-z]+", \1)}` Avís: - les barres invertides no escapen; - Les cometes escapen. **Funció de macro LLD dins del context de macro d'usuari** Expressió regular: `\.+\"[a-z]+`<br> Macro LLD: `{{#MACRO}.iregsub("\.+\\"[a-z]+", \1)}`<br> Macro d'usuari amb context: `{$MACRO:"{{#MACRO}.iregsub(\".+\\\"[a-z]+\", \1)}"}` Avís: - L'escapada de barra invertida per a LLD no canvia; - en inserir la macro LLD al context de la macro de l'usuari, hem de posar-la a la cadena: 1. S'afegeixen cometes al voltant de l'expressió macro; 2. Les cometes escapen; en total, s'introdueixen 3 barres invertides noves. **Paràmetre de cadena de funció no històrica** Contingut de la cadena: `\.+\"[a-z]+`<br> Expressió: `concat("abc", "\\.\\\"[a-z]+")` Avís: - Els paràmetres de cadena requereixen escapar tant de les barres inclinades inverses com de les cometes. **Paràmetre de cadena de la funció d'historial** Contingut de la cadena: `\.+\"[a-z]+`<br> Expressió: `find(__ITEM_KEY__,,"regexp","\.+\\"[a-z]+")` Avís: - les barres invertides no escapen; - Les cometes escapen. **Funció macro LLD dins del paràmetre de cadena de la funció no històrica** Expressió regular: `\.+\"[a-z]+`<br> Macro LLD: `{{#MACRO}.iregsub("\.+\\"[a-z]+", \1)}`<br> Expressió: `concat("abc, "{{#MACRO}.iregsub(\"\\.+\\\\\"[a-z]+\", \\1)}")` Avís: - Els paràmetres de cadena requereixen escapar tant de les barres inclinades inverses com de les cometes; - S'afegeix una altra capa d'escapament, perquè la macro només es resoldrà després que s'hagi desactivat la cadena; **Funció macro LLD dins del paràmetre de cadena de la funció d'historial** Expressió regular: `\.+\"[a-z]+`<br> Macro LLD: `{{#MACRO}.iregsub("\.+\\"[a-z]+", \1)}`<br> Expressió: `find(__ITEM_KEY__,,"eq","{{#MACRO}.iregsub(\"\.+\\\"[a-z]+\", \1)}")` Avís: - les barres invertides no escapen; - Les cometes escapen. **Macro d'usuari amb context dins del paràmetre de cadena de la funció no històrica** Expressió regular: `\.+\"[a-z]+`<br> Macro d'usuari amb context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Expressió: `concat("abc, "{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}")` Avís: - Igual que en l'exemple anterior, es necessita una capa addicional d'escapament; - Les barres invertides i les cometes només s'escapen per a l'escapament de nivell superior (a causa que és un paràmetre de cadena). **Macro d'usuari amb context dins del paràmetre de cadena de la funció d'historial** Expressió regular: `\.+\"[a-z]+`<br> Macro d'usuari amb context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Expressió: `find(__ITEM_KEY__,,"eq","{$MACRO:regex:\"\.+\\\"[a-z]+\"}")` Avís: - les barres invertides no escapen; - Les cometes escapen. **Funció de macro LLD dins del context de macro de l'usuari dins de la funció no històrica** Expressió regular: `\.+\"[a-z]+`<br> Macro LLD: `{{#MACRO}.iregsub("\.+\\"[a-z]+", \1)}`<br> Macro d'usuari amb context: `{$MACRO:"{{#MACRO}.iregsub(\".+\\\"[a-z]+\", \1)}"}`<br> Expressió: `concat("abc, "{$MACRO:\"{{#MACRO}.iregsub(\\\".+\\\\\\\"[a-z]+\\\", \\1) }\"}")` Observeu les tres capes d'escapament: 1. Per a la funció macro LLD, sense escapar de barres invertides; 2. Per a macro d'usuari amb context, sense escapar de barres invertides; 3. Per al paràmetre de cadena d'una funció, amb escapament de barres invertides. **Funció de macro LLD dins del context de macro de l'usuari dins de la funció d'historial** Expressió regular: `\.+\"[a-z]+`<br> Macro LLD: `{{#MACRO}.iregsub("\.+\\"[a-z]+", \1)}`<br> Macro d'usuari amb context: `{$MACRO:"{{#MACRO}.iregsub(\".+\\\"[a-z]+\", \1)}"}`<br> Expressió: `find(__ITEM_KEY__,,"eq","{$MACRO:\"{{#MACRO}.iregsub(\\".+\\\\"[a-z]+\\", \1)}\ "}")` Avís: - les barres invertides no escapen; - Les cometes escapen. **Macro d'usuari amb context dins de la cadena** Expressió regular: `\.+\"[a-z]+`<br> Macro d'usuari amb context: `{$MACRO:regex:"\.+\\"[a-z]+"}`<br> Cadena interior d'alguna expressió, per exemple: `func(arg1, arg2, arg3)="{$MACRO:regex:\"\\.+\\\\\"[a-z]+\"}"` Avís: - Les cadenes també requereixen escapar de barra invertida; - Les cadenes també requereixen escapar de cometes; - De nou un cas amb 2 nivells d'escapament: 1. Escapada per al context de macro d'usuari sense escapar de barra invertida; 2. Escapada perquè és una cadena amb una barra invertida escapada. #### 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 #### Exemples Hores laborables. Dilluns - Divendres de 9h00 a 18h00 : 1-5,09:00-18:00 Horari de feina amb cap de setmana inclòs. Dilluns- Divendres de 9h00 a 18h00 i Dissabte, Diumenge de 10h00 a 16h00 : 1-5,09:00-18:00;6-7,10:00-16:00 ## EXAMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXEMPLES **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]"**\ **zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-agent-cert-issuer "CN=Signing CA,OU=Equip IT,O=Exemple Corp,DC=exemple,DC=com" --tls-agent-cert-subject "CN=server1,OU=IT operations,O=Example Corp,DC=example,DC=com" --tls-cert-file /home/zabbix/zabbix\_get.crt --tls-key-file /home/zabbix/zabbix\_get.key\ zabbix\_get -s 127.0.0.1 -p 10050 -k "system.cpu.load\[all,avg1\]" --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk** [ ]{#lbAH} ## EXAMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## EXEMPLES **zabbix\_js -s script-file.js -p example** [ ]{#lbAG} ## EXAMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of monitored host. Use monitored host and Zabbix server defined in agent configuration file. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Send **342.45** as the value for **mysql.queries** item of **Monitored Host** host using Zabbix server defined in agent configuration file. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Send values from file **data\_values.txt** to Zabbix server with IP **192.168.1.113**. Host names and keys are defined in the file. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Send a timestamped value from the commandline to Zabbix server, specified in the agent configuration file. Dash in the input data indicates that hostname also should be used from the same configuration file. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Send empty value of an item to the Zabbix server with IP address **192.168.1.113** on port **10000** from the commandline. Empty values must be indicated by empty double quotes. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with certificate. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Send **342.45** as the value for **mysql.queries** item in **Monitored Host** host to server with IP **192.168.1.113** using TLS with pre-shared key (PSK). [ ]{#lbAI} ## EXEMPLES **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -k mysql.queries -o 342.45**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip monitorat. Fa ús de l'equip monitorat i el servidor Zabbix definit a l'arxiu de configuració de l'agent de Zabbix. **zabbix\_sender -c /etc/zabbix/zabbix\_agentd.conf -s "Monitored Host" -k mysql.queries -o 342.45**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip **Monitored Host**, fent ús del servidor de Zabbix definit a l'arxiu de configuració de l'agent de Zabbix. \ **zabbix\_sender -z 192.168.1.113 -i data\_values.txt** \ Envia els valors de l'arxiu **data\_values.txt** cal ap servidor zabbix amb la IP **192.168.1.113**. El nom d'equips i les claus es defineixen a l'arxiu. \ **echo "- hw.serial.number 1287872261 SQ4321ASDF" | zabbix\_sender -c /usr/local/etc/zabbix\_agentd.conf -T -i -**\ Envia un valor de timestamp de la línia de comandes per al servidor Zabbix, definit a l'arxiu de configuració de l'agent de Zabbix. La barra a les dades d'entrada indica que el nom de l'equip també s'ha d'emprar al mateix arxiu de configuració. \ **echo '"Zabbix server" trapper.item ""' | zabbix\_sender -z 192.168.1.113 -p 10000 -i -**\ Envia un valor buit d'un element per al servidor Zabbix amb l'adreça IP **192.168.1.113** i el port **10000** des de la línia de comandes. Els valors buits s'han d'indicar amb cometes dobles. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect cert --tls-ca-file /home/zabbix/zabbix\_ca\_file --tls-cert-file /home/zabbix/zabbix\_agentd.crt --tls-key-file /home/zabbix/zabbix\_agentd.key**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip **Monitored Host** cap al servidor amb IP **192.168.1.113**, emprant certificat TLS. **zabbix\_sender -z 192.168.1.113 -s "Monitored Host" -k mysql.queries -o 342.45 --tls-connect psk --tls-psk-identity "PSK ID Zabbix agentd" --tls-psk-file /home/zabbix/zabbix\_agentd.psk**\ Envia **342.45** com a valor per a l'element **mysql.queries** de l'equip **Monitored Host** cap al servidor amb IP **192.168.1.113**, emprant TLS com a clau pre-compartida (PSK). [ ]{#lbAI} #### Example The following example demonstrates how to quickly setup VMware monitoring on Zabbix: - make sure that Zabbix server has been compiled with the required options (--with-libxml2 and --with-libcurl): the log file must contain "VMware monitoring: YES" during server startup. - set the StartVMwareCollectors option in Zabbix server configuration file to 2 or more - create a new host - set the host macros required for VMware authentication:  - link the host to the VMware service template:  - click on the **Add** button to save the host. #### Exemple L'exemple següent mostra com configurar ràpidament el monitoratge de VMware a Zabbix: - assegureu-vos de compilar el servidor Zabbix amb les opcions necessàries (--with-libxml2 i --with-libcurl): l'arxiu de registre ha de contindre "VMware monitoring: YES" quan engegui el servidor. - establiu l'opció StartVMwareCollectors al fitxer de configuració del servidor Zabbix a 1 o superior - creeu un nou equip - definiu les macros d'equips necessàries per a l'autenticació de VMware:  - associeu l'equip amb la plantilla de servei de VMware:  - Feu clic al botó **Afegir** per desar l'equip ### 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"), 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 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 16MB. For more details, see [data limits for LLD return values](/manual/discovery/low_level_discovery/notes#data-limits-for-return-values). ### Exemple El format JSON requerit s'il·lustra millor amb un exemple. Suposem que som executant un antic agent Zabbix 1.8 (un que no admet "vfs.fs.discovery"), però encara hem de descobrir sistemes de fitxers. Aquí hi ha un senzill script Perl per a Linux que descobreix sistemes de fitxers muntats i genera una cadena JSON, que inclou tant el nom com el tipus del sistema de fitxers. Una manera d'emprar-lo seria com a UserParameter amb la clau "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 Els símbols permesos per als noms de macro LLD són **0-9** , **A-Z** , **\_** , **.** Les lletres minúscules no s'admeten als noms. ::: Tot seguit es mostra un exemple de la seva sortida (reformatat per a més claredat). La cadena JSON per a comprovacions de decoberta personalitzades ha de seguir el mateix 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" } ] ``` A l'exemple anterior es requereix que les claus coincideixin amb els noms de macro LLD utilitzats en els prototips, l'alternativa és extreure els valors de macro LLD mitjançant JSONPath `{#FSNAME}` → `$.fsname` i `{#FSTYPE}` → ` $.fstype`, fent possible aquest script: ``` {.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"; ``` Tot seguit podeu veure un exemple de la seva sortida (reformatat per a més claredat). El JSON per a comprovacions de descoberta personalitzades ha de seguir el mateix 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" } ] ``` Aleshores, al camp "Filtre" de la regla de descoberta, podríem especificar "{\#FSTYPE}" com a macro i "rootfs|ext3" com a expressió regular. ::: noteclassic No cal que empreu els noms de macro FSNAME/FSTYPE amb regles LLD personalitzades, podeu emprar els noms que vulgueu. En cas que s'empri JSONPath, la fila LLD serà un element de matriu que pot ser un objecte, però també pot ser una altra matriu o un valor. ::: Tingueu en compte que, si feu servir un paràmetre d'usuari, el valor de retorn és limitat a 16Mo. Per obtindre més informació, consulteu [límits de dades per als valors de retorn d'LLD](/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": (?i)error  Chosen *Expression type*: "Result is TRUE". Characters "error" are matched. ##### Exemple amb un modificador de regex en línia Ús de l'expressió regular següent, inclòs un modificador en línia (?i) per fer coincidir els caràcters d'"error": (?i)error  *Tipus d'expressió* triat: "El resultat és CERT". Els caràcters d'"error" coincideixen. ### Example workflow The following section will walk you through some usage examples in more detail. ### Exemple de flux de treball La secció següent us guiarà per alguns exemples d'ús més detallats. #### 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. #### Passes d'execució :::noteclassic Per defecte, tots els scripts de Zabbix s'executen emprant l'intèrpret d'ordres *sh* i no és possible modificar l'intèrpret d'ordres predeterminat. Per emprar una shell diferent, podeu fer ús d'una solució alternativa: creeu un fitxer d'script i invoqueu aquest script durant l'execució de l'ordre. ::: La comanda/script s'executa de manera similar a les plataformes Unix i Windows: 1. Zabbix (el procés principal) crea un canal de comunicació 2. Zabbix estableix el canal com a sortida del procés fill que s'ha de crear 3. Zabbix crea un procés fill (executa l'ordre/script) 4. Es crea un nou grup de processos (a Unix) o una tasca (a Windows) per al procés fill. 5. Zabbix llegeix l'entrada fins que el temps d'espera o fins que ningú escrigui a l'altre extrem (s'han tancat TOTS els identificadors/els fitxers). Tingueu en compte que el procés fill pot crear diversos processos i acabar abans que surtin o tanquin el controlador/identificador del fitxer. 6. Si no s'ha arribat al temps d'espera, Zabbix espera fins que acabi el procés secundari inicial o que hagi transcorregut el temps d'espera. 7. Si el procés secundari inicial ha acabat i no s'ha superat el temps d'espera, Zabbix comprova el codi de sortida del procés secundari inicial i el compara amb 0 (un valor diferent de zero es considera un error d'execució, només per als scripts d'alerta personalitzats, ordres remotes i scripts d'usuari que s'executen al servidor Zabbix i al proxy Zabbix) 8. En aquest punt, se suposa que tot està fet i que tot l'arbre del procés (és a dir, el grup de processos o el treball) ha acabat. ::: nota important Zabbix assumeix que s'ha processat una ordre/script quan el procés fill inicial hagi acabat I cap altre procés encara mantingui obert el descriptor de sortida/descriptor de fitxer. Quan s'ha completat el processament, acaben TOTS els processos creats. ::: Totes les cometes dobles i les barres inclinades invertides de l'ordre s'escapen amb barres invertides i l'ordre s'inclou entre cometes. #### Exit code Before version 2.2 Zabbix agent returned 0 in case of successful exit and 255 in case of failure. Starting from version 2.2 and higher Zabbix agent returns 0 in case of successful exit and 1 in case of failure. #### Codi de sortida Abans de la versió 2.2, l'agent Zabbix retornava 0 en cas de sortida correcta i 255 en cas de fallida. A partir de la version 2.2 i superior, l'agent Zabbix retorna 0 en cas de sortida correcta i 1 en cas de fallida. #### 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)/[proxy](/manual/appendix/config/zabbix_proxy). 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). #### Comprovació del codi de sortida El codi de sortida es comprova amb les condicions següents: - Només per a scripts d'alerta personalitzats, ordres remotes i scripts d'usuari que s'executen al servidor Zabbix i al proxy Zabbix. - Qualsevol codi de sortida diferent de 0 es considera un error d'execució. - El contingut de l'error estàndard i la sortida estàndard de les execucions fallides es recullen i són disponibles a la interfície (on es mostra el resultat de l'execució). - S'ha de crear una entrada de registre addicional per a ordres remotes al servidor/agent Zabbix activant el paràmetre LogRemoteCommands a l'[agent](/manual/appendix/config/zabbix_agentd)/[proxy](/manual/appendix/config/zabbix_proxy). Possibles missatges de la interfície web i entrades de registre per a ordres/scripts erronis: - Contingut d'error estàndard i sortida estàndard per a execucions fallides (si n'hi han). - "S'ha sortit del procés amb el codi: N." (per a una sortida buida i un codi de sortida diferent de 0). - "Procés mort per el senyal: N." (per al procés finalitzat amb un senyal, només a Linux). - "El procés va acabar inesperadament". (perquè el procés s'ha aturat per motius desconeguts). #### Exit codes Starting from version 4.4.8 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. #### Codis de sortida A partir de la versió 4.4.8, l'agent Zabbix 2 es pot compilar amb les versions antigues d'OpenSSL (1.0.1, 1.0.2). En aquest cas, Zabbix proveeix mutexes per blocar, a OpenSSL. Si un mutex blocat o desblocat falla, s'escriurà un missatge d'error al flux d'errors estàndard (STDERR) i l'agent 2 surt amb el codi d'error 2 o 3, respectivament. ## EXIT STATUS The exit status is 0 if the values were sent and all of them were successfully processed by server. If data was sent, but processing of at least one of the values failed, the exit status is 2. If data sending failed, the exit status is 1. [ ]{#lbAH} ## ESTAT DE SORTIDA L'estat de sortida és 0 si els valors enviats són tots ells processats com a successos pel servidor. Si les dades s'envien i ha fallat el processament de com a mínim un dels valors, l'estat de sortida és 2. Si l'enviament de dades ha fallat, l'estat de sortida és 1. [ ]{#lbAH} ### Expandable lists in latest data subfilter Expandable lists have been introduced in the [latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) subfilter: - For each entity group (e.g. tags, hosts) up to 10 rows of entities are now displayed. If there are more entities, this list can be expanded to a maximum of 1000 entries (the value of SUBFILTER_VALUES_PER_GROUP in [frontend definitions](/manual/web_interface/definitions)) by clicking on a three-dot icon displayed at the end. Previously a non-expandable maximum of 100 entries was the limit. - In the list of *Tag values* up to 10 rows of tag names are now displayed. If there are more tag names with values, this list can be expanded to a maximum of 200 tag names by clicking on a three-dot icon displayed at the bottom. Previously, a non-expandable maximum of 20 rows with tag names was the limit. For each tag name up to 10 rows of values are displayed (expandable to 1000 entries (the value of SUBFILTER_VALUES_PER_GROUP in [frontend definitions](/manual/web_interface/definitions))). ### Llistes ampliables al subfiltre de dades més recents S'han introduït llistes ampliables al subfiltre [darreres dades](/manual/web_interface/frontend_sections/monitoring/latest_data): - Per a cada grup d'entitats (per exemple, etiquetes, equips), ara es mostren fins a 10 files d'entitats. Si hi ha més entitats, aquesta llista es pot ampliar fins a un màxim de 1000 entrades (el valor de SUBFILTER_VALUES_PER_GROUP a les [definicions de la interfície](/manual/web_interface/definitions)) fent clic a la icona als tres punts que es mostren al final. Abans, el límit era un màxim no ampliable de 100 entrades. - A la llista *Valors d'etiquetes*, ara es mostren fins a 10 files de noms d'etiquetes. Si hi ha més noms d'etiquetes amb valors, aquesta llista es pot ampliar fins a un màxim de 200 noms d'etiquetes fent clic a la icona dels tres punts que es mostra a la part inferior. Abans, el límit era un màxim no ampliable de 20 línies amb noms d'etiquetes. Per a cada nom d'etiqueta, es mostren fins a 10 files de valors (ampliables a 1000 entrades (el valor de SUBFILTER_VALUES_PER_GROUP a [definicions de la interfície](/manual/interfície_web/definicions))). #### 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#command-line-based-installation): - `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`) #### Paràmetres de línia d'ordres ampliats per als paquets d'instal·lació MSI de l'agent Els paquets d'instal·lació MSI de l'agent Zabbix (tant per a l'agent Zabbix com per a l'agent Zabbix 2) ara admeten els paràmetres següents quan es realitza una [instal·lació des de la línia d'ordres](/manual/installation/install_from_packages/win_msi#command-line-based-installation): - `HOSTNAMEITEM` - especifica l'element de l'agent Zabbix que s'utilitza per obtenir el nom de l'equip - `UNSAFEUSERPARAMETERS` - permet que tots els caràcters (per exemple, \ ' " ` * ?) es passin com a arguments als paràmetres definits per l'usuari - `STARTAGENTS` - especifica el nombre d'instàncies de `zabbix_agentd` pre-bifurcades que processen comprovacions passives - `DONOTSTART` - impedeix que l'instal·lador MSI iniciï el servei de l'agent Zabbix - `SOURCEIP` - especifica l'adreça IP d'origen per a les connexions sortints al servidor/proxy Zabbix o per a les connexions realitzades en executar determinats elements (per exemple, `web.page.get`, `net.tcp.port`) #### Expired signing key for RHEL packages When upgrading Zabbix on [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#update-repository-configuration-package), you may encounter an expired signing key issue for packages on [Zabbix repository](https://repo.zabbix.com/zabbix/6.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/6.0/)). For example, on **RHEL 9**, run: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/6.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). #### Clau de signatura caducada per als paquets RHEL Quan actualitzeu Zabbix a [Red Hat Enterprise Linux](/manual/installation/upgrade/packages/rhel#update-repository-configuration-package), és possible que us trobeu amb un problema de clau de signatura caducada per als paquets al [repositori Zabbix](https://repo.zabbix.com/zabbix/6.0/). Quan caduca una clau de signatura, els intents de verificar les signatures dels paquets donaran lloc a un error que indica que el certificat o la clau ja no són vàlids. Per exemple: ```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 ``` Per resoldre aquests problemes, torneu a instal·lar manualment el darrer paquet `zabbix-release` per a la vostra variant específica de RHEL (substituïu l'enllaç següent per el correcte del [repositori Zabbix](https://repo.zabbix.com/zabbix/6.0/)). Per exemple, a **RHEL 9**, executeu: ```bash rpm -Uvh https://repo.zabbix.com/zabbix/6.0/rhel/9/x86_64/zabbix-release-latest.el9.noarch.rpm ``` A continuació, actualitzeu la informació del repositori: ```bash dnf update ``` Per obtindre més informació, veieu [ZBX-24761](https://support.zabbix.com/browse/ZBX-24761). #### Export and import Export and import Zabbix configuration data for configuration backups, migration or large-scale configuration updates. [Configuration API](/manual/api/reference/configuration) #### Exportació i importació Exportar i importar les dades de configuració de Zabbix per desar la configuració, les migracions o les actualitzacions en cas d'actualitzacions de configuració a llarga escala. [API Configuració](/manual/api/reference/configuration) ##### 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. ##### Format d'exportació Les dades es poden exportar mitjançant la interfície web de Zabbix o [Zabbix API](/manual/api/reference/configuration). Els formats d'exportació admesos són YAML, XML i JSON. #### Export format Export format in YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:40:55Z' groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Templates/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.38 templates: - name: 'VMware macros' 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. See also: https://www.zabbix.com/documentation/6.0/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records' tags: - tag: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware 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: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware - 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: Templates/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: Templates/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}' valuemaps: - uuid: 3c59c22905054d42ac4ee8b72fe5f270 name: 'VMware status' mappings: - value: '0' newvalue: gray - value: '1' newvalue: green - value: '2' newvalue: yellow - value: '3' newvalue: red ``` #### Format d'exportació Formato d'exportació en YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:40:55Z' groups: - uuid: a571c0d144b14fd4a87a9d9b2aa9fcd6 name: Templates/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.38 templates: - name: 'VMware macros' 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. See also: https://www.zabbix.com/documentation/6.0/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records' tags: - tag: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware 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: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware - 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: Application value: VMware - 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: Templates/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: Templates/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}' 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 format in YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2023-05-03T11:24:04Z' groups: - uuid: dc579cd7a1a34222933f24f52a68bcd8 name: 'Linux servers' hosts: - host: Example_host name: Example_host templates: - name: 'Zabbix server health' groups: - name: 'Linux servers' items: - name: Test_item1 type: ZABBIX_ACTIVE key: kernel.maxproc inventory_mode: DISABLED ``` #### Format d'exportació Format d'exportació YAML : ``` {.yaml} zabbix_export: version: '6.0' date: '2021-09-28T12:20:07Z' groups: - uuid: f2481361f99448eea617b7b1d4765566 name: 'Discovered hosts' - uuid: 6f6799aa69e844b4b3918f779f2abf08 name: 'Zabbix servers' hosts: - host: 'Zabbix server 1' name: 'Main Zabbix 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: Application value: 'Zabbix server' triggers: - expression: 'last(/Zabbix server 1/trap)=0' name: 'Last value is zero' priority: WARNING tags: - tag: Process value: 'Internal test' tags: - tag: Process value: Zabbix 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 to YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:55:10Z' 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: { } ``` #### Format d'exportació Exportació en YAML: ``` {.yaml} zabbix_export: version: '6.0' date: '2021-08-31T12:55:10Z' 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: '6.0' date: '2021-08-31T13:34:17Z' 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}' 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} ``` #### Format d'exportació Exportar a YAML: ```yaml zabbix_export: version: '6.0' date: '2021-08-31T13:34:17Z' 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}' 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} ``` ##### Export format ``` {.yaml} groups: - name: 'Zabbix servers' ``` ##### Format d'exportació ``` {.yaml} groups: - name: 'servidors Zabbix' ``` #### Exporting a host Export the configuration of a host as an XML string. Request: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "hosts": [ "10161" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><tags><tag><tag>Application</tag><value>CPU</value></tag></tags><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>\n", "id": 1 } ``` #### Exportant un equip Exporta la configuració d'un equip com a XML. Petició: ```json { "jsonrpc": "2.0", "method": "configuration.export", "params": { "options": { "hosts": [ "10161" ] }, "format": "xml" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>5.4</version><date>2020-03-13T15:31:45Z</date><groups><group><uuid>6f6799aa69e844b4b3918f779f2abf08</uuid><name>Zabbix servers</name></group></groups><hosts><host><host>Export host</host><name>Export host</name><groups><group><name>Zabbix servers</name></group></groups><interfaces><interface><interface_ref>if1</interface_ref></interface></interfaces><items><item><name>Item</name><key>item.key</key><delay>30s</delay><tags><tag><tag>Application</tag><value>CPU</value></tag></tags><valuemap><name>Host status</name></valuemap><interface_ref>if1</interface_ref><request_method>POST</request_method></item></items><valuemaps><valuemap><name>Host status</name><mappings><mapping><value>0</value><newvalue>Up</newvalue></mapping><mapping><value>2</value><newvalue>Unreachable</newvalue></mapping></mappings></valuemap></valuemaps></host></hosts></zabbix_export>\n", "id": 1 } ``` #### Exporting To export hosts, do the following: - Go to: *Configuration* → *Hosts* - Mark the checkboxes of the hosts to export - Click on *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 #### Exportació Per exportar equips, feu el següent: - Aneu a: *Configuració* → *Equips* - Marqueu les caselles dels equips que voleu exportar - Cliqueu a *Exportar* sota la llista  Segons el format triat, els equips s'exporten a un arxiu local amb un nom per defecte: - *zabbix\_export\_hosts.yaml* - a exportacions YAML (opció per defecte) - *zabbix\_export\_hosts.xml* - en format XML - *zabbix\_export\_hosts.json* - en format JSON #### Exporting To export media types, do the following: - Go to: *Administration* → *Media types* - Mark the checkboxes of the media types to export - Click on *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 #### Exportació Per exportar tipus de suport, feu el següent: - Aneu a: *Administració* → *Tipus de suport* - Marqueu les caselles dels tipus de suport que voleu exportar - Cliqueu a *Exportar* sota la llista  Segons el format triat, els tipus de suport s'exporten a un arxiu local amb un nom per defecte: - *zabbix\_export\_mediatypes.yaml* - a exportacions YAML (opció per defecte) - *zabbix\_export\_mediatypes.xml* - en format XML - *zabbix\_export\_mediatypes.json* - en format JSON #### Exporting To export network maps, do the following: - Go to: *Monitoring* → *Maps* - Mark the checkboxes of the network maps to export - Click on *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 #### Exportació Per exportar mapes de xarxa, feu el següent: - Aneu a: *Monitoratge* → *Mapes* - Marqueu les caselles dels mapes de xarxa que voleu exportar - Cliqueu a *Exportar* sota la llista  Segons el format triat, els mapes s'exporten a un arxiu local amb un nom per defecte: - *zabbix\_export\_maps.yaml* - a exportacions YAML (opció per defecte) - *zabbix\_export\_maps.xml* - en format XML - *zabbix\_export\_maps.json* - en format JSON #### Exporting To export templates, do the following: - Go to: *Configuration* → *Templates* - Mark the checkboxes of the templates to export - Click on *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 #### Exportació Per exportar plantilles, feu el següent: - Aneu a: *Configuració* → *Plantilles* - Marqueu les caselles de les plantilles que voleu exportar - Cliqueu a *Exportar* sota la llista  Segons el format triat, les plantilles s'exporten a un arxiu local amb un nom per defecte: - *zabbix\_export\_templates.yaml* - a exportacions YAML (opció per defecte) - *zabbix\_export\_templates.xml* - en format XML - *zabbix\_export\_templates.json* - en format JSON ###### 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"]} ###### Petició d'exportació Una petició d'execució de la funció Export de l'interfície Exporter. | | | |---|---| |direction|agent → plugin| |response|no| Paràmetres específics de les peticions d'exportació: |Nom|Tipus|Comentaris| |---------|--------|----------| |key|string|La clau del plug-in.| |parameters|array of strings (opcional)|Els paràmetres de la funció Export.| *Exemple:* {"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"} ###### Resposta de l'exportació Resposta de la funció Export de la interfície Exporter. | | | |---|---| |direction|plugin → agent| |response|n/a| Paràmetres específics de les respostes d'exportació: |Nom|Tipus|Comentaris| |---------|--------|----------| |value|string (opcional) |Valor de la resposta de la funció Export. Absent si hi ha un error de retorn.| |error|string (opcional) |Missatge d'error si la funció Export no s'ha executat correctament. Absent, si hi ha un error retornat.| *Exemples:* {"id":5,"type":7,"value":"response"} or {"id":5,"type":7,"error":"error message"} #### 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_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) #### Mètriques exposades Els elements de estadístiques recullen les estadístiques en bloc i reenvien un JSON, que és la base dels elements dependents per obtindre les seves dades. Les [mètriques internes](/manual/config/items/itemtypes/internal) següents es retornen per un o altre dels dos elements: - `zabbix[boottime]` - `zabbix[hosts]` - `zabbix[items]` - `zabbix[items_unsupported]` - `zabbix[preprocessing_queue]` (només servidor) - `zabbix[process,<type>,<mode>,<state>]` (només per les estadístiques basades en el tipus de procés) - `zabbix[rcache,<cache>,<mode>]` - `zabbix[requiredperformance]` - `zabbix[triggers]` (només servidor) - `zabbix[uptime]` - `zabbix[vcache,buffer,<mode>]` (només servidor) - `zabbix[vcache,cache,<parameter>]` - `zabbix[version]` - `zabbix[vmware,buffer,<mode>]` - `zabbix[wcache,<cache>,<mode>]` (tipus 'tendències' de cau; només servidor) ### Expression macros {ITEM.KEY<1-9>} macros are now supported inside [expression macros](/manual/config/macros/expression_macros). ### Macros d'expressió {ITEM.KEY<1-9>} les macros ara suporten contindre [macros d'expressió](/manual/config/macros/expression_macros). ### Expressions The expressions object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**expression**<br>(required)|string|Regular expression.| |**expression\_type**<br>(required)|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.| |exp\_delimiter|string|Expression delimiter. Only when `expression_type` *Any character string included*.<br><br>Default value `,`.<br><br>Possible values: `,`, `.`, `/`.| |case\_sensitive|integer|Case sensitivity.<br><br>Default value `0`.<br><br>Possible values:<br>0 - Case insensitive;<br>1 - Case sensitive.| ### Objecte expressions L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**expression**<br>(obligatori)|string|Expressió regular.| |**expression\_type**<br>(obligatori)|integer|Tipus d'expressió regular.<br><br>Valors possibles:<br>0 - Cadena de caràcters inclosa;<br>1 - Qualsevol cadena de caràcters inclosa; <br>2 - Cadena no inclosa;<br>3 - El resultat és CERT;<br>4 - El resultat és FALS.| |exp\_delimiter|string|Delimitador d'expressió. Només per a `expression_type` *Qualsevol cadena de caràcters inclosa*.<br><br>Valor per defecte `,`.<br><br>Valors possibles: `,`, `.`, `/`.| |case\_sensible|integer|Distingeix entre majúscules i minúscules.<br><br>Valor per defecte `0`.<br><br>Valors possibles:<br>0 - No distingeix entre majúscules i minúscules;<br>1 - Sensible a majúscules i minúscules.| #### 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. #### Expressions amb operands desconeguts Normalment, un operand desconegut (com ara un element no admès) a l'expressió estableix immediatament el valor de trigger a "Desconegut". Tanmateix, en alguns casos es permeten operands desconeguts (elements no admesos, errors de funció) en l'avaluació d'expressions: - La funció `nodata()` s'avalua si l'element referenciat és compatible o no. - Les expressions lògiques amb OR i AND es poden avaluar a valors coneguts en dos casos, independentment dels operands desconeguts: - **Cas 1**: "`1 o some_function(unsupported_item1) o some_function(unsupported_item2) o ...`" es pot avaluar a un resultat conegut ('1' o "Problema"), - **Cas 2**: "`0 and some_function(unsupported_item1) i some_function(unsupported_item2) i ...`" es poden avaluar en un resultat conegut ('0' o "OK").<br> Zabbix mira d'avaluar aquestes expressions lògiques prenent els elements no compatibles com a operands desconeguts. En els dos casos anteriors, es produirà un valor conegut ("Problema" o "OK", respectivament); en **tots els altres** casos, el trigger s'avaluarà com a "Desconegut". - Si l'avaluació de la funció per a un element suportat provoca un error, el valor de la funció esdevé "Desconegut" i participa com a operand desconegut en una avaluació posterior de l'expressió. Tingueu en compte que els operands desconeguts només poden "desaparèixer" en expressions lògiques tal com es descriu anteriorment. En les expressions aritmètiques, els operands desconeguts sempre condueixen al resultat "Desconegut" (excepte la divisió per 0). ::: noteimportant Una expressió el resultat de la qual és "Desconegut" no modifica l'estat del trigger ("Problema/D'acord"). Per tant, si era "Problema" (vegeu el cas 1), roman en el mateix estat encara que la part coneguda es resolgui ('1' es converteix a '0'), perquè l'expressió ara s'avalua com a 'Desconegut' i no canvia l'estat del trigger. ::: Si un trigger amb diversos elements no admesos s'avalua com a "Desconegut", el missatge d'error de la interfície fa referència al darrer element no admès avaluat. ### ExpressMS messenger webhook API changed API version changed to v4 in ExpressMS messenger webhook. ### Canviada l'API ExpressMS webhook La versió API ha canviat a v4 al webhook messenger ExpressMS. #### Extended logging The data gathered by VMware collector can be logged for detailed debugging using debug level 5. This level can be set in [server](/manual/appendix/config/zabbix_server) and [proxy](/manual/appendix/config/zabbix_proxy) configuration files or using a runtime control option (`-R log_level_increase="vmware collector,N"`, where N is a process number). The following examples demonstrate how extended logging can be started provided debug level 4 is already set: # Increase log level of all vmware collectors: zabbix_server -R log_level_increase="vmware collector" # Increase log level of second vmware collector: zabbix_server -R log_level_increase="vmware collector,2" If extended logging of VMware collector data is not required it can be stopped using the `-R log_level_decrease` option. #### Registre detallat Les dades recollides pel col·lector de VMware es poden registrar per a una depuració detallada mitjançant el nivell de depuració 5. Aquest nivell es pot establir als fitxers de configuració del [servidor](/manual/appendix/config/zabbix_server) i [proxy](/manual/appendix/config/zabbix_proxy) o emprant una opció de control en temps d'execució (`-R log_level_increase="vmware collector,N"`, on N és un nombre de procés). Els exemples següents mostren com es pot iniciar el registre ampliat sempre que el nivell de depuració 4 ja sigui establert: Puja el nivell de registre de tots els col·leccionistes de vmware: zabbix_server -R log_level_increase="col·lector de vmware" Puja el nivell de registre del segon col·lector de vmware: zabbix_server -R log_level_increase="vmware collector,2" Si no cal el registre de dades ampliat del col·lector de VMware, es pot aturar mitjançant l'opció `-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) and [proxy](/manual/appendix/config/zabbix_proxy) configuration files or using a 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: shell> zabbix_server -R log_level_increase="http poller" Increase log level of second http poller: shell> 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. #### Monitoratge ampliat De vegades cal registrar el contingut de la pàgina HTML rebuda. Això és especialment útil si falla una passa de l'escenari web. Per a això s'empra el nivell de depuració 5 (traça). Aquest nivell es pot establir als fitxers de configuració del [servidor](/manual/appendix/config/zabbix_server) i [proxy](/manual/appendix/config/zabbix_proxy) o mitjançant una opció de control en temps d'execució (`-R log_level_increase="http poller ,N"`, on N és el nombre de procés). Els exemples següents mostren com es pot iniciar el monitoratge ampliat sempre que el nivell de depuració ja sigui establert a 4: Augmenteu el nivell de registre de tots els enquestadors http: shell> zabbix_server -R log_level_increase="http poller" Augmenteu el nivell de registre del segon sondeig http: shell> zabbix_server -R log_level_increase="http poller,2" Si no cal un monitoratge web ampliat, es pot aturar mitjançant l'opció `-R log_level_decrease`. #### Extended SNMP gateway functionality SNMP gateway can now provide information about triggers in a problem state and reveal host information in trigger details. Additionally, it is now possible to limit the rate of SNMP traps sent by SNMP gateway. The list of supported OIDs has been extended with a new OID **.10** for a comma-delimited list of trigger hostnames. New parameters have been added to the SNMP gateway configuration file: - *ProblemBaseOID* - OID of the problem trigger table; - *ProblemMinSeverity* - minimum severity, triggers having lower severity will not be included; - *ProblemHideAck* - if specified, only triggers with unacknowledged problems will be included; - *ProblemTagFilter* - if specified, only triggers with the specified tag name will be included; - *TrapTimer* - if set, Zabbix will send no more than one trap of the highest severity in the given time frame. For details, see [Zabbix SNMP Gateway](https://git.zabbix.com/projects/ZT/repos/snmp-gateway/browse/README.md). ### Funcionalitat de passarel·la SNMP ampliada La passarel·la SNMP ara pot proporcionar informació sobre els triggers en un estat problemàtic i revelar detalls de la informació de l'equip al trigger. A més, ara és possible limitar la taxa de trampes SNMP enviades per la passarel·la SNMP. La llista d'OID admesos s'ha ampliat amb un nou OID **.10** per a una llista delimitada per comes de triggers d'equips. S'han afegit nous paràmetres al fitxer de configuració de la passarel·la SNMP: - *ProblemBaseOID* - OID de la taula d'activació del problema; - *ProblemMinSeverity* - gravetat mínima, no s'inclouran els triggers que tinguin una gravetat més baixa; - *ProblemHideAck* - si s'especifica, només s'inclouran triggers amb problemes no reconeguts; - *ProblemTagFilter* - si s'especifica, només s'inclouran triggers amb el nom d'etiqueta especificat; - *TrapTimer* - si s'estableix, Zabbix no enviarà més d'una trampa de la més alta gravetat en el període de temps donat. Per obtindre més informació, vegeu la [passarel·la Zabbix SNMP](https://git.zabbix.com/projects/ZT/repos/snmp-gateway/browse/README.md). #### 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. #### Resultat de verificació externa El valor de retorn de la verificació externa és la sortida estàndard amb l'error estàndard producte de la verificació. ::: noteimportant Un element de text (caràcter, registre o informació de tipus text) no s'admetrà en cas de sortida d'error estàndard. ::: El valor de retorn és limita a 16Mo (incloent els espais en blanc truncats al final); també s'apliquen [Límits de la base de dades](/manual/config/items/item#text_data_limits). Si l'script demanat no es troba o si el servidor/proxy Zabbix no té permisos per executar-lo, l'element no s'admetrà i s'establirà el missatge d'error corresponent. En cas de temps d'espera esgotat, l'element serà marcat com a no admès, i un missatge d'error corresponent serà mostrat, i el procés fork de l'script es tancarà. **External plugin loader** Previously, plugins could only be compiled into Zabbix agent 2, which required recompiling the agent every time you need to change the set of available plugins. Now, with the addition of the external plugin loader, plugins don't have to be integrated into the agent 2 directly and can be added as separate external add-ons (loadable plugins), thus making the creation process of additional plugins for gathering new monitoring metrics easier. **Càrrega de plug-ins externs** Anteriorment, els connectors només es podien compilar a l'agent Zabbix 2, cosa que requeria recompilar l'agent cada cop que calia canviar el conjunt de connectors disponibles. Ara, amb l'addició del carregador de connectors externs, els connectors no s'han d'integrar directament a l'Agent 2 i es poden afegir com a complements externs separats (connectors carregables), fent així més senzill el procés de creació de connectors addicionals per recopilar noves mètriques de monitoratge. #### 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. Since Zabbix 2.2.0, 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 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: 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. #### Extracció de la part coincident de l'expressió regular De vegades volem extreure només el valor interessant d'un fitxer de destinació en lloc de retornar tota la fila quan es troba una coincidència d'expressió regular. Des de Zabbix 2.2.0, els elements del fitxer de registre tenen la capacitat d'extreure els valors desitjats de les fileres corresponents. Això s'aconsegueix mitjançant el paràmetre addicional **output** als elements `log` i `logrt`. L'ús del paràmetre 'sortida' ens permet indicar el "grup capturat" de la part que ens pot interessar. Així, per exemple: log[/path/to/the/file,"large result buffer allocation.*Entries: ([0-9]+)",,,,\1] hauria de retornar el nombre d'entrades tal com es troba al contingut de: 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 Només es retornarà el nombre perquè **\\1** es refereix al primer i únic grup capturat: **(\[0-9\]+)** I, amb la possibilitat d'extreure i retornar un nombre, el valor es pot emprar per establir triggers. ### 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 ``` ### Failover cap a mode repòs Zabbix passarà automàticament per error a un altre node si el node actiu cau. Hi ha d'haver almenys un node en estat d'espera perquè es produeixi la migració per error. Amb quina rapidesa es produirà el failover? Tots els nodes actualitzen el seu darrer temps d'accés (i estat, si es canvia) cada 5 segons. Per tant: - Si el node actiu s'atura i aconsegueix informar del seu estat com a "aturat", un altre node prendrà el control en **5 segons**. - Si el node actiu s'atura/és indisponible sense poder actualitzar el seu estat, els nodes en espera esperaran a **endarreriment per error** + 5 segons a prendre el control. L'endarreriment de la migració per error és configurable, amb un interval compatible de 10 segons a 15 minuts (un minut per defecte). Per canviar l'endarreriment de la migració per error, podeu executar: ``` zabbix_server -R ha_set_failover_delay=5m ``` ##### Favorite custom graphs no longer supported It is no longer possible to add custom graphs to favorites in *Monitoring* -> *Hosts* -> *Graphs*. After the upgrade any existing custom graphs will be removed from favorites. ##### Els gràfics personalitzats preferits ja no s'admeten Ja no és possible afegir gràfics personalitzats als preferits a *Monitoratge* -> *Equips* -> *Gràfics*. Després de l'actualització, tots els gràfics personalitzats existents s'esborraran dels preferits. ##### 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 ``` ##### Ordre i format dels camps Zabbix segueix les recomanacions de [RFC 4514](http://tools.ietf.org/html/rfc4514), que especifica un ordre "invers" per a aquests camps, començant pels camps de nivell més baix (`CN`), seguint als camps de nivell mitjà (`OU`, `O`) i concloent amb els camps de nivell més alt (`DC`). ```ini TLSServerCertIssuer=CN=Signing CA,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com TLSServerCertSubject=CN=Proxy Zabbix,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com ``` En canvi, OpenSSL mostra per defecte les cadenes `Emissor` i `Assumpte` en ordre de nivell superior a nivell baix. A l'exemple següent, els camps `Emissor` i `Assumpte` comencen amb el nivell superior ("DC") i acaben amb el camp de nivell baix ("CN"). El format amb espais i separadors de camps també varia en funció de les opcions emprades i, per tant, no coincidirà amb el format requerit per Zabbix. ```bash $ openssl x509 -noout -in /home/zabbix/zabbix_proxy.crt -issuer -subject issuer= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Grup de desenvolupament/CN=Signing CA subject= /DC=com/DC=zabbix/O=Zabbix SIA/OU=Grup de desenvolupament/CN=Proxy Zabbix $ openssl x509 -noout -text -in /home/zabbix/zabbix_proxy.crt Certificat: ... Emissor: DC=com, DC=zabbix, O=Zabbix SIA, OU=Grup de desenvolupament, CN=Signing CA ... Assumpte: DC=com, DC=zabbix, O=Zabbix SIA, OU=Grup de desenvolupament, CN=proxy Zabbix ``` Per formatar correctament les cadenes *Emissor* i *Assumpte* per a Zabbix, invoqueu OpenSSL amb les opcions següents: ```bash $ openssl x509 -noout -issuer -subject \ -nameopt esc_2253,esc_ctrl,utf8,dump_nostr,dump_unknown,dump_der,sep_comma_plus,dn_rev,sname\ -a /home/zabbix/zabbix_proxy.crt ``` Aleshores, la sortida estarà en ordre invers, separada per comes i es podrà emprar als fitxers de configuració i a la interfície de Zabbix: ```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 ``` ##### Field size limit Maximum field size has been increased for the following fields: - [Item preprocessing](/manual/config/items/preprocessing#configuration) parameters - [Media type](/manual/config/notifications/media#common-parameters) message ##### Límit de mida del camp La mida màxima del camp s'ha augmentat per als camps següents: - Configuració de [preprocessament d'elements] (/manual/config/items/preprocessing#configuration) - Missatge de [tipus de suport](/manual/config/notifications/media#common-parameters) ##### 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**. ##### Ubicació dels arxius - Els arxius de configuració són a **/etc/zabbix**. - Els arxius de registre del servidor, del proxy i de l'agent Zabbix són a **/var/log/zabbix**. - La interfície Web Zabbix és a **/usr/share/zabbix**. - La carpeta personal de l'usuari **zabbix** és a **/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} ## ARXIUS */usr/local/etc/zabbix\_agent2.conf* Lloc per defecte de l'arxiu de configuració de l'agent de Zabbix 2 (si no s'ha pas modificat durant la compilació). [ ]{#lbAH} ## FILES */usr/local/etc/zabbix\_agentd.conf* Default location of Zabbix agent configuration file (if not modified during compile time). [ ]{#lbAI} ## ARXIUS */usr/local/etc/zabbix\_agentd.conf* Lloc per defecte dels arxius de configuració de l'agent de Zabbix (si no s'ha modificat durant la compilació). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_proxy.conf* Default location of Zabbix proxy configuration file (if not modified during compile time). [ ]{#lbAI} ## ARXIUS */usr/local/etc/zabbix\_proxy.conf* Lloc per defecte de l'arxiu de configuració del proxy de Zabbix (si no és pas modificat durant la compilació). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_server.conf* Default location of Zabbix server configuration file (if not modified during compile time). [ ]{#lbAI} ## ARXIUS */usr/local/etc/zabbix\_server.conf* Ubicació per defecte de l'arxiu de configuració del servidor de Zabbix (si no s'ha modificat durant la compilació). [ ]{#lbAI} ## FILES */usr/local/etc/zabbix\_web\_service.conf* Default location of Zabbix web service configuration file (if not modified during compile time). [ ]{#lbAG} ## ARXIUS */usr/local/etc/zabbix\_web\_service.conf* Ubicació per defecte de l'arxiu de configuració del servei web de Zabbix (si no s'ha modificat durant la compliació). [ ]{#lbAG} ##### 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). ##### Sistema d'arxius A causa de la implementació del fitxer trap, Zabbix necessita que el sistema de fitxers admeti inodes per diferenciar diferents fitxers (la informació s'adquireix mitjançant una crida a stat()). #### 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). For instance, if you are only interested in C:, D:, and E: file systems, you could put {\#FSNAME} into "Macro" and "\^C\|\^D\|\^E" regular expression into "Regular expression" text fields. Filtering is also possible by file system types using {\#FSTYPE} macro (e.g. "\^ext\|\^reiserfs") and by drive types (supported only by Windows agent) using {\#FSDRIVETYPE} macro (e.g., "fixed").<br>You can enter a regular expression or reference a global [regular expression](/manual/regular_expressions) in "Regular expression" field.<br>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```` <br><br> {\#FSDRIVETYPE} macro on Windows is supported since Zabbix **3.0.0**.<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 (supported since version 5.4.0).<br>Defining several filters is supported since Zabbix **2.4.0**.<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.<br>This flexible warning logic is supported since Zabbix 6.0.11.| ::: 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. ::: #### Filtre Es pot emprar un filtre per generar elements reals, triggers i gràfics només per a les entitats que coincideixen amb els criteris. La psónya **Filtres** conté definicions de filtres de regles de descoberta per filtrar valors de descoberta: {width="600"} |Paràmetre|Descripció| |--|---------| |*Tipus de càlcul*|Les opcions de càlcul de filtres següents són disponibles:<br>**I** - han de complir-ho tots els filtres;<br>**O** - n'hi ha prou si un filtre compleix;< br>**I/O** - empra *I* amb diferents noms de macro i *O* amb el mateix nom de macro;<br>**Expressió personalitzada** - ofereix la possibilitat de definir un càlcul personalitzat de filtres. La fórmula ha d'incloure tots els filtres de la llista. Limitat a 255 símbols.| |*Filtres*|Els operadors de condicions de filtre següents són disponibles: *coincideix*, *no coincideix*, *existeix*, *no existeix*.<br>Els operadors *coincideix* i *no coincideix* esperen una [expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE). Per exemple, si només sou interessats en els sistemes de fitxers C:, D: i E:, podeu posar {\#FSNAME} a "Macro" i l'expressió regular "\^C\|\^D\|\^E" al camp de text "Expressió regular". El filtre també és possible per tipus de sistema de fitxers emprant la macro {\#FSTYPE} (per exemple, "\^ext\|\^reiserfs") i per tipus d'unitat (només és compatible amb l'agent Windows) mitjançant la macro {\#FSDRIVETYPE} (per exemple, "fixat").<br>Podeu introduir una expressió regular o fer referència a una [expressió regular](/manual/regular_expressions) global al camp "Expressió regular".<br>Per provar una expressió regular, podeu emprar "grep -E", per exemple: ````for f a ext2 nfs reiserfs smbfs; do echo $f \| grep -E '^ext\|^reiserfs' \|\| echo "SKIP: $f"; done````<br><br>La macro {\#FSDRIVETYPE} a Windows s'admet des de Zabbix **3.0.0**.<br><br>Els operadors *existeix* i *no existeix pas* permet filtrar entitats en funció de la presència o absència de la macro LLD especificada a la resposta (suportada des de la versió 5.4.0).<br>La configuració de diversos filtres és compatible des de Zabbix **2.4.0**.<br>Tingueu en compte que si manca una macro de filtre a la resposta, l'entitat trobada s'ignorarà tret que s'especifiqui una condició "no existeix" per a aquesta macro.<br>< br>Es mostrarà un avís si l'absència d'una macro afecta al resultat de l'expressió. Per exemple, si hi manca {#B} a:<br>{#A} coincideix amb 1 i {#B} coincideix amb 2 - donarà un avís<br>{#A} coincideix amb 1 o {#B} coincideix amb 2 - no hi haurà cap avís.<br>Aquesta lògica d'avís flexible és compatible des de Zabbix 6.0.11.| ::: notadvert Un error o una errada en l'expressió regular emprada a la regla LLD (per exemple, una expressió regular "Sistema de fitxers per a la descoberta" incorrecta) pot provocar l'esborrat de milers d'elements de configuració, valors històrics i esdeveniments de molts equips. ::: ::: noteimportant La base de dades Zabbix a MySQL s'ha de crear amb distinció entre majúscules i minúscules, de manera que els noms del sistema de fitxers només difereixin en cas que siguin correctament descoberts. ::: ##### 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.| ##### Botons de filtre | | | |--|--------| ||Aplica els criteris de filtre especificats (sense desar).| ||Restablir el filtre actual i tornar a la configuració desada de la pestanya actual. A la pestanya principal, això esborrarà el filtre.| ||Desa la configuració actual del filtre en una pestanya nova. Només disponible a la pestanya principal.| ||Substitueix la configuració de la pestanya per la configuració especificada actualment. No disponible a la pestanya principal.| #### Filter expression The filter expression is an arithmetical expression in infix notation. Supported operands: |Operand|Description|Example| |--|------|------| |`"<text>"`<br>`'<text>'`|Text constant.|'value: \'1\''<br>"value: '1'"| |`<number>`|Numeric constant supporting scientific notation.|123| |`<jsonpath starting with $>`|Value referred to by the JSONPath from the input document root node; only definite paths are supported.|$.object.name| |`<jsonpath starting with @>`|Value referred to by the JSONPath from the current object/element; only definite paths are supported.|@.name| Supported operators: |Operator|Type|Description|Result| |--|--------|----|----| |`-`|binary|Subtraction.|Number.| |`+`|binary|Addition.|Number.| |`/`|binary|Division.|Number.| |`*`|binary|Multiplication.|Number.| |`==`|binary|Is equal to.|Boolean (1 or 0).| |`!=`|binary|Is not equal to.|Boolean (1 or 0).| |`<`|binary|Is less than.|Boolean (1 or 0).| |`<=`|binary|Is less than or equal to.|Boolean (1 or 0).| |`>`|binary|Is greater than.|Boolean (1 or 0).| |`>=`|binary|Is greater than or equal to.|Boolean (1 or 0).| |`=~`|binary|Matches regular expression.|Boolean (1 or 0).| |`!`|unary|Boolean not.|Boolean (1 or 0).| |`||`|binary|Boolean or.|Boolean (1 or 0).| |`&&`|binary|Boolean and.|Boolean (1 or 0).| #### Expressió de filtre L'expressió de filtre és una expressió aritmètica en notació infix. Operands suportats: |Operand|Descripció|Exemple| |--|-------|------| |`"<text>"`<br>`'<text>'`|Constant de text.|'valor: \'1\''<br>"valor: '1'"| |`<nombre>`|Constante numèrica que suporta la notació científica.|123| |`<jsonpath comença amb $>`|Valor al qual fa referència JSONPath des del node arrel del document d'entrada; només s'admeten els camins definits.|$.object.name| |`<jsonpath comença amb @>`|Valor referenciat pel JSONPath des de l'objecte/element actual; només s'admeten els camins definits.|@.name| Operadors compatibles: |Operador|Tipus|Descripció|Resultat| |--|--------|----|----| |`-`|binari|Resta.|Nombre.| |`+`|binari|Suma.|Nombre.| |`/`|binari|Divisió.|Nombre.| |`*`|binari|Multiplicació.|Nombre.| |`==`|binari|Igual.|Booleà (1 o 0).| |`!=`|binari|No és igual a.|Booleà (1 o 0).| |`<`|binari|És inferior a.|Booleà (1 o 0).| |`<=`|binari|És menor o igual a.|Booleà (1 o 0).| |`>`|binari|És més gran que.|Booleà (1 o 0).| |`>=`|binari|És més gran o igual que.|Booleà (1 o 0).| |`=~`|binari|Coincideix amb l'expressió regular.|Booleà (1 o 0).| |`!`|unitari|No booleà.|Booleà (1 o 0).| |`||`|binari|O booleà.|Booleà (1 o 0).| |`&&`|binari|I booleà.|Booleà (1 o 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. ##### Filtre per equip En el mode *per equip*, els resultats es poden filtrar per equip o grup d'equips. L'especificació d'un grup d'equips pare selecciona implícitament tots els grups d'equips heretats. ##### 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*|Select all hosts with triggers from templates belonging to that group. Any host group that includes at least one template can be selected.| |*Template*|Select hosts with triggers from the chosen template and all nested templates. Only triggers inherited from the selected template will be displayed. If a nested template has additional own triggers, those triggers will not be displayed.| |*Template trigger*|Select hosts with chosen trigger. Other triggers of the selected hosts will not be displayed.| |*Host group*|Select hosts belonging to the group.| ##### Filtre per model de trigger En el mode *per plantilla de trigger*, els resultats es poden filtrar segons un o més paràmetres que es llisten tot seguit. |Paràmetre|Descripció| |--|---------| |*Grup de plantilles*|Trieu tots els equips amb triggers de les plantilles que pertanyen a aquest grup. Es pot triar qualsevol grup d'equips amb almenys una plantilla.| |*Plantilla*|Trieu equips amb triggers de la plantilla escollida i totes les plantilles heretades. Només es mostraran els triggers heretats de la plantilla triada. Si un model heretat té els seus propis triggers addicionals, aquests triggers no es mostraran.| |*Plantilla de trigger*|Trieu els equips amb el trigger escollit. Altres triggers dels equips triats no es mostraran.| |*Grup d'equips*|Trieu els equips que pertanyen al grup.| #### Filtering VMware event log records This example uses the [Matches regular expression](/manual/config/items/preprocessing#configuration) preprocessing step to filter unnecessary events from the VMware event log. 1\. On a working VMware Hypervisor host, check that the event log item [vmware.eventlog](/manual/config/items/itemtypes/simple_checks/vmware_keys) is present and working properly. Note that the event log item could already be present on the hypervisor if a [VMware](/manual/vm_monitoring#ready-to-use-templates) 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. 3\. In the *Preprocessing* tab of the dependent item, select the "Matches regular expression" preprocessing step and specify, for example, one of the following parameters: ```bash # Filters all log events: pattern: .* logged in .* # Filters lines containing usernames after "User": pattern: \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#configuration) 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#configuration) preprocessing step to extract matching groups and control output. For example: ```bash # Extracts and outputs the entire log event containing "logged in": pattern: .*logged in.* output: \0 # Extracts and outputs usernames following "User": pattern: User (.*?)(?=\ ) output: \1 ``` #### Filtrat dels registres d'esdeveniments de VMware Aquest exemple empra la passa de preprocessament [Coincideix amb l'expressió regular](/manual/config/items/preprocessing#configuration) per filtrar els esdeveniments innecessaris del registre d'esdeveniments de VMware. 1\. En un equip de VMware Hypervisor que funcioni, comproveu que l'element del registre d'esdeveniments [vmware.eventlog](/manual/config/items/itemtypes/simple_checks/vmware_keys) estigui present i funcioni correctament. Tingueu en compte que l'element del registre d'esdeveniments ja podria estar present a l'hipervisor si s'ha enllaçat una plantilla [VMware](/manual/vm_monitoring#ready-to-use-templates) durant la creació de l'equip. 2\. A l'equip de VMware Hypervisor, creeu un [element dependent](/manual/config/items/itemtypes/dependent_items) del tipus "Registre" i configureu l'element del registre d'esdeveniments com a mestre. 3\. A la pestanya *Preprocessament* de l'element dependent, seleccioneu la passa de preprocessament "Coincideix amb l'expressió regular" i especifiqueu, per exemple, un dels paràmetres següents: ```bash # Filtra tots els esdeveniments de registre: patró: .* iniciat sessió .* # Filtra les línies que contenen noms d'usuari després de "Usuari": patró: \bUsuari\s+\K\S+ ``` ::: noteimportant Si l'expressió regular no coincideix, l'element dependent no s'admet amb un missatge d'error corresponent. Per evitar-ho, marqueu la casella de selecció "Personalitzat en cas d'error" i seleccioneu una opció, com ara descartar el valor o establir-ne un de personalitzat. Tingueu en compte que els valors [descartats](/manual/config/items/preprocessing#configuration) no s'emmagatzemen a la base de dades; com a resultat, els triggers no s'avaluen i no es generen dades de tendència. ::: Alternativament, podeu emprar la passa de preprocessament [Expressió regular](/manual/config/items/preprocessing#configuration) per extreure grups coincidents i controlar la sortida. Per exemple: ```bash # Extreu i genera tot l'esdeveniment de registre que conté "iniciat sessió": patró: .*ha iniciat sessió.* sortida: \0 # Extreu i emet noms d'usuari després d'"Usuari": patró: Usuari (.*?)(?=\ ) sortida: \1 ``` #### Filter settings remembered In several Monitoring pages (*Problems*, *Hosts*, *Latest data*) the current filter settings are now remembered in the user profile. When the user opens the page again, the filter settings will have stayed the same. Additionally, the marking of a changed (but not saved) favorite filter is now a green dot next to the filter name, instead of the filter name in italics. #### Paràmetres de filtre memoritzats A diverses pàgines de monitoratge (*Problemes*, *Equips*, *Darreres dades*), la configuració actual del filtre es recorda ara al perfil de l'usuari. Quan l'usuari torna a obrir la pàgina, la configuració del filtre segueix essent la mateixa. A més, el marcatge d'un filtre favorit modificat (però no desat) és ara un punt verd al costat del nom del filtre, en lloc del nom del filtre en cursiva. #### Find HTTP agent item Find HTTP agent item with post body type XML for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 3, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` 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": "3s", "url": "localhost", "query_fields": [ { "mode": "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": "" } ], "id": 3 } ``` #### Trobar un element d'agent HTTP Trobar un element d'agent HTTP amb el tipus de cos XML per a un ID d'equip donat. Petició: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "hostids": "10255", "filter": { "type": 19, "post_type": 3 } }, "id": 3, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Resposta: ```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": "3s", "url": "localhost", "query_fields": [ { "mode": "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": "" } ], "id": 3 } ``` #### Find HTTP agent item prototype Find HTTP agent item prototype with request method HEAD for specific host ID. Request: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": "19", "request_method": "3" } }, "id": 17, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` 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": "", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "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": 17 } ``` #### Trobar un prototip d'element d'agent HTTP Trobar el prototip d'element d'agent HTTP amb el mètode de consulta HEAD per a un ID d'equip específic. Petició: ```json { "jsonrpc": "2.0", "method": "itemprototype.get", "params": { "hostids": "10254", "filter": { "type": "19", "request_method": "3" } }, "id": 17, "auth": "d678e0b85688ce578ff061bd29a20d3b" } ``` Resposta: ```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": "", "interfaceid": "2", "description": "", "evaltype": "0", "jmx_endpoint": "", "master_itemid": "0", "timeout": "3s", "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": 17 } ``` #### Finding dependent item Find one Dependent item for item with ID "25545". Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": "18", "master_itemid": "25545" }, "limit": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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": "3s", "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 } ``` #### Cercar un element dependent Trobar un element dependent per l'element amb ID "25545". Petició: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "filter": { "type": "18", "master_itemid": "25545" }, "limit": "1" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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": "3s", "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: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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": "3s", "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" }, { "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": "3s", "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" } ], "id": 1 } ``` #### Cercar elements dependents, per clau Recuperar tots els elements dependents de l'equip amb ID "10116" donada una clau que conté el nom "apache". Petició: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10116", "search": { "key_": "apache" }, "filter": { "type": 18 } }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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": "3s", "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" }, { "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": "3s", "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" } ], "id": 1 } ``` #### Finding items by key Retrieve all items used in triggers specific host ID that have word "system.cpu" in the item key and sort results by name. Request: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "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": "3s", "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" }, { "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": "3s", "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" }, { "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": "3s", "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" }, { "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": "3s", "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" }, { "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": "3s", "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" } ], "id": 1 } ``` #### Cercar elements per una clau Recupera tots els elements emprats amb l'ID d'equip específics que contenen el mot "system.cpu" a la clau d'element, i ordenar els resultats per nom. Petició: ```json { "jsonrpc": "2.0", "method": "item.get", "params": { "output": "extend", "hostids": "10084", "with_triggers": true, "search": { "key_": "system.cpu" }, "sortfield": "name" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```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": "3s", "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" }, { "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": "3s", "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" }, { "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": "3s", "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" }, { "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": "3s", "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" }, { "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": "3s", "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" } ], "id": 1 } ``` #### 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 #### Tallafocs Per defecte, només són oberts els ports enumerats a [canvis de configuració](#firewall_configuration). Per obrir ports addicionals, editeu el fitxer "*/etc/sysconfig/iptables*" i torneu a carregar les regles del tallafoc: 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 (53 UDP); - ICMP packets limited to 5 packets per second; - All other incoming connections are dropped. ##### Configuració del tallafocs L'aplicació empra un tallafocs iptables amb les següents regles per defecte: - Permès SSH (port 22 TCP); - Permeses les traces d'agent Zabbix (port 10050 TCP) i Zabbix (port 10051 TCP); - Permesos els ports HTTP (80 TCP) i HTTPS (443 TCP); - Permès el port de traces SNMP (162 UDP); - Permesa la connexió de sortida cap a NTP (port 53 UDP); - Paquets ICMP limitats a 5 paquets per segon; - La resta de connexions entrants són ignorades. ##### 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^| ##### Funcions d'ajustament Per defecte, `fit` és una funció *linial*. Però si el vostre sistema monitorat és més complexe, teniu diverses opcions a escollir. |`fit`|x = f(t)| |-----|--------| |*linial*|x = a + b\*t| |*polinomiN*^[2](#footnotes)^|x = a~0~ + a~1~\*t + a~2~\*t^2^ + ... + a~n~\*t^n^| |*exponencial*|x = a\*exp(b\*t)| |*logarítmica*|x = a + b\*log(t)| |*potència*|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 - *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 starting with Zabbix 3.0 it is recommended to use scheduling intervals for such checks.| #### Intervals flexibles Els intervals flexibles permeten redefinir l'interval d'actualització predeterminat per a períodes de temps específics. Un interval flexible es defineix amb *Interval* i *Període*, on: - *Interval*: l'interval d'actualització per al període de temps especificat - *Període*: el període de temps en què l'interval flexible és actiu (veieu els [períodes de temps](/manual/appendix/time_period) per obtindre una descripció detallada del format *Període*) Si es superposen diversos intervals flexibles, s'empra el valor *Interval* més petit per al període de superposició. Tingueu en compte que si el valor més petit dels intervals flexibles superposats és '0', no es farà pas cap sondeig. Fora dels intervals flexibles s'empra l'interval d'actualització predeterminat. Tingueu en compte que si l'interval flexible és igual a la durada del període, l'element es comprovarà exactament una vegada. Si l'interval flexible és més gran que el període, l'element es pot comprovar una vegada o no es pot comprovar pas (per tant, aquesta configuració no és recomanable). Si l'interval flexible és inferior al període, l'element es comprovarà almenys una vegada. Si l'interval flexible s'estableix a '0', l'element no es consulta durant el període d'interval flexible i es reprèn l'enquesta segons l'*Interval d'actualització* predeterminat un cop finalitzat el període. Exemples: |Interval|Període|Descripció| |--|--|------| |10|1-5,09:00-18:00|L'element es revisarà cada 10 segons durant l'horari laboral.| |0|1-7,00:00-7:00|L'element no es revisarà a les nits.| |0|7-7,00:00-24:00|L'element no es revisarà els diumenges.| |60|1-7,12:00-12:01|L'element es revisarà cada dia a les 12:00 del migdia. Tingueu en compte que això es va emprar com a solució alternativa per a comprovacions programades i, a partir de Zabbix 3.0, es recomana emprar intervals de programació per a aquestes comprovacions.| #### 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 symbols are not allowed in user parameters by default. See [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd) documentation for a full list. ::: #### Paràmetres d'usuari flexibles Els paràmetres d'usuari flexibles admeten paràmetres a la clau. Així, una configuració d'usuari flexible pot servir com a base per crear diversos elements. Els paràmetres d'usuari flexibles tenen la sintaxi següent: UserParameter=key[*],ordre |Paràmetre|Descripció| |--|---------| |**Clau**|Clau d'element única. El \[\*\] defineix que aquesta clau admet paràmetres entre parèntesis.<br>Els paràmetres es donen en configurar l'element.| |**Ordre**|Ordre que s'ha d'executar per avaluar el valor de la clau.<br>*Només per a paràmetres d'usuari flexibles*:<br>Podeu emprar referències posicionals $1...$9 a l'ordre per fer referència al paràmetre respectiu a clau d'element.<br>Zabbix analitza els paràmetres entre \[ \] de la clau d'element i substitueix $1,...,$9 a l'ordre en conseqüència.<br>$0 serà substituït per l'ordre original (abans de $0,...,$9 expansió) per executar-se.<br>Les referències de posició s'interpreten tant si són tancades entre cometes dobles ("") o simples (').<br>Per emprar referències de posició sense canvis, especifiqueu un signe de dòlar doble, per exemple, awk '{ print $$2}' En aquest cas, `$$2` canviarà a `$2` quan s'executi l'ordre.| ::: noteimportant Les referències de posició amb el signe $ es cerquen i substitueixen a l'agent Zabbix només per a la configuració flexible d'usuari. Per als paràmetres d'usuari simples, aquest processament de referència s'ignora i, per tant, no cal que es faci cap cita del signe $. ::: ::: noteimportant Alguns símbols no són permesos a la configuració d'usuari predeterminada. Consulteu la documentació [UnsafeUserParameters](/manual/appendix/config/zabbix_agentd) per obtindre una llista completa. ::: #### 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) #### Inversió de la configuració regional de la interfície web S'ha observat que la configuració regional de la interfície web pot canviar sense lògica aparent, és a dir, algunes pàgines (o parts de pàgines) es mostren en un idioma mentre que altres pàgines (o parts de pàgines) es mostren en un idioma diferent. Normalment, el problema pot aparèixer quan hi ha diversos usuaris, alguns dels quals empren una configuració regional, mentre que altres n'empren una altra. Una solució alternativa coneguda és desactivar el multithreading a PHP i Apache. El problema és relacionat amb el funcionament de la configuració de localitzacions [a PHP](https://www.php.net/manual/en/function.setlocale): la informació de la configuració regional es manté per procés, no per fil. Per tant, en un entorn multifils, quan s'executen diversos projectes pel mateix procés d'Apache, és possible que la configuració regional es canviï en un altre fil i això canviï la manera com es poden processar les dades al fil Zabbix. Per obtindre més informació, consulteu els informes de problemes relacionats: - [ZBX-10911](https://support.zabbix.com/browse/ZBX-10911) (Problema amb la commutació de configuració regional de la interfície web) - [ZBX-16297](https://support.zabbix.com/browse/ZBX-16297) (Problema amb la gestió de nombres als gràfics mitjançant la funció `bcdiv` de les funcions BC Math) ### 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|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|float|Received value.| ### Històric de flotants L'objecte d'històric flotant té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |clock|timestamp|Hora en que el valor s'ha rebut.| |itemid|string|ID de l'element associat.| |ns|integer|Nanosegons de quan es va rebre el valor.| |value|float|Valor rebut.| ### 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. E. g. timestamp of 04:00:00 means values calculated for period 04:00:00-04:59:59.| |itemid|integer|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.| ### Tendència flotant L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |clock|timestamp|La marca de temps d'una hora per a la qual es va calcular el valor. Per exemple: la marca de temps de 04:00:00 significa valors calculats per al període 04:00:00-04:59:59.| |itemid|integer|Id de l'element relacionat.| |num|integer|Nombre de valors disponibles per al temps.| |value\_min|float|Valor horari mínim.| |value\_avg|float|Valor horari mitjà.| |value\_max|float|Valor horari màxim.| ##### 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. ##### Notes de peu ^**1***^Nota específica de Linux: L'agent Zabbix ha de tindre accés només de lectura a sistema de fitxers */proc*. Els pedaços del nucli de www.grsecurity.org limiten els drets d'accés dels usuaris no privilegiats. ^**2**^ `vfs.dev.read[]`, `vfs.dev.write[]`: l'agent de Zabbix tancarà les connexions "obsoletes" de dispositius si no s'accedeix als valors de l'element durant més de 3 hores. Això pot passar si un sistema té dispositius amb dinàmica canviant o si un dispositiu s'esborra manualment. Tingueu en compte també que aquests elements, si s'empren un interval d'actualització de 3 hores o més, sempre retornaran '0'. ^**3**^ `vfs.dev.read[]`, `vfs.dev.write[]`: si s'empra *all* per defecte per al primer paràmetre, la clau retornarà estadístiques de resum, incloent tots els dispositius de bloc com sda, sdb i les seves particions (sda1, sda2, sdb3...) i diversos dispositius (MD raid) basats en aquests blocs de dispositius/particions i volums lògics (LVM) basats en aquests blocs de dispositius/particions. En aquests casos, s'han de tindre en compte els valors retornats només com a valor relatiu (dinàmic en el temps) però no com a valors absoluts. ^**4**^ SSL (HTTPS) només és compatible si l'agent es compila amb suport de cURL. En cas contrari, l'element no serà pas compatible. ##### Footnotes ^**1**^ Default value. ##### Notes a peu de pàgina ^**1**^ Valor per defecte. ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "EMAIL") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### Notes de peu de pàgina ^**1**^ Per als valors de tipus de cadena de caràcters, només s'exportarà la cadena (per exemple, "EMAIL") sense la numeració emprada en aquesta taula. S'empren nombres per als valors d'interval (corresponents als valors de l'API) en aquesta matriu només a petició. ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### Notes de peu de pàgina ^**1**^ Per als valors de tipus de cadena de caràcters, només s'exportarà la cadena (per exemple, "ZABBIX\_ACTIVE") sense la numeració emprada en aquesta taula. S'empren nombres per als valors d'interval (corresponents als valors de l'API) en aquesta matriu només a petició. ##### Footnotes ^**1**^ For string values, only the string will be exported (e.g. "ZABBIX\_ACTIVE") without the numbering used in this table. The numbers for range values (corresponding to the API values) in this table is used for ordering only. ##### Notes de peu de pàgina ^**1**^ Per als valors de tipus de cadena de caràcters, només s'exportarà la cadena (per exemple, "ZABBIX\_ACTIVE") sense la numeració emprada en aquesta taula. S'empren nombres per als valors d'interval (corresponents als valors de l'API) en aquesta matriu només a petició. ##### 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 "\*\*\*\*\*\*". ##### Notes de peu de pàgina ^**1**^ Si múltiples macros en un camp o macros barrejades amb text no s'admeten per la ubicació, una sola macro ha d'omplir el camp. ^**2**^ Les macros emprades als noms i els valors de les etiquetes es resolen només durant el procés de generació d'esdeveniments. ^**3**^ Les URL que contenen una [macro secreta](/manual/config/macros/user_macros#configuration) no funcionaran pas, doncs la macro que conté es resoldrà com a "\*\*\*\*\*\*". ##### 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. ##### Notes de peu de pàgina ^**1**^ Als camps marcats amb ^[1](lld_macros#footnotes)^ una sola macro hauria d'omplir tot el camp. No s'admeten diverses macros en un camp o les macros barrejades amb text. ##### Footnotes ^**1**^ net.if.in, net.if.out and net.if.total items do not provide statistics of loopback interfaces (e.g. lo0). ^**2**^ These values for these items 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 guesstimates. The Zabbix agent does not do any guess work, but net-snmp will return a value for these fields. ^**3**^ 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. ^**4**^ Not supported on Windows Event Log. ^**5**^ On Windows XP vfs.file.time\[file,[change]{.underline}\] may be equal to vfs.file.time\[file,[access]{.underline}\]. ^**6**^ Supported only by Zabbix agent 2; not supported by Zabbix agent. ^**7**^ Supported only by Zabbix agent 2 on 64-bit Windows; not supported by Zabbix agent. ##### Notes de peu de pàgina ^**1**^ Els elements net.if.in, net.if.out et net.if.total no proveeixen estadístiques de les interfícies de (per exemple, lo0). ^**2**^ Aquests valors per aquests elements no s'admeten per les interfícies de loopback sota sistemes Solaris fins a Solaris 10 6/06, doncs les estadístiques d'octet, d'error i d'ús no s'emmagatzemen pas i/o reporten per el kernel. Tanmateix, si monitoreu un sistema Solaris via net-snmp, els valors es poden reenviar doncs net-snmp conté el codi heretat de cmu-snmp tan antic com 1997 qui, en no llegir els valors de bytes de les estadístiques de la interfície, retorna el comptador de paquets (que existeix a les interfícies de loopbak) multiplicat per un valor arbitrari de 308. Això suposa que la longitud mitjana d'un paquet és de 308 octets, que és una estimació massa aproximada doncs el límit MTU dels sistemes Solaris per les interfícies de loopback és de 8892 octets. Aquests valors no han de considerar-se pas correctes o gaire precisos. Són estimacions. L'agent Zabbix no fa pas cap treball de conjectura, però net-snmp retornarà un valor per aquests camps. ^**3**^ La línia de comandes sota Solaris, obtinguda a partir de de /proc/pid/psinfo, es limita a 80 octets i conté la línia de comandes tal com era quan el procés va engegar. ^**4**^ No suportat per al registre d'esdeveniments de Windows. ^**5**^ Sota Windows XP, vfs.file.time\[file,[change]{.underline}\] pot ésser igual a vfs.file.time\[file,[access]{.underline}\]. ^**6**^ Suportat només per l'agent Zabbix 2 ; no suportat per l'agent Zabbix. ^**7**^ Suportat només per l'agent Zabbix 2 sota Windows 64 bits ; no suportat per l'agent Zabbix. ##### 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 and preprocessing workers can **exhaust** the per-process file descriptor limit for the preprocessing manager. ::: notewarning This will cause Zabbix server to stop (usually shortly after the start, but sometimes it can take more time). The configuration file should be revised or the limit should be raised to avoid this situation. ::: ^**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. ##### Notes de peu de pàgina ^**1**^ Tingueu en compte que massa processos de recollida de dades (enquestadors, enquestadors d'inaccessibilitat, enquestadors ODBC, enquestadors HTTP, enquestadors Java, pingers, trappers, pollers proxy) juntament amb el controlador IPMI, el trapper SNMP i el preprocessador poden **exhaurir** el límit del descriptor de fitxer per processos per al gestor de preprocessament. ::: notewarning Això farà que el servidor Zabbix s'aturi (normalment poc després d'iniciar-se, però de vegades pot trigar més). S'ha de revisar el fitxer de configuració o pujar el límit per evitar aquesta situació. ::: ^ ** 2 ** ^ Quan s'esborren molts elements, puja la càrrega de la base de dades, perquè la neteja haurà d'esborrar totes les dades històriques que tenien aquests elements. Per exemple, si només hem d'esborrar un prototip d'element de la plantilla, però aquesta plantilla és lligada a 50 equips i, per cada equip, el prototip s'amplia a 100 elements reals, s'han d'esborrar 5000 elements en total (1\ *50\* 100). Si s'estableix 500 per a MaxHousekeeperDelete (MaxHousekeeperDelete=500), el procés de neteja hauria d'esborrar fins a 2500000 valors (5000\*500) per als elements esborrats de l'historial i les taules de tendències en un cicle. ##### 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) is used to refresh their data in Zabbix VMware cache: - 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 ##### Notes de peu de pàgina ^**1**^ Veieu [Creació de noms de comptadors de rendiment personalitzats per VMware](/manual/appendix/items/perf_counters). ^**2**^ El valor dels elements s'obté a partir dels càlculs de rendiment de VMware i el [paràmetre VMwarePerfFrequency](/manual/appendix/config/zabbix_server) s'empra per actualitzar les seves dades a la cau Zabbix VMware : - 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**^ - Since Zabbix 6.0.13, loadable plugins started using the same versioning system as Zabbix itself. As a result, MongoDB plugin version has changed from 1.2.0 to 6.0.13. ### Nota al peu ^**1**^ - Des de Zabbix 6.0.13, els plugins carregables han començat a emprar el mateix sistema de versionat que el del Zabbix. Per això, la versió del plugin de MongoDB ha canviat d'1.2.1 a 6.0.13. ##### Footnotes ^**1**^ - Since Zabbix 6.0.13, loadable plugins started using the same versioning system as Zabbix itself. As a result, MongoDB plugin version has changed from 1.2.0 to 6.0.13 and PostgreSQL plugin version has changed from 1.2.1 to 6.0.13. ##### Nota al peu ^**1**^ - Des de Zabbix 6.0.13, els plugins carregables han començat a emprar el mateix sistema de versionat que el del Zabbix. Per això, la versió del plugin de MongoDB ha canviat d'1.2.0 a 6.0.13 i la versió del plugin de PostgreSQL ha canviat de la 1.2.1 a la 6.0.13. ##### 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 the **avg**, **last**, **max** and **min** functions, with seconds as parameter are supported in this macro in map labels. ^**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 the **avg**, **last**, **max** and **min** functions, with seconds as parameter are supported within this macro in graph names. The {HOST.HOST<1-9>} macro can be used as host within the macro. For example: last(/Cisco switch/ifAlias[{#SNMPINDEX}]) last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}]) ^**6**^ Supported since 5.2.5. ##### Notes de peu de pàgina ^**1**^ Les macros `{HOST.*}` admeses als paràmetres clau de l'element es resoldran a la interfície seleccionada per l'element. Quan s'empren en elements sense interfícies, es resoldran per l'agent Zabbix, la interfície SNMP, JMX o IPMI de l'equip en aquest ordre de prioritat, o per 'DESCONEGUT' si l'equip no té pas cap interfície. ^**2**^ Als scripts globals, els camps d'interfície IP/DNS i d'escenaris web, la macro es resoldrà a la interfície de l'agent principal. Si no s'ha definit una interfície d'agent, s'emprarà la interfície SNMP principal. Si no s'ha definit una interfície SNMP , s'emprarà la interfície JMX principal. Si tampoc s'ha definit una interfície JMX, s'emprarà la interfície IPMI principal. Si l'equip no té cap interfície, la macro es resol a 'DESCONEGUT'. ^**3**^ Només les funcions **avg**, **last**, **max** i **min**, amb els segons com a paràmetre, són compatibles amb aquesta macro a les etiquetes de mapa. ^**4**^ Les macros `{HOST.*}` s'admeten als camps *Variables*, *Capçaleres*, *Fitxer de certificat SSL* i *Fitxer de clau SSL* de la línia de temps web i a les passes de l'escenari; els camps *URL*, *Publicació*, *Capçaleres* i *String* són obligatoris. Des de Zabbix 5.4.0, les macros `{HOST.*}` ja no són compatibles amb els camps de l'escenari web *Nom* i el pas de l'escenari web *Nom*. ^**5**^ Només les funcions **avg**, **last**, **max** i **min**, amb els segons com a paràmetre, són compatibles amb aquesta macro als noms del gràfic. La macro {HOST.HOST<1-9>} es pot emprar com a equip a la macro. Per exemple: last(/Cisco switch/ifAlias[{#SNMPINDEX}]) last(/{HOST.HOST}/ifAlias[{#SNMPINDEX}]) ^**6***^ Suportat des de 5.2.5. ##### 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. ##### Horitzó de previsió (**forecast** només)<br> El paràmetre `time` especifica fins a quin punt del futur Zabbix hauria d'extrapolar les dependències que es troben a les dades històriques. Tant se val si feu servir `time_shift` o no, el `time` sempre es compta des del moment present. #### Format-specific notes #### Notes específiques de format #### 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.| #### Botons de formulari Els botons de la part inferior del formulari us permeten realitzar diverses operacions. | | | |--|---------| ||Afegeix una regla de descoberta. Aquest botó només és disponible per a regles de descoberta noves.| ||Actualitza les propietats d'una regla de descoberta. Aquest botó només és disponible per a les regles de descoberta existents.| ||Crea una altra regla de descoberta basada en les propietats de la regla de descoberta actual.| ||Fer la descoberta de seguida segons la regla de descoberta. La regla de descoberta ha d'existir. Veieu [més detalls](/manual/config/items/check_now).<br>*Tingueu en compte* que durant la descoberta immediata, la memòria cau de configuració no s'actualitza, de manera que el resultat no reflectirà els canvis més recents a la configuració de la regla de descoberta. | ||ESborra la regla de descoberta.| ||Cancel·la la modificació de propietats de la regla de descoberta.| #### 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.| #### Botons de formulari Els botons abaix del formulari permeten fer múltiples operacions. | | | |---|---| ||Afegeix un element. Aquest botó només està disponible per a elements nous.| ||Actualitza les propietats dels elements.| ||Crear un altre element basat en les propietats de l'element actual.| ||Executeu immediatament una comprovació d'un nou valor d'element. Només s'admet per a comprovacions **passives** (veieu [més detalls](/manual/config/items/check_now)).<br>*Tingueu en compte* que quan comproveu un valor immediatament, la configuració de la memòria cau no s'actualitza, de manera que el valor no reflectirà canvis molt recents a la configuració de l'element.| ||Comprova si la configuració de l'element és correcta obtenint un valor.| ||Esborra l'historial i les tendències d'actius.| ||Esborra l'element.| ||Cancel·la la modificació de les propietats de l'element.| ##### 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.| ##### Botons de formulari Els botons de la part inferior del formulari us permeten realitzar diverses operacions. | | | |--|---------| ||Afegeix un informe. Aquest botó només és disponible per a informes nous.| ||Actualitza les propietats de l'informe.| ||Crear un altre informe basat en les propietats de l'informe actual.| ||Comprova si la configuració de l'informe és correcta enviant un informe a l'usuari actual.| ||Esborra l'informe.| ||Cancel·la la modificació de propietats de l'informe.| #### 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 A la següent taula hi trobareu els valors admesos per al paràmetre 'memtype'. |Valor admès|Descripció|Font a l'estructura kinfo\_proc|Intents per ésser compatible| |--|------|--|--| |vsize|Mida de la memòria virtual|kp\_eproc.e\_vm.vm\_map.size ou ki\_size|ps -o vsz| |pmem|Percentatge de la memòria real|calculat a partir de rss|ps -o pmem| |rss|Mida del conjunt de residents|kp\_eproc.e\_vm.vm\_rssize ou ki\_rssize|ps -o rss| |size ^[1](proc_mem_notes#footnotes)^|mida dels processos (codi + dades + pila)|tsize + dsize + ssize| | |tsize|Mida del text (codi)|kp\_eproc.e\_vm.vm\_tsize ou ki\_tsize|ps -o tsiz| |dsize|Mida de les dades|kp\_eproc.e\_vm.vm\_dsize ou ki\_dsize|ps -o dsiz| |ssize|Mida de la pila|kp\_eproc.e\_vm.vm\_ssize ou ki\_ssize|ps -o ssiz| ## Frontend ## Interfície ## Frontend ## Interfície ## Frontend ## Interfície ## Frontend ## Interfície ## Frontend ## Interfície ## Frontend ## Interfície #### 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 #### Accés a la interfície Web Per defecte, l'accés a la interfície Web es permet des de qualsevol lloc. La interfície Web és accessible a l'adreça *http://<host>*. Es pot personalitzar a **/etc/nginx/conf.d/zabbix.conf**. Nginx s'ha de reiniciar després d'haver modificat l'arxiu. Per fer-ho, connecteu-vos amb SSH i usuari **root** i executeu: systemctl restart nginx ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Configuració de la interfície El proxy Zabbix no té pas interfície; comunica només amb el servidor Zabbix. ##### Frontend configuration A Zabbix proxy does not have a frontend; it communicates with Zabbix server only. ##### Configuració de la interfície El proxy Zabbix no té pas interfície; comunica només amb el servidor Zabbix. **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 to templates: Linux 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. ** Configuració de la interfície web ** Creeu una acció a la interfície, emprant un mot de pas difícil d'endevinar per prohibir els equips no desitjats: - Nom: Acció de desat automàtic de Linux - Condicions: - Tipus de càlcul: AND - Condició (A): les metadades de l'equip contenen Linux - Condició (B): les metadades de l'equip contenen 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Operacions: - Usuaris de missatges: administrador a través de tots els suports - Afegeix al grup d'equips: servidors Linux - Enllaç a la plantilla: Linux Tingueu en compte que aquest mètode per si sol no ofereix una protecció forta, ja que les dades es transmeten en text sense formatar. Cal tornar a carregar la memòria cau de configuració perquè els canvis tinguin efecte immediat. #### 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. #### Configuració de la interfície Web Els mòduls carregables són compatibles amb l'agent, el servidor i el proxy Zabbix. Per tant, el tipus d'element a la interfície Zabbix depèn d'on es carregui el mòdul. Si el mòdul es carrega a l'agent, el tipus d'element hauria d'ésser "agent Zabbix" o "agent Zabbix (actiu)". Si el mòdul es carrega al servidor o al proxy, el tipus d'element ha d'ésser "Verificació simple". L'exportació de l'historial mitjançant mòduls Zabbix no necessita cap configuració frontal. Si el servidor carrega correctament el mòdul i proporciona la funció **zbx\_module\_history\_write\_cbs()** que retorna almenys una funció de devolució de crida no NULL, l'exportació de l'historial s'activarà automàticament. **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 to templates: Linux ::: noteclassic You can skip an "Add host" operation in this case. Linking to a template requires adding a host first so the server will do that automatically. ::: The second action: - Name: Windows host autoregistration - Conditions: Host metadata contains *Windows* - Operations: Link to templates: Windows **Configuració de la interfície web** El primer que cal fer és configurar la interfície web. Crea 2 accions. La primera acció: - Nom: Linux Host Auto Registration - Condicions: les metadades de l'equip contenen *Linux* - Operacions: Enllaçar a la plantilla: Linux :::noteclassic Podeu ometre una operació "Afegeix equip" en aquest cas. La vinculació a un model requereix afegir primer un equip perquè el servidor ho faci automàticament. ::: El segon acte: - Nom: Windows Host Auto Registration - Condicions: les metadades de l'equip contenen *Windows* - Operacions: Enllaç a la plantilla: Windows **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 - Operations: - Send message to users: Admin via all media - Add to host groups: Linux servers - Link to templates: Linux - Link to templates: MySQL by Zabbix Agent **Configuració de la interfície web** Actualitzar una acció a la interfície: - Nom: Acció de desat automàtic de Linux - Condicions: - Tipus de càlcul: AND - Condició (A): les metadades de l'equip contenen Linux - Condició (B): les metadades de l'equip contenen 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae - Operacions: - Usuaris de missatges: administrador a través de tots els suports - Afegeix al grup d'equips: servidors Linux - Plantilles enllaçades: Linux - Plantilles enllaçades: MySQL per Agent de Zabbix ##### 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 ##### Configuració de la interfície amb Kerberos/ADFS El fitxer de configuració de la interfície de Zabbix (*zabbix.conf.php*) es pot utilitzar per configurar SSO amb autenticació Kerberos i ADFS: ```php $SSO['SETTINGS'] = [ 'security' => [ 'requestedAuthnContext' => [ 'urn:oasis:names:tc:SAML:2.0:ac:classes:Kerberos', ], 'requestedAuthnContextComparison' => 'exact' ] ]; ``` En aquest cas, al camp de configuració de SAML *ID de nom d'SP* es defineix: urn:oasis:names:tc:SAML:1.1:nameid-format:unspecified ### Frontend languages Catalan and Romanian languages are now enabled in the frontend. ### Idiomes de la interfície web S'han habilitat les llengües catalana i romanesa a la interfície web. #### Frontend languages Dutch, Georgian, and Spanish languages are now enabled in the frontend. ### Idiomes de la interfície web S'han habilitat les llengües neerlandesa, georgiana i espanyola a la interfície web. ### Frontend languages German and Vietnamese languages are now enabled in the frontend. ### Idiomes de la interfície web S'han habilitat les llengües alemanya i vietnamita a la interfície web. ### Frontend ##### Miscellaneous - Warnings about incorrect housekeeping configuration for TimescaleDB are now displayed if history or trend tables contain compressed chunks, but *Override item history period* or *Override item trend period* options are disabled. For more information, see [TimescaleDB setup](/manual/appendix/install/timescaledb#configuration). ### Interfície ##### Diversos - Es mostren avisos sobre una configuració incorrecta de manteniment per a TimescaleDB si l'historial o les taules de tendències contenen blocs comprimits, però l'*Anul·lació del període d'historial d'elements* o l'*Anul·lació del període de tendència de l'element* són desactivades. Per obtindre més informació, veieu la [Configuració de TimescaleDB](/manual/appendix/install/timescaledb#configuration). ##### 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|Version|Comments| |--|-|-|------| |*Apache*|One of|2.4 or later| | |*Nginx*|^|1.20 or later| | |*PHP*|Yes|7.2.5-8.3|PHP 7.4 or later is recommended.<br>PHP 7.3 or later is required since Zabbix 6.0.45, or if you are using SAML authentication with Zabbix 6.0.5 or later (see *SAML PHP Toolkit* library below).<br><br>Added support for PHP versions:<br>- 8.0 and 8.1 since Zabbix 6.0.6;<br>- 8.2 since Zabbix 6.0.14;<br>- 8.3 since Zabbix 6.0.26.| |PHP extensions:|<|<|<| |*gd*|Yes|2.0.28 or later|PHP GD extension must support PNG images (*--with-png-dir*), JPEG (*--with-jpeg-dir*) images and FreeType 2 (*--with-freetype-dir*).<br>Version 2.3.0 or later might be required to avoid possible [text overlapping in graphs](/manual/installation/known_issues#text-overlapping) for some frontend languages.| |*bcmath*|^| |php-bcmath (*--enable-bcmath*)| |*ctype*|^| |php-ctype (*--enable-ctype*)| |*libXML*|^|2.6.15 or later|php-xml, if provided as a separate package by the distributor.| |*xmlreader*|^| |php-xmlreader, if provided as a separate package by the distributor.| |*xmlwriter*|^| |php-xmlwriter, if provided as a separate package by the distributor.| |*session*|^| |php-session, if provided as a separate package by the distributor.| |*sockets*|^| |php-net-socket (*--enable-sockets*). Required for user script support.| |*mbstring*|^| |php-mbstring (*--enable-mbstring*)| |*gettext*|^| |php-gettext (*--with-gettext*). Required for translations to work.| |*ldap*|No| |php-ldap. Required only if LDAP authentication is used in the frontend.| |*openssl*|^| |php-openssl. Required only if SAML authentication is used in the frontend.| |*mysqli*|^| |Required if MySQL is used as Zabbix backend database.| |*oci8*|^| |Required if Oracle is used as Zabbix backend database.| |*pgsql*|^| |Required if PostgreSQL is used as Zabbix backend database.| 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/SAML-Toolkits/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>- 3.4.1 since Zabbix 6.0.0;<br>- 4.0.0 since Zabbix 6.0.5 (requires PHP 7.3 or later);<br>- 4.3.1 since Zabbix 6.0.45 (recommended; requires PHP 7.3 or later).| |[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).| ##### Interfície L'amplada de pantalla mínima admesa per a la interfície Zabbix és de 1200 píxels. Els requisits obligatoris són sempre necessaris. Es necessiten requisits opcionals per al suport de la funció específica. |Programari|Estat obligatori|Versió|Comentaris| |--|-|-|------| |*Apache*|sí|1.3.12 o posterior| | |*Nginx*|^|1.20 o posterior| | |*PHP*|sí|7.2.5 o posterior, 8.0-8.3|PHP 7.4 o posterior es recomana. Si utilitzeu l'autenticació SAML, PHP 7.3 o posterior és necessari (veieu la biblioteca *SAML PHP Toolkit * a continuació).<br><br>Suport afegit per a les versions de PHP:<br>- 8.0 i 8.1 des de Zabbix 6.0.6; <br>- 8.2 des de Zabbix 6.0.14;<br>- 8.3 des de Zabbix 6.0.26.| |Extensions PHP:|<|<|<| |*gd*|sí|2.0.28 o posterior|L'extensió PHP GD ha de suportar imatges PNG (*--with-png-dir*), imatges JPEG (*--with-jpeg-dir*) i FreeType 2 (*--amb-freetype-dir*).| |*bcmath*|^| |php-bcmath (*--enable-bcmath*)| |*ctype*|^| |php-ctype (*--enable-ctype*)| |*libXML*|^|2.6.15 o posterior|php-xml, si el distribuïdor el proporciona com a paquet separat.| |*xmlreader*|^| |php-xmlreader, si el distribuïdor proporciona com a paquet separat.| |*xmlwriter*|^| |php-xmlwriter, si el distribuïdor proporciona com a paquet separat.| |*sessió*|^| |php-session, si el distribuïdor proporciona com a paquet separat.| |*sockets*|^| |php-net-socket (*--enable-sockets*). Necessari per al suport d'scripts d'usuari.| |*mbstring*|^| |php-mbstring (*--enable-mbstring*)| |*gettext*|^| |php-gettext (*--amb-gettext*). Necessari perquè les traduccions funcionin.| |*ldap*|No| |php-ldap. Només es requereix si s'empra l'autenticació LDAP al frontend.| |*openssl*|^| |php-openssl. Només es requereix si s'empra l'autenticació SAML a la interfície.| |*mysqli*|^| |Necessari si MySQL s'empra com a base de dades de fons Zabbix.| |*oci8*|^| |Necessari si Oracle s'empra com a base de dades de fons Zabbix.| |*pgsql*|^| |Necessari si PostgreSQL s'empra com a base de dades de fons Zabbix.| Biblioteques d'interfície de tercers que es proporcionen amb Zabbix: |Biblioteca|Estat obligatori|Versió mínima|Comentaris| |--|-|-|------| |[Biblioteca JavaScript jQuery](https://jquery.com/)|Sí|3.6.0|Biblioteca JavaScript que simplifica el procés de desenvolupament entre navegadors.| |[Interfície d'usuari de jQuery](https://jqueryui.com/)|^|1.12.1|Un conjunt d'interaccions d'interfície d'usuari, efectes, ginys i temes construïts a sobre de jQuery.| |[El conjunt d'eines SAML PHP](https://github.com/onelogin/php-saml)|^|4.3.1|Un conjunt d'eines PHP que afegeix suport d'autenticació SAML 2.0 per poder iniciar la sessió a Zabbix.<br><br>Història de la versió subministrada:<br>- 3.4.1 des de Zabbix 6.0.0;<br>- 4.0.0 des de Zabbix 6.0.5 (requereix PHP 7.3 o posterior);<br>- 4.3.1 des de Zabbix 6.0.45 (recomanat; requereix PHP 7.3 o posterior).| |[Component de Symfony Yaml](https://symfony.com/doc/current/components/yaml.html)|^|5.1.0|Afegeix suport per exportar i importar elements de configuració Zabbix en format YAML.| ::: noteclassic Zabbix també pot funcionar amb versions anteriors d'Apache, MySQL, Oracle i PostgreSQL. ::: ::: noteimportant Per a altres tipus de lletra que no siguin el DejaVu predeterminat, pot ser que sigui necessària la funció PHP [imagerotate](http://php.net/manual/en/function.imagerotate.php). Si no hi ha, és possible que aquests tipus de lletra es representi incorrectament quan es mostri un gràfic. Aquesta funció només és disponible si PHP es compila amb GD inclòs, cosa que no és el cas a Debian i altres distribucions. ::: Biblioteques de tercers que s'empren per escriure i depurar el codi frontal de Zabbix: |Biblioteca|Estat obligatori|Versió mínima|Descripció| |--|-|-|------| |[Composer](https://getcomposer.org/)|No|2.4.1|Un gestor de paquets a nivell d'aplicació per a PHP que proporciona un format estàndard per gestionar les dependències del programari PHP i les biblioteques necessàries.| |[PHPUnit](https://phpunit.de/)|^|8.5.29|Un marc de proves d'unitat PHP per provar la interfície Zabbix.| |[SASS](https://sass-lang.com/)|^|3.4.22|Un llenguatge de programació de preprocessador que s'interpreta i compila en fulls d'estil en cascada (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'] = ''; ... #### Frontend Per activar el xifrat amb certificat i verificació per les connexions entre la interfície Zabbix i la base de dades: - Marqueu *xifrat TLS de la base de dades* i *Verifiqueu el certificat de la base de dades* - Especifiqueu la ruta d'accés a l'*arxiu de clau TLS de la base de dades* - Especifiqueu la ruta d'accés a l'*arxiu CA TLS de la base de dades* - Especifiqueu la ruta d'accés a l'*arxiu de certificat TLS de la base de dades* - Marqueu *Verificació de l'equip de la base de dades* {width="600"} Alternativament, es pot definir a */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'] = ''; ... #### Frontend Per activar el xifrat amb verificació de l'autoritat de certificació per les connexions entre la interfície Zabbix i la base de dades: - Marqueu *xifrat TLS de la base de dades* i *Verifiqueu el certificat de la base de dades* - Especifiqueu la ruta d'accés a l'*arxiu TLS CA de la base de dades* {width="600"} Alternativament, es pot definir a */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 #### Frontend Per habilitar l'encriptació amb la verificació del certificat per a les connexions entre el frontend de Zabbix i la base de dades: - Comproveu *xifratge TLS de la base de dades* i *Verifiqueu el certificat de la base de dades* - Especifiqueu el camí al fitxer CA TLS de la base de dades {width="600"} Alternativament, ho podeu configurar a */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'] = ''; ... Resoleu problemes d'usuari mitjançant l'eina de línia d'ordres per comprovar si la connexió és possible per a l'usuari requerit: 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'] = ''; ... #### Frontend Per habilitar el xifrat amb una verificació completa de les connexions entre el Frontend de Zabbix i la base de dades: - Comproveu el *xifrat TLS de la base de dades* i el *certificat de la base de dades* - Especifiqueu el camí al *fitxer de claus TLS de la base de dades* - Especifiqueu el camí al *fitxer CA TLS de la base de dades* - Especifiqueu el camí al *fitxer del certificat TLS de la base de dades* Tingueu en compte que la *Verificació de l'equip de la base de dades* és marcada i en gris, aquesta passa no es pot pas saltar a MySQL. ::: notewarning Llista de xifrat hauria d'ésser buida, de manera que la interfície i el servidor puguin negociar el xifrat suportat per ambdós extrems. ::: {width="600"} Altrament, això es pot configurar a */etc/zabbix/web/zabbix.conf.php*: ... // S'empra per a la connexió TLS amb una llista de xifratge estrictament definida. $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'; ... // o ... // Emprat per connexions TLS sense llista de xifratge definida - escollit per 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"} #### Frontend Per activar el xifrat de transport només per les connexions entre la interfície Zabbix i la base de dades: - Marqueu *Xifrat TLS de la base de dades* - Deixeu *Verificar el certificat de la base de dades* desmarcat {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"} #### Frontend Per activar el xifrat de transport només per les connexions entre la interfície Zabbix i la base de dades: - Marqueu *Xifrat TLS de la base de dades* - Deixeu *Verificar el certificat de la base de dades* desmarcat {width="600"} ##### 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. ::: ##### Interfície de la base de dades Es pot configurar una connexió segura cap a la base de dades durant la instal·lació de la interfície: - Marqueu la casella *Xifrat TLS de la base de dades* a la passa [Configurar la connexió a la base de dades](/manual/installation/frontend#configure_db_connection) per activar el xifrat del transport. - Marqueu la casella *Verificar el certificat de la base de dades* que apareix després que el camp *Xifrat TLS* sigui marcat per activar el xifrat amb certificats. ::: noteclassic Per MySQL, la casella a marcar *Xifrat TLS de la base de dades* és desactivada, si *Equip de la base de dades* és definit a localhost, doncs la connexió que empra un arxiu socket (sota Unix) o de la memòria compartida (sota Windows) no es pot pas xifrar.\ Per PostgreSQL, la casella a marcar *Xifrat TLS* és desactivada, si el valor del camp *Equip de la base de dades* comença amb una barra obliqua o el camp és buit. ::: Els paràmetres següents són disponibles al xifrat TLS en mode certificats (si els dos casos són marcats): |Paràmetre|Descripció| |--|--------| |*Arxiu CA TLS de la base de dades*|Especifiqueu el camí d'accés complet a un arxiu d'autoritat de certificació TLS vàlid.| |*Arxiu de clau TLS de la base de dades*|Especifiqueu el camí d'accés complet a un arxiu de clau TLS vàlid.| |*Arxiu de certificat TLS de base de dades*|Especifiqueu el camí d'accés complet a un arxiu de certificat TLS vàlid.| |*Verificació de l'equip de la base de dades*|Marqueu aquest cas per activar la verificació de l'equip.<br>Desactivat per MYSQL, doncs la biblioteca PHP MySQL no permet pas ignorar l'etapa de validació del certificat parell.| |*Llista de xifrat TLS de la base de dades*|Especifiqueu una llista personalitzada de xifrats vàlids. El format de la llista de xifrat ha d'ésser conforme a la norma OpenSSL.<br>Disponible només per MySQL.| ::: noteimportant Els paràmetres TLS han d'apuntar a fitxers vàlids. Si apunten cap a arxius no existents o invàlids donarà lloc a un error d'autorització.\ Si els arxius de certificat són accessibles d'escriptura, la interfície genera un avís a les [informacions de sistema](/manual/web_interface/frontend_sections/reports/status_of_zabbix) assenyalant que "els fitxers de certificat TLS han d'ésser de només lectura". (afegir només si l'usuari PHP és el propietari del certificat). Els certificats protegits per paraules de pas no son pas admesos. ::: #### 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`. 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). #### Paràmetres de la funció Els paràmetres de funció permeten especificar: - l'equip i la clau de l'element (funcions referides només a l'historial de l'element de l'equip) - Paràmetres específics de la funció - altres expressions (no disponible per a funcions que fan referència a l'historial de l'element equip, veieu [altres expressions](#other_expressions) per a exemples) L'equip i la clau de l'element es poden especificar com a "/host/key". L'element referenciat ha d'estar en un estat compatible (excepte per a la funció **nodata()**, que també es calcula per als elements no compatibles). Mentre que altres triggers com a paràmetres de funció es limiten a funcions no històriques en triggers, aquesta limitació no s'aplica als [elements calculats](/manual/config/items/itemtypes/calculated). ## Functions ## Funcions #### 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 the "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. #### Funcions Abans d'establir un trigger, cal definir quin és un estat problema i quant de temps cal per actuar. A continuació, hi ha dues maneres de configurar una senyalització de trigger sobre una possible situació no desitjada. Primer: el trigger s'ha de disparar quan s'espera que el sistema sigui en estat problemàtic després del "temps per actuar". Segon: el trigger s'ha de disparar quan el sistema arribi a l'estat del problema en menys de "temps per actuar". Les funcions de trigger corresponents a emprar són **previsió** i **temps restant**. Tingueu en compte que l'anàlisi estadística subjacent és bàsicament idèntica per a ambdues funcions. Podeu configurar un trigger de la manera que preferiu amb resultats similars. #### Functions for Prometheus histograms It has been possible to collect [Prometheus metrics](/manual/config/items/itemtypes/http/prometheus) in Zabbix for a while now, but some of the metrics are difficult to work with. Specifically, the metrics of histogram type can be presented in Zabbix as multiple items with the same key names, but different parameters. However, even though such items are logically related and represent the same data, it has been difficult to analyze the collected data without specialized functions. To cover this functionality gap in the new version, **rate()** and **histogram\_quantile()** functions, producing the same result as their PromQL counterparts, have been added. Other new additions to complement this functionality are the **bucket\_rate\_foreach()** and the **bucket\_percentile()** functions. For more information see: - [History functions](/manual/appendix/functions/history#history-functions-1) (see **rate()**) - [Aggregate functions](/manual/appendix/functions/aggregate#aggregate-functions-1) (see **histogram\_quantile()**, **bucket\_percentile()**) - [Foreach functions](/manual/appendix/functions/aggregate/foreach) (see **bucket\_rate\_foreach()**) ##### Funcions per a histogrames Prometheus Fa temps que és possible recopilar [mètriques de Prometheus](/manual/config/items/itemtypes/http/prometheus) a Zabbix, però és difícil treballar amb algunes de les mètriques. Concretament, les mètriques del tipus d'histograma es poden presentar a Zabbix com a diversos elements amb els mateixos noms de clau, però amb paràmetres diferents. Tanmateix, tot i que aquests elements són relacionats lògicament i representen les mateixes dades, ha estat difícil analitzar les dades recollides sense funcions especialitzades. Per cobrir aquest buit de funcionalitat a la nova versió, s'han afegit les funcions **rate()** i **histogram\_quantile()**, que produeixen el mateix resultat que els seus homòlegs de PromQL. Altres noves incorporacions per complementar aquesta funcionalitat són les funcions **bucket\_rate\_foreach()** i **bucket\_percentile()**. Per a més informació consulteu: - [Funcions d'historial](/manual/appendix/functions/history#history-functions-1) (see **rate()**) - [Funcions d'afegit](/manual/appendix/functions/aggregate#aggregate-functions-1) (veieu **histogram\_quantile()**, **bucket\_percentile()**) - [Funcions foreach](/manual/appendix/functions/aggregate/foreach) (see **bucket\_rate\_foreach()**) #### 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)). #### Funcions Les funcions permeten calcular els valors recollits (mitjana, mínim, màxim, suma), cercar cadenes, fer referència a l'hora actual i altres factors. Hi ha disponible una llista completa de [funcions admeses](/manual/appendix/functions). En general, les funcions retornen valors numèrics amb finalitats de comparació. Quan tornen cadenes, la comparació és possible amb els operadors **=** i **<>** (veieu l'[exemple](#exemple_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 input array.|Array of numbers.|Number.| |`min`|Minimum value of numbers in input array.|Array of numbers.|Number.| |`max`|Maximum value of numbers in input array.|Array of numbers.|Number.| |`sum`|Sum of numbers in input array.|Array of numbers.|Number.| |`length`|Number of elements in input array.|Array.|Number.| |`first`|The first array element.|Array.|A JSON construct (object, array, value) depending on input array contents.| Quoted numeric values are accepted by the JSONPath aggregate functions. It means that the values are converted from string type to numeric if aggregation is required. Incompatible input will cause the function to generate error. #### Funcions Les funcions es poden emprar al final d'un JSONPath. Es poden encadenar diverses funcions si la funció anterior retorna un valor acceptat per la funció següent. Funcions admeses: |Funció|Descripció|Entrada|Sortida| |--|--------|----|----| |`avg`|Valor mitjà dels nombres a la matriu d'entrada.|Matriu de nombres.|Nombre.| |`min`|Valor mínim dels nombres a la matriu d'entrada.|Matriu de nombres.|Nombre.| |`max`|Valor màxim dels nombres a la matriu d'entrada.|Matriu de nombres.|Nombre.| |`sum`|Suma de nombres de la matriu d'entrada.|Matriu de nombres.|Nombre.| |`length`|Nombre d'elements a la matriu d'entrada.|Matriu.|Nombre.| |`first`|El primer element de la matriu.|Matriu.|Una construcció JSON (objecte, matriu, valor) basada en el contingut de la matriu d'entrada.| Els valors numèrics entre cometes són admesos per les funcions agregades JSONPath. Això vol dir que els valors es converteixen del tipus de cadena a numèric si cal l'agregació. Una entrada incompatible farà que la funció generi un error. ##### 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' ##### Paràmetres específics de la funció Els paràmetres específics de la funció es posen després de la clau d'element i es separen de la clau d'element per una coma. Veieu les [funcions compatibles](/manual/appendix/functions) per obtindre una llista completa d'aquests paràmetres. La majoria de les funcions numèriques accepten el temps com a paràmetre. Podeu emprar segons o [sufixos de temps](/manual/apèndix/sufixos) per indicar l'hora. Precedit d'una marca de hash, el paràmetre té un altre significat: |Expressió|Descripció| |----------|-----------| |**sum**(/host/key,**10m)**|Suma dels valors dels darrers 10 minuts.| |**sum**(/host/key,**\#10)**|Suma dels darrers deu valors.| Els paràmetres amb una marca de hash tenen un significat diferent amb la funció **darrera**: denoten l'enèsim valor anterior, de manera que tinguent en compte els valors 30, 70, 20, 60, 50 (del més nou al més antic): - `last(/host/key,#2)` retornaria '70' - `last(/host/key,#5)` retornaria '50' #### Function syntax Foreach functions support two common parameters: `item filter` (see details below) and `time period`: 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). #### Sintaxi de la funció Les funcions Foreach admeten dos paràmetres comuns: `filtre de l'element` (veieu els detalls a sota) i `període de temps`: foreach_function(item filter,time period) Per exemple: `avg_foreach(/*/mysql.qps?[group="MySQL Servers"],5m)` retorna la mitjana de cinc minuts de cada element 'mysql.qps' del grup de servidors MySQL. Veieu que algunes funcions admeten [paràmetres](#additional_parameters) addicionals. ### Further reading You now know enough to start working with the Zabbix API, but don't stop here. For further reading we suggest you have a look at the [list of available APIs](/manual/api/reference). ### Lectures complementàries Ara coneixeu força bé com treballar amb l'API Zabbix, però no us atureu pas! Per aprendre'n més, us recomanem consultar la [llista d'APIs disponibles](/manual/api/reference). #### General #### General #### General advice - monitor required parameters only - tune 'Update interval' for all items. Keeping a small update interval may be good for nice graphs, however, this may overload Zabbix - tune parameters for default templates - tune housekeeping parameters - do not monitor parameters which return the same information. - avoid the use of triggers with long period given as function argument. For example, max(/host/key,1h) will be calculated significantly slower than max(/host/key,1m). #### Consells generals - Monitoreu només els paràmetres necessaris - Establiu "interval d'actualització" per a tots els elements. Mantindre un petit interval d'actualització pot mostrar gràfics agradables, però, pot sobrecarregar Zabbix. - Ajusteu la configuració de les plantilles predeterminades. - Establiu paràmetres de manteniment. - No superviseu els paràmetres que retornen la mateixa informació. - Eviteu emprar triggers amb un període llarg donat com a argument de funció. Per exemple, max(/host/key,1h) es calcularà molt més lent que max(/host/key,1m). #### General attributes The *User* tab contains general user attributes:  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. Starting with Zabbix 3.4.3 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.<br>With an existing password, contains a *Password* button, clicking on which opens the password fields.<br>Note that passwords longer than 72 characters will be truncated.| |*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. 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>[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.| |*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.| #### Atributs generals La pestanya *Usuari* conté atributs generals d'usuari:  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|Descripció| |--|---------| |*Nom d'usuari*|Nom d'usuari únic, emprat com a nom d'inici de sessió.| |*Nom*|Nom de l'usuari (opcional).<br>Si no és buit, mostra la informació del reconeixement i la informació del destinatari de la notificació.| |*Nom*|Nom d'usuari (opcional).<br>Si no és en blanc, mostra la informació d'aprovació i a la informació del destinatari de la notificació.| |*Grups*|Trieu els [grups d'usuaris](grup d'usuaris) al qual pertany l'usuari. A partir de Zabbix 3.4.3, aquest camp s'omple automàticament, de manera que començar a escriure un nom de grup d'usuaris oferirà una llista desplegable de grups coincidents. Desplaceu-vos cap avall per triar. També podeu fer clic a *Triar* per afegir grups. Feu clic a "x" per esborrar la selecció.<br>La pertinença a un grup d'usuaris determina a quins grups d'equips i equips tindrà [accés](permisos) l'usuari.| |*Mot de pas*|Dos camps per introduir el mot de pas de l'usuari.<br>Amb un mot de pas existent, conté un botó *Mot de pas*, fent clic, s'obren els camps de mot de pas.<br>Tingueu en compte que els mots de pas de més de 72 caràcters es truncaran.| |*Idioma*|Llengua de la interfície Zabbix.<br>L'extensió php gettext és necessària perquè les traduccions funcionin.| |*Timezone*|Trieu la zona horària per anul·lar la [zona horària](/manual/web_interface/time_zone#overview) a nivell d'usuari o trieu **Sistema predeterminat** per emprar la configuració global de la zona horària.| |*Tema*|Defineix l'aspecte de la interfície:<br>**Per defecte del sistema** - empra la configuració predeterminada del sistema<br>**Blau** - tema blau estàndard<br>**Fosc** - tema fosc alternatiu <br>**Llum de contrast alt** - tema de llum d'alt contrast<br>**Fosc de contrast alt** - tema fosc d'alt contrast| |*Inici de sessió automàtic*|Marqueu aquesta casella perquè Zabbix recordi l'usuari i iniciï sessió automàticament durant 30 dies. Les galetes del navegador s'empren amb aquesta finalitat.| |*Autologout*|Amb aquesta casella marcada, l'usuari es tancarà automàticament, després del nombre de segons establert (mínim 90 segons, màxim 1 dia).<br>Els [sufixos de temps](/manual/appendix/sufixes) s'accepten, per exemple, 90s, 5m, 2h, 1d.<br>Tingueu en compte que aquesta opció no funcionarà:<br>\* Si l'opció de configuració global "Mostra l'avís si el servidor Zabbix és executant un error" és activada i la interfície de Zabbix es manté oberta;<br> \* Quan les pàgines del menú Monitoratge fan actualitzacions d'informació de fons;<br>\* Si inicieu sessió amb l'opció *Recorda'm durant 30 dies* marcada.| |*Actualització*|Defineix la freqüència d'actualització emprada per a gràfics, dades de text sense format, etc. Es pot posar a 0 per desactivar.| |*Línies per pàgina*|Podeu determinar quantes línies per pàgina es mostraran a les llistes.| |*URL (després de l'inici de sessió)*|Podeu fer que Zabbix reenviï l'usuari a una URL específica després d'haver iniciat sessió correctament, per exemple, a la pàgina de problemes.| #### 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) | [User macro API](/manual/api/reference/usermacro) | [Settings API](/manual/api/reference/settings) | [Housekeeping API](/manual/api/reference/housekeeping) #### General Modificar opcions de configuració global. [API Enregistrement automàtic](/manual/api/reference/autoregistration) | [API Mapa d'icones](/manual/api/reference/iconmap) | [API Imatge](/manual/api/reference/image) | [API Usuari de macro](/manual/api/reference/usermacro) | [API Regles](/manual/api/reference/settings) | [API Manteniment](/manual/api/reference/housekeeping) #### 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. #### Recomanacions generals - Si hi ha un problema, primer entendre quin component actua com a client TLS i quin actua com a servidor TLS.<br> El servidor Zabbix, els proxys i els agents, depenent de la seva interacció, poden funcionar com a servidors i clients TLS.<br> Per exemple, el servidor Zabbix que es connecta a l'agent per a la verificació passiva, actua com a client TLS. L'agent actua com a servidor TLS.<br> L'agent Zabbix, que demana una llista de comprovacions actives al proxy, actua com a client TLS. El proxy actua com a servidor TLS.<br> Les utilitats `'zabbix\_get'` i `zabbix_sender` sempre actuen com a clients TLS. - Zabbix empra l'autenticació mútua. Cada costat comprova el seu igual i pot rebutjar la connexió.<br> Per exemple, el servidor Zabbix que es connecta a l'agent pot tancar la connexió immediatament si el certificat de l'agent no és vàlid. I viceversa: l'agent Zabbix que admet una connexió del servidor pot tancar la connexió si el servidor no confia en l'agent. - Examineu els fitxers de registre a les dues bandes: costat del client TLS i costat del servidor TLS.<br> La part que rebutja la connexió pot introduir una raó específica per la qual la va rebutjar. L'altra banda sovint informa d'un error força general (per exemple, "Connexió tancada pel parell", "la connexió ha acabat incorrectament"). - De vegades, el xifrat mal configurat provoca missatges d'error confusos que de cap manera indiquen una causa real.<br> A les subseccions següents, intentarem proporcionar una llista (lluny d'ésser exhaustiva) de possibles missatges i causes que poden ajudar a solucionar problemes.<br> Els kits d'eines (OpenSSL, GnuTLS) solen produir missatges d'error diferents en les mateixes situacions de problema.<br> De vegades, els missatges d'error depenen fins i tot d'una combinació particular de conjunts d'eines criptogràfiques a cada costat. #### Generate multiple tokens Generate two tokens. Request: ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 0 } ``` #### Generar diversos tokens Generar dos tokens. Petició: ```json { "jsonrpc": "2.0", "method": "token.generate", "params": [ "1", "2" ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": [ { "tokenid": "1", "token": "bbcfce79a2d95037502f7e9a534906d3466c9a1484beb6ea0f4e7be28e8b8ce2" }, { "tokenid": "2", "token": "fa1258a83d518eabd87698a96bd7f07e5a6ae8aeb8463cae33d50b91dd21bd6d" } ], "id": 0 } ``` ##### 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. ```{=html} <!-- --> ``` - 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). ```{=html} <!-- --> ``` - if trends are disabled, item history is used for graph building - if available for that period. This is supported starting with Zabbix 2.2.1 (before, disabled trends would mean an empty graph for the period even if item history was available). ##### Generar a partir de l'historial/tendències Els gràfics es poden dibuixar en funció dels elements [historial o tendències](/manual/config/items/history_and_trends). Per als usuaris que tenen la interfície de [mode de depuració](/manual/web_interface/debug_mode) activada, es mostra una llegenda vertical grisa a la part inferior dreta d'un gràfic que indica d'on provenen les dades. Diversos factors influeixen en l'ús de l'històric o les tendències: - longevitat de l'històric de l'element. Per exemple, l'històric d'articles es pot conservar durant 14 dies. En aquest cas, totes les dades anteriors a aquests catorze dies vindran de tendències. ```{=html} <!-- --> ``` - Congestió de dades al gràfic. Si el nombre de segons per mostrar en un píxel de gràfic horitzontal supera els 3600/16, es mostren les dades de tendència (tot i que l'historial d'elements encara és disponible per al mateix període de temps). ```{=html} <!-- --> ``` - si les tendències són desactivades, l'historial d'elements s'empra per fer gràfics - si és disponible per a aquest període de temps. Això és compatible amb Zabbix 2.2.1 (les tendències desactivades anteriorment significaven un gràfic buit per al període, fins i tot si l'historial d'elements era disponible). #### 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. #### Generació de PSK Per exemple, un PSK de 256 bits (32 octets) es pot generar emprant les comandes segúents: - amb *OpenSSL*: ```{=html} <!-- --> ``` $ openssl rand -hex 32 af8ced32dfe8714e548694e2d29e1a14ba6fa13f216cb35c19d0feb1084b0429 - amb *GnuTLS*: ```{=html} <!-- --> ``` $ psktool -u psk_identity -p database.psk -s 32 Genera una clau aleatòria per l'usuari 'psk_identity'. Clau emmagatzemada a database.psk $ cat database.psk psk_identity:9b8eafedfaae00cece62e85d5f4792c7d9c9bcc851b23216a1d300311cc4f7cb Tingueu en compte que l'ordre "psktool" anterior genera un fitxer de base de dades amb una identitat PSK i el seu PSK associat. Zabbix només proporciona un PSK al fitxer PSK. Per tant, la cadena d'identitat i els dos punts (':') s'han d'esborrar del fitxer. #### 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/monitoring/dashboard/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 for loading and displaying the tile layer on geographical maps. 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*.| #### Mapes geogràfics Aquesta secció permet triar el proveïdor de serveis de mosaic de mapes geogràfics i configurar el proveïdor de serveis per al Geomap [giny del tauler de control](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#geomap). Per proporcionar visualització mitjançant els mapes geogràfics, Zabbix empra la biblioteca de mapes interactius JavaScript de codi obert Leaflet. Tingueu en compte que Zabbix no té control sobre la qualitat de les imatges proporcionades per proveïdors de tercers, inclosos els proveïdors predefinits.  |Paràmetre|Descripció| |--|---------| |Proveïdor de fitxes|Seleccioneu un dels proveïdors de serveis de mosaic disponibles o seleccioneu *Altres* per afegir un altre proveïdor de fitxes o fitxes autoallotjades (veieu [emprar un proveïdor de serveis personalitzat](#using_a_custom_tile_service_provider)).| |URL de mosaic|La plantilla d'URL per carregar i mostrar la capa de mosaic en mapes geogràfics. Aquest camp només es pot editar si el *Proveïdor de mosaic* s'estableix a *Altres*.<br><br>S'admeten els següents marcadors de posició:<br>*{s}* representa un dels subdominis disponibles;<br>*{z}* representa el paràmetre de nivell de zoom a l'URL;<br>*{x}* i *{y}* representen les coordenades de mosaic;<br>*{r}* es pot emprar per afegir "@2x" a l'URL a carregar fitxes de retina.<br><br>Exemple: `https://{s}.example.com/{z}/{x}/{y}{r}.png`| |Text d'atribució|Text d'atribució del proveïdor de mosaic que es veurà en un petit quadre de text al mapa. Aquest camp només és visible si el *Proveïdor de mosaic* és establert a *Altres*.| |Nivell de zoom màxim|Nivell de zoom màxim del mapa. Aquest camp només es pot editar si el *Proveïdor de mosaic* és establert a *Altres*.| #### Geomap A new geomap widget for the dashboards has been introduced providing a way to display hosts on geographical maps. For more information see the *Geomap* [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) and [geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical_maps).  ##### Geomapes S'ha afegit un nou giny de geomapa per als taulers de control, que ofereix una manera de mostrar els equips a mapes geogràfics. Per obtindre més informació, consulteu el *Geomapa* [giny del tauler](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) i els [mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical_maps).  #### 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 6.0 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: location ~ /(api\/|conf[^\.]|include|locale|vendor) { deny all; return 404; } Then, replace this block with: location ~ /(api\/|conf[^\.]|include|locale) { deny all; return 404; } location /vendor { deny all; return 404; } #### Error del giny Geomap És possible que els mapes del giny del geomap no es carreguin correctament si heu actualitzat des d'una versió anterior de Zabbix amb NGINX i no heu actualitzat al nou fitxer de configuració d'NGINX durant l'actualització. Per resoldre el problema, podeu esborrar el fitxer de configuració antic, emprar el fitxer de configuració del paquet 6.0 i reconfigurar-lo tal com es descriu a les [instruccions de descàrrega](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql&ws=nginx) a la secció *configura PHP per a la interfície Zabbix*. També podeu editar manualment el fitxer de configuració NGINX existent (normalment */etc/zabbix/nginx.conf*). Per fer-ho, obriu el fitxer i localitzeu el bloc següent: · location ~ /(api\/|conf[^\.]|include|locale|vendor) { · deny · all; · return · 404; · } Després, reemplaceu el bloc per: · location ~ /(api\/|conf[^\.]|include|locale) { · deny · all; · return · 404; · } · location /vendor { · deny · all; · return · 404; · } #### Get a count of standby nodes Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### Obtindre el nombre de nodes en espera Petició: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "countOutput": true, "filter": { "status": 0 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": "3", "id": 1 } ``` #### Get a list of nodes ordered by status Request: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "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 } ``` #### Recuperar una llista de nodes ordenat per estat Petició: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "preservekeys": true, "sortfield": "status", "sortorder": "DESC" }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "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 } ``` #### Obtindre una llista de nodes específics pels seus IDs Petició: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "ha_nodeids": ["ckuo7i1nw000e0sajwfttc1mp", "ckuo7i1nv000c0sajz85xcrtt"] }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```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: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "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 } ``` #### Obtindre una llista dels nodes aturats Petició: ```json { "jsonrpc": "2.0", "method": "hanode.get", "params": { "output": ["ha_nodeid", "address", "port"], "filter": { "status": 1 } }, "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```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 ## Comencem amb Zabbix #### Getting Java gateway You can install Java gateway either from the sources or packages downloaded from [Zabbix website](http://www.zabbix.com/download.php). Using the links below you can access information how to get and run Zabbix Java gateway, how to configure Zabbix server (or Zabbix proxy) to use Zabbix Java gateway for JMX monitoring, and how to configure Zabbix items in Zabbix frontend that correspond to particular JMX counters. |Installation from|Instructions|Instructions| |-----------------|------------|------------| |*Sources*|[Installation](/manual/installation/install#installing_java_gateway)|[Setup](/manual/concepts/java/from_sources)| |*RHEL packages*|[Installation](/manual/installation/install_from_packages/rhel#java_gateway_installation)|[Setup](/manual/concepts/java/from_rhel)| |*Debian/Ubuntu packages*|[Installation](/manual/installation/install_from_packages/debian_ubuntu#java_gateway_installation)|[Setup](/manual/concepts/java/from_debian_ubuntu)| #### Obtindre la passarel·la Java Podeu instal·lar Java Gateway des de la font o descarregant els paquets des del [lloc web de Zabbix](http://www.zabbix.com/download.php). Mitjançant els enllaços següents, podeu accedir a informació sobre com obtindre i executar la passarel·la Zabbix Java, com configurar el servidor Zabbix (o el proxy Zabbix) per emprar la passarel·la Zabbix Java per a la supervisió de JMX i com configurar els elements Zabbix a la interfície web que corresponen a comptadors JMX particulars. |Instal·la des de|Instruccions|Instruccions| |-------------------|------------|------------| |*Sources*|[Installation](/fr/manual/installation/install#installation_de_la_passerelle_java)|[Configuration](/fr/manual/concepts/java/from_sources)| |*packages RHEL*|[Installation](/fr/manual/installation/install_from_packages/rhel#installation_de_la_passerelle_java)|[Configuration](/fr/manual/concepts/java/from_rhel)| |*packages Debian/Ubuntu*|[Installation](/fr/manual/installation/install_from_packages/debian_ubuntu#installation_de_la_passerelle_java)|[Configuration](/fr/manual/concepts/java/from_debian_ubuntu)| ##### 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_ intervals. ```json { "request": "active checks", "host": "Zabbix server", "host_metadata": "mysql,nginx", "interface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` | 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. | **Server response** The active checks response is sent by the server back to agent after processing the active checks request. ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": 30, "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "key_orig": "agent.version", "itemid": 5678, "delay": 10, "lastlogsize": 0, "mtime": 0 } ] } ``` | Field |<| Type | Mandatory | Value | |-|------|--|-|-----------------------| | response |<| _string_ | yes | `success` \| `failed` | | info |<| _string_ | no | Error information in the case of failure. | | data |<| _array of objects_ | no | Active check items. | | | key | _string_ | no | Item key with expanded macros. | |^| key_orig | _string_ | no | Item key without expanded macros. | |^| itemid | _number_ | no | Item identifier. | |^| delay | _integer_ | no | Item update interval. | |^| lastlogsize | _number_ | no | Item lastlogsize. | |^| mtime | _number_ | no | Item mtime. | | 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. | 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 (item key, delay) 4. Agent parses the response 5. TCP connection is closed 6. Agent starts periodical collection of data ::: 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. ::: ##### Obtindre la llista d'elements **Petició de l'agent** La petició de les verificacions actives s'empra per obtindre les verificacions actives a tractar per l'agent. Aquesta petició s'envia per l'agent a l'iniciar, i després amb els intervals _RefreshActiveChecks_. ```json { "request": "active checks", "host": "Zabbix server", "host_metadata": "mysql,nginx", "interface": "zabbix.server.lan", "ip": "159.168.1.1", "port": 12050 } ``` | Camp| Tipus| Obligatori| Valor | |-|-|-|--------| | request | _string_ | sí | `active checks` | | host | _string_ | sí | Nom d'equip. | | host_metadata | _string_ | no | El paràmetre de configuració HostMetadata o el valor de mètrica HostMetadataItem.| | interface | _string_ | no | El valor de mètrica del paràmetre de configuració HostInterface o HostInterfaceItem.| | ip | _string_ | no | El paràmetre de configuració ListenIP first IP, si s'ha definit. | | port | _number_ | no | El valor del paràmetre de configuració ListenPort si s'ha definit i no pas el port d'escola per defecte de l'agent. | **Resposta del servidor** La resposta de les verificacions actives s'envien per el servidor a l'agent després del tractament de la petició de verificacions actives. ```json { "response": "success", "data": [ { "key": "log[/home/zabbix/logs/zabbix_agentd.log]", "key_orig": "log[/home/zabbix/logs/zabbix_agentd.log]", "itemid": 1234, "delay": 30, "lastlogsize": 0, "mtime": 0 }, { "key": "agent.version", "key_orig": "agent.version", "itemid": 5678, "delay": 10, "lastlogsize": 0, "mtime": 0 } ] } ``` | Camp | Tipus | Obligatori | Valor | |-|------|--|-|-----------------------| | response |<| _string_ | sí | `success` \| `failed` | | info |<| _string_ | no | Informacions d'error en cas de fallida. | | data |<| _array of objects_ | no | Elements de verificacions actius. | | | key | _string_ | no | Clau d'element amb macros esteses. | |^| key_orig | _string_ | no | Clau d'element sense macros esteses. | |^| itemid | _number_ | no | Identificador d'element. | |^| delay | _integer_ | no | Interval d'actualització de l'element. | |^| lastlogsize | _number_ | no | Darrera mida del registre de l'element. | |^| mtime | _number_ | no | Mtime de l'element. | | refresh_unsupported |<| _number_ | no | Interval d'actualització dels elements no suportats.| | regexp |<| _array of objects_ | no | Expressions regulars globals. | | | name | _string_ | no | Nom de l'expressió regular global.| |^| expression | _string_ | no | Expression régulière globale. | |^| expression_type | _number_ | no | Tipus de l'expressió regular global. | |^| exp_delimiter | _string_ | no | Delimitador de l'expressió regular global. | |^| case_sensitive | _number_ | no | Paràmetre global de sensibilitat a majúscules de les expressions regulars.| El servidor ha de respondre amb èxit. Per exemple : 1. L'agent obre una connexió TCP 2. L'agent demana la llista de verificacions 3. El servidor contesta amb una llista d'elements (clau d'element, retard) 4. L'agent analitza la resposta 5. Es tanca la connexió TCP 6. L'agent comença la recollida periòdica de dades ::: noteimportant Veieu que les dades de configuració (sensibles) poden ésser disponibles per a les persones que tinguin accés al port del trapper del servidor Zabbix quan emprin verificació activa. Això és possible perquè tot el món pot pretendre tindre un agent actiu i demanar informació de configuració d'elements. L'autenticació no té lloc excepte que empreu les opcions de [xifrat](/manual/encryption). ::: #### Getting Zabbix source code There are several ways of getting Zabbix source code: - You can [download](https://www.zabbix.com/download_sources#60LTS) 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 #### Obtindre el codi font de Zabbix Hi ha diverses maneres d'obtindre el codi font de Zabbix: - Podeu [descarregar](https://www.zabbix.com/download_sources#60LTS) versions estables publicades des del lloc oficial de Zabbix - Podeu [descarregar](https://www.zabbix.com/developers) compilacions nocturnes des de la pàgina oficial de desenvolupadors del lloc web de Zabbix - Podeu obtindre la darrera versió de desenvolupament des del sistema de dipòsit de codi font de Git: - La ubicació principal del repositori complet és a <https://git.zabbix.com/scm/zbx/zabbix.git> - Les versions principals i compatibles també es reflecteixen a Github a <https://github.com/zabbix/zabbix> S'ha d'instal·lar un client Git per clonar el repositori. El paquet de client de línia d'ordres oficial de Git s'anomena habitualment **git** a les distribucions. Per instal·lar-lo per exemple a Debian/Ubuntu, executeu: sudo apt-get update sudo apt-get install git Per afegir totes les fonts de Zabbix, navegueu fins al directori on voleu posar el codi i executeu: 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. #### Correlació global d'esdeveniments Els esdeveniments poden no ésser correlacionats correctament si l'interval de temps entre el primer i el segon esdeveniment és molt petit, és a dir, mig segon o menys. ### 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 6.0.31, decodes Base64 string as Uint8Array buffer (in Zabbix 6.0.0 - 6.0.30 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's 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').<br>This function is supported since Zabbix 6.0.15. ### Funcions globals de JavaScript S'han afegit funcions JavaScript globals addicionals amb Duktape: - `btoa (data)` - codifica la cadena a cadena en base64; - `atob(base64\_string)` - des de la versió 6.0.31, descodifica la cadena en base64 com a buffer Uint8Array (a Zabbix 6.0.0 - 6.0.30 retornava una cadena descodificada). ```javascript try { b64 = btoa("test string"); buffer = atob(b64); // Fixeu-vos que la lògica de descodificació depen del format de les dades del buffer. decoded = String.fromCharCode.apply(this, [].slice.call(buffer)); } catch (error) { return {'error.name' : error.name, 'error.message' : error.message}; } ``` - `md5(dades)` - calcula el hash MD5 d'una cadena - `sha256(dades)` - calcula el hash SHA256 d'una cadena - `mac('\<tipus hash\>',clau,dades)` - retorna el hash HMAC com una cadena en format hexadecimal; s'admeten els `tipus hash` `MD5` i `SHA256`; els paràmetres `clau` i de `dades` admeten dades binàries. Exemples: - `hmac('md5',clau,dades)` - `hmac('sha256',clau,dades)` - `sign(hash,clau,dades)` - retorna la signatura calculada (signatura RSA amb SHA-256) com a cadena, on:<br> **hash** - només es permet 'sha256', en cas contrari es genera un error;<br> **clau** - la clau privada. Ha de correspondre a l'estàndard PKCS#1 o PKCS#8. La clau es pot proporcionar de diferents formes:<br> - amb espais en lloc de noves línies; - amb o sense escapat '\n' en lloc de noves línies; - sense cap nova línia com una cadena d'una sola línia; - com a cadena en format JSON. La clau també es pot carregar des d'una macro d'usuari/macro/macro secreta. **dades** - les dades que es signaran. Pot ser una cadena (també s'admeten dades binàries) o una memòria intermèdia (Uint8Array/ArrayBuffer).<br> Exemple: - `sign('sha256',key,data)` OpenSSL o GnuTLS s'empren per calcular signatures. Si Zabbix s'ha compilat sense cap d'aquestes biblioteques de xifrat, es generarà un error ("Manca la biblioteca OpenSSL o GnuTLS").<br>Aquesta funció és compatible des de Zabbix 6.0.15. ### Global macro The global macro object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |globalmacroid|string|*(readonly)* ID of the global macro.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Macro global L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |globalmacroid|string|*(només lectura)* ID de macro global.| |**macro**<br>(obligatori)|string|Cadena de macro.| |**valor**<br>(obligatori)|string|Valor de la macro.| |type|integer|Tipus de la macro.<br><br>Valors possibles:<br>0 - *(per defecte)* Text de la macro;<br>1 - Macro secreta;<br>2 - Secret de caixa de cabals.| |description|string|Descripció de la macro.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. ##### Global messages displayed As the messages arrive, they are displayed in a floating section on the right hand side. This section can be repositioned freely 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. ##### Visualització de missatges globals Quan arriben els missatges, es mostren en una secció flotant al costat dret. Aquesta secció es pot reposicionar lliurement arrossegant la seva capçalera.  Per a aquesta secció, hi ha diversos controls disponibles: -  el botó **Informar** silencia el so de l'alarma activa; -  el botó **Silenciar/Desactivar** alterna entre reproduir i no reproduir els sons de l'alarma. #### 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. #### Expressions regulars globals Hi ha un editor avançat per crear i provar expressions regulars complexes a la interfície Zabbix. Un cop s'ha creat una expressió regular d'aquesta manera, es pot emprar a diversos llocs de la interfície fent referència al seu nom amb el prefix @, per exemple, *@mycustomregexp*. Per crear una expressió regular global: - Aneu a: *Administració → General* - Seleccioneu *Expressions regulars* al menú desplegable - Feu clic a *Nova expressió regular* La pestanya **Expressions** us permet definir el nom de l'expressió regular i afegir subexpressions.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom*|<|Definiu el nom de l'expressió regular. Es permeten tots els caràcters Unicode.| |*Expressions*|<|Feu clic a *Afegir* al bloc Expressions per afegir una subexpressió nova.| | |*Tipus d'expressió*|Trieu el tipus d'expressió:<br>**Cadena inclosa** - coincideix amb la subcadena<br>**Qualsevol cadena inclosa** - coincideix amb totes les subcadenes d'una llista delimitada. La llista delimitada inclou una coma (,), un punt (.) o una barra inclinada (/).<br>**La cadena no s'inclou** - coincideix amb qualsevol cadena excepte la subcadena<br>**El resultat és CERT** - coincideix amb l'expressió regular <br>**El resultat és FALS** - no coincideix amb l'expressió regular| |^|*Expressió*|Introduïu una subcadena/expressió regular.| |*Delimitador*|<|Una coma (,), punt (.) o barra inclinada (/) per separar cadenes de text en una expressió regular. Aquest paràmetre només és actiu quan es tria el tipus d'expressió "*Qualsevol cadena de caràcters inclosa*".| |*Distingeix entre majúscules i minúscules*|<|Una casella de selecció per especificar si una expressió regular distingeix entre majúscules i minúscules.| Una barra inclinada (/) a l'expressió es tracta literalment, en lloc d'un delimitador. D'aquesta manera és possible desar expressions que contenen una barra, sense errors. ::: noteimportant Un nom d'expressió regular personalitzada a Zabbix pot contindre comes, espais, etc. En casos en què això pot provocar una interpretació errònia quan es fa referència (per exemple, una coma al paràmetre d'una clau d'element), la referència sencera es pot citar així: *"@My regexp personalizada per a propòsit1, propòsit2"*.<br> Els noms de les expressions regulars no s'han de citar en altres llocs (per exemple, a les propietats de les regles LLD). ::: A la pestanya **Provar**, l'expressió regular i les seves subexpressions es poden provar proporcionant una cadena de prova.  Els resultats mostren l'estat de cada subexpressió i l'estat total de l'expressió personalitzada. L'estat total de l'expressió personalitzada s'estableix a *Resultat combinat*. Si es defineixen diverses subexpressions, Zabbix empra l'operador I lògic per calcular el *resultat combinat*. Això vol dir que si almenys un resultat és Fals, el *Resultat combinat* també té l'estat Fals. ### GLPI integration A new [GLPI integration](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/) is available allowing to use the [webhook](/manual/config/notifications/media/webhook) media type to create problems in GLPI Assistance section based on Zabbix problem notifications. ### Integració GLPi Hi ha disponible una nova [integració GLPI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/) que permet emprar el tipus de suport [webhook](/manual /config /notifications /media/webhook) per crear problemes a la secció de suport de GLPi basats en les notificacions de problemes de Zabbix. ### Go library for Windows updated Go library used by Zabbix agent 2 in conjunction with MongoDB or PostgreSQL plugins to monitor Windows now is `github.com/Microsoft/go-winio`, version 0.6.0 (previously `github.com/natefinch/npipe`). See also [Agent 2 requirements](/manual/installation/requirements#agent-2). ### Biblioteca Go per a Windows actualitzada La biblioteca Go que utilitza l'agent 2 de Zabbix juntament amb els complements de MongoDB o PostgreSQL per monitorar Windows ara és `github.com/Microsoft/go-winio`, versió 0.6.0 (anteriorment `github.com/natefinch/npipe`). Veieu també [Requisits de l'agent 2](/manual/installation/requirements#agent-2). ### Google Cloud Platform Monitoring A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform by HTTP (GCP by HTTP)* is available. See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http). You can get this template: - In *Configuration → Templates* in new installations. - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). ### Monitoratge de la plataforma Google Cloud Hi ha disponible una nova [plantilla](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform per HTTP GCP per HTTP)*. Veieu les instruccions de configuració per [plantilles HTTP](/manual/config/templates_out_of_the_box/http). Podeu obtindre aquesta plantilla: - A *Configuració → Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar aquestes plantilles des del [repositori Git] de Zabbix (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) o obtindre-les des del directori `templates` de la darrera versió descarregada de Zabbix. Després, dins de *Configuració* → *Plantilles* podeu importar-les manualment cap al Zabbix. #### graph Changes:<br> [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: Graph availability doesn't depend on permissions to items specified in graph "ymin_itemid" and "ymax_itemid" fields.<br> Graph having MIN or MAX Y axis linked to inaccessible items will still be accessible but MIN/MAX Y axis works the same way as if specified calculation method is "Calculated". #### gràfic Canvis:<br> [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: La disponibilitat del gràfic no depèn dels permisos dels elements especificats als camps del gràfic "ymin_itemid" i "ymax_itemid".\ El gràfic amb l'eix MIN o MAX Y vinculat a elements inaccessibles seguirà essent accessible; però l'eix MIN/MAX Y funciona igual que si el mètode de càlcul especificat fos "Calculated". #### graph Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: the parameter `uuid` can now be updated. #### gràfic Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: el paràmetre `uuid` ara es pot actualitzar. # 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|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |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|string|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.| ### Element de gràfic ::: noteclassic Els elements del gràfic només es poden modificar emprant l'API `graph`. ::: L'objecte d'element de gràfic té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |gitemid|string|*(només lectura)* ID de l'element del gràfic.| |**color**<br>(obligatori)|string|Traceu el color de l'element del gràfic com a codi de color hexadecimal.| |**item**<br>(obligatori)|string|ID de l'element.| |calc\_fnc|integer|Valor de l'element que es mostrarà.<br><br>Valors possibles:<br>1 - valor mínim;<br>2 - *(per defecte)* valor mitjà;<br> 4 - valor màxim;<br>7 - tots els valors;<br>9 - darrer valor, emprat només pels gràfics circulars i explotats.| |drawtype|integer|Estil de dibuix de l'element del gràfic.<br><br>Valors possibles:<br>0 - línia *(per defecte)*;<br>1 - àrea plena;<br>2 - línia en negreta;< br>3 - punt;<br>4 - línia de punts;<br>5 - línia degradada.| |graphid|string|ID del gràfic al qual pertany l'element del gràfic.| |sortorder|integer|Posició de l'element al gràfic.<br><br>Per defecte: comença amb 0 i augmenta un amb cada entrada.| |type|integer|Tipus d'element del gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* simple;<br>2 - suma del gràfic, només emprat pels gràfics circulars i explotat.| |yaxisside|integer|Cara del gràfic on es representarà l'escala Y de l'element gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* costat esquerre;<br>1 - costat dret.| # Graph item object The following objects are directly related to the `graphitem` API. # Objecte gràfic Els següents objectes són relacionats amb l'API `graphitem`. # 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) - retrieving graph items # Element de gràfic Aquesta classe és dissenyada per treballar amb els elements de gràfic. Referències d'objectes: - [Element de gràfic](/manual/api/reference/graphitem/object#graph_item) Mètodes disponibles: - [graphitem.get](/manual/api/reference/graphitem/get) - recuperar els elements de gràfic # Graph object The following objects are directly related to the `graph` API. # Objecte gràfic Els següents objectes són relacionats amb l'API `graph`. ##### 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. If graph height is set as less than 120 pixels, no trigger will be displayed in the legend. ::: ##### Previsualització del gràfic A la pestanya *Vista prèvia*, es mostra una vista prèvia del gràfic perquè pugueu veure immediatament el que esteu creant. {width="600"} Tingueu en compte que la previsualització no ensenyarà cap dada per als elements del model. {width="600"} En aquest exemple, presteu atenció a la línia discontínua en negreta que mostra el nivell de trigger i la informació del trigger que es mostra a la llegenda. :::noteclassic No es poden mostrar més de 3 línies de trigger. Si hi ha més triggers, primer s'ensenyen els de menor gravetat. Si l'alçada del gràfic s'estableix a menys de 120 píxels, no es veurà cap trigger a la llegenda. ::: #### graphprototype Changes:<br> [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Graph prototype availability doesn't depend on permissions to items specified in graph prototype "ymin_itemid" and "ymax_itemid" fields. #### prototip gràfic Canvis:<br> [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: La disponbilitat del prototip de gràfic no depèn pas dels permisos per a items triats als camps de prototip gràfic "ymin_itemid" i "ymax_itemid". #### graphprototype Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: the parameter `uuid` can now be updated. #### prototipus de gràfic Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: el paràmetre `uuid` ara es pot actualitzar. # 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. # Objecte prototip de gràfic Els objectes següents són vinculats a l'API `graphprototype`. #### 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"} #### Prototips de gràfics La següent captura de pantalla ensenya com podem emprar aquestes macros a prototips de gràfics: {width="600"} {width="600"} Un resum de la nostra regla de descoberta: {width="600"} ### Graph prototype The graph prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |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|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (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|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymin\_type would be set to '0' (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. Used only for graph prototypes on templates. Auto-generated, if not given.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Prototipus de gràfic L'objecte prototipus de gràfic té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphid|string|*(només de lectura)* ID del prototipus de gràfic.| |**height**<br>(obligatori)|integer|Alçada del gràfic del prototipus en píxels.| |**name**<br>(obligatori)|string|Nom del prototipus de gràfic.| |**width**<br>(obligatori)|integer|Amplada del prototipus de gràfic en píxels.| |graphtype|integer|Tipus de disseny del prototipus de gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - apilat;<br>2 - circular;< br>3 - explotat.| |percent\_left|float|Percentil esquerre.<br><br>Per defecte: 0.| |percent\_right|float|Percentil dret.<br><br>Per defecte: 0.| |show\_3d|integer|Indica si s'han de mostrar gràfics circulars i explosius en 3D.<br><br>Valors possibles:<br>0 - *(per defecte)* es mostra en 2D;<br>1 - Mostra en 3D .| |show\_legend|integer|Indica si s'ha de mostrar la llegenda al gràfic descobert.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* mostrar.| |show\_work\_period|integer|Indica si s'ha de mostrar el temps de treball al gràfic descobert.<br><br>Valors possibles:<br>0 - ocultar;<br>1 - *(per defecte) * mostrar.| |templateid|string|*(només lectura)* ID de prototipus de gràfic de la plantilla principal.| |yaxismax|float|El valor màxim fix per a l'eix Y.| |yaxismin|float|El valor mínim fix per a l'eix Y.| |ymax\_itemid|string|Id de l'element emprat com a valor màxim per a l'eix Y.<br><br>Des de Zabbix 6.0.7, si l'usuari no té accés a l'element especificat, el gràfic es representa com si ymax\_type fos establert a '0' (calculat).| |ymax\_type|integer|Mètode per calcular el valor màxim de l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |ymin\_itemid|string|Id de l'element emprat com a valor mínim per a l'eix Y.<br><br>Des de Zabbix 6.0.7, si l'usuari no té accés a l'element especificat, el gràfic es representa com si ymin\_type fos establert a '0' (calculat).| |ymin\_type|integer|Mètode per calcular el valor mínim per a l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |discover|integer|Estat de descobriment de prototipus de gràfics.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran gràfics nous;<br>1: no es descobriran gràfics nous i els gràfics existents es marcaran com a perduts.| |uuid|string|Identificador únic universal, emprat per enllaçar prototips de gràfics importats amb els existents. S'empra només per a prototips de gràfics de plantilla. Es genera automàticament, si no es proporciona.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # 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) - creating new graph prototypes - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - deleting graph prototypes - [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieving graph prototypes - [graphprototype.update](/manual/api/reference/graphprototype/update) - updating graph prototypes # Prototipus de gràfic Aquesa classe és dissenyada per treballar amb prototips de gràfics. Referències d'objectes: - [Prototipus de gràfic](/manual/api/reference/graphprototype/object#graph_prototype) Mètodes disponibles: - [graphprototype.create](/manual/api/reference/graphprototype/create) - crear nous prototipus de gràfics - [graphprototype.delete](/manual/api/reference/graphprototype/delete) - esborrar prototips de gràfics - [graphprototype.get](/manual/api/reference/graphprototype/get) - recuperar prototipus de gràfics - [graphprototype.update](/manual/api/reference/graphprototype/update) - actualitzar prototipus de gràfics # graphprototype.update # graphprototype.update #### Graphs ##### 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. #### Gràfics ##### Horari d'estiu Els canvis a l'horari d'estiu (DST) causen irregularitats en mostrar les etiquetes de l'eix X (data doble, data que manca, etc.). ##### Suma afegida Quan s'empra la [suma afegida](/manual/config/visualization/graphs/aggregate#configuration) a un gràfic durant un període inferior a una hora, els gràfics mostren valors incorrectes (multiplicats) quan les dades provenen de tendències. ##### Text superposat Per a alguns idiomes d'interfície (per exemple, el japonès), els tipus de lletra locals poden provocar que el text es superposi a la llegenda del gràfic. Per evitar-ho, empreu la versió 2.3.0 (o posterior) de l'extensió PHP GD. #### 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) #### Gràfics Modifica els gràfics o els elements de gràfics separats per una millor presentació de les dades recollides. [API Gràfic](/manual/api/reference/graph) | [API Element de gràfic](/manual/api/reference/graphitem) ##### 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"} ##### Gràfics Amb l'element en funcionament durant una estona, potser és hora de veure quelcom visual. Els [Gràfics simples](/manual/config/visualization/graphs/simple) són disponibles per a qualsevol element digital monitorat sense cap configuració addicional. Aquests gràfics es generen en temps d'execució. Per veure el gràfic, aneu a *Monitoratge → Dades més recents* i feu clic a l'enllaç "Gràfic" al costat de l'element. {width="600"} ### Graph The graph object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |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|string|*(readonly)* ID of the parent template graph.| |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|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (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|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (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. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Gràfic L'objecte gràfic té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphid|string|*(només lectura)* ID del gràfic.| |**altura**<br>(obligatori)|integer|Alçada del gràfic en píxels.| |**nom**<br>(obligatori)|string|Nom del gràfic.| |**amplada**<br>(obligatori)|integer|Amplada del gràfic en píxels.| |flags|integer|*(només de lectura)* Origen del gràfic.<br><br>Els valors possibles són:<br>0 - *(per defecte)* un gràfic simple;<br>4 - un gràfic descobert. | |graphtype|integer|Tipus de disseny del gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - apilat;<br>2 - circular;<br> 3 - explotat.| |percent\_left|float|Percentil esquerre.<br><br>Per defecte: 0.| |percent\_right|float|Percentil dret.<br><br>Per defecte: 0.| |show\_3d|integer|Indica si s'han de mostrar gràfics circulars i explosius en 3D.<br><br>Valors possibles:<br>0 - *(per defecte)* es mostra en 2D;<br>1 - es mostra en 3D. | |mostra\_legenda|integer|Indica si s'ha de mostrar la llegenda al gràfic.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* mostrar.| |show\_work\_period|integer|Indica si s'ha de mostrar el temps de treball al gràfic.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* visualització.| |show\_triggers|integer|Indica si s'ha de mostrar la línia d'activació al gràfic.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* mostrar. | |templateid|string|*(només de lectura)* ID del gràfic de plantilla principal.| |yaxismax|float|El valor màxim fix per a l'eix Y.<br><br>Per defecte: 100.| |yaxismin|float|El valor mínim fix per a l'eix Y.<br><br>Per defecte: 0.| |ymax\_itemid|string|Id de l'element emprat com a valor màxim per a l'eix Y.<br><br>Des de Zabbix 6.0.7, si l'usuari no té accés a l'element especificat, el gràfic es representa com si ymax\_type fos establert a '0' (calculat).| |ymax\_type|integer|Mètode per calcular el valor màxim de l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |ymin\_itemid|string|Id de l'element emprat com a valor mínim per a l'eix Y.<br><br>Des de Zabbix 6.0.7, si l'usuari no té accés a l'element especificat, el gràfic es representa com si ymin\_type fos establert a '0' (calculat).| |ymin\_type|integer|Mètode per calcular el valor mínim per a l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |uuid|string|Identificador únic universal, emprat per enllaçar els gràfics importats amb els existents. S'empra només per a gràfics de models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només de lectura*.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # 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) - creating new graphs - [graph.delete](/manual/api/reference/graph/delete) - deleting graphs - [graph.get](/manual/api/reference/graph/get) - retrieving graphs - [graph.update](/manual/api/reference/graph/update) - updating graphs # Gràfic Aquesta classe és dissenyada per treballar amb gràfics. Referències d'objectes: - [Gràfic](/manual/api/reference/graph/object#graph) Mètodes disponibles: - [graph.create](/manual/api/reference/graph/create) - crear nous gràfics - [graph.delete](/manual/api/reference/graph/delete) - esborrar gràfics - [graph.get](/manual/api/reference/graph/get) - recuperar gràfics - [graph.update](/manual/api/reference/graph/update) - actualitzar gràfics # graph.update # graph.update ### Group link The group link object links a host prototype with a host group and has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupid**<br>(required)|string|ID of the host group.| ### Enllaç de grup L'objecte d'enllaç de grup enllaça un prototip d'equips amb un grup d'equips i té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**groupid**<br>(obligatori)|cadena|ID del grup d'equips.| ### Group prototype The group prototype object defines a group that will be created for a discovered host and has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**group_prototypeid**|string|*(readonly)* ID of the group prototype.| |**name**<br>(required)|string|Name of the group prototype.| ### Prototipus de grup L'objecte defineix un grup que es crearà per a un equip descobert i té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**group_prototypeid**|string|*(només lectura)* ID del prototip de grup.| |**name**<br>(obligatori)|string|Nom del prototip del grup.| #### groups/group |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| | #### grups/grup |Paràmetre|Tipus|Descripció|Detalls| |---------|----|-----------|-------| |nom|*cadena*|Nom del grup.| | #### GSM modem validation for SMS media type In SMS media type configuration, the GSM modem path is now validated to be a modem device or symlink to such. #### Validació del mòdem GSM per al tipus de suport SMS En la configuració del tipus de suport SMS, la ruta del mòdem GSM ara és validada per ésser un dispositiu de mòdem o un enllaç simbòlic a aquest. #### Guest user authorization Automatic login for the guest user has been removed. After this change, the guest user will need to log in like any other user. Previously, a guest could immediately get to almost any monitoring or reporting page without going through authorization. #### Autorització d'usuari convidat S'ha tret l'inici de sessió automàtic per a l'usuari convidat. Després d'aquest canvi, l'usuari convidat haurà d'iniciar sessió com qualsevol altre usuari. Abans, un convidat podia accedir immediatament a gairebé qualsevol pàgina de seguiment o d'informe sense tindre pas autorització. #### GUI debugging Problems related to the frontend performance may be diagnosed using the frontend [debug mode](/manual/web_interface/debug_mode). #### Depuració de la interfície gràfica Els problemes vinculats al rendiment de la interfície poden ésser diagnosticats emprant la interfície en [mode depuració](/manual/web_interface/debug_mode). #### 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 *Configuration > 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.<br>This parameter is supported since Zabbix 2.0.1.| |*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 (since Zabbix 3.4.0).| |*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/administration/users#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 Aquesta secció permet personalitzar diversos valors predeterminats relacionats amb la interfície.  Paràmetres de configuració: |Paràmetre|Descripció| |--|---------| |*Idioma predeterminat*|Idioma per defecte per als usuaris que no han especificat cap idioma als seus perfils i usuaris convidats.<br>Per obtindre més informació, veieu [Instal·lació d'idiomes d'interfície addicionals]( /manual/appendix/install/locales).| |*Fus horari predeterminat*|[Zona horària](/manual/web_interface/time_zone#overview) per defecte per als usuaris que no han especificat una zona horària als seus perfils i usuaris convidats.| |*Tema predeterminat*|Tema per defecte per als usuaris que no han especificat cap tema als seus perfils i usuaris convidats.| |*Límit d'elements cercats/filtrats*|Nombre màxim d'elements (fileres) que es veuran en una llista d'interfícies web, per exemple, a *Configuració → Equips*.<br>*Nota*: si s'estableix per exemple a '50', només es veuran els primers 50 elements a totes les llistes d'interfície rellevants. Si una llista conté més de 50 elements, la indicació serà el signe '+' a *"Mostrant de l'1 al 50 de **50+** trobats"*. A més, si s'empra el filtrat i encara hi ha més de 50 coincidències, només es veuran les primeres 50.<br>Fixeu-vos que incrementant el valor d'aquest paràmetre pot donar lloc a una baixada de rendiment i un consum més elevat de memòria per part del servidor.| |*Nombre màxim de columnes<br>i fileres a les taules de previsualització*|Nombre màxim de columnes i fileres a ensenyar als ginys Previsualització de dades i Previsualització del trigger. El mateix límit s'aplica a columnes i fileres. Si hi ha més fileres i/o columnes de les indicades, el sistema ensenyarà un avís a la part inferior de la taula: "No es mostren tots els resultats. Proporcioneu criteris de cerca més específics."| |*Nombre màxim d'elements<br>mostrats a la cel·la*|Per a les entrades que es mostren en una sola cel·la de taula, no s'ensenyarà més del que és configurat aquí.| |*Mostra l'alerta si el servidor Zabbix és caigut*|Aquesta configuració permet mostrar un missatge d'avís a la finestra del navegador si el servidor Zabbix no és accessible (possiblement sigui caigut). El missatge continua essent visible fins i tot si l'usuari es desplaça cap avall per la pàgina. Quan es passa el cursor, el missatge s'amaga temporalment per revelar el contingut que hi ha a sota.<br>Aquesta configuració és compatible des de Zabbix 2.0.1.| |*Horari de feina*|Aquesta configuració de tot el sistema defineix l'horari de feina. Als gràfics, les hores de feina es veuen en fons blanc i el temps no laboral es veu en gris.<br>Consulteu la pàgina [Especificació del període](/manual/appendix/time_period) per obtindre una descripció del format de l'hora.<br >[Les macros d'usuari](/manual/config/macros/user_macros) són compatibles (des de Zabbix 3.4.0).| |*Mostra errors tècnics*|Si és marcat, tots els usuaris registrats podran veure els errors tècnics (PHP/SQL). Si no és marcada, la informació només serà disponible per als [superadministradors de Zabbix](/manual/web_interface/frontend_sections/administration/users#users1) i els usuaris que pertanyen a grups d'usuaris amb [mode de depuració](/manual/web_interface/debug_mode) activat.| |*Període màxim de visualització de l'historial*|Període màxim per mostrar dades històriques a les subseccions *Monitoratge* > *Darreres dades*, informació de l'[escenari web](/manual/web_interface/frontend_sections/monitoring/hosts/web) de l'equip a *Monitoratge > Equips*, i *Web* i al giny del tauler de control *Visió general de les dades*.<br>Interval permès: 24 hores (predeterminat) - 1 setmana. S'admeten [sufixos oportuns](/manual/apèndix/sufixos), per exemple 1w (una setmana), 36h (36 hores).| |*Període predeterminat del filtre de temps*|Període que s'emprarà com a predeterminat a gràfics i taulers. Interval permès: 1 minut - 10 anys (predeterminat: 1 hora).<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), p. ex., 10 m (deu minuts), 5 w (cinc setmanes).<br>Nota: quan un usuari canvia el període de temps mentre visualitza un gràfic, aquest període de temps s'emmagatzema com a preferència de l'usuari, anul·lant el valor predeterminat global o una selecció anterior de l'usuari.| |*Període màxim per al selector de temps*|Període de temps màxim disponible per a gràfics i taulers. Els usuaris no podran veure dades anteriors. Interval permès: 1 any - 10 anys (predeterminat: 2 anys).<br>[Sufixos de temps](/manual/appendix/sufixos), p. ex., 1 any (un any), 365w (365 setmanes) són càrregues compatibles.| ### Handling of NaN values in Prometheus preprocessing There is a new behavior for handling (skipping) NaN values. So, if a dataset consists of valid numeric values and NaNs, then NaN values are skipped and: - 'avg', 'max', 'min', 'sum' return a result that is calculated from the valid values - 'count' returns the number of valid values If all values in a dataset are NaNs then 'avg', 'max', 'min', and 'sum' return a "no data (at least one value is required)" error, while 'count' returns 0. Previously, if NaN was the first value in a dataset then: - 'avg', 'max', 'min', 'sum' returned a "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" error - 'count' returned the number of values (including NaN values) Also previously, if NaN was not the first value in a dataset then: - 'avg', 'sum' returned a "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" error - 'max' returned the maximum of values until the first NaN was encountered - 'min' returned the minimum of values until the first NaN was encountered - 'count' returned the number of values (including NaN values) ### Gestió de valors de NaN al preprocessament de Prometheus Hi ha un comportament nou per manejar (ometre) els valors de NaN. Així, si un conjunt de dades consta de valors numèrics i NaN vàlids, els valors de NaN s'ignoren i: - 'avg', 'màx', 'min', 'sum' retornen un resultat calculat a partir dels valors vàlids - 'count' retorna el nombre de valors vàlids Si tots els valors d'un conjunt de dades són NaN, aleshores "mitjana", "màx", "mín" i "suma" retornen "no hi ha dades (es requereix almenys un valor)", mentre que "recompte" retorna 0. Abans, si NaN era el primer valor d'un conjunt de dades, aleshores: - 'avg', 'màx', 'min', 'sum' retornant un error "El valor "NAN" de tipus "cadena" no és adequat per al tipus de valor "Numèric (flotant)"" - 'count' retorna el nombre de valors (inclosos els valors de NaN) També abans, si NaN no era el primer valor d'un conjunt de dades, aleshores: - 'avg', 'sum' retornen l'error "El valor "NAN" del tipus "cadena" no és adequat per al tipus de valor "Numèric (flotant)"" - 'max' retorna el màxim de valors fins que es troba el primer NaN - 'min' retorna el mínim de valors fins que es troba el primer NaN - 'count' retorna el nombre de valors (inclosos els valors de NaN) #### 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). Note that the logging of regular expression runtime errors is supported since Zabbix 6.0.21. 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. #### Gestió de la compilació d'expressions regulars i els errors d'execució Si una expressió regular emprada a l'element `log[]`, `logrt[]`, `log.count[]` o `logrt.count[]` no es pot compilar per la biblioteca PCRE o PCRE2, llavors l'element passa a l'estat NO ADMÈS amb un missatge d'error. Per continuar monitorant l'element de registre, s'hauria de corregir l'expressió regular. Si l'expressió regular es compila correctament, però falla en temps d'execució (en alguns o en tots els registres de registre), aleshores l'element de registre continua essent compatible i el monitoratge continua. L'error d'execució es registra al fitxer de registre de l'agent Zabbix (sense el registre del fitxer de registre). Tingueu en compte que el registre d'errors d'execució d'expressions regulars és compatible des de Zabbix 6.0.21. La taxa de registre es limita a un error de temps d'execució per comprovació per permetre que l'agent Zabbix controli el seu propi fitxer de registre. Per exemple, si s'analitzen 10 registres i 3 registres fallen amb un error d'execució de l'expressió regular, es genera un registre al registre de l'agent. Excepció: si MaxLinesPerSecond=1 i l'interval d'actualització=1 (només es permet analitzar 1 registre per comprovació), no es registren els errors d'execució de l'expressió regular. zabbix_agentd registra la clau de l'element en cas d'error d'execució, zabbix_agent2 registra l'ID de l'element per ajudar a identificar quin element de registre té errors d'execució. Es recomana redissenyar l'expressió regular en cas d'errors d'execució. # hanode.get # hanode.get #### Hardware #### Maquinari #### Hardware General advice on hardware: - Use fastest processor available - SCSI or SAS is better than IDE (performance of IDE disks may be significantly improved by using utility hdparm) and SATA - 15K RPM is better than 10K RPM which is better than 7200 RPM - Use fast RAID storage - Use fast Ethernet adapter - Having more memory is always better #### Material Consells generals sobre el material: * Empreu el processador més ràpid possible * SCSI ou SAS és millor que IDE (el rendiment dels discs IDE poden millorar-se considerablement emprant hdparm) i SATA * 15K RPM és millor que 10K RPM, que a la vegada és millor que no pas 7200 RPM * Emprar un emmagatzematge RAID ràpid * Emprar un adaptador de xarxa ràpid * Tindre quanta més memòria, millor **ha\_remove\_node**\[=*target*\] Remove the high availability (HA) node specified by its name or ID. Note that active/standby nodes cannot be removed. **ha\_set\_failover\_delay**\[=*delay*\] Set high availability (HA) failover delay. Time suffixes are supported, e.g. 10s, 1m. **secrets\_reload** Reload secrets from Vault. **service\_cache\_reload** Reload the service manager cache. **prof\_enable**\[=*target*\] Enable profiling. Affects all processes if target is not specified. Enabled profiling provides details of all rwlocks/mutexes by function name. Supported since Zabbix 6.0.13. **prof\_disable**\[=*target*\] Disable profiling. Affects all processes if target is not specified. Supported since Zabbix 6.0.13. **log\_level\_increase**\[=*target*\] Increase log level, affects all processes if target is not specified **log\_level\_decrease**\[=*target*\] Decrease log level, affects all processes if target is not specified [ ]{#lbAG} **ha\_remove\_node**\[=*target*\] Esborra el node d'alta disponibilitat (HA) especificat pel seu nom o identificador. Tingueu en compte que els nodes actius/en espera no es poden pas esborrar. **ha\_set\_failover\_delay**\[=*delay*\] Estableix l'endarreriment de la migració per error d'alta disponibilitat (HA). S'admeten sufixos de temps, p. 10 segons, 1 m. **secrets\reload** Torna a carregar els secrets de Vault. **service\_cache\_reload** Torneu a carregar la memòria cau del gestor de serveis. **prof\_enable**\[=*target*\] Desactiva perfils. Afecta tots els processos si no s'especifica l'objectiu. Admès des de Zabbix 6.0.13. **prof\_disable**\[=*target*\] Desactiva la creació de perfils. Afecta tots els processos si no s'especifica l'objectiu. Admès des de Zabbix 6.0.13. **log\_level\_increase**\[=*target*\] Augmenta el nivell de registre, afecta tots els processos si no s'especifica l'objectiu **log\_level\_decrease**\[=*target*\] Disminueix el nivell de registre, afecta tots els processos si no s'especifica l'objectiu [ ]{#lbAG} ##### HDD/flash image (raw) dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync Replace */dev/sdc* with your Flash/HDD disk device. ##### Imatge HDD/flash (en brut) dd if=./zabbix_appliance_5.2.0.raw of=/dev/sdc bs=4k conv=fdatasync Substituïu */dev/sdc* per el vostre perifèric de disc Flash/HDD. #### 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" } ] ``` #### Processament de la capçalera #### Procés de la capçalera La línia de capçalera del fitxer CSV es pot processar de dues maneres diferents: - Si la casella *Amb filera de capçalera* és marcada, els valors de la filera de capçalera s'interpreten com a noms de columna. En aquest cas, els noms de les columnes han d'ésser únics i la filera de dades no ha de contindre més columnes que la filera de capçalera; - Si la casella *Amb filera de capçalera* no és pas marcada, la filera de capçalera s'interpreta com a dades. Els noms de les columnes es generen automàticament (1,2,3,4...) Exemple de fitxer CSV: Nombre, nom de l'element, clau, quantitat 1, element agent actiu, agent.hostname,33 "2","element d'agent passiu","agent.version","44" 3,"elements d'agent actiu i passiu", agent.ping,55 :::noteclassic Les cometes en un camp entre cometes de l'entrada s'han d'escapar precedint-les amb una altra cometa. ::: **Processament de filera de capçalera** Sortida JSON quan s'espera una filera de capçalera: ``` {.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 es processa cap filera de capçalera** Sortida JSON quan no s'espera una filera de capçalera: ``` {.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" } ] ``` ##### 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. ##### Menu amagat Fins i tot quan el menú és totalment amagat, un menú complet és a només un clic de distància, fent clic a la icona de l'hamburguesa. Tingueu en compte que reapareix al contingut de la pàgina; per moure el contingut de la pàgina cap a la dreta, heu de mostrar el menú fent clic al botó Mostra la barra lateral. #### Hiding the file with list of common passwords To increase the complexity of password brute force attacks, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication). For example, on NGINX file access can be limited by using the `location` directive: ```ini location = /data/top_passwords.txt { deny all; return 404; } ``` On Apache - by using `.htaccess` file: ```ini <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ``` #### Amagar l'arxiu amb la llista de mots de pas comuns Per augmentar la complexitat dels atacs de força bruta amb mots de pas, es recomana limitar l'accés al fitxer `ui/data/top_passwords.txt` modificant la configuració del servidor web. Aquest fitxer conté una llista dels mots de pas més comuns i específics del context, i s'empra per evitar que els usuaris estableixin aquests mots de pas si la configuració *Evitar mots de pas fàcils d'endevinar* és activada a la [política de seguretat dels mots de pas](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication). Per exemple, sota NGINX, l'accés als fitxers es pot limitar emprant la directiva "location": ``` location = /data/top_passwords.txt {​​​​​​​ deny all; return 404; }​​​​​​​ ``` Sota Apache - emprant l'arxiu `.htaccess`: ```ini <Files "top_passwords.txt"> Order Allow,Deny Deny from all </Files> ``` #### High availability cluster for Zabbix server The new version comes with a native high availability solution for Zabbix server. The solution consists of multiple zabbix\_server instances or nodes, where only one node can be active (working) at a time, while other nodes are on standby, ready to take over in case the current node is stopped or fails. See also: [High availability cluster](/manual/concepts/server/ha). ### Cluster d'alta disponibilitat per al servidor Zabbix La nova versió inclou una solució nadiua d'alta disponibilitat per al servidor Zabbix. La solució consta de múltiples instàncies o nodes de zabbix\_server, on només un node pot ésser actiu (funcionant) alhora, mentre que els altres nodes són en espera, preparats per fer-se càrrec en cas que el node actual sigui caigut o falli. Veieu també: [Cluster d'alta disponibilitat](/manual/concepts/server/ha). #### High availability cluster Retrieve a list of server nodes and their status. [High availability cluster API](/manual/api/reference/hanode) #### Cluster d'alta disponibilitat Recupera una llista de nodes de servidors i el seu estat. [API Cluster d'Alta Disponibilitat](/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|string|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, t.i. 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.| ### Node d'alta disponibilitat ::: noteclassic Els nodes són creats pel servidor de Zabbix i no pot ésser pas modificat via l'API. ::: L'objecte node d'alta disponibilitat té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |ha\_nodeid|string|ID del node.| |name|string|Nom assignat al node, emprant la configuració HANodeName a zabbix\_server.conf. Buit per a servidors executant-se de manera autònoma.| |address|string|IP o nom DNS des d'on connecta el node.| |port|integer|Port on el node és funcionant.| |lastaccess|integer|temps de Heartbeat: hora de la darrera actualització des del node. En temps UTC.| |status|integer|Estat del node.<br><br>Valors possibles:<br>0 - standby;<br>1 - aturat manualment;<br>2 - no disponible;<br>3 - actiu.| # High availability node object The following object is related to operating a High availability cluster of Zabbix servers. # Objecte de node d'alta disponibilitat El següent objecte serveix per operar amb un cluster d'alta disponibilitat de servidors Zabbix. #### 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:<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| #### Nodes d'alta disponibilitat Si el [clúster HA](/manual/concepts/server/ha) és habilitat, es veu un altre bloc de dades amb l'estat de cada node HA. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom del node, tal com es defineix a la configuració del servidor.| |*Adreça*|Adreça IP i port del node.| |*DArrer accés*|Hora del darrer accés al node.<br>Si passeu el cursor per sobre de la cel·la, es veu la marca de temps del darrer accés en format llarg.| |*Estat*|Estat del node:<br>**Activat** - el node és en funcionament<br>**No disponible** - el node no s'ha vist durant més que el temps de migració per error (pot ser que vulgueu saber per què)<br>**Aturat** - el node s'ha aturat o no s'ha pogut iniciar (podeu iniciar-lo o esborrar-lo)<br>**Pendent** - el node és actiu i pendent| # 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#hanode) Available methods: - [hanode.get](/manual/api/reference/hanode/get) - retrieving nodes # Node d'alta disponibilitat Aquesta classe és pensada per treballar amb servidors nodes que són part d'un cluster d'alta disponibilitat, o amb una instància de servidor autònom. Referències dels objectes: - [Node d'alta disponibilitat](/manual/api/reference/hanode/object#hanode) Mètodes disponibles: - [hanode.get](/manual/api/reference/hanode/get) - consultar els nodes #### history Changes:<br> [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) added new API method `history.clear`. #### historial Canvis:<br> [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) afegit un nou mètode d'API `history.clear`. # history.clear # history.clear #### History functions |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**change** (/host/key)|<|<| |The amount of difference between the previous and latest value.| |Supported value types: float, int, str, text, log<br><br>For strings returns:<br>0 - values are equal<br>1 - values differ<br><br>Example:<br>=> **change**(/host/key)>10<br><br>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><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Number of changes between adjacent values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**mode** (optional; must be double-quoted)<br><br>Supported `modes`:<br>*all* - count all changes (default)<br>*dec* - count decreases<br>*inc* - count increases|Supported value types: float, int, str, text, log<br><br>For non-numeric value types, *mode* parameter is ignored.<br><br>Examples:<br>=> **changecount**(/host/key, 1w) → number of value changes for the last week until [now](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → number of value increases (relative to the adjacent value) among the last 10 values<br>=> **changecount**(/host/key,24h,"dec") → number of value decreases (relative to the adjacent value) for the last 24 hours until [now](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Number of values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>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><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>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 '/').<br><br>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.<br><br>Examples:<br>=> **count**(/host/key,**10m**) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **count**(/host/key,**10m**,,12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that equal '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → number of values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **count**(/host/key,**10m:now-1d**) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Number of unique values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>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><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, 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 '/').<br><br>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.<br><br>Examples:<br>=> **countunique**(/host/key,**10m**) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key,**10m**,"like","error") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **countunique**(/host/key,**10m**,"gt",12) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**\#10**,"gt",12) → number of unique values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **countunique**(/host/key,**10m:now-1d**) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<| |Find a value match.|See [common parameters](#common-parameters).<br><br>**sec** or **\#num** (optional) - defaults to the latest value if not specified<br><br>**operator** (optional; must be double-quoted)<br><br>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) - value 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><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** - 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*.|Supported value types: float, int, str, text, log<br><br>Returns:<br>1 - found<br>0 - otherwise<br><br>If more than one value is processed, '1' is returned if there is at least one matching value.<br><br>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.<br><br>Example:<br>=> **find**(/host/key,**10m**,"like","error") → find a value that contains 'error' within the last 10 minutes until [now](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<| |The first (the oldest) value within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int, str, text, log<br><br>Example:<br>=> **first**(/host/key,**1h**) → retrieve the oldest value within the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>See also last().| |**fuzzytime** (/host/key,sec)|<|<| |Checking how much the passive agent time differs from the Zabbix server/proxy time.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Returns:<br>1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp (clock of value collection) is less than or equal to *sec* seconds<br>0 - otherwise<br><br>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).<br>Can be used also with vfs.file.time\[/path/file,modify\] key to check that file didn't get updates for long time.<br><br>Example:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detect a problem if the time difference is over 60 seconds<br><br>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`| |**last** (/host/key,<\#num<:time shift>>)|<|<| |The most recent value.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: float, int, str, text, log<br><br>Take note that a hash-tagged time period (\#N) works differently here than with many other functions.<br>For example:<br>last(/host/key) is always equal to last(/host/key,\#1)<br>last(/host/key,\#3) - third most recent value (*not* three latest values)<br><br>Zabbix does not guarantee the exact order of values if more than two values exist within one second in history.<br><br>Example:<br>=> **last**(/host/key) → retrieve the last value<br>=> **last**(/host/key,**\#2**) → retrieve the previous value<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,**\#2**) → the last and previous values differ<br><br>See also first().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Checking if event ID of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<| |Log severity of the last log entry.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: log<br><br>Returns:<br>0 - default severity<br>N - severity (integer, useful for Windows event logs: 1 - Information, 2 - Warning, 4 - Error, 7 - Failure Audit, 8 - Success Audit, 9 - Critical, 10 - Verbose).<br>Zabbix takes log severity from **Information** field of Windows event log.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Checking if log source of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches<br><br>Normally used for Windows event logs. For example, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Check if there has been a monotonous decrease in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is smaller or the same as the previous one; default) or *strict* (every value has decreased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously decrease, 0 otherwise.<br><br>Example:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calculate in how many hosts there has been a decrease in free swap size| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Check if there has been a monotonous increase in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is bigger or the same as the previous one; default) or *strict* (every value has increased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously increase, 0 otherwise.<br><br>Example:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - check if system local time has been increasing consistently| |**nodata** (/host/key,sec,<mode>)|<|<| |Checking for no data received.|See [common parameters](#common-parameters).<br><br>**sec** period should not be less than 30 seconds because the history syncer process calculates this function only every 30 seconds.<br><br>nodata(/host/key,0) is disallowed.<br><br>**mode** - if set to *strict* (double-quoted), this function will be insensitive to proxy availability (see comments for details).|All value types are supported.<br><br>Returns:<br>1 - if no data received during the defined period of time<br>0 - otherwise<br><br>Since Zabbix 5.0, the 'nodata' triggers monitored by proxy are, by default, sensitive to proxy availability - if proxy becomes unavailable, the 'nodata' triggers will not fire immediately after a restored connection, but will skip the data for the delayed period. Note that for passive proxies suppression is activated if connection is restored more than 15 seconds and no less than 2 seconds later. For active proxies suppression is activated if connection is restored more than 15 seconds later.<br><br>To turn off sensitiveness to proxy availability, use the third parameter, e.g.: **nodata**(/host/key,**5m**,**"strict"**); in this case the function will work the same as before 5.0.0 and fire as soon as the evaluation period (five minutes) without data has past.<br><br>Note that this function will display an error if, within the period of the 1st parameter:<br>- there's no data and Zabbix server was restarted<br>- there's no data and maintenance was completed<br>- there's no data and the item was added or re-enabled<br>Errors are displayed in the *Info* column in trigger [configuration](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>This function may not work properly if there are time differences between Zabbix server, proxy and agent. See also: [Time synchronization requirement](/manual/installation/requirements#time_synchronization);<br><br>nodata() function cannot be used in the expression by itself; at least one function from [another group](/manual/appendix/functions), referencing the host item, must be included in the expression (except [date and time functions](/manual/appendix/functions/time)). For detailed information on how the nodata() function works within expressions, see [Calculation time](/manual/config/triggers#calculation-time).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<| |P-th percentile of a period, where P (percentage) is specified by the third parameter.|See [common parameters](#common-parameters).<br><br>**percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point|Supported value types: float, int| |**rate** (/host/key,sec<:time shift>)|<|<| |Per-second average rate of the increase in a monotonically increasing counter within the defined time period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.<br><br>Example:<br>=> **rate**(/host/key,**30s**) → If the monotonic increase over 30 seconds is 20, this function will return 0.67.| #### Funcions d'històric |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**change** (/host/key)|<|<| |La quantitat de diferència entre el valor anterior i el darrer.| |Tipus de valors admesos: float, int, str, text, log<br><br>Per a les cadenes retorna:<br>0 - els valors són iguals<br>1 - els valors són diferents<br><br>Exemple:<br> => **change**(/host/key)>10<br><br>Es calcularà la diferència numèrica, tal com es veu en aquests valors d'exemple entrants (valor 'anterior' i 'darrer' = diferència):<br> "1" i "5" = "+4"<br>"3" i "1" = "-2"<br>"0" i "-2,5" = "-2,5"<br><br>Veieu també: [abs](/manual/apèndix/funcions/matemàtiques) per a la comparació| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Nombre de canvis entre valors adjacents dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (opcional; s'ha de fer entre cometes)<br>< br>Modes admesos:<br>*all* - comptar tots els canvis (predeterminat)<br>*dec* - recompte disminueix<br>*inc* - recompte augmenta|Tipus de valors admesos: float, int, str, text , registre<br><br>Per als tipus de valors no numèrics, el paràmetre *mode* s'ignora.<br><br>Exemples:<br>=> **changecount**(/host/key, 1w) → nombre de canvis de valor durant la darrera setmana fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → nombre d'augments de valor (en relació amb el valor adjacent) entre els darrers 10 valors<br>=> **changecount**(/host/key,24h,"dec") → el nombre de disminucions de valor (en relació amb el valor adjacent) durant le darreres 24 hores fins a [ara](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operador>,<pattern>)|<|<| |Nombre de valors dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**operador** (opcional; ha d'ésser entre cometes)<br><br>Admet `operadors`:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - major de<br>*ge* - major o igual<br>*lt* - menor de <br>*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - concordança sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br><br>**patró** (opcional) - patró obligatori (els arguments de cadena han d'ésser entre cometes dobles)|Tipus de valors admesos: flotant, enter, cadena, text, registre<br><br>Els elements flotants coincideixen amb la precisió de 2.22e-16; si la base de dades no és [actualitzada](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) la precisió és de 0,000001.<br><br>Amb *bitand* com a tercer paràmetre, el quart paràmetre `patró` es pot especificar com a dos nombres, separats per "/": **nombre\_a\_comparar\_amb/màscara**. count() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre\_a\_comparar\_amb*. Si el resultat de "AND bit a bit" és igual a *nombre\_a\_comparar\_amb*, es compta el valor.<br>Si *nombre\_a\_comparar\_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions# global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.<br><br>Exemples:<br>=> **count**(/ host/key,**10m**) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,* *10m**,"like","error") → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que contenen "error"<br>=> **count**(/host/key,**10m**,,12) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que són iguals a '12'<br>=> * *count**(/host/key,**10m**,"gt",12) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que són superiors a '12 '<br>=> **count**(/host/key,**\#10**,"gt",12) → nombre de valors dins dels darrers 10 valors fins a [ara](/manual/config/ triggers#evaluation_period) que superen '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt" ,12) → nombre de valors entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period) que eren superiors a '12'<br>=> **count**(/host /key,**10m**,"bitand","6/7") → nombre de valors dels darrers 10 minuts fins [ara](/manual/config/triggers#evaluation_period) que tinguin '110' (en binari) als 3 bits menys significatius.<br>=> **count**(/host/key,**10m:now-1d**) → nombre de valors entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Nombre de valors únics dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**operador** (opcional; ha d'estar entre cometes)<br><br> `Operadors` admesos:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - més gran de <br>*ge* - major o igual<br>*lt* - més petit de <br>*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'element normal expressió donada a `pattern`<br>*iregexp*: coincidència sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br><br>**patró** (opcional) - patró obligatori (els arguments de la cadena han d'ésser dobles)|Tipus de valors admesos: flotant, enter, cadena, text, registre<br><br>Els elements flotants coincideixen amb la precisió de 2.22e-16; si la base de dades no és [actualitzada](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) la precisió és 0,000001.<br><br>Amb *bitand* com a tercer paràmetre, el quart paràmetre "patró" es pot especificar com a dos nombres, separats per "/": **nombre\_a\_comparar\_amb/màscara**. countunique() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre\_a\_comparar\_amb*. Si el resultat de "AND bit a bit" és igual a *nombre\_a\_comparar\_amb*, es compta el valor.<br>Si *nombre\_a\_comparar\_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions# global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.<br><br>Exemples:<br>=> **countunique**(/ host/key,**10m**) → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key, **10m**,"like","error") → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que contenen "error"<br>=> ** countunique**(/host/key,**10m**,"gt",12) → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que superen el '12 '<br>=> **countunique**(/host/key,**\#10**,"gt",12) → nombre de valors únics dins dels darrers 10 valors fins a [ara](/manual/config /triggers#evaluation_period) que superen '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → nombre de valors únics entre 24 fa hores i 10 minuts i 24 hores des d'[ara](/man ual/config/triggers#evaluation_period) que eren superiors a '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → nombre d'únics valors dels darrers 10 minuts fins [ara](/manual/config/triggers#evaluation_period) tingui '110' (en binari) als 3 bits menys significatius.<br>=> **countunique**(/host/key ,**10m:now-1d**) → nombre de valors únics entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operador>,<pattern>)|<|<| |Cerca una coincidència de valor.|Veieu [paràmetres comuns](#common-parameters).<br><br>**sec** o **\#num** (opcional) - per defecte el valor més recent si no s'especifica <br><br>**operador** (opcional; ha d'ésser entre cometes)<br><br>"operadors" admesos:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - major de<br>*ge* - major o igual<br>*lt* - menor de<br>*le* - menor o igual<br>*com* - el valor conté la cadena donada a `pattern` (distingeix entre majúscules i minúscules)<br>*bitand* - bit a bit AND<br>*regexp* - concordança sensible a majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - coincidència insensible a majúscules i minúscules del expressió regular donada a `pattern`<br><br>**patró** - patró obligatori (els arguments de cadena han d'ésser entre cometes); [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) expressió regular si `operador` és *regexp*, *iregexp*.|Tipus de valors admesos: float, int, str, text, registre<br><br>Retorna:<br>1 - trobat<br>0 - en cas contrari<br><br>Si es processa més d'un valor, es retorna '1' si hi ha almenys un valor coincident.<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars.<br><br>Exemple:<br>=> **find**(/host/key,**10m**,"like", "error") → cerca un valor que contingui "error" dins dels darrera 10 minuts fins [ara](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<| |El primer valor (el més antic) dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int, str, text, log<br><br>Exemple:< br>=> **first**(/host/key,**1h**) → recupera el valor més antic durant la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)<br><br> Veieu també last().| |**fuzzytime** (/host/key,sec)|<|<| |Comprovació de quant difereix el temps de l'agent passiu del temps del servidor/proxy Zabbix.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Retorna:<br>1 - La diferència entre el valor de l'element passiu (com a marca de temps) i la marca de temps del servidor/proxy Zabbix (rellotge de recollida de valors) és menor o igual a T segons<br>0 - en cas contrari<br><br>S'empra habitualment amb el 'system.localtime' (temps local del sistema) per comprovar que l'hora local és sincronitzada amb l'hora local del servidor Zabbix. *Tingueu en compte* que 'system.localtime' s'ha de configurar com a [comprovació passiva](/manual/appendix/items/activepassive#passive_checks).<br>També es pot emprar amb vfs.file.time\[/path/file ,modifica\] per comprovar que el fitxer no ha rebut actualitzacions durant molt de temps.<br><br>Exemple:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detecta un problema si la diferència de temps supera els 60 segons<br><br>Aquesta funció no es recomana emprar-la en expressions d'activació complexes (amb diversos elements implicats), perquè pot provocar resultats inesperats (la diferència de temps es mesurarà amb el mètrica més recent), p. ex. a `fuzzytime(/Host/system.localtime,60s)=0 o last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<| |El valor més recent.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent|Tipus de valors admesos: float, int, str, text, log<br><br>Tingueu en compte que un període de temps etiquetat amb hash (\#N) funciona de manera diferent aquí que a moltes altres funcions.<br>Per exemple:<br>last() sempre és igual a last(\#1)<br>darrer(\#3) - tercer valor més recent (*no* tres valors més recents)<br><br>Zabbix no garanteix l'ordre exacte dels valors si hi ha més de dos valors dins un segon a l'historial.<br><br>Exemple:<br>=> **last**(/host/key) → recupera el darrer valor<br>=> **last**(/host/key, **\#2**) → recupera el valor anterior<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key, **\#2**) → els darrers valors i els anteriors són diferents<br><br>Veieu també primer().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Comprovar si l'ID d'esdeveniment de la darrera entrada de registre coincideix amb una expressió regular.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent <br><br>**pattern** (opcional) - expressió regular que descriu el patró requerit, estil [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (els arguments de cadena han d'ésser entre cometes dobles).|Tipus de valors admesos: log<br><br>Retorna:<br>0 - no coincideix<br>1 - coincideix| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<| |Gravetat del registre de la darrera entrada del registre.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - el valor enèsim més recent|Tipus de valors admesos: registre <br><br>Retorna:<br>0 - gravetat predeterminada<br>N - gravetat (enter, útil per als registres d'esdeveniments de Windows: 1 - Informació, 2 - Avís, 4 - Error, 7 - Auditoria d'errors, 8 - Auditoria correcta, 9 - Crític, 10 - Detall).<br>Zabbix pren la gravetat del registre del camp **Information** del registre d'esdeveniments de Windows.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Comprovar si l'origen del registre de la darrera entrada del registre coincideix amb una expressió regular.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent <br><br>**pattern** (opcional) - expressió regular que descriu el patró requerit, estil [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (els arguments de cadena han d'ésser entre cometes dobles).|Tipus de valors admesos: registre<br><br>Retorna:<br>0 - no coincideix<br>1 - coincideix<br><br>S'empra normalment per als registres d'esdeveniments de Windows. Per exemple, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Comproveu si hi ha hagut una disminució monòtona dels valors.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (ha d'ésser entre cometes dobles) - *feble* (cada valor) és més petit o el mateix que l'anterior; per defecte) o *estricte* (tots els valors han disminuït)|Tipus de valors admesos: int<br><br>Retorna 1 si tots els elements del període de temps disminueixen contínuament, 0 en cas contrari.< br><br>Exemple:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/ system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calcula a quants equips hi ha hagut una disminució de la mida de l'intercanvi lliure| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Comprovar si hi ha hagut un increment monòton de valors.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (ha d'ésser entre cometes dobles) - *feble* (cada valor és més gran o el mateix que l'anterior; per defecte) o *estricte* (tots els valors han augmentat)|Tipus de valors admesos: int<br><br>Retorna 1 si tots els elements del període de temps augmenten contínuament, 0 en cas contrari.<br><br>Exemple:< br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - comproveu si l'hora local del sistema ha pujat de forma constant| |**nodata** (/host/key,sec,<mode>)|<|<| |Comprovació de no rebuda de dades.|Veieu els [paràmetres comuns](#common-parameters).<br><br>El període de **seg** no hauria d'ésser inferior a 30 segons perquè el procés de sincronització de l'historial calcula aquesta funció només cada 30 segons.<br><br>nodata(/host/key,0) no és permesa.<br><br>**mode**: si s'estableix en *estricte* (entre cometes), aquesta funció serà insensible a Disponibilitat de proxy (veieu els comentaris per obtindre més informació).|S'admeten tots els tipus de valors.<br><br>Retorna:<br>1 - si no s'han rebut dades durant el període de temps definit<br>0 - en cas contrari<br><br >Des de Zabbix 5.0, els triggers de "nodata" monitorats pel proxy són, de manera predeterminada, sensibles a la disponibilitat del proxy; si el proxy no és pas disponible, els triggers de "nodata" no s'activaran immediatament quan es restauri la connexió, sinó que saltaran les dades per als períodes endarrerits. Tingueu en compte que per als proxys passius la supressió s'activa si la connexió es restableix més de 15 segons i no menys de 2 segons més tard. Per als proxys actius, la supressió s'activa si la connexió es restaura més de 15 segons després.<br><br>Per desactivar la sensibilitat a la disponibilitat del proxy, empreu el tercer paràmetre, p. ex.: **nodata**(/host/key,** 5m**,**"estricte"**); en aquest cas, la funció anirà igual que abans de la 5.0.0 i s'activarà tan aviat com hagi passat el període d'avaluació (cinc minuts) sense dades.<br><br>Tingueu en compte que aquesta funció mostrarà un error si, dins del període del 1r paràmetre:<br>- no hi ha dades i el servidor Zabbix s'ha reiniciat<br>- no hi ha dades i s'ha completat el manteniment<br>- no hi ha dades i l'element s'ha afegit o tornat a habilitar<br>Es mostren errors a la columna *Informació* del trigger [configuració](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>És possible que aquesta funció no funcioni correctament si hi ha diferències horàries entre el servidor Zabbix, el proxy i l'agent. Veieu també: [Requisit de sincronització de l'hora](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<| |P-è percentil d'un període, on P (percentatge) s'especifica com a tercer paràmetre.|Veieu [paràmetres comuns](#common-parameters).<br><br>**percentatge** - un nombre de coma flotant entre 0 i 100 (inclosos) amb fins a 4 dígits després del punt decimal|Tipus de valors admesos: float, int| |**tax** (/host/key,sec<:time shift>)|<|<| |Taxa mitjana per segon de l'augment d'un comptador que augmenta monòtonament dins del període de temps definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Correspon funcionalment a "[tarifa](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)" de PromQL.<br><br>Exemple:<br>=> **tarifa**(/ host/clau,**30s**) → Si l'augment monòton en 30 segons és 20, aquesta funció retornarà 0,67.| # history.get # history.get # 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 the Zabbix server and cannot be modified via the API. ::: # > Objecte historial Els objectes següents són vinculats a l'API`history`. ::: noteclassic Els objectes d'històric difereixen segons el tipus d'informació de l'element. Es creen pel servidor Zabbix i no poden pas ésser modificats per via de l'API. ::: #### History Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing. [History API](/manual/api/reference/history) #### Historial Recupera els valors de l'historial recollits per els processos de monitoratge de Zabbix per presentar-los o tractar-los posteriorment. [API Historial](/manual/api/reference/history) # History This class is designed to work with history data. Object references: - [History](/manual/api/reference/history/object#history) Available methods: - [history.get](/manual/api/reference/history/get) - retrieving history data. # Històric Aquesta classe és pensada per treballar amb les informació de l'històric. Referències d'objectes: - [Històric](/manual/api/reference/history/object#history) Mètodes disponibles: - [history.get](/manual/api/reference/history/get) - consultar dades de l'històric. ### HMAC function for JavaScript A new function has been added to the JavaScript engine allowing to return HMAC hash: - `hmac('<hash type>',key,string)` This is useful for cases when hash-based message authentication code (HMAC) is required for signing requests. MD5 and SHA256 hash types are supported, e. g.: - `hmac('md5',key,string)` - `hmac('sha256',key,string)` ### Funció HMAC per JavaScript S'ha afegit una nova funció al motor JavaScript per calcular el hash HMAC: - `hmac('<tipus hash>',clau,cadena)` Això és útil en els casos en què es requereix un codi d'autenticació de missatges basat en hash (HMAC) per signar les peticions. S'admeten els tipus hash MD5 i SHA256, per exemple: · - · `hmac('md5',clau,cadena)` · - · `hmac('sha256',clau,cadena)` #### Host access from several user groups A user may belong to any number of user groups. These groups may have different access permissions to hosts. Therefore, it is important to know what hosts 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 starting with Zabbix 2.2. ::: - 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**. #### Accés a equips des de diferents grups d'usuaris Un usuari pot pertànyer a qualsevol nombre de grups d'usuaris. Aquests grups poden tindre diferents permisos d'accés als equips. Per tant, és important sabre a quins equips podrà accedir un usuari sense privilegis. Per exemple, examinem com es veurà afectat l'accés a l'equip **X** (al grup d'equip 1) en diverses situacions per a un usuari que es troba als grups d'usuaris A i B. - Si el grup A només té accés de *lectura* al grup d'equip 1, però el grup B té accés de *lectura-escriptura* al grup d'equip 1, l'usuari tindrà accés de **lectura-escriptura** a 'X'. ::: noteimportant Els permisos de "lectura-escriptura" tenen prioritat sobre els permisos de "lectura" des de Zabbix 2.2. ::: - En el mateix escenari que l'anterior, si 'X' també es troba simultàniament al grup d'equip 2 que és **denegat** al grup A o B, l'accés a 'X' serà **no disponible** , tot i haver-hi *lectura-escriptura* al grup d'equip 1. - Si el grup A no té permisos establerts i el grup B té accés de *Lectura-Escriptura* al grup d'equip 1, l'usuari obtindrà accés de **Lectura-Escriptura** a 'X'. - Si el grup A té accés *Denegat* al grup d'equip 1 i el grup B té accés de *Lectura-Escriptura* al grup d'equip 1, l'usuari tindrà accés a 'X' **denegat**. ##### 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. ##### Configuració de l'equip S'ha de configurar un equip per tractar les verificacions IPMI. Una interfície IPMI s'ha d'afegir, amb les adreces IP i els nombres de port respectius, i s'han de definir els paràmetres d'autenticació IPMI. Veieu la [configuració d'equips](/manual/config/hosts/host) per tindre més detalls. #### Host configuration To use VMware simple checks the host must have the following user macros defined: - **{$VMWARE.URL}** - VMware service (vCenter or ESX hypervisor) SDK URL (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - VMware service user name - **{$VMWARE.PASSWORD}** - VMware service {$VMWARE.USERNAME} user password #### Configuració de l'equip Per emprar VMware Simple Checks, l'equip ha d'haver definit les macros d'usuari següents: - **{$VMWARE.URL}** - URL de l'SDK del servei VMware (vCenter o hipervisor ESX) (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - Nom d'usuari del servei VMware - **{$VMWARE.PASSWORD}** - Mot de pas d'usuari del servei VMware {$VMWARE.USERNAME} ##### Host configuration You can specify that an individual host should be monitored by a proxy in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by proxy* field.  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy. ##### Configuració de l'equip Podeu especificar que un equip s'ha de monitorar a un proxy al formulari [Configuració de l'equip](/manual/config/hosts/host), emprant el camp *Monitorat mitjançant proxy*.  L'[actualització massiva](/manual/config/hosts/hostupdate) dels equips pot ésser una altra manera d'especificar que els equips han d'ésser monitorats per un proxy. # 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 is the criterion for finding a host in the system. If a host with that IP address and interface type already exists, that host will be the target for performing operations. 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. ##### Creació d'equip S'afegeix un equip si és triada l'operació *Afegir equip*. També s'afegeix un equip, encara que falti l'operació *Afegir equip*, si trieu operacions que donen lloc a accions en un equip. Aquestes operacions són: - activar equip - desactivar equip - afegir un equip a un grup d'equips - vincular un model a un equip Els equips creats s'afegeixen al grup *Equips descoberts* (per defecte, configurable a *Administració* → *General* → *[Altres](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Si voleu que s'afegeixin equips a un altre grup, afegiu una operació *Treure dels grups d'equips* (especificant "Equips descoberts") i també una operació *Afegir als grups d'equips* (especificant un altre grup d'equips), perquè un equip ha de pertànyer a un grup d'equips. L'adreça IP del dispositiu trobat és el criteri per trobar un equip al sistema. Si ja existeix un equip amb aquesta adreça IP i aquest tipus d'interfície, aquest equip serà l'objectiu per realitzar les operacions. Si es canvia l'adreça IP de l'equip trobat o s'esborra la interfície, es crearà un equip nou a la següent descoberta. # host.delete # host.delete #### Host editing as popup The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration. Direct links to the host edit page still work and are opening the host edit page in full page. ##### Modificació d'equip via popup El formulari de creació i edició de l'equip s'obre ara en una finestra modal (pop-up), a *Configuració* → *Equips*, *Monitoratge* → *Equips*, i a qualsevol pàgina on hi hagi un menú d'equips o un altre enllaç directe a la configuració de l'equip. Els enllaços directes a la pàgina d'edició de l'equip encara funcionen i obren la pàgina d'edició de l'equip a pantalla completa. # host.get # host.get ##### Host graph tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |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`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| ##### Etiquetes de gràfic d'equip |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |gràfics| |\-| | |Element arrel per a gràfics.| | |name|x|`cadena`| |Nom del gràfic.| | |width|\-|`integer`|20-65535 (per defecte: 900)|Amplada del gràfic, en píxels. S'empra per a la previsualització i per a gràfics circulars/explotats.| | |height|\-|`integer`|20-65535 (per defecte: 200)|Alçada del gràfic, en píxels. S'empra per a la previsualització i per a gràfics circulars/explotats.| | |yaxismin|\-|`double`|Per defecte: 0|Valor mínim de l'eix Y.<br><br>S'empra si 'ymin\_type\_1' està FIXAT.| | |yaxismax|\-|`double`|Per defecte: 0|Valor màxim de l'eix Y.<br><br>S'empra si 'ymax\type\_1' està FIXAT.| | |show\_work\_period|\-|`cadena`|0 - NO<br>1 - SÍ (predeterminat)|Destaca les hores no treballades.<br><br>S'empren per gràfics normals i apilats. | | |show\_triggers|\-|`cadena`|0 - NO<br>1 - YES (per defecte)|Mostra els valors de trigger únics com a línia.<br><br>S'empren per gràfics normals i apilats .| | |type|\-|`cadena`|0 - NORMAL (predeterminat)<br>1 - APILAT<br>2 - PASTÍS<br>3 - EXPLOTAT|Tipus de gràfic.| | |show\_legend|\-|`cadena`|0 - NO<br>1 - SÍ (per defecte)|Mostra la llegenda del gràfic.| | |show\_3d|\-|`cadena`|0 - NO (predeterminat)<br>1 - SÍ|Activa l'estil 3D.<br><br>S'empren per gràfics de sectors i gràfics de sectors explotats. | | |percent\_left|\-|`double`|Per defecte: 0|Mostra la línia percentil per a l'eix esquerre.<br><br>Només s'empra per a gràfics normals.| | |percent\_right|\-|`double`|Per defecte: 0|Mostra la línia percentil per a l'eix dret.<br><br>Només s'empra per a gràfics normals.| | |ymin\_type\_1|\-|`cadena`|0 - CALCULAT (predeterminat)<br>1 - FIXAT<br>2 - ARTICLE|Valor mínim de l'eix Y.<br><br>Emprat amb gràfics normals i apilats.| | |ymax\_type\_1|\-|`cadena`|0 - CALCULAT (predeterminat)<br>1 - FIXAT<br>2 - ELEMENT|Valor màxim de l'eix Y.<br><br>Emprat per gràfics normals i apilats.| |ymin\_item\_1| |\-| | |Detalls de cada element.<br><br>Obligatori si 'ymin\_type\_1' és ELEMENT.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| |ymax\_item\_1| |\-| | |Detalls de cada element.<br><br>Obligatori si 'ymax\_type\_1' és ELEMENT.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| |gràfic\_elements| |x| | |Element arrel per als elements del gràfic.| | |sortorder|\-|`enter`| |Ordre de dibuix. Primer es dibuixa el valor més petit. Es pot emprar per dibuixar línies o regions darrere (o davant) d'una altra.| | |drawtype|\-|`cadena`|0 - SINGLE\_LINE (per defecte)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Estil de dibuix d'elements gràfics.<br><br>Només s'empren els gràfics normals.| | |color|\-|`cadena`| |Color de l'element (6 símbols, hexadecimal).| | |yaxisside|\-|`cadena`|0 - ESQUERRE (per defecte)<br>1 - DRET|Lateral del gràfic on es dibuixarà l'escala Y de l'element del gràfic.<br><br>S'empra a gràfics normals i apilats.| | |calc\_fnc|\-|`cadena`|1 - MIN<br>2 - AVG (predeterminat)<br>4 - MAX<br>7 - ALL (mínim, mitjà i màxim; emprat només per gràfics simples)<br>9 - LAST (emprat només per gràfics de pastís i gràfics de pastís explotats)|Dades per dibuixar si hi ha diversos valors per a un element.| | |type|\-|`cadena`|0 - SINGLE (per defecte)<br>2 - GRAPH\_SUM (el valor de l'element representa el sector sencer; només s'empren els gràfics de pastís i de pastís explotats)|Tipus d'element de gràfic.| |element| |x| | |Element individual.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| #### host group Changes:<br> [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.<br> [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters. #### grup d'equips Canvis:<br> [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: els camps `hosts` i `templates` ara són necessaris.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: afegida validació estricta dels paràmetres de mètode. #### hostgroup Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated. #### grup d'equips Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: el paràmetre `uuid` ara es pot actualitzar. # 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. # Objecte Grup d'equips Els següents objectes són relacionats amb l'API `hostgroup`. ### Host group The host group object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Grup d'equips L'objecte té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|string|*(nomes lectura)* ID del grup d'equips.| |**name**<br>(obligatori)|string|Nom del grup d'equips.| |flags|integer|*(nomes lectura)* Origen del grup d'equips.<br><br>Valors possibles:<br>0 - un grup d'equips en brut;<br>4 - un grup d'equips descobert.| |internal|integer|*(nomes lectura)* Indica si el grup s'empra internament per al sistema. Un grup intern no pot pas esborrar-se.<br><br>Valors possibles:<br>0 - *(per defecte)* no intern;<br>1 - intern.| |uuid|string|Identificador universal únic, emprat per enllaçar els grups d'equips importats als ja existents. Generat automàticament si no es proporciona.| Veieu que per alguns mètodes (com ara actualitzar i esborrar), la combinació de paràmetres obligatoris o opcionals és diferent. # 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) - creating new host groups - [hostgroup.delete](/manual/api/reference/hostgroup/delete) - deleting host groups - [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving host groups - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - adding related objects to host groups - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - removing related objects from host groups - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - replacing or removing related objects from host groups - [hostgroup.update](/manual/api/reference/hostgroup/update) - updating host groups # Grup d'equips Aquesta classe és dissenyada per treballar amb grups d'equips. Referències d'objectes: - [Grup d'equips](/manual/api/reference/hostgroup/object#host_group) Mètodes disponibles: - [hostgroup.create](/manual/api/reference/hostgroup/create) - crear grups d'equips - [hostgroup.delete](/manual/api/reference/hostgroup/delete) - esborrar grups d'equips - [hostgroup.get](/manual/api/reference/hostgroup/get) - recuperar grups d'equips - [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - afegir objectes als grups d'equips - [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - esborrar objectes dels grups d'equips - [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - reemplaçar o esborrar objectes dels grups d'equips - [hostgroup.update](/manual/api/reference/hostgroup/update) - actualitzar grups d'equips # hostgroup.update # hostgroup.update # hostinterface.create # hostinterface.create # hostinterface.delete # hostinterface.delete # hostinterface.get # hostinterface.get # hostinterface.massadd # hostinterface.massadd # hostinterface.massremove # hostinterface.massremove # Host interface object The following objects are directly related to the `hostinterface` API. # Objecte interfície d'equip Els següents objectes són enllaçats amb l'API `hostinterface`. # hostinterface.replacehostinterfaces # hostinterface.replacehostinterfaces ### Host interface The host interface object has the following properties. ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. ::: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|object|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|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 are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Interfície d'equip L'objecte d'interfície d'equip té les propietats següents. ::: nota important Tingueu en compte que cal IP i DNS. Si no s'ha d'emprar DNS, configureu-lo en una cadena buida. ::: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |available|integer|*(només lectura)*Disponibilitat de la interfície de l'equip.<br><br>Els valors possibles són:<br>0 - *(per defecte)* desconegut;<br>1 - disponible;< br>2 - no disponible.| |details|objecte|Objecte addicional per a la interfície. **Obligatori** si el "tipus" d'interfície és SNMP.| |disable\_until|timestamp|*(només lectura)* La propera vegada que es consulta una interfície d'equip no disponible.| |**dns**<br>(obligatori)|string|Nom DNS emprat per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant IP.| |error|string|*(només lectura)* Text d'error si la interfície de l'equip no és pas disponible.| |errors\_from|timestamp|*(només lectura)*Hora en què la interfície de l'equip no va estar disponible.| |**hostid**<br>(obligatori)|string|ID de l'equip al que pertany la interfície.| |interfaceid|string|*(només lectura)* ID de la interfície.| |**ip**<br>(obligatori)|string|adreça IP emprada per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant DNS.| |**main**<br>(obligatori)|integer|Indica si la interfície s'empra per defecte a l'equip. Només es pot configurar per defecte una interfície d'un tipus determinat en un host.<br><br>Valors possibles:<br>0 - no (per defecte);<br>1 - predeterminat.| |**port**<br>(obligatori)|string|Nombre de port emprat per la interfície. Pot contindre macros d'usuari.| |**tipus**<br>(obligatori)|integer|Tipus d'interfície.<br><br>Valors possibles:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI; <br> >4 - JMX.<br>| |**useip**<br>(obligatori)|integer|Indica si la connexió s'ha d'establir mitjançant IP.<br><br>Valors possibles:<br>0 - connecteu-vos amb el nom DNS de l'equip ;<br>1 - connecteu-vos mitjançant l'adreça IP de l'equip per a aquesta interfície d'equip.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Host interface This class is designed to work with host interfaces. Object references: - [Host interface](/manual/api/reference/hostinterface/object#host_interface) Available methods: - [hostinterface.create](/manual/api/reference/hostinterface/create) - creating new host interfaces - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - deleting host interfaces - [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieving host interfaces - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - adding host interfaces to hosts - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - removing host interfaces from hosts - [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replacing host interfaces on a host - [hostinterface.update](/manual/api/reference/hostinterface/update) - updating host interfaces # Interfícies d'equips Aquesta classe és dissenyada per treballar amb interfícies d'equips. Referències d'objectes: - [interfície d'equips](/manual/api/reference/hostinterface/object#host_interface) Mètodes disponibles: - [hostinterface.create](/manual/api/reference/hostinterface/create) - crear interfícies d'equips - [hostinterface.delete](/manual/api/reference/hostinterface/delete) - esborrar interfícies d'equips - [hostinterface.get](/manual/api/reference/hostinterface/get) - recuperar interfícies d'equips - [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - afegir objectes als interfícies d'equips - [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - esborrar objectes dels interfícies d'equips - [hostinterface.replacehostinterfaces (/manual/api/reference/hostinterface/replacehostinterfaces) - reemplaçar les interfícies d'un equip - [hostinterface.update](/manual/api/reference/hostinterface/update) - actualitzar interfícies d'equips # hostinterface.update # hostinterface.update ### 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.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters| ### Inventari d'equip L'objecte d'inventari d'equip té les propietats següents. ::: notetip Cada propietat té el seu propi nombre d'identificació únic, que s'empra per associar camps d'inventari de l'equip amb articles. ::: |ID|Propietat|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |-|--|-|-----|-----| |4|alias|string|Àlies.|128 caràcters| |11|asset\_tag|string|Etiqueta característica.|64 caràcters| |28|chassis|string|Xassís.|64 caràcters| |23|contact|string|Persona de contacte.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |32|contract\_number|string|Nombre de contracte.|64 caràcters| |47|date\_hw\_decomm|string|Material - Data de retirada.|64 caràcters| |46|data\_hw\_expiry|string|Maquinari - Data de finalització del manteniment|64 caràcters| |45|date\_hw\_install|string|Maquinari - Data d'instal·lació.|64 caràcters| |44|data\_hw\_purchase|string|Material - Data de compra.|64 caràcters| |34|desplegament\_estat|string|Estat del desplegament.|64 caràcters| |14|hardware|string|Maquinari.|255 caràcters| |15|hardware\_full|string|Detalls complets del maquinari.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |39|host\_netmask|string|Màscara de subxarxa de l'equip.|39 caràcters| |38|host\_networks|string|Xarxes d'equip.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |40|host\_router|string|Equip - Encaminador.|39 caràcters| |30|hw\_arch|string|Arquitectura del material.|32 caràcters| |33|installer\_name|string|Nom de l'instal·lador.|64 caràcters| |24|location|string|Ubicació.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |25|location\_lat|string|Latitud de la ubicació.|16 caràcters| |26|location\_lon|string|Longitud de la ubicació.|16 caràcters| |12|macaddress\_a|string|adreça MAC A.|64 caràcters| |13|macaddress\_b|string|adreça MAC B.|64 caràcters| |29|model|string|Model.|64 caràcters| |3|name|string|Nom.|128 caràcters| |27|notes|string|Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |41|oob\_ip|string|Adreça IP OOB.|39 caràcters| |42|oob\_netmask|string|Màscara de subxarxa OOB.|39 caràcters| |43|oob\_router|string|OOB de l'encaminador.|39 caràcters| |5|os|string|OS.|128 caràcters| |6|os\_full|string|Nom complet del sistema operatiu.|255 caràcters| |7|os\_short|string|Nom curt del SO.|128 caràcters| |61|poc\_1\_cell|string|Contacte principal - mòbil.|64 caràcters| |58|poc\_1\_email|string|Contacte principal - Correu electrònic.|128 caràcters| |57|poc\_1\_name|string|Contacte principal - Nom.|128 caràcters| |63|poc\_1\_notes|string|Contacte principal - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |59|poc\_1\_phone\_a|string|Contacte principal - Telèfon 1.|64 caràcters| |60|poc\_1\_phone\_b|string|Contacte principal - Telèfon 2.|64 caràcters| |62|poc\_1\_screen|string|Contacte principal - Nom d'usuari.|64 caràcters| |68|poc\_2\_cell|string|Contacte secundari - Mòbil.|64 caràcters| |65|poc\_2\_email|string|Contacte secundari - Correu electrònic.|128 caràcters| |64|poc\_2\_name|string|Contacte secundari - Nom.|128 caràcters| |70|poc\_2\_notes|string|Contacte secundari - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |66|poc\_2\_phone\_a|string|Contacte secundari - Telèfon 1.|64 caràcters| |67|poc\_2\_phone\_b|string|Contacte secundari - Telèfon 2.|64 caràcters| |69|poc\_2\_screen|string|Contacte secundari - ID.|64 caràcters| |8|serialno\_a|string|Nombre de sèrie A.|64 caràcters| |9|serialno\_b|string|Nombre de sèrie B.|64 caràcters| |48|site\_address\_a|string|Lloc - Adreça 1.|128 caràcters| |49|site\_address\_b|string|Lloc - Adreça 2.|128 caràcters| |50|site\_address\_c|string|Lloc - Adreça 3.|128 caràcters| |51|site\_city|string|Lloc - Ciutat.|128 caràcters| |53|lloc\_country|string|Lloc - País.|64 caràcters| |56|lloc\_notes|string|Lloc - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |55|site\_rack|string|Lloc - Ubicació del bastidor.|128 caràcters| |52|lloc\_state|string|Lloc - estat/província.|64 caràcters| |54|site\_zip|string|Lloc - codi postal.|64 caràcters| |16|software|string|Programari.|255 caràcters| |18|software\_app\_a|string|Aplicació de programari A.|64 caràcters| |19|software\_app\_b|string|Aplicació de programari B.|64 caràcters| |20|software\_app\_c|string|Aplicació de programari C.|64 caràcters| |21|software\_app\_d|string|Aplicació de programari D.|64 caràcters| |22|software\_app\_e|string|Aplicació de programari E.|64 caràcters| |17|software\_full|string|Detalls del programari.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |10|tag|string|Etiqueta.|64 caràcters| |1|type|string|Tipus.|64 caràcters| |2|type\_full|string|Detalls del tipus.|64 caràcters| |35|url\_a|string|URL A.|255 caràcters| |36|url\_b|string|URL B.|255 caràcters| |37|url\_c|string|URL C.|255 caràcters| |31|vendor|string|Proveïdor.|64 caràcters| ##### Host item tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |items| |\-| | |Root element for items.| | |name|x|`string`| |Item name.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| | |snmp\_oid|\-|`string`| |SNMP object ID.<br><br>Required by SNMP items.| | |key|x|`string`| |Item key.| | |delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| | |history|\-|`string`|Default: 90d|Time period of how long the history data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |trends|\-|`string`|Default: 365d|Time period of how long the trends data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| | |value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| | |allowed\_hosts|\-|`string`| |List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| | |units|\-|`string`| |Units of returned values (bps, B, etc).| | |params|\-|`text`| |Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| | |ipmi\_sensor|\-|`string`| |IPMI sensor.<br><br>Used only by IPMI items.| | |authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| | |username|\-|`string`| |Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| | |password|\-|`string`| |Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| | |publickey|\-|`string`| |Name of the public key file.<br><br>Required for SSH agent items.| | |privatekey|\-|`string`| |Name of the private key file.<br><br>Required for SSH agent items.| | |description|\-|`text`| |Item description.| | |inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| | |logtimefmt|\-|`string`| |Format of the time in log entries.<br>Used only by log items.| | |interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| | |jmx\_endpoint|\-|`string`| |JMX endpoint.<br><br>Used only by JMX agent items.| | |url|\-|`string`| |URL string.<br><br>Required only for HTTP agent items.| | |allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while polling data.<br><br>Used only by HTTP agent items.| |headers| |\-| | |Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |http\_proxy|\-|`string`| |HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| | |output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| | |post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| | |posts|\-|`string`| |HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields| |\-| | |Root element for query parameters.<br><br>Used only by HTTP agent items.| | |name|x|`string`| |Parameter name.| | |value|\-|`string`| |Parameter value.| | |request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| | |ssl\_cert\_file|\-|`string`| |Public SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_file|\-|`string`| |Private SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_password|\-|`string`| |Password for SSL Key file.<br><br>Used only by HTTP agent items.| | |status\_codes|\-|`string`| |Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| | |timeout|\-|`string`| |Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Used only by HTTP agent items.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters| |\-| | |Root element for user-defined parameters.<br><br>Used only by Script items.| | |name|x|`string`| |Parameter name.<br><br>Used only by Script items.| | |value|\-|`string`| |Parameter value.<br><br>Used only by Script items.| |value map| |\-| | |Value map.| | |name|x|`string`| |Name of the value map to use for the item.| |preprocessing| |\-| | |Root element for item value preprocessing.| |step| |\-| | |Individual item value preprocessing step.| | |type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| | |parameters|\-| | |Root element for parameters of the item value preprocessing step.| | |parameter|x|`string`| |Individual parameter of the item value preprocessing step.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| | |error\_handler\_params|\-|`string`| |Error handler parameters used with 'error\_handler'.| |master\_item| |\-| | |Individual item master item.<br><br>Required by dependent items.| | |key|x|`string`| |Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers| |\-| | |Root element for simple triggers.| | |*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Root element for item tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| ##### Etiquetes d'element d'equip |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |items| |\-| | |Element arrel dels elements.| | |name|x|`cadena`| |Nom de l'element.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (per defecte)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERN<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERN <br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULAT<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT <br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Tipus d'element.| | |snmp\_oid|\-|`cadena`| |ID d'objecte SNMP.<br><br>Requerit pels elements SNMP.| | |key|x|`cadena`| |Clau d'element.| | |delay|\-|`cadena`|Per defecte: 1m|Interval d'actualització de l'element.<br><br>Tingueu en compte que el `retard` sempre serà '0' per als elements trapper.<br> <br>Accepta segons o unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com a programació.<br> Diversos intervals es separen per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten múltiples macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).| | |history|\-|`string`|Per defecte: 90d|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'historial. Unitat de temps amb sufix, macro d'usuari o macro LLD.| | |trends|\-|`string`|Per defecte: 365d|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendència. Unitat de temps amb sufix, macro d'usuari o macro LLD.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'element.| | |value\_type|\-|`cadena`|0 - FLOAT<br>1 - CHAR<br>2 - REGISTR<br>3 - SIN signa (per defecte)<br>4 - TEXT|Tipus de valor rebut.| | |allowed\_hosts|\-|`cadena`| |Llista d'adreces IP (separades per comes) dels equips amb permís per enviar dades de l'element.<br><br>Emprat pels elements de trapper i d'agent HTTP.| | |units|\-|`cadena`| |Unitats de valors retornats (bps, B, etc).| | |params|\-|`text`| |Paràmetres addicionals segons el tipus d'element:<br>- script executat per a elements Script, SSH i Telnet;<br>- Consulta SQL per a elements del monitor de base de dades;<br>- fórmula per als elements calculats.| | |ipmi\_sensor|\-|`cadena`| |Sensor IPMI.<br><br>Ús només per elements IPMI.| | |authtype|\-|`string`|Tipus d'autenticació per als elements de l'agent SSH:<br>0 - MOT DE PAS (per defecte)<br>1 - PUBLIC\_KEY<br><br>Tipus d'autenticació per als elements de l'agent HTTP:<br> 0 - CAP (per defecte)<br>1 - BÀSICA<br>2 - NTLM|Tipus d'autenticació.<br><br>Només l'empren els elements de l'agent SSH i HTTP.| | |username|\-|`cadena`| |Nom d'usuari per a l'autenticació.<br>Emprat per elements d'agent de simple comprovació, SSH, Telnet, Database Monitor, JMX i HTTP.<br><br>Requerit per elements SSH i Telnet. <br>Quan l'empra l'agent JMX, el mot de pas també s'ha d'especificar amb el nom d'usuari o les dues propietats s'han de deixar en blanc.| | |password|\-|`cadena`| |Mot de pas per a l'autenticació.<br>S'empra per comprovació simple, SSH, Telnet, monitor de base de dades, elements de l'agent JMX i HTTP.<br><br>Quan l'empra l'agent JMX, el nom d'usuari també s'ha d'especificar amb el mot de pas o ambdues propietats s'han de deixar en blanc.| | |publickey|\-|`cadena`| |Nom del fitxer de clau pública.<br><br>Requerit per als elements de l'agent SSH.| | |privatekey|\-|`cadena`| |Nom del fitxer de clau privada.<br><br>Requerit per als elements de l'agent SSH.| | |description|\-|`text`| |Descripció de l'element.| | |inventory\_link|\-|`string`|0 - CAP<br><br>El nom del camp d'inventari de l'equip en majúscula. Per exemple:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Camp d'inventari de l'equip ocupat per element.<br><br>Informe: aneu a la [pàgina de l'inventari d'equip](/manual/api/reference/host/object#host_inventory) per obtindre una llista de camps d'inventari d'equip admesos i els seus ID. | | |logtimefmt|\-|`cadena`| |Format d'hora a les entrades de registre.<br>Ús només pels elements de registre.| | |interface\_ref|\-|`cadena`|Format: `if<N>`|Referència a la interfície de l'equip.| | |jmx\_endpoint|\-|`cadena`| |Punt final JMX.<br><br>Només l'empren els elements de l'agent JMX.| | |url|\-|`cadena`| |Cadena d'URL.<br><br>Només cal per als elements de l'agent HTTP.| | |allow\_traps|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Permet que el valor s'ompli com en un element de trapper.<br><br>Emprat només amb elements de l'agent HTTP.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - SÍ (per defecte)|Seguiu les redireccions de resposta HTTP quan s'afegeixin dades.<br><br>Només s'empren els elements de l'agent HTTP.| |headers| |\-| | |L'element arrel per a les capçaleres de peticions HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br>Només l'empren els elements de capçalera d'Agent HTTP.| | |name|x|`cadena`| |Nom de la capçalera.| | |value|x|`cadena`| |Valor de la capçalera.| | |http\_proxy|\-|`cadena`| |Cadena de connexió del proxy HTTP(S).<br><br>Només s'empren els elements de l'agent HTTP.| | |output\_format|\-|`string`|0 - RAW (predeterminat)<br>1 - JSON|Com processar la resposta.<br><br>Ús només pels elements de l'agent HTTP.| | |post\_type|\-|`string`|0 - RAW (predeterminat)<br>2 - JSON<br>3 - XML|Tipus de cos de dades de publicació.<br><br>Només s'empren els elements de l'agent HTTP.| | |posts|\-|`cadena`| |Dades del cos de la petició HTTP(S).<br><br>Només s'empren els elements de l'agent HTTP.| |query\_fields| |\-| | |Element arrel per als paràmetres de consulta.<br><br>Només l'empren els elements de l'agent HTTP.| | |name|x|`cadena`| |Nom del paràmetre.| | |value|\-|`cadena`| |Valor del paràmetre.| | |request\_method|\-|`string`|0 - GET (per defecte)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Mètode de petició.<br><br>Ús només per elements d'agent HTTP.| | |retrieve\_mode|\-|`string`|0 - COS (per defecte)<br>1 - CAPÇALERA<br>2 - AMBDÓS|Quina part de la resposta s'ha d'emmagatzemar.<br><br>Ús només per elements de l'agent HTTP.| | |ssl\_cert\_file|\-|`cadena`| |Camí al fitxer de clau SSL pública.<br><br>Només l'empren els elements de l'agent HTTP.| | |ssl\_key\_file|\-|`cadena`| |Camí al fitxer de clau SSL privada.<br><br>Només l'empren els elements de l'agent HTTP.| | |ssl\_key\_password|\-|`cadena`| |Mot de pas per al fitxer de clau SSL.<br><br>Només l'empren els elements de l'agent HTTP.| | |status\_codes|\-|`cadena`| |Intervals de codis d'estat HTTP obligatoris separats per comes. Admet macros d'usuari.<br>Exemple: 200.200-{\$M},{\$M},200-400<br><br>Només l'empren els elements de l'agent HTTP.| | |timeout|\-|`cadena`| |Temps d'espera de la petició de consulta de dades d'element. Admet macros d'usuari.<br><br>Emprat per l'agent HTTP i els elements d'script.| | |verify\_host|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Valida si el nom d'equip de la connexió coincideix amb el nom del certificat d'equip.<br><br>Ús només pels elements de l'agent HTTP.| | |verify\_peer|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Valida si el certificat de l'equip és autèntic.<br><br>Només l'empra l'agent HTTP dels iguals.| |parameters| |\-| | |Element arrel per als paràmetres definits per l'usuari.<br><br>Només l'empren els elements de l'script.| | |name|x|`cadena`| |Nom del paràmetre.<br><br>Només l'empren els elements de l'script.| | |value|\-|`cadena`| |Valor del paràmetre.<br><br>Només l'empren els elements de l'script.| |value map| |\-| | |Coincidència de valors.| | |name|x|`cadena`| |Nom del mapa de valors que s'emprarà per a l'element.| |preprocessing| |\-| | |Element arrel per al preprocessament del valor de l'element.| |step| |\-| | |Passa de preprocessament del valor d'element individual.| | |type|x|`string`|1 - MULTIPLICADOR<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculat com a (valor rebut-valor anterior))<br>10 - CHANGE\_PER\_SECOND (calculat com a (valor valor rebut-anterior)/(hora actual-hora de darrera comprovació))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DESCART\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Tipus de passa de preprocessament del valor de l'element.| | |parameters|\-| | |Element arrel per als paràmetres de la passa de preprocessament del valor de l'element.| | |parameter|x|`cadena`| |Paràmetre individual de la passa de preprocessament del valor de l'element.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (per defecte)<br>1 - DESCART\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Tipus d'acció a emprendre si la passa de preprocessament falla.| | |error\_handler\_params|\-|`cadena`| |Paràmetres del gestor d'errors emprats amb 'error\_handler'.| |master\_item| |\-| | |Element individual de l'element principal.<br><br>Requerit pels elements dependents.| | |key|x|`cadena`| |Valor clau de l'element principal de l'element dependent.<br><br>Es permet la recursió fins a 3 elements dependents i un nombre màxim d'elements dependents igual a 29.999.| |triggers| |\-| | |Element arrel per a triggers simples.| | |*Per als valors de l'etiqueta de trigger, veieu [etiquetes de trigger d'equips](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Element arrel per a les etiquetes d'elements.| | |tag|x|`cadena`| |Nom de l'etiqueta.| | |value|\-|`cadena`| |Valor de l'etiqueta.| ##### Host low-level discovery rule tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |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.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.| ##### Etiquetes de regla de descoberta de baix nivell |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Element arrel per a regles de descoberta de baix nivell.| | |*Per a la majoria dels valors de l'etiqueta d'element, consulteu els valors de l'etiqueta d'element per a un element estàndard. A continuació només es descriuen les etiquetes específiques de les regles de descoberta de baix nivell.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (per defecte)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERN<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERN <br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Tipus d'element.| | |lifetime|\-|`string`|Per defecte: 30d|Període després del qual s'esborraran els elements que no es trobn. Segons, unitat de temps amb sufix o macro d'usuari.| |filter| | | | |Filtre individual.| | |evaltype|\-|`string`|0 - I\_O (per defecte)<br>1 - I<br>2 - O<br>3 - FORMULA|Lògica que s'empra per comprovar les condicions de filtre de les regles de descoberta de baix nivell.| | |formula|\-|`cadena`| |Fórmula de càlcul personalitzada per a condicions de filtre.| |conditions| |\-| | |Element arrel per a condicions de filtre.| | |macro|x|`cadena`| |Nom de la macro de descoberta de baix nivell.| | |value|\-|`cadena`| |Valor del filtre: expressió regular o expressió regular global.| | |operator|\-|`string`|8 - MATCHES\_REGEX (per defecte)<br>9 - NOT\_MATCHES\_REGEX|Operador de condició.| | |formulaid|x|`caràcter`| |ID únic arbitrari emprat per fer referència a una condició de l'expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho demani més endavant.| |lld\_macro\_paths| |\-| | |Element arrel per a camins de macro LLD.| | |lld\_macro|x|`cadena`| |Nom de la macro de descoberta de baix nivell.| | |path|x|`cadena`| |Selector de valors que s'assignarà a la macro corresponent.| |preprocessing| |\-| | |Preprocessament del valor de la regla LLD.| |step| |\-| | |Passa de preprocessament del valor de la regla LLD individual.| | |*Per a la majoria dels valors de l'etiqueta d'element, consulteu Valors de l'etiqueta d'element per al preprocessament del valor de l'element equip. Tot seguit es descriuen les etiquetes específiques per al preprocessament de valors de descoberta de baix nivell.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Tipus de passa de preprocessament del valor de l'element.| |trigger\_prototypes| |\-| | |Element arrel per a prototips de triggers.| | |*Per als valors de l'etiqueta d'element del prototip de trigger, consulteu les etiquetes habituals [trigger d'equip](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |graph\_prototypes| |\-| | |Element arrel per a prototips de gràfics.| | |*Per als valors de l'etiqueta d'elements de gràfic prototip, veieu les etiquetes de [gràfics d'equip](/manual/xml_export_import/hosts#host_graph_tags).*| | | | | |host\_prototypes| |\-| | |Element arrel per a prototips d'equips.| | |*Per als valors de l'etiqueta d'element del prototip d'amfitrió, vegeu les etiquetes habituals [host](/manual/xml_export_import/hosts#host_tags).*| | | | | |item\_prototypes| |\-| | |Element arrel per a prototips d'elements.| | |*Per als valors de l'etiqueta d'element del prototip d'element, consulteu les etiquetes [element d'equip](/manual/xml_export_import/hosts#host_item_tags).*| | | | | |master\_item| |\-| | |Prototip d'element individual Element mestre/Dades de prototip d'element.| | |key|x|`cadena`| |Valor clau de l'element principal del prototip d'element dependent/prototip d'element.<br><br>Requerit per a un element dependent.| ### 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|string|*(readonly)* ID of the host macro.| |**hostid**<br>(required)|string|ID of the host that the macro belongs to.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |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.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Macro d'equip L'objecte defineix una macro disponible a un equip, prototip d'equip o plantilla. Té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostmacroid|string|*(només lectura)* ID de la macro d'equip.| |**hostid**<br>(obligatori)|string|ID de l'equip a qui pertany la macro.| |**macro**<br>(obligatori)|string|Cadena de la macro.| |**valor**<br>(obligatori)|string|Valor de la macro.| |type|integer|Tipus de la macro.<br><br>Valors possibles:<br>0 - *(per defecte)* Text de la macro;<br>1 - Macro secreta;<br>2 - Secret de caixa de cabals.| |description|string|Descripció de la macro.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. 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/frontend_sections/monitoring/dashboard#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.  Els marcadors d'equips que es mostren al mapa tenen el color del problema més greu de l'equip i el color verd si un equip no té cap problema. Si feu clic a un marcador d'equip, es mostra el nom visible de l'equip i el nombre de problemes no resolts agrupats per gravetat. Si feu clic al nom visible, s'obrirà el [menú de l'equip](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu). Els equips que es mostren al mapa es poden filtrar per la gravetat del problema. Toqueu la icona de filtre a l'extrem superior dret del giny i marqueu la gravetat que considereu.  # host.massadd # host.massadd # host.massremove # host.massremove # host.massupdate # host.massupdate #### Host menu Clicking on a host in the *Problems* widget brings up the host menu. It includes links to host inventory, latest data, problems, graphs, dashboards, web scenarios and configuration. Note that host configuration is available for Admin and Superadmin users only.  [Global scripts](/manual/web_interface/frontend_sections/administration/scripts) can also be run from the host menu. These scripts need to have their scope defined as 'Manual host action' to be available in the host menu. The host menu is accessible by clicking on a host in several other frontend sections: - Monitoring → [Problems](problems) - Monitoring → [Problems](problems) → Event details - Monitoring → [Hosts](hosts) - Monitoring → Hosts → [Web Monitoring](/manual/web_interface/frontend_sections/monitoring/hosts/web) - Monitoring → [Latest data](latest_data) - Monitoring → [Maps](maps) - Reports → [Triggers top 100](/manual/web_interface/frontend_sections/reports/triggers_top) #### Menú equips Si feu clic a un equip al giny *Problemes*, s'obre el menú d'equips. Inclou enllaços a l'inventari d'allotjament, dades més recents, problemes, gràfics, taulers, escenaris web i configuració. Tingueu en compte que la configuració de l'equip només és disponible per als usuaris administradors i superadministradors.  També es poden executar [Guions globals](/manual/web_interface/frontend_sections/administration/scripts) des del menú de l'equip. Aquests scripts han de tindre el seu abast definit a "Acció manual de l'equip" perquè estiguin disponibles al menú de l'equip. Es pot accedir al menú de l'equip fent clic a un equip en diverses altres seccions de la interfície: - Monitoratge → [Problemes](problems) - Monitoratge → [Problemes](problems) → Detalls de l'esdeveniment - Monitoratge → [Equips](hosts) - Monitoratge → Equips → [Web](/manual/web_interface/frontend_sections/monitoring/hosts/web) - Monitoratge → [Darreres dades](latest_data) - Monitoratge → [Mapes](maps) - Informes → [Els 100 triggers principals](/manual/web_interface/frontend_sections/reports/triggers_top) ##### 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* parameter determines the type of the name the item should return. Supported values: - *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* (supported since Zabbix 5.4.7) - returns part of the hostname before the first dot. It will return a full string if the name does not contain a dot. *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values: - *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, two different approaches could 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> 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. ##### Paràmetre Hostname Per fer [verificacions actives](/manual/appendix/items/activepassive#active_checks) d'un equip, l'agent Zabbix ha de definir el nom de l'equip. A més, el valor del nom d'equip definit ha de ser el mateix que el "[Nom d'equip](/manual/config/hosts/host)" configurar per l'equip a la interfície. El valor del nom d'equip de la banda de l'agent es pot definir amb el paràmetre **Hostname** o **HostnameItem**, a l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) de l'agent - o els valors per defecte s'empren si cap paràmetre és especificat. El valor per defecte del paràmetre **HostnameItem** és el valor reenviat per la clau de l'agent "system.hostname". Per Windows, reenvia el resultat de la funció gethostname(), qui demana els proveïdors d'espais de noms per determinar el nom d'equip local. si cap proveïdor de noms respon, enviarà el nom NetBIOS. El valor per defecte de **Hostname** és el valor reenviat per el paràmetre **HostnameItem**. Per tant, si aquests dos paràmetres no són pas especificats, el nom d'equip real serà el nom NetBIOS de l'equip; i l'agent Zabbix emprarà el nom d'equip NetBIOS per recuperar la llista de verificacions actives del servidor Zabbix i enviar-li els resultats. La clau "system.hostname" suporta dos paràmtres opcionals - *type* i *transform*. El paràmetre *Type* determina el tipus de nom que l'element ha d'enviar. Valors admesos: - *netbios* (per defecte) - retorna el nom d'equip NetBIOS, limitat a 15 símbols i només en MAJÚSCULES; - *host* - sensible a majúscules i minúscules, retorna el nom real d'equip Windows sencer (sense domini); - *shorthost* (suportat des de Zabbix 5.4.7) - retorna una part del nom d'equip abans del primer punt. Retornarà una cadena sencera si el nom no té cap punt. El paràmetre *transform* es suporta des de Zabbix 5.4.7 i permet especificar una regla de transformació addicional per al nom d'equip. Valors admesos: - *none* (per defecte) - empra el text original, em majúscules o minúscules; - *lower* - converteix el text a minúscules. Per tant, per simplificar la configuració de l'arxiu zabbix\_agentd.conf i unificar, es poden emprar dues maneres diferents. 1. deixar els paràmetres **Hostname** o **HostnameItem** sense definir i l'agent Zabbix emprarà el nom d'equip NetBIOS com a nom d'equip; 2. deixar el paràmetre **Hostname** sense definir i definir **HostnameItem** així:<br> **HostnameItem=system.hostname\[host\]** - perquè l'agent Zabbix empri el nom d'equip Windows sencer i real (sensible a majúscules i minúscules) com a nom d'equip<br> **HostnameItem=system.hostname\[shorthost,lower\]** - perquè l'agent Zabbix només empri una part del nom d'equip abans del primer punt, convertit a minúscules. El nom d'equip s'empra igualment al quadre del nom de servei Windows que s'empra per instal·lar, aturar, engegar i desinstal·lar el servei Windows. Per exemple, si l'arxiu de configuració de l'agent Zabbix especifica `Hostname=Windows_db_server`, llavors l'agent s'instal·larà com a servei Windows "`Zabbix Agent [Windows_db_server]`". Per tant, per tindre un nom de servei Windows diferent per cada instància d'agent Zabbix, cada instància ha d'emprar un nom d'equip diferent. ##### 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, a new host is not created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host. ##### Nomenament de l'equip Quan s'afegeixen equips, un nom d'equip és el resultat d'una cerca DNS inversa o una adreça IP si la cerca inversa falla. La cerca es realitza des del servidor Zabbix o des del proxy Zabbix, depenent de quina és fent la descoberta. Si la cerca falla al proxy, no es torna a provar al servidor. Si l'equip amb aquest nom ja existeix, el següent equip tindrà **_2** afegit al nom, després **_3** i així successivament. També és possible anul·lar la cerca DNS/IP i emprar un valor d'element per al nom d'equip, per exemple: - Podeu descobrir diversos servidors amb l'agent Zabbix en execució mitjançant un element d'agent Zabbix per a la descoberta i assignar-los automàticament noms propis, en funció del valor de cadena que retorna aquest element - Podeu descobrir diversos dispositius de xarxa SNMP mitjançant un element d'agent SNMP per a la descoberta i assignar-los automàticament noms propis, en funció del valor de cadena que retorna aquest element Si el nom d'equip es va establir amb un valor d'element, no s'actualitzarà en comprovacions de descoberta posteriors. Si no és possible establir el nom d'equip mitjançant un valor d'element, s'empra el valor per defecte (nom DNS). Si ja existeix un equip amb l'adreça IP descoberta, no s'en crea cap de nou. Tanmateix, si l'acció de descoberta conté operacions (enllaç a una plantilla, afegir a un grup d'equip, etc.), es realitzen a l'equip existent. # Host object The following objects are directly related to the host API. # Objecte equip Els següents objectes són relacionats amb l'API d'equip. #### hostprototype Changes:<br> [ZBX-23284](https://support.zabbix.com/browse/ZBX-23284) `hostprototype.get`, `hostprototype.update`: returned support for `group_prototypeid` property of Group prototype objects. #### hostprototype Canvis:<br> [ZBX-23284](https://support.zabbix.com/browse/ZBX-23284) `hostprototype.get`, `hostprototype.update`: ha retornat el suport per a la propietat `group_prototypeid` dels objectes del prototip del grup. #### host prototype Changes:<br> [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: dropped support of properties `group_prototypeid`, `hostid`, `templateid` of group link and group prototype API objects.<br> [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: dropped the ability to modify the readonly fields `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` of inherited host prototypes.<br> [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: added strict validation of the method parameters. #### Prototipus d'equip Canvis :<br> [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: es deixa de suportar les propietats `group_prototypeid`, `hostid`, `templateid` dels objetes API dels enllaços i prototips de grups.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: es treu la possibilitat de modificar els camps de només lectura `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` dels prototipus d'equips heretats.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: afegida una validació estricta dels paràmetres del mètode. #### hostprototype Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated. #### prototip d'equips Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: el paràmetre `uuid` ara es pot actualitzar. # 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. # Objecte prototip d'equips Els següents objectes són relacionats amb l'API `hostprototype`. #### Host prototypes Host prototypes can be created with the low-level discovery rule. When virtual machines are discovered, these prototypes are the basis for generating real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates. {width="600"} In order for hosts created from a prototype to have unique host names, the *Host name* field must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros). Since Zabbix 5.2, discovered hosts may be configured with custom interfaces or inherit the IP of a host the discovery rule belongs to (default). To add one or more custom interface, switch the *Interface* selector from *Inherit* to *Custom* mode, then press  and select the required interface type from the drop-down menu that appears. All supported types of interfaces can be defined for a host prototype: Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros). If several custom interfaces are specified - use the *Default* column to specify the primary interface. Notes: - If *Custom* is selected, but no interfaces have been specified the hosts will be created without interfaces. - If *Inherit* is selected for a host prototype that belongs to a template, discovered hosts will inherit the interface of a host to which the template is linked to. ::: notewarning A host will not be created, if the host interface contains incorrect data :::  LLD macros can also be used for the visible name, host group prototype fields, tag values, or values of host prototype user macros. Other options that can be specified for a host prototype are: - Linkage to existing host groups - Template linkage - Encryption If *Create enabled* is checked, the host will be added in an enabled state. If unchecked, the host will be added, but in a disabled state. If *Discover* is checked (default), the host will be created. If unchecked, the host will not be created, unless this setting is overridden in the [discovery rule](/manual/discovery/low_level_discovery#override). This functionality provides additional flexibility when creating discovery rules. Discovered hosts are prefixed with the name of the discovery rule that created them, in the host list. Discovered hosts can be manually deleted. Discovered hosts will also be automatically deleted, based on the *Keep lost resources period (in days)* value of the discovery rule. Most of the configuration options are read-only, except for enabling/disabling the host and host inventory. ::: noteclassic Zabbix does not support nested host prototypes, i.e. host prototypes are not supported on hosts that are discovered by low-level discovery rule. ::: #### Prototips d'equips Els prototips d'equips es poden crear amb la regla de descoberta de baix nivell. Quan es descobreixen màquines virtuals, aquests prototips es converteixen en equips reals. Els prototips, abans de ser trobats, no poden tindre els seus propis elements i triggers, excepte els de les plantilles enllaçades. Els equips trobats pertanyeran a un equip existent. {width="600"} Perquè els equips creats a partir d'un prototip tinguin noms d'equip únics, el camp *Nom d'equip* ha de contindre almenys una [macro de descoberta de baix nivell](/manual/config/macros/lld_macros). Des de Zabbix 5.2, els equips descoberts es poden configurar amb interfícies personalitzades o heretar la IP d'un equip al qual pertany la regla de descoberta (per defecte). Per afegir una o més interfícies personalitzades, canvieu el selector *Interfície* del mode *Heretar* al mode *Personalitzat* i, a continuació, premeu  i trieu el tipus d'interfície requerit al menú desplegable que apareix. Tots els tipus d'interfícies compatibles es poden definir per a un prototip d'equip: agent Zabbix, SNMP, JMX, IPMI. Els camps de la interfície admeten macros de descoberta de baix nivell i [macros d'usuari](/manual/config/macros/user_macros). Si s'especifiquen diverses interfícies personalitzades, empreu la columna *Predeterminada* per especificar la interfície principal. Notes: - Si es tria *Personalitzar*, però no s'ha especificat cap interfície, els equips es crearan sense interfícies. - Si es tria *Heretar* per a un prototip d'equip que pertany a una plantilla, els equips descoberts heretaran la interfície d'un equip al qual la plantilla és enllaçada. ::: notewarning No es crearà cap equip si la interfície de l'equip conté dades incorrectes :::  Les macros LLD també es poden emprar per al nom visible, els camps del prototip del grup d'equip, els valors de l'etiqueta o els valors de les macros d'usuari del prototip de l'equip. Altres opcions que es poden especificar per a un prototip d'equip són: - Enllaç amb grups d'acollida existents - Enllaç de plantilles - Xifrat Si s'ha marcat *Crear activat*, l'equip s'afegirà en estat habilitat. Si no és marcat, s'afegirà l'equip, però en un estat desactivat. Si és marcat *Descoberta* (per defecte), es crearà l'equip. Si no és marcat, l'equip no es crearà, tret que aquesta configuració es substitueixi a la [regla de descoberta](/manual/discovery/low_level_discovery#override). Aquesta funcionalitat proporciona flexibilitat addicional a l'hora de crear regles de descoberta. Els equips descoberts tenen com a prefix el nom de la regla de descoberta que els ha creat, a la llista d'equips. Els equips descoberts es poden esborrar manualment. Els equips descoberts també s'esborraran automàticament, en funció del valor de la regla de descoberta *Conservar el període de recursos perduts (en dies)*. La majoria de les opcions de configuració són de només lectura, tret d'activar/desactivar l'inventari de l'equip i l'equip. ::: noteclassic Zabbix no admet prototips d'equip heretats, és a dir, els prototips d'equip no s'admeten als equips que es troben per regla de descoberta de baix nivell. ::: ### Host prototype tag The host prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.| ### Etiqueta de prototip d'equips L'objecte d'etiqueta de prototip d'equips té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta de prototip d'equips.| |value|string|Valor de l'etiqueta de prototip d'equips.| ### Host prototype The host prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |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 interfaces 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.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Prototipus d'equip L'objecte prototip d'equip té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|*(només lectura)* ID del prototip d'equips.| |**host**<br>(obligatori)|cadena|Nom tècnic del prototip d'equips.| |name|string|Nom visible del prototip d'equips.<br><br>Per defecte: valor de la propietat `host`.| |status|integer|Estat del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* equip supervisat;<br>1 - equip no supervisat.| |inventory\_mode|integer|Mode d'omplerta d'inventari de l'equip.<br><br>Els valors possibles són:<br>-1 - *(per defecte)* desactivat;<br>0 - manual ;<br>1 - automàtic .| |templateid|string|*(només lectura)* ID de la plantilla principal del prototip d'equips.| |discover|integer|Estat de descobriment del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran nous equips;<br>1 - no es descobriran els nous equips i els existents es marcaran com a perduts.| |custom\_interfaces|integer|Font de les interfícies dels equips creats per el prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* hereta les interfícies de l'equip principal; <br>1 - empra personalitzat interfícies de prototips d'equips.| |uuid|string|Identificador universal únic, que s'empra per enllaçar els prototips d'equips importats amb els existents. S'empra només per a prototips d'equips en models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Host prototype This class is designed to work with host prototypes. Object references: - [Host prototype](/manual/api/reference/hostprototype/object#host_prototype) - [Host prototype inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) - [Group link](/manual/api/reference/hostprototype/object#group_link) - [Group prototype](/manual/api/reference/hostprototype/object#group_prototype) Available methods: - [hostprototype.create](/manual/api/reference/hostprototype/create) - creating new host prototypes - [hostprototype.delete](/manual/api/reference/hostprototype/delete) - deleting host prototypes - [hostprototype.get](/manual/api/reference/hostprototype/get) - retrieving host prototypes - [hostprototype.update](/manual/api/reference/hostprototype/update) - updating host prototypes # Prototipus d'equip Aquesta classe és dissenyada per treballar amb prototipus d'equips. Referències d'objectes: - [Prototipus d'equip](/manual/api/reference/hostprototype/object#host_prototype) - [Inventari de prototipus d'equip](/manual/api/reference/hostprototype/object#host_prototype_inventory) - [Enllaç de grup](/manual/api/reference/hostprototype/object#group_link) - [Prototipus de grup](/manual/api/reference/hostprototype/object#group_prototype) Mètodes disponibles: - [hostprototype.create](/manual/api/reference/hostprototype/create) - crear nou prototipus d'equip - [hostprototype.delete](/manual/api/reference/hostprototype/delete) - esborrar prototipus d'equip - [hostprototype.get](/manual/api/reference/hostprototype/get) -recuperar prototipus d'equip - [hostprototype.update](/manual/api/reference/hostprototype/update) - actualitzar prototipus d'equip # hostprototype.update # hostprototype.update ##### 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. ##### Esborrar un equip Els equips trobats per una regla de descoberta de xarxa s'esborren automàticament de *Monitoratge* → *Descoberta* si una entitat descoberta no es troba pas al rang IP de la regla. Els equips s'esborren de seguida. #### 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) #### Equips i grup d'equips Gestionar els grups d'equips, els equips i tot el que hi ha relacionat, fins i tot les interfícies i les macros d'equips i els períodes de manteniment. [API Equip](/manual/api/reference/host) | [API Grup d'equips](/manual/api/reference/hostgroup) | [API Interfície d'equip](/manual/api/reference/hostinterface) | [API Macro d'usuari](/manual/api/reference/usermacro) | [API Mapa de valors](/manual/api/reference/valuemap) | [API Manteniment](/manual/api/reference/maintenance) #### Hosts/host prototypes In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) 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| #### Equips/prototips d'equips A la configuració d'[equip](/manual/config/hosts/host) i de [prototip d'equip](/manual/vm_monitoring#host_prototypes), les macros d'usuari es poden emprar en aquest camps: |Ubicació|<|Múltiples macros/barreja de text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interfície IP/DNS|<|només DNS| |Port d'Interfície|<|no| |*SNMP v1, v2*|<|<| | |Comunitat SNMP|sí| |*SNMP v3*|<|<| | |Nom del context|sí| |^|Nom de seguretat|sí| |^|Frase secreta d'autenticació|sí| |^|Frase secreta de confidencialitat|sí| |*IPMI*|<|<| | |Nom d'usuari|sí| |^|Paraula de pas|sí| |*Etiquetes*^[2](supported_by_location_user#footnotes)^|<|<| | |Noms d'etiqueta|sí| |^|Valors d'etiqueta|sí| ##### Host tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |groups| |x| | |Root element for host groups.| | |name|x|`string`| |Host group name.| |hosts| |\-| | |Root element for hosts.| | |host|x|`string`| |Unique host name.| | |name|\-|`string`| |Visible host name.| | |description|\-|`text`| |Host description.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| | |ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| | |ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| | |ipmi\_username|\-|`string`| |Username for IPMI checks.| | |ipmi\_password|\-|`string`| |Password for IPMI checks.| |proxy| |\-| | |Proxy.| | |name|x|`string`| |Name of the proxy (if any) that monitors the host.| |templates| |\-| | |Root element for linked templates.| | |name|x|`string`| |Template name.| |interfaces| |\-| | |Root element for host interfaces.| | |default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| | |type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| | |useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| | |ip|\-|`string`| |IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| | |dns|\-|`string`| |DNS name.<br><br>Required if the connection is made via DNS.| | |port|\-|`string`| |Port number. Supports user macros.| | |interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details| |\-| | |Root element for interface details.| | |version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| | |community|\-|`string`| |SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| | |contextname|\-|`string`| |SNMPv3 context name.<br><br>Used only by SNMPv3 items.| | |securityname|\-|`string`| |SNMPv3 security name.<br><br>Used only by SNMPv3 items.| | |securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| | |authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| | |authpassphrase|\-|`string`| |SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| | |privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| | |privpassphrase|\-|`string`| |SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| | |bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items| |\-| | |Root element for items.| | |*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |tags| |\-| | |Root element for host tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| |macros| |\-| | |Root element for macros.| | |macro|x| | |User macro name.| | |type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| | |value|\-|`string`| |User macro value.| | |description|\-|`string`| |User macro description.| |inventory| |\-| | |Root element for host inventory.| | |<inventory\_property>|\-| | |Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode| |\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps| |\-| | |Root element for host value maps.| | |name|x|`string`| |Value map name.| | |mapping|\-| | |Root element for mappings.| | |value|x|`string`| |Value of a mapping.| | |newvalue|x|`string`| |New value of a mapping.| ##### Etiquetes d'equips |Element|Propietat de l'element|Obligatori|Tipus|Interval^**[1](#footnote)**^|Descripció| |-------|-----------------|---------|-----|---------- ----------------|------------| |groups|<|x|<|<|Element arrel per a grups d'equips.| |<|name|x|`cadena`|<|Nom del grup d'equips.| |hosts|<|\-|<|<|Element arrel per a equips.| |<|host|x|`string`|<|Nom d'equip distingit. |<|name|\-|`cadena`|<|Nom visible d'equip.| |<|description|\-|`text`|<|Descripció de l'equip.| |<|status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'equip.| |<|ipmi\_authtype|\-|`cadena`|-1 - PER DEFECTE (predeterminat)<br>0 - CAP<br>1 - MD2<br>2 - MD5<br>4 - DRET<br>5 - OEM<br>6 - RMCP\_PLUS|Tipus d'autenticació de sessió IPMI.| |<|ipmi\_privilege|\-|`string`|1 - RECORDATORI<br>2 - USUARI (per defecte)<br>3 - OPERADOR<br>4 - ADMINISTRADOR<br>5 - OEM|Nivell de privilegi de la sessió IPMI .| |<|ipmi\_username|\-|`string`|<|Nom d'usuari per a comprovacions IPMI.| |<|ipmi\_password|\-|`string`|<|Mot de pas per a comprovacions IPMI.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Nom del proxy (si n'hi ha) que monitora l'equip.| |templates|<|\-|<|<|Element arrel per a plantilles enllaçades.| |<|name|x|`cadena`|<|Nom de la plantilla.| |interfaces|<|\-|<|<|Element arrel per a les interfícies d'equip. |<|per defecte|\-|`cadena`|0 - NO<br>1 - SÍ (predeterminat)|Si aquesta és la interfície principal de l'equip.<br>Només pot haver-hi una única interfície principal d'un tipus en un equip.| |<|type|\-|`cadena`|1 - ZABBIX (per defecte)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|tipus d'interfície.| |<|useip|\-|`string`|0 - NO<br>1 - sí (per defecte)|Empreu la IP com a interfície per connectar-vos a l'equip (en cas contrari s'emprarà DNS).| |<|ip|\-|`string`|<|adreça IP, pot ser IPv4 o IPv6.<br><br>Requerit si us connecteu mitjançant una adreça IP.| |<|dns|\-|`string`|<|Nom DNS.<br><br>Requerit si es connecta mitjançant DNS.| |<|port|\-|`cadena`|<|Nombre de port. Admet macros d'usuari.| |<|interfície\_ref|x|`cadena`|Format: `if<N>`|Nom de referència de la interfície a emprar als elements.| |details|<|\-|<|<|Element arrel per als detalls de la interfície.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (per defecte)<br>3 - SNMP\_V3|Emprar aquesta versió de SNMP.| |<|community|\-|`cadena`|<|Comunitat SNMP.<br><br>Requerit pels elements SNMPv1 i SNMPv2.| |<|contextname|\-|`cadena`|<|Nom de context SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|securityname|\-|`string`|<|Nom de seguretat SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (per defecte)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|Nivell de seguretat SNMPv3.<br><br>Només s'empra per a elements SNMPv3. | |<|authprotocol|\-|`string`|0 - MD5 (per defecte)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|Protocol d'autenticació SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|authpassphrase|\-|`cadena`|<|Frase de pas d'autenticació SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|privprotocol|\-|`string`|0 - DES (predeterminat)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 protocol de privadesa.<br><br>Només s'empra per a elements SNMPv3.| |<|privpassphrase|\-|`cadena`|<|Frase de pas de privadesa SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|bulk|\-|`string`|0 - NO<br>1 - SÍ (per defecte)|Empreu consultes massives per a SNMP.| |items|<|\-|<|<|Element arrel dels elements.| |<|*Per als valors de l'etiqueta d'element, veieu [etiquetes d'element d'equip](/manual/xml_export_import/hosts#host_item_tags).*|<|<|<|<| |tags|<|\-|<|<|Element arrel per a les etiquetes d'equip.| |<|tag|x|`cadena`|<|Nom de l'etiqueta.| |<|value|\-|`cadena`|<|Valor de l'etiqueta.| |macros|<|\-|<|<|Element arrel per a macros.| |<|macro|x|<|<|Nom de la macro d'usuari.| |<|type|\-|`cadena`|0 - TEXT (per defecte)<br>1 - SECRET\_TEXT<br>2 - VAULT|Tipus de macro.| |<|value|\-|`cadena`|<|Valor de la macro d'usuari.| |<|description|\-|`cadena`|<|Descripció de la macro de l'usuari.| |inventory|<|\-|<|<|Element arrel per a l'inventari de l'amfitrió.| |<|<inventory\_property>|\-|<|<|Propietat d'inventari individual.<br><br>Totes les propietats d'inventari disponibles es mostren sota les etiquetes respectives, p. <tipus>, <nom>, <SO> (veieu l'exemple anterior).| |mode\_inventory|<|\-|`cadena`|-1 - DESACTIVAT<br>0 - MANUAL (per defecte)<br>1 - AUTOMÀTIC|Mode d'inventari.| |valuemaps|<|\-|<|<|Element arrel per a l'assignació de valors de l'equip.| |<|name|x|`cadena`|<|El nom del valor coincideix.| |<|mapping|\-|<|<|Element arrel per al mapeig.| |<|valor|x|`cadena`|<|Concorda amb el valor.| |<|newvalue|x|`string`|<|Nou valor de coincidència.| ### Host tag The host tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.| ### Etiqueta d'equip L'objecte d'etiqueta d'equip té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta d'equip.| |value|string|Valor de l'etiqueta d'equip.| ### Host The host object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<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 are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<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|*(write-only)* 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)). Required if either `tls_connect` or `tls_accept` has PSK enabled.<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.| |tls\_psk|string|*(write-only)* Pre-shared key (PSK); must be at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Equip L'objecte equip té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|*(només lectura)* ID de l'equip.| |**host**<br>(obligatori)|string|Nom tècnic de l'equip.| |description|text|Descripció de l'equip.| |flags|integer|*(només lectura)* Origen de l'equip.<br><br>Valors possibles:<br>0 - un equip normal;<br>4 - un equip descobert.| |inventory\_mode|integer|Mode de població d'inventari de l'equip.<br><br>Valors possibles:<br>-1 - *(per defecte)* desactivat;<br>0 - manual;<br>1 - automàtic.| |ipmi\_authtype|integer|Algorisme d'autenticació IPMI.<br><br>Valors possibles:<br>-1 - *(per defecte)* per defecte;<br>0 - cap;<br>1 - MD2; <br> 2 - MD5<br>4 - recte;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|mot de pas IPMI.| |ipmi\_privilege|integer|Nivell de privilegis IPMI.<br><br>Valors possibles:<br>1 - devolució de trucada;<br>2 - *(per defecte)* usuari;<br>3 - operador;<br >4 - admin;<br>5 - OEM.| |ipmi\_username|string|Nom d'usuari IPMI.| |maintenance\_from|timestamp|*(només lectura)* Hora d'inici del manteniment efectiu.| |maintenance\_status|integer|*(només lectura)* Estat efectiu del manteniment.<br><br>Valors possibles:<br>0 - *(per defecte)* sense manteniment;<br>1 - manteniment efectiu. | |maintenance\_type|integer|*(només lectura)* Tipus de manteniment efectiu<br><br>Valors possibles:<br>0 - *(per defecte)* manteniment amb recollida de dades;<br>1 - manteniment sense recollida de dades. | |maintenanceid|string|*(només lectura)* ID del manteniment vigent actualment a l'equip.| |name|string|Nom de l'equip visible.<br><br>Per defecte: valor de la propietat `equip`.| |proxy\_hostid|string|ID de proxy emprat per supervisar l'equip.| |status|integer|Estat i funció de l'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* equip supervisat;<br>1 - equip no supervisat.| |tls\_connect|integer|Connexions a l'equip.<br><br>Valors possibles:<br>1 - *(per defecte)* Sense xifrat;<br>2 - PSK;<br>4 - certificat.| |tls\_accept|integer|Connexions de l'equip.<br><br>Els valors de mapa de bits possibles són:<br>1 - *(per defecte)* Sense xifratge;<br>2 - PSK;<br> 4 - certificat.<br><br>És un camp de màscara de bit; s'admet qualsevol suma de possibles valors de mapa de bits (per exemple, 6 per PSK i certificat).| |tls\_issuer|string|Emissor del certificat.| |tls\_subject|string|Assumpte del certificat.| |tls\_psk\_identity|string|*(només escriptura)* Identitat PSK; s'ha d'aparellar només amb un PSK (a través de [registre automàtic](/manual/api/reference/autoregistration/object), [equips](/manual/api/reference/host/object) i [proxys](/manual/api/reference/proxy/object)). Necessari si `tls_connect` o `tls_accept` tenen PSK habilitat.<br>No inclogueu informació sensible a la identitat PSK, ja que s'envia sense xifrar a través de la xarxa per informar al receptor quina PSK ha d'emprar.| |tls\_psk|string|*(només escriptura)*La clau prèviament compartida, com a mínim 32 dígits hexadecimals. Necessari si `tls_connect` o `tls_accept` tenen PSK habilitat.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # 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) Available methods: - [host.create](/manual/api/reference/host/create) - creating new hosts - [host.delete](/manual/api/reference/host/delete) - deleting hosts - [host.get](/manual/api/reference/host/get) - retrieving hosts - [host.massadd](/manual/api/reference/host/massadd) - adding related objects to hosts - [host.massremove](/manual/api/reference/host/massremove) - removing related objects from hosts - [host.massupdate](/manual/api/reference/host/massupdate) - replacing or removing related objects from hosts - [host.update](/manual/api/reference/host/update) - updating hosts # Equip Aquesta classe és pensada per treballar amb equips. Referències d'objectes: - [Equip](/manual/api/reference/host/object#host) - [Inventari d'equips](/manual/api/reference/host/object#host_inventory) Mètodes disponibles: - [host.create](/manual/api/reference/host/create) - crear un nou equip - [host.delete](/manual/api/reference/host/delete) - esborrar equips - [host.get](/manual/api/reference/host/get) - consultar equips - [host.massadd](/manual/api/reference/host/massadd) - afegir objectes als equips - [host.massremove](/manual/api/reference/host/massremove) - esborrar objectes dels equips - [host.massupdate](/manual/api/reference/host/massupdate) - reemplaçar o esborrar objectes dels equips - [host.update](/manual/api/reference/host/update) - actualitzar equips ##### Host trigger tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |triggers| |\-| | |Root element for triggers.| | |expression|x|`string`| |Trigger expression.| | |recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| | |recovery\_expression|\-|`string`| |Trigger recovery expression.| | |correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| | |correlation\_tag|\-|`string`| |The tag name to be used for event correlation.| | |name|x|`string`| |Trigger name.| | |event_name|\-|`string`| |Event name.| | |opdata|\-|`string`| |Operational data.| | |url|\-|`string`| |URL associated with the trigger.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| | |priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| | |description|\-|`text`| |Trigger description.| | |type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| | |manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies| |\-| | |Root element for dependencies.| | |name|x|`string`| |Dependency trigger name.| | |expression|x|`string`| |Dependency trigger expression.| | |recovery\_expression|\-|`string`| |Dependency trigger recovery expression.| |tags| |\-| | |Root element for event tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| ##### Etiquetes de trigger d'equip |Element|Propietat de l'element|Obligatori|Tipus|Range^**[1](#footnote)**^|Descripció| |-------|-----------------|---------|-----|---------- ----------------|------------| |triggers|<|\-|<|<|Element arrel dels triggers.| |<|expression|x|`cadena`|<|Expressió de trigger.| |<|recovery\_mode|\-|`string`|0 - EXPRESSIÓ (per defecte)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Base per generar esdeveniments OK| |<|recovery\_expression|\-|`string`|<|Activar l'expressió de recuperació.| |<|correlation\_mode|\-|`string`|0 - DESACTIVAT (predeterminat)<br>1 - TAG\_VALUE|Mode de correlació (sense correlació d'esdeveniments o correlació d'esdeveniments per etiqueta). | |<|correlation\_tag|\-|`string`|<|El nom de l'etiqueta que s'emprarà per a la correlació d'esdeveniments.| |<|nom|x|`cadena`|<|Nom del trigger.| | |event_name|\-|`cadena`| |Nom de l'esdeveniment.| | |opdata|\-|`cadena`| |Informació operacional.| |<|url|\-|`string`|<|URL associat amb el trigger.| |<|estat|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat del trigger.| |<|prioritat|\-|`string`|0 - NO\_CLASSIFICAT (predeterminat)<br>1 - INFO<br>2 - ADVERTIMENT<br>3 - MITJANA<br>4 - ALTA<br>5 - DESASTRE |Gravetat del trigger.| |<|descripció|\-|`text`|<|Descripció del trigger.| |<|tipus|\-|`cadena`|0 - SINGLE (per defecte)<br>1 - MULTIPLE|Tipus de generació d'esdeveniments (un sol esdeveniment problema o diversos esdeveniments problema).| |<|manual\_close|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Tancament manual dels esdeveniments del problema.| |dependències|<|\-|<|<|Element arrel per a dependències.| |<|nom|x|`cadena`|<|Nom de la dependència del trigger.| |<|expressió|x|`cadena`|<|Expressió de dependència del trigger.| |<|recovery\_expression|\-|`string`|<|Activar l'expressió de recuperació de dependència.| |etiquetes|<|\-|<|<|Element arrel per a les etiquetes d'esdeveniments.| |<|etiqueta|x|`cadena`|<|Nom de l'etiqueta.| |<|valor|\-|`cadena`|<|Valor de l'etiqueta.| # host.update # host.update ##### Host web scenario tags |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |httptests| |\-| | |Root element for web scenarios.| | |name|x|`string`| |Web scenario name.| | |delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| | |attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| | |agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| | |http\_proxy|\-|`string`| |Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables| |\-| | |Root element for scenario-level variables (macros) that may be used in scenario steps.| | |name|x|`text`| |Variable name.| | |value|x|`text`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`text`| |Header name.| | |value|x|`text`| |Header value.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| | |authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| | |http\_user|\-|`string`| |User name used for basic, HTTP or NTLM authentication.| | |http\_password|\-|`string`| |Password used for basic, HTTP or NTLM authentication.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's certificate is authentic.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.| | |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| |x| | |Root element for web scenario steps.| | |name|x|`string`| |Web scenario step name.| | |url|x|`string`| |URL for monitoring.| |query\_fields| |\-| | |Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| | |name|x|`string`| |Query field name.| | |value|\-|`string`| |Query field value.| |posts| |\-| | |HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| | |name|x|`string`| |Post field name.| | |value|x|`string`| |Post field value.| |variables| |\-| | |Root element of step-level variables (macros) that should be applied after this step.<br><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|x|`string`| |Variable name.| | |value|x|`string`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| | |timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| | |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. Ignored if empty. For example: 200-201,210-299| |tags| |\-| | |Root element for web scenario tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| ##### Etiquetes d'escenari web d'equip |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |httptests| |\-| | |Element arrel per a escenaris web.| | |name|x|`cadena`| |Nom de l'escenari web.| | |delay|\-|`cadena`|Per defecte: 1m|Freqüència d'execució de l'escenari web. Segons, unitat de temps amb sufix o macro d'usuari.| | |attempts|\-|`enter`|1-10 (per defecte: 1)|Nombre d'intents d'execució de passes d'escenari web.| | |agent|\-|`cadena`|Per defecte: Zabbix|Agent client. Zabbix simularà ser el navegador seleccionat. Això és útil quan un lloc web retorna contingut diferent amb diferents navegadors.| | |http\_proxy|\-|`cadena`| |Especifiqueu un proxy HTTP per emprar, en format:`http://[nom d'usuari[:mot de pas]@]proxy.exemple.com[:port]`| |variables| |\-| | |Element arrel per a variables a nivell d'escenari (macros) que es poden emprar a passes d'escenari.| | |name|x|`text`| |Nom de la variable.| | |value|x|`text`| |Valor variable.| |headers| |\-| | |L'element arrel de les capçaleres HTTP que s'enviarà en executar una petició. Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| | |name|x|`text`| |Nom de la capçalera.| | |value|x|`text`| |Valor de la capçalera.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'escenari web.| | |authentication|\-|`cadena`|0 - CAP (per defecte)<br>1 - BÀSICA<br>2 - NTLM|Mètode d'autenticació.| | |http\_user|\-|`cadena`| |Nom d'usuari emprat per a l'autenticació bàsica, HTTP o NTLM.| | |http\_password|\-|`cadena`| |Mot de pas emprat a l'autenticació bàsica, HTTP o NTLM.| | |verify\_peer|\-|`cadena`|0 - NO (predeterminat)<br>1 - SÍ|Validar que el certificat de l'equip és autèntic.| | |verify\_host|\-|`cadena`|0 - NO (per defecte)<br>1 - YES|Valida que el nom de l'equip per a la connexió coincideixi amb el del certificat de l'equip.| | |ssl\_cert\_file|\-|`cadena`| |Nom del fitxer de certificat SSL emprat per a l'autenticació del client (ha de ser en format PEM).| | |ssl\_key\_file|\-|`cadena`| |Nom del fitxer de clau privada SSL emprat per a l'autenticació del client (ha de ser en format PEM).| | |ssl\_key\_password|\-|`cadena`| |Mot de pas del fitxer de clau privada SSL.| |steps| |x| | |Element arrel per a les passes de l'escenari web.| | |name|x|`cadena`| |Nom de la passa de l'escenari web.| | |url|x|`cadena`| |URL de seguiment.| |query\_fields| |\-| | |Element arrel per als camps de consulta: una matriu de camps HTTP que s'afegiran a l'URL quan s'executa una consulta.| | |name|x|`cadena`| |Nom del camp de consulta.| | |value|\-|`cadena`| |Valor del camp de consulta.| |posts| |\-| | |Variables HTTP POST com a cadena (dades de publicació en brut) o com a matriu de camps HTTP (dades de camp de formulari).| | |name|x|`cadena`| |Nom del camp del missatge.| | |value|x|`cadena`| |Valor del camp Post.| |variables| |\-| | |Element arrel de les variables de nivell de passa (macros) que s'haurien d'aplicar després d'aquesta passa.<br><br>Si el valor de la variable té un prefix "regex:", aleshores el seu valor s'agafa de les dades retornades per aquesta passa segons el patró d'expressió regular seguint el prefix 'regex:'| | |name|x|`cadena`| |Nom de la variable.| | |value|x|`cadena`| |Valor variable.| |headers| |\-| | |L'element arrel de les capçaleres HTTP que s'enviarà en executar una petició. Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| | |name|x|`cadena`| |Nom de la capçalera.| | |value|x|`cadena`| |Valor de la capçalera.| | |follow\_redirects|\-|`cadena`|0 - NO<br>1 - SÍ (per defecte)|Seguiu les redireccions HTTP.| | |retrieve\_mode|\-|`cadena`|0 - COS (per defecte)<br>1 - CAPÇALERES<br>2 - AMBDÚES|Mode de recuperació de la resposta HTTP.| | |timeout|\-|`cadena`|Per defecte: 15s|Temps d'execució de la passa. Segons, unitat de temps amb sufix o macro d'usuari.| | |required|\-|`cadena`| |Text que ha de ser present a la resposta. S'ignora si és buit.| | |status\_codes|\-|`cadena`| |Una llista delimitada per comes de codis d'estat HTTP acceptats. S'ignora si és buit. Per exemple: 200-201,210-299| |tags| |\-| | |Element arrel per a les etiquetes de la història web.| | |tag|x|`cadena`| |Nom de l'etiqueta.| | |value|\-|`cadena`| |Valor de l'etiqueta.| #### Housekeeper The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log). If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper. Deleting an item/trigger will also delete problems generated by that item/trigger. Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records. For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "0"), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled. It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field. ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, data kept in these tables will still be stored in partitions, however, the housekeeper will not drop outdated partitions, and warnings about incorrect configuration will be displayed. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items, and history for deleted items will be cleared when an outdated partition is deleted. ::: [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years. *Reset defaults* button allows to revert any changes made. #### Neteja La neteja és un procés periòdic, realitzat pel servidor Zabbix. El procés esborra la informació obsoleta i la informació esborrada per l'usuari.  En aquesta secció, les tasques de manteniment es poden habilitar o desactivar per separat per a cada tasca: Esdeveniments i alertes/Serveis de TI/Sessions d'usuari/Historial/Tendències. La configuració de manteniment de l'auditoria és disponible a una [secció de menú] independent (/manual/web_interface/frontend_sections/administration/general#audit_log). Si l'esborrat és activat, és possible definir quants dies es conservaran els registres de dades abans d'esborrar-se. L'esborrat d'un element/trigger també esborrarà els problemes generats per aquest element/trigger. A més, un esdeveniment només s'esborra mitjançant la neteja si ja no és associat a un problema. Això vol dir que si un esdeveniment és un problema o un esdeveniment de recuperació, no s'esborrarà fins que no s'esborri el registre del problema associat. La neteja esborrarpa els problemes primer i els esdeveniments després, per evitar possibles problemes amb esdeveniments obsolets o registres de problemes. Per a l'historial i les tendències, hi ha una opció addicional disponible: *Anul·lació del període de l'historial d'articles* i *Anul·lació del període de tendència d'elements*. Aquesta opció us permet establir globalment quants dies es mantindran l'historial/tendències d'articles (d'1 hora a 25 anys; o "0"), en aquest cas, anul·lant els valors establerts per a articles individuals a la [configuració de l'element](/manual/config/items/item) *Període d'emmagatzematge de l'historial/Període d'emmagatzematge de tendències*. Tingueu en compte que el període d'emmagatzematge no es substituirà per als articles que tinguin l'opció de configuració *No conservar l'historial* i/o *No mantindre les tendències* activada. És possible anul·lar l'historial/període d'emmagatzematge de tendències fins i tot si la neteja interna és desactivada. Per tant, quan s'empra una neteja externa, el període d'emmagatzematge de l'historial es pot establir mitjançant el camp Historial *Període d'emmagatzematge de dades*. ::: noteimportant Si empreu TimescaleDB, per tal d'aprofitar al màxim la partició automàtica de les taules històriques i de tendències de TimescaleDB, les opcions *Substituïr el període de l'historial d'elements* i *Substituïr el període de tendència d'elements* haurien d'habilitar-se així com l'opció *Activar la neteja interna* per a història i tendències. En cas contrari, les dades conservades en aquestes taules encara s'emmagatzemaran a les particions, però, la neteja no esborrarà pas les particions antigues i es mostraran avisos sobre una configuració incorrecta. Quan s'habilita l'esborrat de particions antigues, el servidor Zabbix i la interfície ja no faran un seguiment dels elements esborrats i l'historial dels elements suprimits s'esborrarà quan s'elimini una partició obsoleta. ::: S'admeten [sufixos de temps](/manual/apèndix/sufixos) als camps de període de temps, per exemple, 1d (un dia), 1w (una setmana). El mínim és 1 dia (1 hora per a la història), el màxim - 25 anys. El botó *Restableix els valors predeterminats* us permet desfer els canvis fets. #### housekeeping Changes:<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added support of property `hk_events_service`. #### Manteniment Changes:<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) afegit el suport de la propietat `hk_events_service`. # housekeeping.get # housekeeping.get # Housekeeping object The following objects are directly related to the `housekeeping` API. # Objecte de manteniment Els següents objectes tenen relació directa a l'API `housekeeping`. ### 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: 365d.| |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: 90d.| |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|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |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.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.| ### Manteniment L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hk\_events\_mode|integer|Activa el manteniment intern per a esdeveniments i alertes.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_events\_trigger|string|Període d'activació d'emmagatzematge de dades. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_events\_service|string|Període d'emmagatzematge de dades del servei. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_internal|string|Període d'emmagatzematge de dades intern. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_discovery|string|Període d'emmagatzematge de dades de descoberta de xarxa. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_autoreg|string|Període d'emmagatzematge de dades del registre automàtic. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_services\_mode|integer|Activa la neteja interna dels serveis.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_services|string|Període d'emmagatzematge de dades del servei. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_audit\_mode|integer|Activa el manteniment intern per a l'auditoria.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_audit|string|Període d'emmagatzematge de dades d'auditoria. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_sessions\_mode|integer|Activa la neteja interna per a les sessions.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_sessions|string|Període d'emmagatzematge de dades de la sessió. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_history\_mode|integer|Activa el manteniment intern de l'historial.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_history\_global|integer|Substitueix el període de l'historial d'elements.<br><br>Valors possibles:<br>0 - No substitueix;<br>1 - *(per defecte)* Substitueix.| |hk\_history|string|Període d'emmagatzematge de dades de l'historial. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 90d.| |hk\_trends\_mode|integer|Activa la neteja interna per a tendències.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_trends\_global|integer|Anul·lació del període de tendència de l'element.<br><br>Valors possibles:<br>0 - No substituir;<br>1 - *(per defecte)* Anul·lar. | |hk\_trends|string|Període de temps per emmagatzemar dades de tendències. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |db\_extension|string|*(només lectura)* Marcador de configuració de l'extensió de la base de dades. Si aquesta marca s'estableix a "timescaledb", el servidor canvia el seu comportament per netejar i suprimir elements.| |compression\_status|integer|Activa la compressió TimescaleDB per a l'historial i les tendències.<br><br>Valors possibles:<br>0 - *(per defecte)* Desactiva;<br>1 - Activa.| |compress\_older|string|Comprimir l'historial i els registres de tendències anteriors al període de temps especificat. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 7d.| |compression\_availability|integer|*(només lectura)* Disponibilitat de compressió.<br><br>Valors possibles:<br>0 - No disponible;<br>1 - Disponible.| # 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 # Manteniment Aquesta classe és dissenyada per treballar amb el manteniment. Referències d'objectes: - [Manteniment](/manual/api/reference/housekeeping/object#housekeeping) Mètodes disponibles: - [housekeeping.get](/manual/api/reference/housekeeping/get) - recuperar el manteniment - [housekeeping.update](/manual/api/reference/housekeeping/update) - actualitzar el manteniment # housekeeping.update # housekeeping.update #### How it works In log monitoring you may encounter lines similar to these: Line1: Application 1 stopped Line2: Application 2 stopped Line3: Application 1 was restarted Line4: Application 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: Application 1 stopped Line3: Application 1 was restarted #problem from Line 1 closed Line2: Application 2 stopped Line4: Application 2 was restarted #problem from Line 2 closed To do this you need to tag these related events as, for example, "Application 1" and "Application 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 "Application 1" and "Application 2" respectively and problem can be matched to the resolution. #### Com funciona tot plegat Al monitoratge del registre, podeu trobar línies semblants a aquestes: Línia 1: s'ha aturat l'aplicació 1 Línia 2: s'ha aturat l'aplicació 2 Línia 3: s'ha reiniciat l'aplicació 1 Línia 4: s'ha reiniciat l'aplicació 2 La idea de la correlació d'esdeveniments és poder fer coincidir l'esdeveniment problema de Línia 1 amb la resolució de Línia 3 i l'esdeveniment problema Línia 2 amb la resolució de Línia 4, i tancar aquests problemes un per un: Línia 1: s'ha aturat l'aplicació 1 Línia 3: s'ha reiniciat l'aplicació 1 #problema de la línia 1 tancada Línia 2: s'ha aturat l'aplicació 2 Línia 4: s'ha reiniciat l'aplicació 2 #problema de la línia 2 tancada Per fer-ho, heu d'etiquetar aquests esdeveniments associats com, per exemple, "Aplicació 1" i "Aplicació 2". Això es pot fer aplicant una expressió regular a la línia de registre per extreure el valor de l'etiqueta. Aleshores, quan es creen els esdeveniments, s'etiqueten "Aplicació 1" i "Aplicació 2" respectivament i el problema es pot associar amb la resolució. #### HP OpenView Zabbix can be configured to send messages to OpenView server. The following steps must be performed: #### HP OpenView Es pot configurar Zabbix per enviar els missatges al servidor OpenView. Les següents passes s'haurien de seguir: ### HTML support in Geomap attribution dropped The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. If this field already contains HTML, it will be rendered as plain text after the upgrade. In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*. ### S'ha deixat el suport HTML a l'atribució de Geomap El text d'atribució per al [Giny del tauler de geomapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) ara només pot contindre text pla; S'ha tret el suport HTML. Si aquest camp ja conté HTML, es representarà com a text senzill després de l'actualització. A la configuració de [Mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical-maps) dins la secció Administració → General, el camp *Atribució* ara només és visible quan el *Proveïdor de rajoles* sigui establert a *Altres*. ### HTML support in Geomap attribution dropped The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*. ### S'ha deixat el suport HTML a l'atribució de Geomap El text d'atribució per al [Giny del tauler de geomapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) ara només pot contindre text pla; S'ha tret el suport HTML. A la configuració de [Mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical-maps) dins la secció Administració → General, el camp *Atribució* ara només és visible quan el *Proveïdor de rajoles* sigui establert a *Altres*. ### HTTP authentication HTTP or web server-based authentication (for example: Basic Authentication, NTLM/Kerberos) can be used to check user names and passwords. Note that a user must exist in Zabbix as well, however its Zabbix password will not be used. ::: noteimportant Be careful! Make sure that web server authentication is configured and works properly before switching it on. ::: {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. ::: ### Autenticació HTTP L'autenticació HTTP o basada en servidor web (per exemple: autenticació bàsica, NTLM/Kerberos) es pot emprar per verificar noms d'usuari i mots de pas. Tingueu en compte que un usuari també ha d'existir a Zabbix, però el seu mot de pas de Zabbix no s'emprarà pas. ::: noteimportant Compte! Assegureu-vos que l'autenticació del servidor web sigui configurada i funcioni correctament abans d'activar-la. ::: {width="600"} Paràmetres de configuració: |Paràmetre|Descripció| |--|---------| |*Activa l'autenticació HTTP*|Marqueu la casella per habilitar l'autenticació HTTP. Passant el cursor per damunt de  apareixerà un quadre d'avís que advertirà que en el cas del web autenticació del servidor, tots els usuaris (fins i tot per a [accés a la interfície](/manual/config/users_and_usergroups/usergroup#configuration) establert a LDAP/Internal) seran autenticats pel servidor web, no per Zabbix.| |*Formulari d'inici de sessió predeterminat*|Indiqueu si voleu redirigir els usuaris no autenticats a:<br>**Formulari d'inici de sessió Zabbix** - Pàgina d'inici de sessió estàndard de Zabbix.<br>**Formulari d'inici de sessió HTTP** - Pàgina d'inici de sessió HTTP.<br>Es recomana habilitar l'autenticació basada en el servidor web només per a la pàgina `index_http.php`. Si el *Formulari d'inici de sessió predeterminat* s'estableix a 'Pàgina d'inici de sessió HTTP', l'usuari s'iniciarà automàticament si el mòdul d'autenticació del servidor web defineix un inici de sessió d'usuari vàlid a la variable `$_SERVER`.<br>El `$_SERVER` compatible. les claus són `PHP_AUTH_USER`, `REMOTE_USER`, `AUTH_USER`.| |*Esborra el nom de domini*|Una llista delimitada per comes de noms de domini que s'han d'esborrar del nom d'usuari.<br>Ex. `comp,any' - si el nom d'usuari és 'Admin@any', 'comp\\Admin', l'usuari s'iniciarà com a 'Admin'; si el nom d'usuari és 'notacompany\\Admin', l'inici de sessió serà denegat.| |*Inici de sessió sensible a majúscules i minúscules*|Desmarqueu la casella per desactivar l'inici de sessió sensible a majúscules i minúscules (activat de manera predeterminada) per als noms d'usuari.<br>Ex. desactiveu l'inici de sessió que distingeix entre majúscules i minúscules i, per exemple, l'usuari "ADMINISTRADOR", encara que l'usuari de Zabbix sigui "Administrador".<br>*Tingueu en compte* que amb l'inici de sessió sensible a majúscules i minúscules desactivat, l'inici de sessió es denegarà si existeixen diversos usuaris a la base de dades de Zabbix amb noms d'usuari similars (p. ex. Admin, admin).| ::: notetip Per als usuaris interns que no poden iniciar sessió amb credencials HTTP (amb el formulari d'inici de sessió HTTP definit com a predeterminat) que genera l'error 401, podeu afegir una línia "ErrorDocument 401 /index.php?form=default" a les directives bàsiques d'autenticació, que redirigeix ​​al formulari d'inici de sessió habitual de Zabbix. ::: ### HTTP field The HTTP field object defines a name and value that is used to specify variable, HTTP header, POST form field data of query field data. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of header / variable / POST or GET field.| |**value**<br>(required)|string|Value of header / variable / POST or GET field.| ### Camp HTTP L'objecte de camp HTTP defineix un nom i un valor emprats per especificar una variable, una capçalera HTTP, les dades del camp de formulari POST o les dades de camp de petició. Té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**nom**<br>(obligatori)|string|Nom de la capçalera / variable / camp POST o GET.| |**nom**<br>(obligatori)|string|Valor de la capçalera / variable / camp POST o GET.| #### HttpRequest ::: noteimportant "HttpRequest" is a new name for this object since Zabbix 5.4. Previously it was called "CurlHttpRequest". Method names have also been changed in Zabbix 5.4. The old object/method names are now deprecated and their support will be discontinued after Zabbix 6.0. ::: 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 ::: noteimportant "HttpRequest" és un nom nou per a aquest objecte des de Zabbix 5.4. Abans s'anomenava "CurlHttpRequest". Els noms dels mètodes també es van canviar a Zabbix 5.4. Els noms antics d'objectes/mètodes ara són obsolets i el seu suport es discontinuarà després de Zabbix 6.0. ::: Aquest objecte encapsula el controlador cURL que permet fer peticions HTTP senzilles. Els errors es llancen com a excepcions. ::: noteimportant La inicialització de diversos objectes `HttpRequest` és limitada a 10 per execució de l'script. ::: |Mètode|Descripció| |--|---------| |`addHeader(name, value)`|Afegiu un camp de capçalera HTTP. Aquest camp s'empra per a totes les peticions posteriors fins que s'esborra amb el mètode clearHeader().<br>L'allargada total dels camps de capçalera que es poden afegir a un únic objecte `HttpRequest` és limitada a 128Ko (inclosos caràcters especials i noms de capçalera).| |`clearHeader()`|Esborra la capçalera HTTP. Si no s'estableix cap camp de capçalera, `HttpRequest` establirà el Content-Type a application/json si les dades publicades són en format JSON; text/llaç en cas contrari.| |`connect(url)`|Envieu la petició HTTP CONNECT a l'URL i retorneu la resposta.| |`customRequest(method, url, data)`|Permet especificar qualsevol mètode HTTP al primer paràmetre. Envieu la petició de mètode a l'URL amb la càrrega útil de *dades* opcional i la resposta de retorn.| |`delete(url, data)`|Envia la petició HTTP DELETE a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`getHeaders(<asArray>)`|Retorna l'objecte dels camps de capçalera HTTP rebuts.<br>El paràmetre `asArray` es pot establir com a "true" (per exemple, `getHeaders(true)`), "false" o ésser indefinit. Si es defineix com a "true", els valors dels camps de capçalera HTTP rebuts es retornaran com a matrius; això s'ha d'emprar per recuperar els valors dels camps de diverses capçaleres amb el mateix nom.<br>Si no s'estableix o s'estableix com a "fals", els valors dels camps de capçalera HTTP rebuts es retornaran com a cadenes. |`get(url, data)`|Envia una petició HTTP GET a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`head(url)`|Envia la petició HTTP HEAD a l'URL i retorna la resposta.| |`options(url)`|Envia la petició HTTP OPTIONS a l'URL i retorna la resposta.| |`patch(url, data)`|Envia la petició HTTP PATCH a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`put(url, data)`|Envia una petició HTTP PUT a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`post(url, data)`|Envia una petició HTTP POST a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`getStatus()`|Retorna el codi d'estat de la darrera petició HTTP.| |`setProxy(proxy)`|Configura el proxy HTTP amb el valor "proxy". Si aquest paràmetre és buit, no s'empra cap proxy.| |`setHttpAuth(bitmask, username, password)`|Defineix els mètodes d'autenticació HTTP activats (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) al paràmetre "bitmask".<br>El HTTPAUTH\_NONE s'empra per desactivar l'autenticació HTTP.<br> Exemples:<br>`request.setHttpAuth(HTTPAUTH_NTLM\| HTTPAUTH_BASIC, nom d'usuari, mot de pas)`<br>`request.setHttpAuth(HTTPAUTH_NONE)``| |`trace(url, data)`|Envia la petició de TRACE HTTP a l'URL amb la càrrega útil de *data* opcional i retorna la resposta.| Exemple: ```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 Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: the parameter `uuid` can now be updated. #### httptest Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `httptest.update`: el paràmetre `uuid` ara es pot actualitzar. # 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! ::: #### Histèresi De vegades cal un interval entre els estats de problema i de recuperació, en lloc de només un llindar. Per exemple, si volem establir un trigger per informar d'un problema quan la temperatura de la sala del servidor supera els 20 °C i volem que es mantingui en l'estat de problema fins que la temperatura baixi dels 15 °C, un llindar d'activació simple a 20 °C no serà suficient. el que hem de fer és, primer, definir un trigger per a l'esdeveniment problemàtic (temperatura superior a 20 °C). Tot seguit, hem de definir una condició de recuperació addicional (temperatura inferior a 15 °C). Per fer-ho, definiu un paràmetre addicional *Expressió de recuperació* quan [definiu](/manual/config/triggers/trigger) el trigger. En aquest cas, la recuperació del problema es farà en dues passes: - En primer lloc, l'expressió del problema (temperatura superior a 20°C) s'ha de valorar com a FALSE - En segon lloc, l'expressió de recuperació (temperatura inferior a 15 °C) s'ha de valorar com a TRUE L'expressió de recuperació s'avaluarà només quan es resolgui primer l'esdeveniment problema. ::: notewarning L'expressió de recuperació per si sola a TRUE no resol el problema si l'expressió problema encara és TRUE! ::: #### ICMP pings Zabbix uses external utility **fping** for processing of ICMP pings. The utility is not part of Zabbix distribution and has to be additionally installed. If the utility is missing, has wrong permissions or its location does not match the location set in the Zabbix server/proxy configuration file ('FpingLocation' parameter), ICMP pings (**icmpping**, **icmppingloss**, **icmppingsec**) will not be processed. See also: [known issues](/manual/installation/known_issues#simple_checks) **fping** must be executable by the user Zabbix daemons run as and setuid root. Run these commands as user **root** in order to set up correct permissions: chown root:zabbix /usr/sbin/fping chmod 4710 /usr/sbin/fping After performing the two commands above check ownership of the **fping** executable. In some cases the ownership can be reset by executing the chmod command. Also check, if user zabbix belongs to group zabbix by running: groups zabbix and if it's not add by issuing: usermod -a -G zabbix zabbix 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 to a target|-C| |3|1|10000| |interval|milliseconds|time to wait between successive packets|-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** - inherited from *-p* flag, but not more than 2000| |50|unlimited| 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). Those 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) process individually. Auto-detected fping options are invalidated every hour and detected again on the next attempt to perform ICMP check. Set DebugLevel>=4 in order to view details of this process in the server or proxy log file. ::: notewarning Warning: fping defaults can differ depending on platform and version - if in doubt, check fping documentation. ::: Zabbix writes IP addresses to be checked by any of three *icmpping\** keys to a temporary file, which is then passed to **fping**. If items have different key parameters, only ones with identical key parameters are written to a single file.<br> 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. #### Pings ICMP Zabbix empra la utilitat externa **fping** per fer pings ICMP. La utilitat no forma part de la distribució Zabbix i s'ha d'instal·lar addicionalment. Si manca la utilitat, té permisos incorrectes o la seva ubicació no coincideix amb la ubicació definida al fitxer de configuració del servidor/proxy Zabbix (paràmetre 'FpingLocation'), els pings ICMP (**icmpping**, **icmppingloss**, ** icmppingsec**) no es processaran pas. Veieu també: [problemes coneguts](/manual/installation/known_issues#simple_checks) **fping** ha d'ésser executable per l'usuari dels dimonis Zabbix que s'executen com a root i setuid. Executeu aquestes ordres com a usuari **root** per configurar els permisos correctes: chown root:zabbix /usr/sbin/fping chmod 4710 /usr/sbin/fping Després d'executar les dues ordres anteriors, comproveu la propietat de l'executable **fping**. En alguns casos, la propietat es pot restablir executant l'ordre chmod. Comproveu també si l'usuari zabbix pertany al grup zabbix executant: groups zabbix i si no, afegiu-lo executant: usermod -a -G zabbix zabbix Després d'executar les dues ordres anteriors, comproveu la propietat de l'executable **fping**. En alguns casos, la propietat es pot restablir executant l'ordre chmod. Comproveu també si l'usuari zabbix pertany al grup zabbix executant: grups zabbix Valors per defecte, límits i descripció dels valors dels paràmetres de control ICMP: |Paràmetre|Unitat|Descripció|Etiqueta Fping|Valors per defecte establerts per|<|Límits permesos<br>per Zabbix|<| |--|--|---------|-|--|--|--|--| | | | | |**fping**|**Zabbix**|**min**|**max**| |paquets|nombre|nombre de paquets de petició a un objectiu|-C| |3|1|10000| |interval|mil·lisegons|temps d'espera entre paquets successius|-p|1000| |20|il·limitat| |mida|octets|mida del paquet en octets<br>56 octets a x86, 68 octets a x86_64|-b|56 o 68| |24|65507| |timeout|mil·lisegons|**fping v3.x** - temps d'espera després de l'enviament del darrer paquet, afectat per la marca *-C*<br> **fping v4.x** - temps d'espera individual per a cada paquet |-t|* *fping v3.x** - 500<br>**fping v4.x** - heretat de l'assenyalador *-p*, però no més de 2000| |50| il·limitat| A més, Zabbix empra les opcions fping *-i interval ms* (no s'ha de confondre amb el paràmetre d'element *interval* esmentat a la taula anterior, que correspon a l'opció fping *-p*) i *-S adreça IP font* (o * -I* en versions anteriors d'fping). Aquestes opcions es detecten automàticament executant comprovacions amb diferents combinacions d'opcions. Zabbix prova de detectar el valor mínim en mil·lisegons que fping permet emprar amb *-i* provant 3 valors: 0, 1 i 10. El valor que té èxit primer s'empra per a les comprovacions ICMP posteriors. Aquest procés el fa cada procés [ICMP pinger](/manual/concepts/server#server_process_types) individualment. Les opcions d'fping detectades automàticament s'invaliden cada hora i es tornen a detectar al següent intent de verificació ICMP. Establiu DebugLevel>=4 per mostrar els detalls d'aquest procés al fitxer de registre del servidor o del proxy. ::: notewarning Exempció de responsabilitat: els valors predeterminats d'fping poden variar segons la plataforma i la versió; en cas de dubte, consulteu la documentació d'fping. ::: Zabbix escriu adreces IP per ésser verificades amb una de les tres claus *icmpping\** a un fitxer temporal, que després es passa a **fping**. Si els elements tenen paràmetres clau diferents, només s'escriuen en un sol fitxer aquells amb paràmetres clau idèntics.<br> Totes les adreces IP escrites al fitxer únic es comprovaran mitjançant fping en paral·lel, de manera que el procés Zabbix icmp pinger passarà un temps fix independentment del nombre d'adreces IP del fitxer. ##### Icon highlighting If a map element is in problem status, it is highlighted with a round circle. The fill color of the circle corresponds to the severity color of the problem. Only problems on or above the selected severity level will be displayed with the element. If all problems are acknowledged, a thick green border around the circle is displayed. Additionally: - a host in [maintenance](/manual/maintenance) is highlighted with an orange, filled square. Note that maintenance highlighting has priority over the problem severity highlighting (since Zabbix 6.0.5, only if the map element is host). - a disabled (not-monitored) host is highlighted with a gray, filled square. Highlighting is displayed if the *Icon highlighting* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map). ##### Icona ressaltada Si un element del mapa es troba en un estat problemàtic, es ressalta amb un cercle. El color de farcit del cercle correspon al color de la gravetat del problema. Amb l'element només es mostraran problemes amb el nivell de gravetat seleccionat o superior. Si es resolen tots els problemes, es mostrarà una vora verda gruixuda al voltant del cercle. A més de: - un equip a [manteniment](/manual/maintenance) es ressalta amb un quadrat carbassa sòlid. Tingueu en compte que el ressaltat de manteniment té prioritat sobre el ressaltat de la gravetat del problema (des de Zabbix 6.0.5, només si l'element del mapa és un equip). - un equip desactivat (no monitorat) es ressalta amb un quadrat gris ple. El ressaltat es mostra si la casella de selecció *Icona destacada* és marcada a la [configuració](/manual/config/visualization/maps/map#creating_a_map) del mapa. #### iconmap Changes:<br> [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: dropped support of the icon mapping object property `sortorder`. #### mapa d'icones Canvis:<br> [ZBXNEXT-6914](https://support.zabbix.com/browse/ZBXNEXT-6914) `iconmap.create`, `iconmap.update`: suport descartat de la propietat de l'objecte de mapatge de la icona `sortorder`. # iconmap.create # iconmap.create # iconmap.delete # iconmap.delete # iconmap.get # iconmap.get # Icon map object The following objects are directly related to the `iconmap` API. # Objecte mapa d'icones imatge Els següents objectes tenen relació directa amb l'API `iconmap`. ### Icon mapping The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmappingid|string|*(readonly)* ID of the icon map.| |**iconid**<br>(required)|string|ID of the icon used by the icon mapping.| |**expression**<br>(required)|string|Expression to match the inventory field against.| |**inventory\_link**<br>(required)|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.| |iconmapid|string|*(readonly)* ID of the icon map that the icon mapping belongs to.| |sortorder|integer|*(readonly)* Position of the icon mapping in the icon map.| ### Mapatge d'icones L'objecte defineix una icona específica per emprar-la per als equips amb un valor de camp d'inventari determinat. Té les següents propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconmappingid|string|*(només lectura)* ID de mapatge d'icones.| |**iconid**<br>(obligatori)|string|ID de la icona emprada per l'assignació d'icones.| |**expression**<br>(obligatori)|string|Expressió que coincideixi amb el camp d'inventari.| |**inventory\_link**<br>(obligatori)|integer|ID de camp d'inventari de l'eqio.<br><br>Consulteu [Objecte d'inventari d'equip](/manual/ api/reference/host/object#host_inventory) per a una llista de camps d'inventari compatibles.| |iconmapid|string|*(només lectura)* Id del mapa d'icones al qual pertany el mapatge.| |sortorder|integer|*(només lectura)* Posició de l'assignació d'icones a l'assignació d'icones.| #### Icon mapping This section allows creating the mapping of certain hosts with certain icons. Host inventory field information is used to create the mapping. The mappings can then be used in [network map configuration](/manual/config/visualization/maps/map) to assign appropriate icons to matching hosts automatically. To create a new icon map, click on *Create icon map* in the top right corner. {width="600"} Configuration parameters: |Parameter|Description| |--|--------| |*Name*|Unique name of icon map.| |*Mappings*|A list of mappings. The order of mappings determines which one will have priority. You can move mappings up and down the list with drag-and-drop.| |*Inventory field*|Host inventory field that will be looked into to seek a match.| |*Expression*|Regular expression describing the match.| |*Icon*|Icon to use if a match for the expression is found.| |*Default*|Default icon to use.| #### Mapatge d'icones Aquesta secció us permet crear el mapatge de determinats equips amb determinades icones. La informació del camp d'inventari de l'equip s'empra per crear el mapatge. Els mapes es poden emprar a la [configuració del mapa de xarxa](/manual/config/visualization/maps/map) per assignar automàticament les icones correctes als equips corresponents. Per crear un mapa d'icones nou, feu clic a *Crear un mapa d'icones* a l'extrem superior dret. {width="600"} Paràmetres de configuració: |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic del mapa d'icones.| |*Mapatges*|Una llista de mapes. L'ordre dels mapes determina quins tindran prioritat. Podeu moure mapes amunt i avall per la llista arrossegant i deixant anar.| |*Camp d'inventari*|Camp d'inventari de l'equip que es comprovarà si hi ha una coincidència.| |*Expressió*|Expressió regular que descriu la coincidència.| |*Icona*|Icona a emprar si es troba una coincidència per a l'expressió.| |*Per defecte*|Icona per defecte a emprar.| ### Icon map The icon map object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapid|string|*(readonly)* ID of the icon map.| |**default\_iconid**<br>(required)|string|ID of the default icon.| |**name**<br>(required)|string|Name of the icon map.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Mapatge d'icones L'objecte de mapatge d'icones té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconmapid|string|*(només lectura)* ID del mapa d'icones.| |**default\_iconid**<br>(obligatori)|string|ID de la icona per defecte.| |**name**<br>(obligatori)|string|Nom del mapa d'icones.| Veieu que per alguns mètodes (actualitzar, esborrar), la combinació de paràmetres obligatoris o opcionals és diferent. # Icon map This class is designed to work with icon maps. Object references: - [Icon map](/manual/api/reference/iconmap/object#icon_map) - [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping) Available methods: - [iconmap.create](/manual/api/reference/iconmap/create) - create new icon maps - [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon maps - [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon maps - [iconmap.update](/manual/api/reference/iconmap/update) - update icon maps # Mapa d'icones Aquesta classe és dissenyada per treballar amb mapes d'icones. Referències d'objectes: - [Mapa d'icones](/manual/api/reference/iconmap/object#icon_map) - [Cartografia d'icones](/manual/api/reference/iconmap/object#icon_mapping) Mètodes disponibles: - [iconmap.create](/manual/api/reference/iconmap/create) - crear nou mapa d'icones - [iconmap.delete](/manual/api/reference/iconmap/delete) - esborrar mapa d'icones - [iconmap.get](/manual/api/reference/iconmap/get) - recuperar mapa d'icones - [iconmap.update](/manual/api/reference/iconmap/update) - actualitzar mapa d'icones # iconmap.update # iconmap.update If access rights to persistent storage files are removed during agent operation or other errors occur (e.g. disk full) then errors are logged into the agent log file but the log item does not become NOTSUPPORTED. Si els drets d'accés als arxius d'emmagatzematge persistent s'esborren durant el funcionament de l'agent o si hi ha altre errors (per exemple, disc dur ple), els errors s'afegiran a l'arxiu de registre de l'agent però l'element de registre serà NO SUPORTAT. ##### If installed as package Zabbix agent runs as a daemon process. The agent can be started by executing: systemctl start zabbix-agent This will work on most of GNU/Linux systems. On other systems you may need to run: /etc/init.d/zabbix-agent start Similarly, for stopping/restarting/viewing status of Zabbix agent, use the following commands: systemctl stop zabbix-agent systemctl restart zabbix-agent systemctl status zabbix-agent ##### Si s'instal·la com a paquet L’agent Zabbix s'executa com un procés dimoni. L'agent es pot engegar executant: systemctl start zabbix-agent Això funcionarà a la majoria de sisetmes GNU/Linux. Sota altres sistemes haureu d'executar aquesta comanda: /etc/init.d/zabbix-agent start Igualment, per aturar/reiniciar/veure l'estat de l'agent Zabbix, empreu aquestes comandes: systemctl stop zabbix-agent systemctl restart zabbix-agent systemctl status zabbix-agent ##### If installed as package Zabbix proxy runs as a daemon process. The proxy can be started by executing: systemctl start zabbix-proxy This will work on most of GNU/Linux systems. On other systems you may need to run: /etc/init.d/zabbix-proxy start Similarly, for stopping/restarting/viewing status of Zabbix proxy, use the following commands: systemctl stop zabbix-proxy systemctl restart zabbix-proxy systemctl status zabbix-proxy ##### Si s'instal·la com a paquet El proxy Zabbix s'executa com a procés dimoni. El proxy es pot engegar executant: systemctl start zabbix-proxy Això funcionarà a la majoria dels sistemes GNU/Linux. Sota altres sistemes, haurem d'executar: /etc/init.d/zabbix-proxy start De la mateixa manera, per aturar/reiniciar/veure l'estat dell proxy Zabbix, empreu les comandes següents: systemctl stop zabbix-proxy systemctl restart zabbix-proxy systemctl status zabbix-proxy ##### If installed as package Zabbix server runs as a daemon process. The server can be started by executing: systemctl start zabbix-server This will work on most of GNU/Linux systems. On other systems you may need to run: /etc/init.d/zabbix-server start Similarly, for stopping/restarting/viewing status, use the following commands: systemctl stop zabbix-server systemctl restart zabbix-server systemctl status zabbix-server ##### Si s'instal·la com a paquet El servidor funciona com un procés dimoni. Pot engegar-se executant: systemctl start zabbix-server això funcionarà a la majoria dels sistemes GNU/Linux. Sota altre sistemes, haureu de poder executar: /etc/init.d/zabbix-server start De la mateixa manera, per aturar/reiniciar/consultar l'estat, empreu les comandes següents: systemctl stop zabbix-server systemctl restart zabbix-server systemctl status zabbix-server ##### If the webhook test fails - *"Media type test failed."* message is displayed, followed by additional failure details. ##### Si el test de webhook falla - El missatge *"Ha fallat el test de tipus de suport."* es mostra, seguit de detalls suplementaris de l'error. ##### If the webhook test is successful - *"Media type test successful."* message is displayed - Server response appears in the gray *Response* field - Response type (JSON or String) is specified below the *Response* field ##### Si el test de webhook ha funcionat - Apareix el missatge *"La prova de tipus de suport ha funcionat."* - La resposta del servidor apareix al camp gris *Resposta* - El tipus de resposta (JSON o String) s'especifica al camp *Resposta* # image.create # image.create # image.delete # image.delete # image.get # image.get # Image object The following objects are directly related to the `image` API. # Objecte imatge Els següents objectes tenen relació directa amb l'API `image`. #### Images The Images section displays all the images available in Zabbix. Images are stored in the database. {width="600"} The *Type* dropdown allows you to switch between icon and background images: - Icons are used to display [network map](/manual/config/visualization/maps/map) elements - Backgrounds are used as background images of network maps **Adding image** You can add your own image by clicking on the *Create icon* or *Create background* button in the top right corner.  Image attributes: |Parameter|Description| |--|--------| |*Name*|Unique name of an image.| |*Upload*|Select the file (PNG, JPEG, GIF) from a local system to be uploaded to Zabbix.<br>*Note* that it may be possible to upload other formats that will be converted to PNG during upload. GD library is used for image processing, therefore formats that are supported depend on the library version used (2.0.28 or higher is required by Zabbix).| ::: noteclassic Maximum size of the upload file is limited by the value of ZBX\_MAX\_IMAGE\_SIZE that is 1024x1024 bytes or 1 MB. The upload of an image may fail if the image size is close to 1 MB and the `max_allowed_packet` MySQL configuration parameter is at a default of 1MB. In this case, increase the [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet) parameter. ::: #### Imatges La secció Imatges mostra totes les imatges disponibles a Zabbix. Les imatges s'emmagatzemen a la base de dades. {width="600"} La llista desplegable *Tipus* us permet canviar entre icones i imatges de fons: - Les icones s'empren per mostrar elements de [mapes de xarxa](/manual/config/visualization/maps/map) - Els fons s'empren com a imatges de fons de les targetes de xarxa **Afegir una imatge** Podeu afegir la vostra pròpia imatge fent clic al botó *Crear una icona* o *Crear fons* a l'extrem superior dret.  Atributs de la imatge: |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic d'una imatge.| |*Càrrega*|Seleccioneu el fitxer (PNG, JPEG, GIF) d'un sistema local per carregar-lo a Zabbix.<br>*Tingueu en compte* que és possible que es puguin penjar altres formats que es convertiran a PNG en baixar. La biblioteca GD s'empra per al processament d'imatges, de manera que els formats admesos depenen de la versió de la biblioteca emprada (Zabbix requereix 2.0.28 o superior).| :::noteclassic La mida màxima del fitxer de càrrega és limitada pel valor de ZBX\_MAX\_IMAGE\_SIZE, que és de 1024 x 1024 octets o 1 Mo. La càrrega d'una imatge pot fallar si la mida de la imatge és propera a 1 Mo i el paràmetre de configuració de MySQL `max_allowed_packet` és d'1Mo per defecte. En aquest cas, augmenteu el paràmetre [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet). ::: #### Image tags Each image supports tags to select the base operating system and Zabbix version: ```default zabbix/<image>:<os>-<version> ``` Supported `<os>` values: - `alpine` - Alpine Linux - `ubuntu` - Ubuntu - `centos` - CentOS Stream - `ol` - Oracle Linux - `ltsc2022` - Windows 11 LTSC 2022 (Zabbix agent only) Supported `<version>` values: - `latest` - Latest stable Zabbix version on Alpine Linux - `<os>-latest` - Latest stable Zabbix version on the selected OS - `<os>-trunk` - Latest development (nightly) build on the selected OS - `<os>-X.X-latest` - Latest Zabbix minor release of a specific Zabbix major version on the selected OS - `<os>-X.X.*` - Specific Zabbix minor release on the selected OS Examples: ```bash # Latest stable Zabbix proxy (SQLite3) on Alpine Linux: docker pull zabbix/zabbix-proxy-sqlite3:latest # Latest stable Zabbix proxy (SQLite3) on Ubuntu: docker pull zabbix/zabbix-proxy-sqlite3:ubuntu-latest # Latest development (nightly) build of Zabbix server (MySQL) on Ubuntu: docker pull zabbix/zabbix-server-mysql:ubuntu-trunk # Latest 6.0 minor release of Zabbix server (MySQL) on Alpine Linux: docker pull zabbix/zabbix-server-mysql:alpine-6.0-latest # Version 6.0.1 of Zabbix server (MySQL) on Alpine Linux: docker pull zabbix/zabbix-server-mysql:alpine-6.0.1 ``` #### Etiquetes d'imatge Cada imatge admet etiquetes per triar el sistema operatiu base i la versió de Zabbix: ``default zabbix/<image>:<os>-<versió> ``` Valors suportats `<os>`: - 'alpine' - Alpine Linux - `ubuntu` - Ubuntu - `centos` - Corrent CentOS - `ol` - Oracle Linux - `ltsc2022` - Windows 11 LTSC 2022 (només agent de Zabbix) Valors suportats `<version>`: - `latest' - Darrera versió estable de Zabbix a Alpine Linux - `<os>-latest` - Darrera versió estable de Zabbix en el sistema operatiu seleccionat - `<os>-trunk` - Darrer desenvolupament (per nit) construir sobre el sistema operatiu seleccionat - `<os>-X.X-latest` - Darrera versió menor de Zabbix d'una versió principal específica de Zabbix en el sistema operatiu seleccionat - `<os>-X.X. *` - Versió menor específica de Zabbix en el sistema operatiu seleccionat Exemples: ``bash # Darrer proxy estable de Zabbix (SQLite3) a Linux Alpine: docker pull zabbix/zabbix-proxy-sqlite3: últim # Darrer proxy estable de Zabbix (SQLite3) a Ubuntu: docker pull zabbix/zabbix-proxy-sqlite3:ubuntu-latest # Darrer desenvolupament (nit) construcció del servidor Zabbix (MySQL) en Ubuntu: docker pull zabbix/zabbix-server-mysql:ubuntu-trunk # Darrera versió menor de 6.0 del servidor Zabbix (MySQL) a Alpine Linux: docker pull zabbix/zabbix-server-mysql:alpine-6.0-latest # Versió 6.0.1 del servidor Zabbix (MySQL) a Alpine Linux: docker pull zabbix/zabbix-server-mysql:alpine-6.0.1 ``` ### Image The image object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageid|string|*(readonly)* ID of the image.| |**name**<br>(required)|string|Name of the image.| |imagetype|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Imatge L'objecte imatge té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |imageid|string|*(nomes lectura)* ID de l'imatge.| |**name**<br>(obligatori)|string|Nom de l'imatge.| |imagetype|integer|Tipus d'imatge.<br><br>Valors admesos:<br>1 - *(per defecte)* icona;<br>2 - imatge de fons.| Veieu que per alguns mètodes (actualitzar, esborrar), la combinació de paràmetres obligatoris o opcionals és diferent. # Image This class is designed to work with images. Object references: - [Image](/manual/api/reference/image/object#image) Available methods: - [image.create](/manual/api/reference/image/create) - create new images - [image.delete](/manual/api/reference/image/delete) - delete images - [image.get](/manual/api/reference/image/get) - retrieve images - [image.update](/manual/api/reference/image/update) - update images # Imatge Aquesta classe és dissenyada per treballar amb imatges. Referències d'objectes: - [Imatge](/manual/api/reference/image/object#image) Mètodes disponibles: - [image.create](/manual/api/reference/image/create) - crear nous imatges - [image.delete](/manual/api/reference/image/delete) - esborrar imatges - [image.get](/manual/api/reference/image/get) - recuperar imatges - [image.update](/manual/api/reference/image/update) - actualitzar imatges # image.update # image.update ### Implementation details The high availability (HA) cluster is an opt-in solution and it is supported for Zabbix server. The native HA solution is designed to be simple in use, it will work across sites and does not have specific requirements for the databases that Zabbix recognizes. Users are free to use the native Zabbix HA solution, or a third-party HA solution, depending on what best suits the high availability requirements in their environment. The solution consists of multiple zabbix\_server instances or nodes. Every node: - is configured separately - uses the same database - may have several modes: active, standby, unavailable, stopped Only one node can be active (working) at a time. A standby node runs only one process - the HA manager. A standby node does no data collection, processing or other regular server activities; they do not listen on ports; they have minimum database connections. Both active and standby nodes update their last access time every 5 seconds. Each standby node monitors the last access time of the active node. If the last access time of the active node is over 'failover delay' seconds, the standby node switches itself to be the active node and assigns 'unavailable' status to the previously active node. The active node monitors its own database connectivity - if it is lost for more than `failover delay-5` seconds, it must stop all processing and switch to standby mode. The active node also monitors the status of the standby nodes - if the last access time of a standby node is over 'failover delay' seconds, the standby node is assigned the 'unavailable' status. The nodes are designed to be compatible across minor Zabbix versions. ### Detalla de la implementació El clúster d'alta disponibilitat (HA) és una solució activada i és compatible amb el servidor Zabbix. La solució nadiua HA és dissenyada per ser senzilla d'emprar, funcionarà en tots els llocs i no té requisits específics per a les bases de dades reconegudes per Zabbix. Els usuaris poden emprar la solució nadiua de Zabbix HA o una solució de tercers, la que s'adapti millor als requisits d'alta disponibilitat del seu entorn. La solució consta de múltiples instàncies o nodes zabbix\_server. Cada node: - es configura per separat - empra la mateixa base de dades - pot tindre diversos modes: actiu, en espera, no disponible, aturat Només un node pot ésser actiu alhora. Un node d'espera només executa un procés: el gestor d'HA. Un node en espera no fa la recollida de dades, el processament ni altres activitats normals del servidor, ni escolta els ports; té connexions de base de dades mínimes. Els nodes actius i en espera actualitzen el seu darrer temps d'accés cada 5 segons. Cada node d'espera monitora el darrer moment d'accés del node actiu. Si el darrer moment d'accés del node actiu és superior als segons de "temps d'espera de commutació per error", el node en espera es converteix en el node actiu i assigna l'estat "no disponible" al node anteriorment actiu. El node actiu controla la seva pròpia connectivitat a la base de dades: si es perd durant més de `delay de failover-5` segons, hauria d'aturar tot el processament i passar al mode d'espera. El node actiu també monitora l'estat dels nodes en espera: si el darrer temps d'accés d'un node en espera supera els segons de "temps d'espera per a errors", al node en espera se li assigna l'estat "no disponible". Els nodes són dissenyats per ésser compatibles amb versions menors de Zabbix. #### Important notes - All [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) items are disabled by default (even when `DenyKey` is empty), as if `DenyKey=system.run[*]` was set as the [last rule](#allowdeny-rule-order). Because of this, you can allow specific `system.run` items without explicitly denying other `system.run` items. - An item specified in `AllowKey` must also be specified in `DenyKey` (except for `system.run` items); otherwise, Zabbix agent **will not start**. - If possible, use `AllowKey` to allow only required items and deny everything else. Some keys can be abused to read unintended files via path traversal (e.g., `vfs.file.contents["../../../../etc/passwd"]`), and new Zabbix agent versions may introduce keys not covered by your `DenyKey` rules. - `AllowKey` and `DenyKey` configuration does not affect `HostnameItem`, `HostMetadataItem`, or `HostInterfaceItem` agent parameters. - Denied items become unsupported without any hints or error messages; for example: - Zabbix agent [`--print (-p)`](/manual/concepts/agent#other-agent-options) command-line parameter will not show denied item keys. - Zabbix agent [`--test (-t)`](/manual/concepts/agent#other-agent-options) command-line parameter will return "Unsupported item key." for denied item keys. - Zabbix agent log file will not log denied [remote commands](/manual/config/notifications/action/operation/remote_command) if `LogRemoteCommands=1`. #### Notes importants - Tots els elements de [`system.run`](/manual/config/items/itemtypes/zabbix_agent#system-data) són desactivats per defecte (fins i tot quan `DenyKey` està buit), com si `DenyKey=system.run[*]` s'hagués definit com a [última regla](#allowdeny-rule-order). Per això, podeu permetre elements específics de `system.run` sense denegar explícitament altres elements de `system.run`. - Un element especificat a `AllowKey` també s'ha d'especificar a `DenyKey` (excepte els elements de `system.run`); en cas contrari, l'agent Zabbix **no s'iniciarà**. - Si és possible, utilitzeu `AllowKey` per permetre només els elements necessaris i denegar tota la resta. Algunes claus es poden fer un ús indegut per llegir fitxers no desitjats mitjançant el recorregut de ruta (per exemple, `vfs.file.contents["../../../../etc/passwd"]`), i les noves versions de l'agent Zabbix poden introduir claus no cobertes per les vostres regles `DenyKey`. - La configuració d'`AllowKey` i `DenyKey` no afecta els paràmetres de l'agent `HostnameItem`, `HostMetadataItem` o `HostInterfaceItem`. - Els elements denegats esdevenen no compatibles sense cap suggeriment ni missatge d'error; per exemple: - El paràmetre de línia d'ordres de l'agent Zabbix [`--print (-p)`](/manual/concepts/agent#other-agent-options) no mostrarà les claus d'element denegades. - El paràmetre de línia d'ordres de l'agent Zabbix [`--test (-t)`](/manual/concepts/agent#other-agent-options) retornarà "Clau d'element no compatible." per a les claus d'element denegades. - El fitxer de registre de l'agent Zabbix no registrarà les [ordres remotes] denegades (/manual/config/notifications/action/operation/remote_command) si `LogRemoteCommands=1`. #### Important notes - Database monitoring items will become unsupported if no *odbc poller* processes are started in the server or proxy configuration. To activate ODBC pollers, set *StartODBCPollers* parameter in Zabbix [server](/manual/appendix/config/zabbix_server) configuration file or, for checks performed by proxy, in Zabbix [proxy](/manual/appendix/config/zabbix_proxy) configuration file. - Zabbix does not limit the query execution time. It is up to the user to choose queries that can be executed in a reasonable amount of time. - The [Timeout](/manual/appendix/config/zabbix_server) parameter value from Zabbix server is used as the ODBC login timeout (note that depending on ODBC drivers the login timeout setting might be ignored). - The SQL command must return a result set like any query with `select ...`. The query syntax will depend on the RDBMS which will process them. The syntax of request to a storage procedure must be started with `call` keyword. #### Notes importants - Els elements de monitoratge de la base de dades no seran compatibles si no s'inicia cap procés *odbc poller* a la configuració del servidor o del proxy. Per habilitar els enquestadors ODBC, configureu el paràmetre *StartODBCPollers* al fitxer de configuració del [servidor](/manual/appendix/config/zabbix_server) Zabbix o, per a comprovacions de proxy, al [proxy](/ manual/appendix/config/zabbix_proxy) Zabbix. - Zabbix no limita el temps d'execució de consultes. Correspon a l'usuari triar les consultes que es puguin executar en un temps raonable. - El valor del paràmetre [Timeout](/manual/appendix/config/zabbix_server) del servidor Zabbix s'empra com a temps d'espera de connexió ODBC (tingueu en compte que el paràmetre de temps d'espera de connexió dels controladors ODBC es pot ignorar). - L'ordre SQL ha de retornar un conjunt de resultats com qualsevol consulta amb `select ...`. La sintaxi de les peticions dependrà de l'RDBMS, que les processarà. La sintaxi de consulta d'un procediment d'emmagatzematge s'ha d'iniciar amb la paraula clau `call`. #### Important notes - If more than one user macro with context exists, Zabbix will try to match the simple context macros first and then context macros with regular expressions in an undefined order. ::: notewarning Do not create different context macros matching the same string to avoid undefined behavior. ::: - If a macro with its context is not found on host, linked templates or globally, then the macro without context is searched for. - Only low-level discovery macros are supported in the context. Any other macros are ignored and treated as plain text. Technically, macro context is specified using rules similar to [item key](/manual/config/items/item/key) parameters, except macro context is not parsed as several parameters if there is a `,` character: - Macro context must be quoted with `"` if the context contains a `}` character or starts with a `"` character. Quotes inside quoted context must be escaped with the `\` character. - The `\` character itself is not escaped, which means it's impossible to have a quoted context ending with the `\` character - the macro {$MACRO:"a:\\b\\c\\"} is invalid. - The leading spaces in context are ignored, the trailing spaces are not: - For example {$MACRO:A} is the same as {$MACRO: A}, but not {$MACRO:A }. - All spaces before leading quotes and after trailing quotes are ignored, but all spaces inside quotes are not: - Macros {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } and {$MACRO: "A" } are the same, but macros {$MACRO:"A"} and {$MACRO:" A "} are not. The following macros are all equivalent, because they have the same context: {$MACRO:A}, {$MACRO: A} and {$MACRO:"A"}. This is in contrast with item keys, where 'key\[a\]', 'key\[ a\]' and 'key\["a"\]' are the same semantically, but different for uniqueness purposes. #### Notes importants - Si hi ha diverses macros d'usuari amb context, Zabbix mirarà de fer coincidir macros de context simples primer, després macros de context amb expressions regulars en ordre no definit. ::: notewarning No creeu macros de context diferents que coincideixin amb la mateixa cadena per evitar un comportament no definit. ::: - Si una macro amb el seu context no es troba a l'equip, en models enllaçats o globalment, es cerca la macro sense context. - Només s'admeten macros de descoberta de baix nivell en context. La resta de macros s'ignoren i es tracten com a text sense format. Tècnicament, el context de la macro s'especifica mitjançant regles similars als paràmetres [clau d'element](/manual/config/items/item/key), excepte que el context de la macro no s'analitzi com a paràmetres múltiples per haver-hi un caràcter `,`: - El context de la macro s'ha de citar amb `"` si el context conté un caràcter `}` o comença amb un caràcter `"`. Les cometes dins del context citat s'han d'escapar amb el caràcter `\`. - El caràcter `\` en si no s'escapa, la qual cosa significa que és impossible tindre un context entre cometes que acabi amb el caràcter `\` - la macro {$MACRO:"a:\\ b\\c\\"} és invàlid. - Els espais inicials en el context s'ignoren, els espais finals no són: - Per exemple {\$MACRO:A} és idèntic a {\$MACRO:A}, però no a {$MACRO:A }. - Tots els espais abans de les cometes inicials i després de les cometes finals s'ignoren, però tots els espais dins de les cometes no ho són: - Les macros {\$MACRO:"A"}, {\$MACRO: "A"}, {\$MACRO:"A" } i {\$MACRO: "A" } són idèntiques, però les macros {\ $MACRO:"A"} i {\$MACRO:"A"} no ho són. Les macros següents són equivalents perquè tenen el mateix context: {\$MACRO:A}, {\$MACRO:A} i {\$MACRO:"A"}. Això contrasta amb les claus d'element, on "clau\[a\]", "clau\[a\]" i "clau\["a"\]" són semànticament iguals, però diferents per a finalitats d'unicitat. #### Important notes - The server and agent keep the trace of a monitored log's size and last modification time (for logrt) in two counters. Additionally: - The agent also internally uses inode numbers (on UNIX/GNU/Linux), file indexes (on Microsoft Windows) and MD5 sums of the first 512 log file bytes for improving decisions when logfiles get truncated and rotated. - On UNIX/GNU/Linux systems it is assumed that the file systems where log files are stored report inode numbers, which can be used to track files. - On Microsoft Windows Zabbix agent determines the file system type the log files reside on and uses: - On NTFS file systems 64-bit file indexes. - On ReFS file systems (only from Microsoft Windows Server 2012) 128-bit file IDs. - On file systems where file indexes change (e.g. FAT32, exFAT) a fall-back algorithm is used to take a sensible approach in uncertain conditions when log file rotation results in multiple log files with the same last modification time. - The inode numbers, file indexes and MD5 sums are internally collected by Zabbix agent. They are not transmitted to Zabbix server and are lost when Zabbix agent is stopped. - Do not modify the last modification time of log files with 'touch' utility, do not copy a log file with later restoration of the original name (this will change the file inode number). In both cases the file will be counted as different and will be analyzed from the start, which may result in duplicated alerts. - If there are several matching log files for `logrt[]` item and Zabbix agent is following the most recent of them and this most recent log file is deleted, a warning message `"there are no files matching "<regexp mask>" in "<directory>"` is logged. Zabbix agent ignores log files with modification time less than the most recent modification time seen by the agent for the `logrt[]` item being checked. - The agent starts reading the log file from the point it stopped the previous time. - The number of bytes already analyzed (the size counter) and last modification time (the time counter) are stored in the Zabbix database and are sent to the agent to make sure the agent starts reading the log file from this point in cases when the agent is just started or has received items which were previously disabled or not supported. However, if the agent has received a non-zero size counter from server, but the logrt\[\] or logrt.count\[\] item is unable to find matching files, the size counter is reset to 0 to analyze from the start if the files appear later. - Whenever the log file becomes smaller than the log size counter known by the agent, the counter is reset to zero and the agent starts reading the log file from the beginning taking the time counter into account. - If there are several matching files with the same last modification time in the directory, then the agent tries to correctly analyze all log files with the same modification time and avoid skipping data or analyzing the same data twice, although it cannot be guaranteed in all situations. The agent does not assume any particular log file rotation scheme nor determines one. When presented multiple log files with the same last modification time, the agent will process them in a lexicographically descending order. Thus, for some rotation schemes the log files will be analyzed and reported in their original order. For other rotation schemes the original log file order will not be honored, which can lead to reporting matched log file records in altered order (the problem does not happen if log files have different last modification times). - Zabbix agent processes new records of a log file once per *Update interval* seconds. - Zabbix agent does not send more than **maxlines** of a log file per second. The limit prevents overloading of network and CPU resources and overrides the default value provided by **MaxLinesPerSecond** parameter in the [agent configuration file](/manual/appendix/config/zabbix_agentd). - To find the required string Zabbix will process 10 times more new lines than set in MaxLinesPerSecond. Thus, for example, if a `log[]` or `logrt[]` item has *Update interval* of 1 second, by default the agent will analyze no more than 200 log file records and will send no more than 20 matching records to Zabbix server in one check. By increasing **MaxLinesPerSecond** in the agent configuration file or setting **maxlines** parameter in the item key, the limit can be increased up to 10000 analyzed log file records and 1000 matching records sent to Zabbix server in one check. If the *Update interval* is set to 2 seconds the limits for one check would be set 2 times higher than with *Update interval* of 1 second. - Additionally, log and log.count values are always limited to 50% of the agent send buffer size, even if there are no non-log values in it. So for the **maxlines** values to be sent in one connection (and not in several connections), the agent [BufferSize](/manual/appendix/config/zabbix_agentd) parameter must be at least maxlines x 2. Zabbix agent can upload data during log gathering and thus free the buffer, whereas Zabbix agent 2 will stop log gathering until the data is uploaded and the buffer is freed, which is performed asynchronously. - In the absence of log items all agent buffer size is used for non-log values. When log values come in they replace the older non-log values as needed, up to the designated 50%. - For log file records longer than 256kB, only the first 256kB are matched against the regular expression and the rest of the record is ignored. However, if Zabbix agent is stopped while it is dealing with a long record the agent internal state is lost and the long record may be analyzed again and differently after the agent is started again. - Special note for "\\" path separators: if file\_format is "file\\.log", then there should not be a "file" directory, since it is not possible to unambiguously define whether "." is escaped or is the first symbol of the file name. - Regular expressions for `logrt` are supported in filename only, directory regular expression matching is not supported. - On UNIX platforms a `logrt[]` item becomes NOTSUPPORTED if a directory where the log files are expected to be found does not exist. - On Microsoft Windows, if a directory does not exist the item will not become NOTSUPPORTED (for example, if directory is misspelled in item key). - An absence of log files for `logrt[]` item does not make it NOTSUPPORTED. Errors of reading log files for `logrt[]` item are logged as warnings into Zabbix agent log file but do not make the item NOTSUPPORTED. - Zabbix agent log file can be helpful to find out why a `log[]` or `logrt[]` item became NOTSUPPORTED. Zabbix can monitor its agent log file, except when at DebugLevel=4 or DebugLevel=5. - Searching for a question mark using a regular expression, e.g. `\?` may result in false positives if the text file contains NUL symbols, as those are replaced with "?" by Zabbix to continue processing the line until the newline character. #### Notes importants - El servidor i l'agent fan un seguiment de la mida d'un registre monitorat i modificat durant la darrera hora (per al logrt) a dos comptadors. Addicionalment: - L'agent també empra internament nombres d'inode (a UNIX/GNU/Linux), índexs de fitxers (a Microsoft Windows) i sumes MD5 dels primers 512 octets de fitxers de registre per millorar les decisions quan els fitxers de registre es trunquen i giren. - Als sistemes UNIX/GNU/Linux, se suposa que els sistemes de fitxers on s'emmagatzemen els fitxers de registre retornen nombres d'inode, que es poden emprar per fer un seguiment dels fitxers. - A Microsoft Windows, l'agent Zabbix determina el tipus de sistema de fitxers on resideixen els fitxers de registre i empra: - En sistemes de fitxers NTFS indexa fitxers de 64 bits. - En sistemes de fitxers ReFS (només des de Microsft Windows Server 2012) ID de fitxer de 128 bits. - En sistemes de fitxers on els índexs de fitxers canvien (per exemple, FAT32, exFAT) s'empra un algorisme de reserva per adoptar un enfocament raonable en condicions incertes quan la rotació del fitxer de registre dóna lloc a diversos fitxers de registre amb el mateix temps de modificació. - Els nombres d'inode, els índexs de fitxers i les sumes MD5 es recullen internament per l'agent Zabbix. No es transmeten al servidor Zabbix i es perden quan s'atura l'agent Zabbix. - No modifiqueu l'hora de la darrera modificació dels fitxers de registre amb la utilitat 'touch', no recupereu un fitxer de registre conservant el seu nom original (això canviarà el nombre d'inode del fitxer). En qualsevol dels casos, el fitxer es considerarà diferent i s'escanejarà des del principi, la qual cosa pot generar alertes duplicades. - Si hi ha diversos fitxers de registre coincidents per a l'element ''logrt[]'' i l'agent de Zabbix fa un seguiment del més recent d'ells i s'esborra aquest fitxer de registre més recent, s'envia al registre un missatge d'avís ''"no hi ha cap fitxer que coincideixi"<regexp màscara>" a "<directori>"''. L'agent Zabbix ignora els fitxers de registre el temps de modificació dels quals és inferior al temps de modificació més recent vist per l'agent per a l'element ''logrt[]'' que s'està comprovant. - L'agent comença a llegir el fitxer de registre des de quan es va aturar la vegada anterior. - El nombre d'octets ja escanejats (el comptador de mida) i la darrera modificació (el comptador de temps) s'emmagatzemen a la base de dades de Zabbix i s'envien a l'agent per assegurar que l'agent comença a llegir el fitxer de registre des d'aquesta ubicació en cas que l'agent acabi d'iniciar-se o hagi rebut elements desactivats o no compatibles. Tanmateix, si l'agent va rebre un comptador de mida diferent de zero del servidor, però l'element logrt[] o logrt.count[] no s'ha trobat i no ha trobat cap fitxer coincident, el comptador de mida es restablirà a 0 si els fitxers apareixen més tard. - Cada cop que el fitxer de registre sigui més petit que el comptador de mida del fitxer de registre conegut per l'agent, el comptador es reinicia i l'agent comença a llegir el fitxer de registre des del principi tinguent en compte el comptador de temps. - Si al directori hi ha diversos fitxers corresponents amb el mateix temps de modificació, l'agent analitza tots els fitxers de registre amb el mateix temps de modificació i evita saltar dades o analitzar les mateixes dades dues vegades, encara que això no es pot garantir. L'agent no assumeix cap esquema de rotació de fitxers de registre particular i no en determina cap. Quan es presenten diversos fitxers de registre amb la mateixa hora de darrera modificació, l'agent els processa en ordre lexicogràfic descendent. Així, per a determinats esquemes de rotació, els fitxers de registre s'analitzaran i s'informaran en el seu ordre original. Per a altres esquemes de rotació, no es respectarà l'ordre dels fitxers de registre originals, fet que pot provocar que es generin informes als fitxers de registre corresponents (el problema no es produeix si els fitxers de registre tenen diferents temps de modificació). - L'agent Zabbix processa nous registres de fitxers de registre una vegada per //interval d'actualització// segons. - L'agent Zabbix no envia més d'un fitxer de registre **maxlines** per segon. El límit evita la sobrecàrrega de recursos de la xarxa i de la CPU i anul·la el valor predeterminat proporcionat pel paràmetre **MaxLinesPerSecond** al fitxer de configuració de l'agent](/manual/appendix/config/zabbix_agentd). - Per trobar la cadena necessària, Zabbix processarà 10 vegades més noves línies que a MaxLinesPerSecond. Per exemple, si un element `log[]` o `logrt[]` té un *interval d'actualització* d'1 segon, l'agent no analitzarà, de manera predeterminada, més de 200 registres de fitxers de registre i no enviarà més de 20 registres coincidents al servidor Zabbix en una sola comprovació. Augmentant **MaxLinesPerSecond** al fitxer de configuració de l'agent o establint el paràmetre **maxlines** a la clau d'element, el límit es pot augmentar fins a 10.000 registres de fitxer de registre escanejats i 1.000 registres coincidents enviats al servidor Zabbix en una sola comprovació. Si l'*interval d'actualització* s'estableix a 2 segons, els límits d'una comprovació s'establiran 2 vegades més que amb l'*interval d'actualització* d'1 segon. - A més, els valors de log i log.count sempre són limitats al 50% de la mida del buffer d'enviament de l'agent, fins i tot si no hi ha valors que no siguin de registre. Per tant, perquè els valors de **maxlines** s'enviïn en una connexió (i no en diverses connexions), el paràmetre [BufferSize](/manual/appendix/config/zabbix_agentd) de l'agent ha d'ésser com a mínim maxlines x 2. - Si no hi ha elements de registre, s'empra tota la mida del buffer de l'agent per als valors que no són de registre. Quan arriben els valors dels fitxers de registre, sobreescriuen els valors antics que no són de registre, segons sigui necessari, fins a un 50%. - Per als registres de fitxers de registre més grans de 256 Ko, només els primers 256Ko coincideixen amb l'expressió regular i la resta del registre s'ignora. Tanmateix, si l'agent Zabbix s'atura mentre processa un registre llarg, l'estat intern de l'agent es perd i el registre llarg es pot analitzar de nou i de manera diferent després de reiniciar l'agent. - Nota especial per als separadors de camins "\\": si filer\_format és "file\.log", no hi ha d'haver un directori "file" perquè és impossible definir sense ambigüitats si "." s'escapa o és el primer símbol del nom del fitxer. - Les expressions regulars per a `logrt` només s'admeten al nom de fitxer, la concordança d'expressions regulars del directori no és compatible. - A les plataformes UNIX, `logrt[]` passa a NO ADMÈS si no existeix un directori on s'hi han de trobar els fitxers de registre. - A Microsoft Windows, si un directori no existeix, l'element no passarà a NO ADMÈS (per exemple, si el directori s'ha escrit malament a la clau de l'element). - L'absència de fitxers de registre per a `logrt[]` no fa que NO S'ADMETI. Els errors de lectura dels fitxers de registre per a `logrt[]` es registren com a avisos al fitxer de registre de l'agent Zabbix, però no mostren l'element NO ADMÈS. - El fitxer de registre de l'agent Zabbix pot ésser útil per sapiguer per què un element `log[]` o `logrt[]` no s'admet. Zabbix pot monitorar el fitxer de registre de l'agent excepte a DebugLevel=4 o DebugLevel=5. - Buscar un signe d'interrogació mitjançant una expressió regular, com ara `\?` pot donar lloc a falsos positius si el fitxer de text conté símbols NUL, ja que es substitueixen per "?" per Zabbix per continuar processant la línia fins al caràcter de nova línia. ### Important notes To perform the database upgrade: 1. Stop Zabbix server. Stopping Zabbix server for the time of the upgrade is strongly recommended. However, if absolutely necessary, you can perform the upgrade while the server is running (only for MySQL, MariaDB, and PostgreSQL without TimescaleDB). 2. Back up your database. 3. Run the scripts for your database. 4. Start Zabbix server. ::: notewarning Run the scripts for the server database only. The proxy will not benefit from this upgrade. ::: If the database uses partitions, contact the DB administrator or Zabbix Support for help. CSV files can be removed after a successful upgrade to primary keys. Optionally, Zabbix frontend may be switched to [maintenance mode](/manual/web_interface/maintenance_mode). ### Notes importants Per fer l'actualització de la base de dades: 1. Atureu el servidor Zabbix. Es recomana aturar el servidor Zabbix durant el moment de l'actualització. Tanmateix, si és absolutament necessari, podeu fer l'actualització mentre el servidor és engegat (només per a MySQL, MariaDB i PostgreSQL sense TimescaleDB). 2. Feu una còpia de seguretat de la vostra base de dades. 3. Executeu els scripts de la vostra base de dades. 4. Inicieu el servidor Zabbix. ::: notewarning Executeu els scripts només per a la base de dades del servidor. El proxy no es beneficiarà d'aquesta actualització. ::: Si la base de dades té particions, poseu-vos en contacte amb l'administrador de la base de dades o amb el suport de Zabbix per obtindre ajuda. Els fitxers CSV es poden esborrar després d'una actualització correcta a les claus primàries. Opcionalment, la interfície Zabbix es pot canviar a [mode de manteniment](/manual/web_interface/maintenance_mode). #### Importing a template Import the template configuration contained in the XML string. If any items or triggers in the XML string are missing, they will be deleted from the database, and everything else will be left unchanged. Request: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></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 '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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### Importar una plantilla Importa la configuració d'un model contingut a la cadena XML. Si manquen elements o triggers de la cadena XML, s'esborraran de la base de dades i la resta es mantindrà sense canvis. Consulta: ```json { "jsonrpc": "2.0", "method": "configuration.import", "params": { "format": "xml", "rules": { "templates": { "createMissing": true, "updateExisting": true }, "items": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "triggers": { "createMissing": true, "updateExisting": true, "deleteMissing": true }, "valueMaps": { "createMissing": true, "updateExisting": false } }, "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>6.0</version><date>2023-01-01T12:00:00Z</date><groups><group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></group></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><dt>Server uptime: (.*)</dt></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)>2</expression><name>CPU load 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" }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ##### Importing data Import initial schema: cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Importació de dades Importeu l'esquema inicial: cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix Per un proxy amb PostgreSQL (o SQLite) : cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Importing data Import initial schema: cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix For proxy with PostgreSQL (or SQLite): cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db ##### Importació de dades Importeu l'esquema inicial: cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix Per un proxy amb PostgreSQL (o SQLite) : cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db #### Importing data Now import initial schema and data for the **server** with MySQL: zcat /usr/share/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix You will be prompted to enter your newly created database password. With PostgreSQL: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix With TimescaleDB, in addition to the previous command, also run: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u <username> psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: For proxy, import initial schema: zcat /usr/share/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix For proxy with PostgreSQL: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix #### Importació de dades Ara importeu l'esquema inicial i les dades del **servidor** amb MySQL: # zcat /usr/share/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix Se us demanarà que introduïu el mot de pas de la base de dades que acabeu de crear. Amb PostgreSQL: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix Amb TimescaleDB, a més de l'ordre anterior, executeu també: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/timescaledb.sql.gz | sudo -u <username> psql zabbix ::: notewarning TimescaleDB només és compatible amb el servidor Zabbix. ::: Per al proxy, importeu l'esquema inicial: zcat /usr/share/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix Per al proxy amb PostgreSQL: zcat /usr/share/packages/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix #### Importing data with Timescale DB With TimescaleDB, in addition to the import command for PostgreSQL, also run: cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### Importació de dades amb Timescale DB Amb TimescaleDB afegida a la comanda d'importació per a PostgreSQL, executeu també: cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB s'admet només amb el servidor Zabbix. ::: #### Importing data with Timescale DB With TimescaleDB, in addition to the import command for PostgreSQL, also run: cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB is supported with Zabbix server only. ::: #### Importació de dades amb Timescale DB Amb TimescaleDB afegida a la comanda d'importació per a PostgreSQL, executeu també: cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix ::: notewarning TimescaleDB s'admet només amb el servidor Zabbix. ::: #### Importing To import hosts, do the following: - Go to: *Configuration* → *Hosts* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.<br>If *Delete missing* is marked for template linkage, existing template linkage not present in the import file will be unlinked. Since Zabbix 6.0.13, entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).| #### Importació Per importar equips, feu el següent: - Aneu a: *Configuració* → *Equips* - Feu clic a *Importar* a la dreta - Trieu el fitxer a importar - Comproveu les opcions requerides a les regles d'importació - Feu clic a *Importar*  A la interfície veureu un missatge d'èxit o error d'importació. Regles d'importació: |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb les dades extretes del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crear nou*|La importació afegirà nous elements emprant les dades del fitxer d'importació. En cas contrari, no els afegirà.| |*Esborrar absents*|La importació esborrarà els elements existents que no són presents al fitxer d'importació. En cas contrari, no els esborrarà pas.<br>Si es marca *Esborra el que manca* per a l'enllaç de plantilles, es desenllaçarà l'enllaç de plantilles existent que no sigui present al fitxer d'importació. Des de Zabbix 6.0.13, les entitats (elements, triggers, gràfics, etc.) heretades de les plantilles no enllaçades no s'esborraran pas (tret que l'opció *Esborra el que manca* també sigui triada per a cada entitat).| #### Importing To import media types, do the following: - Go to: *Administration* → *Media types* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise it will not remove them.| #### Importació Per importar tipus de suport, feu el següent: - Anar a: *Administració* → *Tipus de suport* - Feu clic a *Importar* a la dreta - Trieu el fitxer a importar - Comproveu les opcions requerides a les regles d'importació - Feu clic a *Importar*  A la interfície veureu un missatge d'èxit o error d'importació. Regles d'importació: |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb les dades extretes del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crear nou*|La importació afegirà nous elements emprant les dades del fitxer d'importació. En cas contrari, no els afegirà.| |*Esborrar absents*|La importació esborrarà els elements existents que no són presents al fitxer d'importació. En cas contrari, no els esborrarà pas.| #### Importing To import network maps, do the following: - Go to: *Monitoring* → *Maps* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  All mandatory input fields are marked with a red asterisk. A success or failure message of the import will be displayed in the frontend. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated with data taken from the import file. Otherwise they will not be updated.| |*Create new*|The import will add new maps using data from the import file. Otherwise it will not add them.| If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to Super Admin users. ::: notewarning If replacing an existing image, it will affect all maps that are using this image. ::: #### Importació Per importar mapes de xarxa, feu el següent: - Aneu a: *Monitoratge* → *mapes* - Feu clic a *Importar* a la dreta - Trieu el fitxer a importar - Comproveu les opcions requerides a les regles d'importació - Feu clic a *Importar*  Tots els camps obligatoris són marcats amb un asterisc vermell. A la interfície es veurà un missatge d'èxit o error d'importació. Regles d'importació: |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb les dades extretes del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crear nou*|La importació afegirà nous elements emprant les dades del fitxer d'importació. En cas contrari, no els afegirà.| |*Esborra els absents*|La importació esborrarà els elements existents que no són presents al fitxer d'importació. En cas contrari, no els esborrarà.| Si desmarqueu les dues opcions del mapa i marqueu les opcions respectives per a les imatges, només s'importaran les imatges. La importació d'imatges només és disponible per als usuaris superadministradors. ::: notewarning Si sobreescriu una imatge existent, afectarà totes les targes que empren aquesta imatge. ::: #### Importing To import templates, do the following: - Go to: *Configuration* → *Templates* - Click on *Import* to the right - Select the import file - Mark the required options in import rules - Click on *Import*  All mandatory input fields are marked with a red asterisk. Import rules: |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated with data taken from the import file. Otherwise, they will not be updated.| |*Create new*|The import will add new elements using data from the import file. Otherwise, it will not add them.| |*Delete missing*|The import will remove existing elements not present in the import file. Otherwise, it will not remove them.<br>If *Delete missing* is marked for template linkage, existing template linkage not present in the import file will be unlinked. Since Zabbix 6.0.13, entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).| On the next screen, you will be able to view the content of a template being imported. If this is a new template all elements will be listed in green. If updating an existing template, new template elements are highlighted in green; removed template elements are highlighted in red; elements that have not changed are listed on a gray background. {width="600"} The menu on the left can be used to navigate through the list of changes. Section *Updated* highlights all changes made to existing template elements. Section *Added* lists new template elements. The elements in each section are grouped by element type; press on the gray arrow down to expand or collapse the group of elements.  Review template changes, then press *Import* to perform template import. A success or failure message of the import will be displayed in the frontend. #### Importació Per importar plantilles, feu el següent: - Anar a: *Configuració* → *Plantilles* - Feu clic a *Importar* a la dreta - Trieu el fitxer d'importació - Marqueu les opcions requerides a les regles d'importació - Feu clic a *Importar*  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Regles d'importació: |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb les dades extretes del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crear nou*|La importació afegirà nous elements emprant les dades del fitxer d'importació. En cas contrari, no els afegirà.| |*Esborra el que manca*|La importació esborrarà els elements existents que no són presents al fitxer d'importació. En cas contrari, no els esborrarà pas.<br>Si es marca *Esborra el que manca* per a l'enllaç de plantilles, es desenllaçarà l'enllaç de plantilles existent que no sigui present al fitxer d'importació. Des de Zabbix 6.0.13, les entitats (elements, triggers, gràfics, etc.) heretades de les plantilles no enllaçades no s'esborraran pas (tret que l'opció *Esborra el que manca* també sigui triada per a cada entitat).| A la pantalla següent, podreu veure el contingut d'una plantilla que s'és important. Si aquesta és una plantilla nova, tots els elements es veuran en verd. Si actualitzeu una plantilla existent, els nous elements de plantilla es ressalten en verd; els elements de plantilla esborrats es destaquen en vermell; els elements que no han canviat es veuen sobre fons gris. {width="600"} El menú de l'esquerra es pot emprar per navegar per la llista de canvis. La secció *Actualitzat* destaca tots els canvis fets als elements de la plantilla existents. La secció *Afegit* enumera els nous elements de plantilla. Els elements de cada secció s'agrupen per tipus d'element; premeu la fletxa grisa cap avall per ampliar o reduir el grup d'elements.  Reviseu els canvis de plantilla i, a continuació, premeu *Importar* per importar la plantilla. Es veurà un missatge d'èxit o fracàs de la importació a la interfície. ### Improved performance of history syncers The performance of history syncers has been improved by introducing a new read-write lock. This reduces locking between history syncers, trappers and proxy pollers by using a shared read lock while accessing the configuration cache. The new lock can be write locked only by the configuration syncer performing a configuration cache reload. ### Rendiment millorat dels sincronitzadors d'historial El rendiment dels sincronitzadors d'historial s'ha millorat amb la introducció d'un nou bloqueig de lectura-escriptura. Això redueix el bloqueig entre els sincronitzadors d'historial, els trappers i els enquestadors de proxy mitjançant l'ús d'un bloqueig de lectura compartit quan s'accedeix a la memòria cau de configuració. El nou bloqueig només es pot blocar per escriptura pel sincronitzador de configuració que realitza una recàrrega de la memòria cau de configuració. ### Improved performance of history syncers The performance of history syncers has been improved by introducing a new read-write lock. This reduces locking between history syncers, trappers and proxy pollers by using a shared read lock while accessing the configuration cache. The new lock can be write locked only by the configuration syncer performing a configuration cache reload. ### Rendiment millorat dels sincronitzadors d'historial El rendiment dels sincronitzadors d'historial s'ha millorat amb la introducció d'un nou bloqueig de lectura-escriptura. Això redueix el bloqueig entre els sincronitzadors d'historial, els trappers i els enquestadors de proxy mitjançant l'ús d'un bloqueig de lectura compartit quan s'accedeix a la memòria cau de configuració. El nou bloqueig només es pot blocar per escriptura pel sincronitzador de configuració que realitza una recàrrega de la memòria cau de configuració. ##### In accepting-side log: ...failed to accept an incoming connection: from 127.0.0.1: support for TLS was not compiled in ##### Al registre del costat del servidor/proxy : ...no s'ha pogut acceptar una connexió entrant: a partir de 127.0.0.1: el suport per a TLS no s'ha compilat pas In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Host groups to display data for.| |*Hosts*|Hosts to display data for.| |*Host tags*|Specify tags to limit the number of hosts 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><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| |*Columns*|Add data [columns](#column-configuration) to display.<br>The column order determines their display from left to right.<br>Columns can be reordered by dragging up and down by the handle before the column name.| |*Order*|Specify the ordering of rows:<br>**Top N** - in descending order by the *Order column* aggregated value<br>**Bottom N** - in ascending order by the *Order column* aggregated value | |*Order column*|Specify the column from the defined *Columns* list to use for *Top N* or *Bottom N* ordering.| |*Host count*|Count of host rows to be shown (1-100).| A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Grups d'equips*|Grups d'equips dels quals ensenyar dades.| |*Equips*|Equips per a mostrar dades.| |*Etiquetes d'equip*|Especifiqueu etiquetes per limitar el nombre d'equips que es mostren al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br><br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou noms d'etiquetes especificats<br>**Es igual** - inclou noms i valors d'etiquetes especificats. ​​(distingue entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats quan els valors de les etiquetes contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou l'etiqueta especificada noms<br>**No són iguals** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br> **No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes , no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per la condició O<br>**O** - suficient si es compleix una condició| |*Columnes*|Afegiu dades [columnes](#column-configuration) per mostrar-les.<br>L'ordre de les columnes determina la seva visualització d'esquerra a dreta.<br>Les columnes es poden reordenar arrossegant cap amunt i cap avall per la nansa abans del nom de la columna.| |*Ordre*|Especifiqueu l'ordre de les fileres:<br>**N superior** - descendent per valor agregat *Columna ordenada*<br>**N inferior** - ascendent per valor agregat *Columna ordenada* | |*Columna ordenada*|Especifiqueu la columna de la llista *Columnes* definida per emprar-la per a la comanda *N superior* o *N inferior*.| |*Nombre d'equips*|Nombre de fileres d'equips a mostrar (1-100).| In addition to the parameters that are [common](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) for all widgets, you may set the following specific options: | | | |--|--------| |*Host groups*|Select host groups to be displayed on the map. 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 selected groups. <br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.| |*Hosts*|Select hosts to be displayed all the map. 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 selected hosts. <br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.| |*Tags*|Specify tags to limit the number of hosts 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| |*Initial view*|Comma-separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format `<latitude>,<longitude>,<zoom>`<br>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the [max zoom](/manual/web_interface/frontend_sections/administration/general#geographical_maps) for the particular tile provider.<br>The initial view is ignored if the default view is set (see below).<br>Examples:<br>=> 40.6892494,-74.0466891,14<br>=> 40.6892494,-122.0466891| A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets#common-parameters) per a tots els ginys, podeu establir les opcions específiques següents: | | | |--|---------| |*Grups d'equips*|Trieu els grups d'equips per mostrar al mapa. Aquest camp s'emplena automàticament, de manera que començant a escriure un nom de grup oferirà una llista desplegable de grups coincidents. Desplaceu-vos cap avall per triar. Feu clic a "x" per desmarcar els grups seleccionats. <br>Si no es tria res als camps *Grups d'equips* i *Equips*, es mostraran tots els equips amb coordenades vàlides.| |*Equips*|Trieu els equips per mostrar-los a tot el mapa. Aquest camp s'emplena automàticament, de manera que comenceu a escriure un nom d'equips oferirà una llista desplegable d'equips coincidents. Desplaceu-vos cap avall per triar. Feu clic a "x" per desmarcar els equips seleccionats. <br>Si no es tria res als camps *Grups d'equips* i *Equips*, es mostraran tots els equips amb coordenades vàlides.| |*Etiquetes*|Especifiqueu etiquetes per limitar el nombre d'equips que es mostren al giny. És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden definir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms i valors d'etiquetes especificats ​​(distingeix entre majúscules i minúscules)<br>**Conté** - inclou noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br >**No existeix** - exclou els valors especificats noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen les dades introduïdes cadena (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions amb el mateix nom d'etiqueta s'agruparan per condició O<br>**O** - suficient si es compleix una condició| |*Vista inicial*|Coordenades centrals separades per comes i un nivell de zoom opcional per mostrar quan el widget es carrega inicialment en el format `<latitud>,<longitud>,<zoom>`<br>Si s'especifica el zoom inicial, el widget Geomap es carrega al nivell de zoom donat. En cas contrari, el zoom inicial es calcula com la meitat del [zoom màxim](/manual/web_interface/frontend_sections/administration/general#geographical_maps) per al proveïdor de mosaics concret.<br>La vista inicial s'ignora si es defineix la vista predeterminada (veieu més avall).<br>Exemples:<br>=> 40,6892494,-74,0466891,14<br>=> 40,6892494,-122,0466891| In addition, Zabbix provides the zabbix-selinux-policy package as part of source RPM packages for [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) and [RHEL 7](http://repo.zabbix.com/zabbix/6.0/rhel/7/SRPMS/). This package provides a basic default policy for SELinux and makes zabbix components work out-of-the-box by allowing Zabbix to create and use sockets and enabling httpd connection to PostgreSQL (used by frontend). The source *zabbix_policy.te* file contains the following rules: module zabbix_policy 1.2; require { type zabbix_t; type zabbix_port_t; type zabbix_var_run_t; type postgresql_port_t; type httpd_t; class tcp_socket name_connect; class sock_file { create unlink }; class unix_stream_socket connectto; } #============= zabbix_t ============== allow zabbix_t self:unix_stream_socket connectto; allow zabbix_t zabbix_port_t:tcp_socket name_connect; allow zabbix_t zabbix_var_run_t:sock_file create; allow zabbix_t zabbix_var_run_t:sock_file unlink; allow httpd_t zabbix_port_t:tcp_socket name_connect; #============= httpd_t ============== allow httpd_t postgresql_port_t:tcp_socket name_connect; This package has been created to prevent users from turning off SELinux because of the configuration complexity. It contains the default policy that is sufficient to speed up Zabbix deployment and configuration. For maximum security level, it is recommended to set custom SELinux settings. A més, Zabbix proporciona el paquet zabbix-selinux-policy com a part dels paquets font RPM per a [RHEL 8](http://repo.zabbix.com/zabbix/6.0/rhel/8/SRPMS/) i [RHEL 7] (http://repo.zabbix.com/zabbix/6.0/rhel/7/SRPMS/). Aquest paquet proporciona una política bàsica per defecte per a SELinux i fa que els components de zabbix funcionin de manera immediata, permetent a Zabbix crear i emprar sòcols i habilitar la connexió httpd a PostgreSQL (emprada per la interfície). El fitxer d'origen *zabbix_policy.te* té les regles següents: module zabbix_policy 1.2; require { type zabbix_t; type zabbix_port_t; type zabbix_var_run_t; type postgresql_port_t; type httpd_t; class tcp_socket name_connect; class sock_file { create unlink }; class unix_stream_socket connectto; } #============= zabbix_t ============== allow zabbix_t self:unix_stream_socket connectto; allow zabbix_t zabbix_port_t:tcp_socket name_connect; allow zabbix_t zabbix_var_run_t:sock_file create; allow zabbix_t zabbix_var_run_t:sock_file unlink; allow httpd_t zabbix_port_t:tcp_socket name_connect; #============= httpd_t ============== allow httpd_t postgresql_port_t:tcp_socket name_connect; Aquest paquet s'ha creat per evitar que els usuaris tanquin SELinux a causa de la complexitat de la configuració. Conté la política predeterminada que és suficient per accelerar el desplegament i la configuració de Zabbix. Per obtindre el màxim nivell de seguretat, es recomana configurar la configuració personalitzada d'SELinux. ##### Incoming connections It is a bit more complicated with incoming connections because rules are specific for components and configuration. For Zabbix **agent**: |Agent connection setup|Cipher configuration| |----------------------|--------------------| |TLSConnect=cert|TLSCipherCert, TLSCipherCert13| |TLSConnect=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll, TLSCipherAll13| For Zabbix **server** and **proxy**: |Connection setup|Cipher configuration| |----------------|--------------------| |Outgoing connections using PSK|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using certificates|TLSCipherAll, TLSCipherAll13| |Incoming connections using PSK if server has no certificate|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using PSK if server has certificate|TLSCipherAll, TLSCipherAll13| Some pattern can be seen in the two tables above: - TLSCipherAll and TLSCipherAll13 can be specified only if a combined list of certificate- **and** PSK-based ciphersuites is used. There are two cases when it takes place: server (proxy) with a configured certificate (PSK ciphersuites are always configured on server, proxy if crypto library supports PSK), agent configured to accept both certificate- and PSK-based incoming connections - in other cases TLSCipherCert\* and/or TLSCipherPSK\* are sufficient The following tables show the `TLSCipher*` built-in default values. They could be a good starting point for your own custom values. |Parameter|GnuTLS 3.6.12| |--|--------| |TLSCipherCert|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |TLSCipherPSK|NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL| |TLSCipherAll|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |Parameter|OpenSSL 1.1.1d ^**1**^| |--|--------| |TLSCipherCert13|<| |TLSCipherCert|EECDH+aRSA+AES128:RSA+aRSA+AES128| |TLSCipherPSK13|TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256| |TLSCipherPSK|kECDHEPSK+AES128:kPSK+AES128| |TLSCipherAll13|<| |TLSCipherAll|EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128| ^**1**^ Default values are different for older OpenSSL versions (1.0.1, 1.0.2, 1.1.0), for LibreSSL and if OpenSSL is compiled without PSK support. **Examples of user-configured ciphersuites** See below the following examples of user-configured ciphersuites: - [Testing cipher strings and allowing only PFS ciphersuites](#testing_cipher_strings_and_allowing_only_pfs_ciphersuites) - [Switching from AES128 to AES256](#switching_from_aes128_to_aes256) ##### Connexions entrants És una mica més complicat amb les connexions entrants perquè les regles són específiques dels components i de la configuració. Per a l'**agent** Zabbix: |Configuració de connexió de l'agent|Configuració de xifrat| |----------------------|---------------------| |TLSConect=cert|TLSCipherCert,TLSCipherCert13| |TLSConect=psk|TLSCipherPSK,TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll,TLSCipherAll13| Per al **servidor** i **proxy** Zabbix: |Configuració de connexió|Configuració de xifrat| |----------------|---------------------| |Connexions sortints amb PSK|TLSCipherPSK, TLSCipherPSK13| |Connexions entrants amb certificats|TLSCipherAll, TLSCipherAll13| |Connexions entrants amb PSK si el servidor no té certificat|TLSCipherPSK, TLSCipherPSK13| |Connexions entrants amb PSK si el servidor té un certificat|TLSCipherAll, TLSCipherAll13| Alguns patrons es poden veure a les dues taules anteriors: - TLSCipherAll i TLSCipherAll13 només es poden especificar si s'empra una llista combinada de conjunts de xifrat **i** basats en PSK. Hi ha dos casos en què això passa: servidor (proxy) amb un certificat configurat (les suites de xifrat PSK sempre es configuren al servidor, i al proxy si la biblioteca de xifrat admet PSK), agent configurat per acceptar connexions entrants basades en certificat i PSK. - en altres casos TLSCipherCert\* i/o TLSCipherPSK\* són suficients Les taules següents mostren els valors predeterminats integrats de `TLSCipher*`. Poden ser un bon punt de partida per als vostres propis valors personalitzats. |Configuració|GnuTLS 3.6.12| |--|---------| |TLSCipherCert|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP -NULL:+SIGN-ALL:+CTYPE-X.509| |TLSCipherPSK|NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP -NULL:+SIGN-ALL| |TLSCipherAll|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1 :+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |Paràmetre|OpenSSL 1.1.1d ^**1**^| |--|---------| |TLSCipherCert13|<| |TLSCipherCert|EECDH+aRSA+AES128:RSA+aRSA+AES128| |TLSCipherPSK13|TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256| |TLSCipherPSK|kECDHEPSK+AES128:kPSK+AES128| |TLSCipherAll13|<| |TLSCipherAll|EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128| ^**1**^ Els valors per defecte són diferents per a les versions anteriors d'OpenSSL (1.0.1, 1.0.2, 1.1.0), per a LibreSSL i si OpenSSL es compila sense suport PSK. **Exemples de suites de xifrat configurades per l'usuari** Veieu els exemples següents de suites de xifrat configurades per l'usuari tot seguit: - [Provant les cadenes de xifrat i només permetent les suites de xifrat PFS](#testing_cipher_strings_and_allowing_only_pfs_ciphersuites) - [Canvi d'AES128 a AES256](#switching_from_aes128_to_aes256) ##### In connecting-side log: Linux: ...In zbx_tls_init_child() ...OpenSSL library (version OpenSSL 1.1.1 11 Sep 2018) initialized ... ...In zbx_tls_connect(): psk_identity:"PSK test sender" ...End of zbx_tls_connect():FAIL error:'connection closed by peer' ...send value error: TCP successful, cannot establish TLS to [[localhost]:10051]: connection closed by peer Windows: ...OpenSSL library (version OpenSSL 1.1.1a 20 Nov 2018) initialized ... ...In zbx_tls_connect(): psk_identity:"PSK test sender" ...zbx_psk_client_cb() requested PSK identity "PSK test sender" ...End of zbx_tls_connect():FAIL error:'SSL_connect() I/O error: [0x00000000] The operation completed successfully.' ...send value error: TCP successful, cannot establish TLS to [[192.168.1.2]:10051]: SSL_connect() I/O error: [0x00000000] The operation completed successfully. ##### Al registre del costat de la connexió: Linux: ...A zbx_tls_init_child() ...Biblioteca OpenSSL (versió OpenSSL 1.1.1 11 de setembre de 2018) inicialitzada ... ...A zbx_tls_connect(): psk_identity:"Remitent de prova de PSK" ...Final de zbx_tls_connect():Error FAIL: 'connexió tancada pel company' ... error d'enviament del valor: TCP correcte, no es pot establir TLS a [[localhost]:10051]: connexió tancada pel company Windows: ...Biblioteca OpenSSL (versió OpenSSL 1.1.1a 20 de novembre de 2018) inicialitzada ... ...A zbx_tls_connect(): psk_identity:"Remitent de prova de PSK" ...zbx_psk_client_cb() ha sol·licitat la identitat PSK "Remitent de prova PSK" ...Fi de zbx_tls_connect():Error FAIL:'Error d'E/S SSL_connect(): [0x00000000] L'operació s'ha completat correctament.' ... error d'enviament del valor: TCP correcte, no es pot establir TLS a [[192.168.1.2]:10051]: Error d'E/S SSL_connect(): [0x00000000] L'operació s'ha completat correctament. #### Incorrect information from nested host groups in maps Information from nested host groups is incorrectly displayed in maps, for example: - Host group label displays the problem summary not including all hosts in nested host groups; - "Host group elements" view does not display a separate map element for each host in the nested host groups; - Map label displays summary of all problems not including those in nested host groups. #### Informació incorrecta dels grups d'equips heretats als mapes La informació dels grups d'equips heretats es mostra incorrectament als mapes, per exemple: - L'etiqueta del grup d'equips mostra el resum del problema sense incloure tots els equips dels grups d'equips heretats; - La vista "Elements del grup d'equips" no mostra un element de mapa independent per a cada equip dels grups d'equips heretats. - L'etiqueta del mapa mostra un resum de tots els problemes sense incloure els dels grups d'equips heretats. #### Incorrect request method parameter in items The request method parameter, used only in HTTP checks, may be incorrectly set to '1', a non-default value for all items as a result of upgrade from a pre-4.0 Zabbix version. For details on how to fix this situation, see [ZBX-19308](https://support.zabbix.com/browse/ZBX-19308). #### El paràmetre del mètode de petició és incorrecte als elements El paràmetre del mètode de sol·petició, que només s'empra a les comprovacions HTTP, pot estar configurat incorrectament a "1", un valor no predeterminat per a tots els elements després d'una actualització d'una versió anterior a la versió 4.0 de Zabbix. Per obtindre més informació sobre com solucionar aquest problema, consulteu [ZBX-19308](https://support.zabbix.com/browse/ZBX-19308). #### Indexed macros The indexed macro syntax of {MACRO**<1-9>**} works only in the context of **trigger expressions**. It can be used to reference hosts or functions in the order in which they appear in the expression. Macros like {HOST.IP1}, {HOST.IP2}, {HOST.IP3} will resolve to the IP of the first, second, and third host in the trigger expression (providing the trigger expression contains those hosts). Macros like {FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3} will resolve to the value of the first, second, and third item-based function in the trigger expression at the time of the event (providing the trigger expression contains those functions). Additionally the {HOST.HOST<1-9>} macro is also supported within the `{?func(/host/key,param)}` expression macro in **graph names**. For example, `{?func(/{HOST.HOST2}/key,param)}` in the graph name will refer to the host of the second item in the graph. ::: notewarning Indexed macros will not resolve in any other context, except the two cases mentioned here. For other contexts, use macros **without** index (i. e.{HOST.HOST}, {HOST.IP}, etc) instead. ::: #### Macros indexades La sintaxi de macro indexada de {MACRO**<1-9\>**} només funciona en el context dels **triggers**. Es pot emprar per fer referència a equips o funcions en l'ordre en què apareixen a l'expressió. Macros com {HOST.IP1}, {HOST.IP2}, {HOST.IP3} resoldran l'adreça IP del primer, segon i tercer equip al trigger (sempre que el trigger contingui aquests equips). Macros com ara {FUNCTION.VALUE1}, {FUNCTION.VALUE2}, {FUNCTION.VALUE3} resoldran el valor de la primera, segona i tercera funció basada en l'element al trigger en el moment de l'esdeveniment (sempre que sigui el trigger de l'expressió qui contingui aquestes funcions). A més, la macro {HOST.HOST<1-9>} també és compatible amb la macro d'expressió `{?func(/host/key,param)}` als **noms de gràfics**. Per exemple, `{?func(/{HOST.HOST2}/key,param)}` al nom del gràfic es referirà a l'equip del segon element del gràfic. ::: nota d'advertència Les macros indexades no es resoldran en cap altre context, excepte en els dos casos esmentats aquí. Per a altres contextos, utilitzeu macros **sense** índexs (és a dir, {HOST.HOST}, {HOST.IP}, etc.). ::: #### Index lookup caching When a dynamic index item is requested, Zabbix retrieves and caches whole SNMP table under base OID for index, even if a match would be found sooner. This is done in case another item would refer to the same base OID later - Zabbix would look up index in the cache, instead of querying the monitored host again. Note that each poller process uses separate cache. In all subsequent value retrieval operations only the found index is verified. If it has not changed, value is requested. If it has changed, cache is rebuilt - each poller that encounters a changed index walks the index SNMP table again. #### Emmagatzematge a la cau de la cerca d'índex Quan es demana un element d'índex dinàmic, Zabbix recupera i desa a la memòria cau tota la taula SNMP sota l'OID base per a l'índex, fins i tot si troba abans una coincidència. Això es fa en cas que un altre element es refereixi al mateix OID base més endavant: Zabbix cercaria l'índex a la memòria cau, en lloc de tornar a consultar l'equip supervisat. Tingueu en compte que cada procés d'enquesta empra una memòria cau separada. En totes les operacions de recuperació de valors posteriors només es verifica l'índex trobat. Si no ha canviat, es demana valor. Si ha canviat, la memòria cau es reconstrueix: cada poller que troba un índex canviat torna a recórrer la taula SNMP d'índex. ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [EXAMPLES](#lbAF) [SEE ALSO](#lbAG) ------------------------------------------------------------------------ This document was created on: 21:23:35 GMT, March 18, 2020 ## Index [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [EXEMPLES](#lbAF) [VEIEU TAMBÉ](#lbAG) ------------------------------------------------------------------------ Aquest document fou creat a les 21:23:35 GMT, 18 de Març de 2020 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [FILES](#lbAF) [SEE ALSO](#lbAG) [AUTHOR](#lbAH) ------------------------------------------------------------------------ This document was created on: 12:58:30 GMT, June 11, 2021 ## Índex [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [ARXIUS](#lbAF) [VEIEU TAMBÉ](#lbAG) [AUTOR](#lbAH) ------------------------------------------------------------------------ Aquest document s'ha creat a les 12:58:30 GMT, 11 de Juny de 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [EXAMPLES](#lbAG) [SEE ALSO](#lbAH) [AUTHOR](#lbAI) ------------------------------------------------------------------------ This document was created on: 08:42:29 GMT, June 11, 2021 ## índex [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [EXEMPLES](#lbAG) [VEIEU TAMBÉ](#lbAH) [AUTOR](#lbAI) ------------------------------------------------------------------------ Aquest document fou creat a les 08:42:29 GMT, 11 de Juny de 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [EXIT STATUS](#lbAG) [EXAMPLES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 08:42:39 GMT, June 11, 2021 ## Índex [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [ESTAT DE SORTIDA](#lbAG) [EXEMPLES](#lbAH) [VEIEU TAMBÉ](#lbAI) [AUTOR](#lbAJ) ------------------------------------------------------------------------ Aquest document fou creat a les 08:42:39 GMT, 11 de Juny de 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [FILES](#lbAG) [SEE ALSO](#lbAH) [AUTHOR](#lbAI) ------------------------------------------------------------------------ This document was created on: 14:07:57 GMT, November 22, 2021 ## Index [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [ARXIUS](#lbAG) [VEIEU TAMBÉ](#lbAH) [AUTOR](#lbAI) ------------------------------------------------------------------------ Aquesta document fou creat a les 14:07:57 GMT, 22 de Novembre de 2021 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 16:12:14 GMT, September 04, 2020 ## Índex [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [](#lbAG) [ARXIUS](#lbAH) [VEIEU TAMBÉ](#lbAI) [AUTOR](#lbAJ) ------------------------------------------------------------------------ Aquest document s'ha creat el 16:12:14 GMT, 4 de Setembre de 2020 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 16:12:22 GMT, September 04, 2020 ## Índex [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [](#lbAG) [ARXIUS](#lbAH) [VEIEU TAMBÉ](#lbAI) [AUTOR](#lbAJ) ------------------------------------------------------------------------ Aquest document fou creat a les 16:12:22 GMT, 4 de Setembre de 2020 ## Index [NAME](#lbAB) [SYNOPSIS](#lbAC) [DESCRIPTION](#lbAD) [OPTIONS](#lbAE) [](#lbAF) [](#lbAG) [FILES](#lbAH) [SEE ALSO](#lbAI) [AUTHOR](#lbAJ) ------------------------------------------------------------------------ This document was created on: 20:50:13 GMT, November 22, 2021 ## Index [NOM](#lbAB) [SINOPSI](#lbAC) [DESCRIPCIÓ](#lbAD) [OPCIONS](#lbAE) [](#lbAF) [](#lbAG) [ARXIUS](#lbAH) [VEIEU TAMBÉ](#lbAI) [AUTOR](#lbAJ) ------------------------------------------------------------------------ Aquest document fou creat a les 20:50:13 GMT, 22 de Novembre de 2021 #### Individual migration of history tables * Prepare directories for Data Pump for each history table. Data Pump must have read and write permissions to these directories. Example: ``` {.bash} mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text 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; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * Export and import each table. Replace N with the desired thread count. ``` {.bash} expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### Migració individual de la taula d'històric * Prepareu els directoris per Data Pump per cada taula d'històric. Data Pump ha de tindre permisos de lectura i escriptura en aquests directoris. Exemple: ``` {.bash} mkdir -pv /export/history /export/history_uint /export/history_str /export/history_log /export/history_text chown -R oracle:oracle /export ``` * Creeu un directori i doneu-hi permisos de lectura i escriptura a l'usuari que empreu per l'autenticació de Zabbix ('zabbix', a l'exemple de més avall). Sota el rol *sysdba*, executeu: ``` {.sql} create directory history as '/export/history'; grant read,write on directory history to zabbix; create directory history_uint as '/export/history_uint'; grant read,write on directory history_uint to zabbix; create directory history_str as '/export/history_str'; grant read,write on directory history_str to zabbix; create directory history_log as '/export/history_log'; grant read,write on directory history_log to zabbix; create directory history_text as '/export/history_text'; grant read,write on directory history_text to zabbix; ``` * Exporteu i importeu cada taula. Substituïu N amb el comptador que empreu. ``` {.bash} expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history TABLES=history_old REMAP_TABLE=history_old:history data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_uint TABLES=history_uint_old REMAP_TABLE=history_uint_old:history_uint data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_str TABLES=history_str_old REMAP_TABLE=history_str_old:history_str data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_log TABLES=history_log_old REMAP_TABLE=history_log_old:history_log data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only expdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old PARALLEL=N impdp zabbix/password@oracle_host:1521/xe DIRECTORY=history_text TABLES=history_text_old REMAP_TABLE=history_text_old:history_text data_options=SKIP_CONSTRAINT_ERRORS table_exists_action=APPEND PARALLEL=N CONTENT=data_only ``` * Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues. ### Informational ### Informatiu ##### Informix Standard Informix utility **onstat** can be used for monitoring of virtually every aspect of Informix database. Also, Zabbix can retrieve information provided by Informix SNMP agent. ##### Informix L'usuari estàndard d'Informix **onstat**, es pot emprar per tots els aspectes de la base de dades Informix. A més, Zabbix pot recuperar extreure informació proveïda per l'agent SNMP d'Informix. ##### Input data ``` {.java} { "books": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95, "id": 1 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99, "id": 2 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99, "id": 3 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99, "id": 4 } ], "services": { "delivery": { "servicegroup": 1000, "description": "Next day delivery in local town", "active": true, "price": 5 }, "bookbinding": { "servicegroup": 1001, "description": "Printing and assembling book in A5 format", "active": true, "price": 154.99 }, "restoration": { "servicegroup": 1002, "description": "Various restoration methods", "active": false, "methods": [ { "description": "Chemical cleaning", "price": 46 }, { "description": "Pressing pages damaged by moisture", "price": 24.5 }, { "description": "Rebinding torn book", "price": 99.49 } ] } }, "filters": { "price": 10, "category": "fiction", "no filters": "no \"filters\"" }, "closed message": "Store is closed", "tags": [ "a", "b", "c", "d", "e" ] } ``` |JSONPath|Type|Result|Comments| |--|--|------|------| |`$.filters.price`|definite|10| | |`$.filters.category`|definite|fiction| | |`$.filters['no filters']`|definite|no "filters"| | |`$.filters`|definite|{<br>"price": 10,<br>"category": "fiction",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|definite|Sword of Honour| | |`$.books[-1].author`|definite|J. R. R. Tolkien| | |`$.books.length()`|definite|4| | |`$.tags[:]`|indefinite|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|indefinite|\["c", "d", "e" \]| | |`$.tags[:3]`|indefinite|\["a", "b", "c"\]| | |`$.tags[1:4]`|indefinite|\["b", "c", "d"\]| | |`$.tags[-2:]`|indefinite|\["d", "e"\]| | |`$.tags[:-3]`|indefinite|\["a", "b"\]| | |`$.tags[:-3].length()`|definite|2| | |`$.books[0, 2].title`|indefinite|\["Moby Dick", "Sayings of the Century"\]| | |`$.books[1]['author', "title"]`|indefinite|\["Sword of Honour", "Evelyn Waugh"\]| | |`$..id`|indefinite|\[1, 2, 3, 4\]| | |`$.services..price`|indefinite|\[154.99, 5, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinite|\["Sword of Honour"\]|This query shows that arithmetical operations can be used in queries. Of course this query can be simplified to `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|indefinite|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|indefinite|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|indefinite|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|indefinite|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|indefinite|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|indefinite|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "fiction" && @.price < 10)].title`|indefinite|\["Moby Dick"\]| | |`$..[?(@.id)]`|indefinite|\[<br>{<br>"price": 8.95,<br>"id": 1,<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century"<br>},<br>{<br>"price": 12.99,<br>"id": 2,<br>"category": "fiction",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour"<br>},<br>{<br>"price": 8.99,<br>"id": 3,<br>"category": "fiction",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3"<br>},<br>{<br>"price": 22.99,<br>"id": 4,<br>"category": "fiction",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8"<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|indefinite|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|definite|4| | |`$.books[?(@.id == 2)].title.first()`|definite|Sword of Honour| | |`$..tags.first().length()`|definite|5|$..tags is indefinite path, so it returns an array of matched elements - \[\["a", "b", "c", "d", "e" \]\], first() returns the first element - \["a", "b", "c", "d", "e" \] and finally length() calculates its length - 5.| |`$.books[*].price.min()`|definite|8.95| | |`$..price.max()`|definite|154.99| | |`$.books[?(@.category == "fiction")].price.avg()`|definite|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|indefinite| |A query without match returns NULL for definite and indefinite paths.| |`$.services[?(@.active=="true")].servicegroup`|indefinite|\[1001,1000\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.active=="false")].servicegroup`|indefinite|\[1002\]|Text constants must be used in boolean value comparisons.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definite|restoration| | ##### Dades d'entrada ``` {.java} { "books": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95, "id": 1 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99, "id": 2 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99, "id": 3 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99, "id": 4 } ], "services": { "delivery": { "servicegroup": 1000, "description": "Next day delivery in local town", "active": true, "price": 5 }, "bookbinding": { "servicegroup": 1001, "description": "Printing and assembling book in A5 format", "active": true, "price": 154.99 }, "restoration": { "servicegroup": 1002, "description": "Various restoration methods", "active": false, "methods": [ { "description": "Chemical cleaning", "price": 46 }, { "description": "Pressing pages damaged by moisture", "price": 24.5 }, { "description": "Rebinding torn book", "price": 99.49 } ] } }, "filters": { "price": 10, "category": "fiction", "no filters": "no \"filters\"" }, "closed message": "Store is closed", "tags": [ "a", "b", "c", "d", "e" ] } ``` |JSONPath|Tipus|Resultat|Comentaris| |--|--|------|------| |`$.filters.price`|definit|10| | |`$.filters.category`|definit|ficció| | |`$.filters['no filters']`|definit|no "filters"| | |`$.filters`|definit|{<br>"price": 10,<br>"category": "ficció",<br>"no filters": "no \\"filters\\""<br>}| | |`$.books[1].title`|definit|Sword of Honour| | |`$.books[-1].author`|definit|J. R. R. Tolkien| | |`$.books.length()`|definit|4| | |`$.tags[:]`|indefinit|\["a", "b", "c", "d", "e" \]| | |`$.tags[2:]`|indefinit|\["c", "d", "e" \]| | |`$.tags[:3]`|indefinit|\["a", "b", "c"\]| | |`$.tags[1:4]`|indefinit|\["b", "c", "d"\]| | |`$.tags[-2:]`|indefinit|\["d", "e"\]| | |`$.tags[:-3]`|indefinit|\["a", "b"\]| | |`$.tags[:-3].length()`|definit|2| | |`$.books[0, 2].title`|indefinit|\["Moby Dick", "Sayings of the Century"\]| | |`$.books[1]['author', "title"]`|indefinit|\["Sword of Honour", "Evelyn Waugh"\]| | |`$..id`|indefinit|\[1, 2, 3, 4\]| | |`$.services..price`|indefinit|\[5, 154.99, 46, 24.5, 99.49\]| | |`$.books[?(@.id == 4 - 0.4 * 5)].title`|indefinit|\["Sword of Honour"\]|Aquesta cerca ensenya que les operacions aritmètiques es poden emprar a les consultes. Evidentment, aquesta consulta es pot simplificar com a `$.books[?(@.id == 2)].title`| |`$.books[?(@.id == 2 \|\| @.id == 4)].title`|indefinit|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(!(@.id == 2))].title`|indefinit|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.id != 2)].title`|indefinit|\["Sayings of the Century", "Moby Dick", "The Lord of the Rings"\]| | |`$.books[?(@.title =~ " of ")].title`|indefinit|\["Sayings of the Century", "Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.price > 12.99)].title`|indefinit|\["The Lord of the Rings"\]| | |`$.books[?(@.author > "Herman Melville")].title`|indefinit|\["Sayings of the Century", "The Lord of the Rings"\]| | |`$.books[?(@.price > $.filters.price)].title`|indefinit|\["Sword of Honour", "The Lord of the Rings"\]| | |`$.books[?(@.category == $.filters.category)].title`|indefinit|\["Sword of Honour","Moby Dick","The Lord of the Rings"\]| | |`$.books[?(@.category == "ficció" && @.price < 10)].title`|indefinit|\["Moby Dick"\]| | |`$..[?(@.id)]`|indefinit|\[<br>{<br>"category": "reference",<br>"author": "Nigel Rees",<br>"title": "Sayings of the Century",<br>"price": 8.95,<br>"id": 1<br>},<br>{<br>"category": "ficció",<br>"author": "Evelyn Waugh",<br>"title": "Sword of Honour",<br>"price": 12.99,<br>"id": 2<br>},<br>{<br>"category": "ficció",<br>"author": "Herman Melville",<br>"title": "Moby Dick",<br>"isbn": "0-553-21311-3",<br>"price": 8.99,<br>"id": 3<br>},<br>{<br>"category": "ficció",<br>"author": "J. R. R. Tolkien",<br>"title": "The Lord of the Rings",<br>"isbn": "0-395-19395-8",<br>"price": 22.99,<br>"id": 4<br>}<br>\]| | |`$.services..[?(@.price > 50)].description`|indefinit|'\["Printing and assembling book in A5 format", "Rebinding torn book"\]| | |`$..id.length()`|definit|4| | |`$.books[?(@.id == 2)].title.first()`|definit|Sword of Honour| | |`$..tags.first().length()`|definit|5|$..etiquetes és un camí indefinit, pel que retornarà una matriu d'elements trobats - \[\["a", "b", "c", "d", "e" \]\], first() retorna el primer element - \["a", "b", "c", "d", "e" \] and finally length() calcula la seva allargada - 5.| |`$.books[*].price.min()`|definit|8.95| | |`$..price.max()`|definit|154.99| | |`$.books[?(@.category == "ficció")].price.avg()`|definit|14.99| | |`$.books[?(@.category == $.filters.xyz)].title`|indefinit| |Una consulta sense trobar res retornarà NULL per camins definits i indefinits.| |`$.services[?(@.active=="true")].servicegroup`|indefinit|\[1000,1001\]|Les constants de text s'han d'emprar a les comparacions de valors booleans.| |`$.services[?(@.active=="false")].servicegroup`|indefinit|\[1002\]|Les constants de text s'han d'emprar a les comparacions de valors booleans.| |`$.services[?(@.servicegroup=="1002")]~.first()`|definit|restoration| | ## Installation ## Instal·lació ##### Installation After this is done use the following command to install Zabbix agent as Windows service: C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i Now you should be able to configure "Zabbix agent" service normally as any other Windows service. See [more details](/manual/appendix/install/windows_agent#installing_agent_as_windows_service) on installing and running Zabbix agent on Windows. ##### Instal·lació Un cop hagueu fet les passes anteriors, executeu la comanda següent per instal·lar l’agent Zabbix com a servei: C:\> c:\zabbix\zabbix_agentd.exe -c c:\zabbix\zabbix_agentd.conf -i Ara hauríeu de poder configurar el servei “Agent Zabbix” com qualsevol altre servei de Windows. Veieu [més detalls](/manual/appendix/install/windows_agent#installing_agent_as_windows_service) sobre la instal·lació i execució de l'agent sota Windows. #### Installation A new [Zabbix web service](/manual/concepts/web_service) process and Google Chrome browser should be installed to enable generation of scheduled reports. The web service may be installed on the same machine where the Zabbix server is installed or on a different machine. Google Chrome browser should be installed on the same machine, where the web service is installed. #### Instal·lació Un nou procés [Servei Web de Zabbix](/manual/concepts/web_service) i el navegador Google Chrome han d'ésser instal·lats per permetre generar els informes programats. El servei Web pot ésser instal·lat a la mateixa màquina on resideix el servidor Zabbix, o a una màquina diferent. El navegador ha d'ésser a la màquina on el servei Web sigui instal·lat. #### Installation Please always read the installation manual for a particular module. It is recommended to install new modules one by one to catch failures easily. Just before you install a module: - Make sure you have downloaded the module from a trusted source. Installation of harmful code may lead to consequences, such as data loss - Different versions of the same module (same ID) can be installed in parallel, but only a single version can be enabled at once Steps to install a module: - Unpack your module within its own folder in the `modules` folder of the Zabbix frontend - Ensure that your module folder contains at least the manifest.json file - Navigate to [Module administration](/manual/web_interface/frontend_sections/administration/general#modules) and click the *Scan directory* button - New module will appear in the list along with its version, author, description and status - Enable module by clicking on its status Troubleshooting: |Problem|Solution| |---------|----------------------------------------| |*Module did not appear in the list*|Make sure that the manifest.json file exists in `modules/your-module/` folder of the Zabbix frontend. If it does that means the module does not suit the current Zabbix version. If manifest.json file does not exist, you have probably unpacked in the wrong directory.| |*Frontend crashed*|The module code is not compatible with the current Zabbix version or server configuration. Please delete module files and reload the frontend. You'll see a notice that some modules are absent. Go to [Module administration](/manual/web_interface/frontend_sections/administration/general#modules) and click *Scan directory* again to remove non-existent modules from the database.| |*Error message about identical namespace, ID or actions appears*|New module tried to register a namespace, ID or actions which are already registered by other enabled modules. Disable the conflicting module (mentioned in error message) prior to enabling the new one.| |*Technical error messages appear*|Report errors to the developer of the module.| #### Instal·lació Si us plau, llegiu sempre el manual d'instal·lació d'un mòdul concret. Es recomana instal·lar els nous mòduls un per un per gestionar fàcilment els errors. Just abans d'instal·lar un mòdul: - Assegureu-vos que l'heu descarregat des d'una font de confiança. La instal·lació de codi nociu pot tindre conseqüències, com ara la pèrdua de dades - Es poden instal·lar diferents versions del mateix mòdul (mateix ID) en paral·lel, però només es pot activar una versió alhora Passes per instal·lar un mòdul: - Descomprimiu el vostre mòdul a la seva pròpia carpeta dins de la carpeta `modules` de la interfície Zabbix - Assegureu-vos que la carpeta del mòdul contingui almenys el fitxer manifest.json - Navegueu a [Administració de mòduls](/manual/web_interface/frontend_sections/administration/general#modules) i feu clic al botó *Analitzar directori* - El nou mòdul apareixerà a la llista amb la seva versió, autor, descripció i estat - Activa el mòdul fent clic al seu estat Resolució de problemes |Problema|Solució|: |Problema|Solució| |---------|---------------------------------------- -| |*El mòdul no apareix al llistat*|Assegureu-vos que el fitxer manifest.json és a la carpeta `modules/your-module/` de la interfície Zabbix. Si és així, vol dir que el mòdul no és adequat per a la versió actual de Zabbix. Si el fitxer manifest.json no hi és, segurament l'heu descomprimit al directori incorrecte.| |*GUI fallida*|El codi del mòdul no és compatible amb la versió actual de Zabbix o la configuració del servidor. Si us plau, esborreu els fitxers del mòdul i torneu a carregar la interfície. Veureu un avís que manquen alguns mòduls. Aneu a [Administració de mòduls](/manual/web_interface/frontend_sections/administration/general#modules) i torneu a fer clic al botó *Analitzar directori* per esborrar mòduls inexistents de la base de dades.| |*Apareix un missatge d'error sobre un espai de noms, ID o accions idèntiques*|El nou mòdul ha intentat registrar un espai de noms, ID o accions que ja són registrades per altres mòduls activats. Desactiveu el mòdul conflictiu (esmentat al missatge d'error) abans d'habilitar el nou.| |*Apareixen missatges d'error tècnic*|Informa d'errors al desenvolupador del mòdul.| #### Installation Please refer to [Oracle documentation](https://www.oracle.com/database/technologies/releasenote-odbc-ic.html) for all the necessary instructions. For some additional information please refer to: [Installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### Instal·lació Reviseu la [documentació d' Oracle](https://www.oracle.com/database/technologies/releasenote-odbc-ic.html) per tindre les instruccions necessàries. Per tindre més informació, reviseu la secció: [Instal·lació de unixODBC](/manual/config/items/itemtypes/odbc_checks). #### Installation - **Red Hat Enterprise Linux**: ```bash dnf install mariadb-connector-odbc ``` - **Debian/Ubuntu**: Please refer to [MySQL documentation](https://dev.mysql.com/downloads/connector/odbc/) (for `mysql-connector-odbc`), or [MariaDB documentation](https://mariadb.com/kb/en/mariadb-connector-odbc/) (for `mariadb-connector-odbc`) to download necessary database driver for the corresponding platform. For some additional information please refer to: [installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### Instal·lació - **Red Hat Enterprise Linux**: ```bash dnf install mariadb-connector-odbc ``` - **Debian/Ubuntu**: Reviseu la [documentació de MySQL](https://dev.mysql.com/downloads/connector/odbc/) (de `mysql-connector-odbc`), o la [documentació de MariaDB](https://mariadb.com/kb/en/mariadb-connector-odbc/) (de `mariadb-connector-odbc`) per descarregar els controladors de la base de dades necessaris per a la plataforma corresponent. Per tindre més informació, reviseu: [instal·lació de unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### Installation - **Red Hat Enterprise Linux**: ```bash dnf install postgresql-odbc ``` - **Debian/Ubuntu**: Please refer to [PostgreSQL documentation](https://www.postgresql.org/download/linux/ubuntu/) to download necessary database driver for the corresponding platform. For some additional information please refer to: [installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### Instal·lació - **Red Hat Enterprise Linux**: ```bash dnf install postgresql-odbc ``` - **Debian/Ubuntu**: Reviseu la [documentació de PostgreSQL](https://www.postgresql.org/download/linux/ubuntu/) per descarregar els controladors de la base de dades necessaris per a la plataforma corresponent. Per tindre més informació, reviseu: [instal·lació de unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### Installation - **Red Hat Enterprise Linux** ([EPEL](https://docs.fedoraproject.org/en-US/epel/) packages): ```bash dnf install epel-release dnf install freetds ``` - **Debian/Ubuntu**: Please refer to [FreeTDS user guide](http://www.freetds.org/userguide/) to download necessary database driver for the corresponding platform. For some additional information please refer to: [installing unixODBC](/manual/config/items/itemtypes/odbc_checks/). #### Instal·lació - **Red Hat Enterprise Linux** (paquets [EPEL](https://docs.fedoraproject.org/en-US/epel/): ```bash dnf install epel-releasednf install freetds ``` - **Debian/Ubuntu**: Reviseu la [guia d'usuari FreeTDS](http://www.freetds.org/userguide/) per descarregar els controladors de la base de dades necessaris per a la plataforma corresponent. Per tindre més informació, reviseu : [instal·lació de unixODBC](/manual/config/items/itemtypes/odbc_checks/). ##### Installation See the [package installation](/manual/installation/install_from_packages) section for instructions on how to install Zabbix agent as package. Alternatively see instructions for [manual installation](/manual/installation/install#installing_zabbix_daemons) if you do not want to use packages. ::: noteimportant In general, 32bit Zabbix agents will work on 64bit systems, but may fail in some cases. ::: ##### Instal·lació Veieu la secció [instal·lació dels paquets](/manual/installation/install_from_packages) veieu instruccions d'instal·lació de l'agent Zabbix en forma de paquet. Alternativament, referiu-vos a les instruccions d’[instal·lació manual](/manual/installation/install#installing_zabbix_daemons) si no voleu emprar paquets. ::: noteimportant En general, els agents Zabbix 32bits funcionen sota sistemes de 64bits, tot i que en alguns casos poden no funcionar. ::: #### Installation steps To install, double-click the downloaded MSI file.   Accept the license to proceed to the next step.  Specify the following parameters. |Parameter|Description| |--|--------| |*Host name*|Specify host name.| |*Zabbix server IP/DNS*|Specify IP/DNS of Zabbix server.| |*Agent listen port*|Specify agent listen port (10050 by default).| |*Server or Proxy for active checks*|Specify IP/DNS of Zabbix server/proxy for active agent checks.| |*Enable PSK*|Mark the checkbox to enable TLS support via pre-shared keys.| |*Add agent location to the PATH*|Add agent location to the PATH variable.|  Enter pre-shared key identity and value. This step is only available if you checked *Enable PSK* in the previous step.  Select Zabbix components to install - [Zabbix agent daemon](/manual/concepts/agent), [Zabbix sender](/manual/concepts/sender), [Zabbix get](/manual/concepts/get).  Zabbix components along with the configuration file will be installed in a *Zabbix Agent* folder in Program Files. zabbix\_agentd.exe will be set up as Windows service with automatic startup.  #### Passes d'instal·lació Per instal·lar, feu doble clic a l'arxiu MSI descarregat.   Accepteu la llicència per passar a la següent passa.  Concreteu els paràmetres següents. |Paràmetre|Descripció| |--|---------| |*Nom d'equip*|Especifiqueu el nom d'equip.| |*IP/DNS del servidor Zabbix*|Especifiqueu IP/DNS del servidor Zabbix.| |*Port d'escolta de l'agent*|Especifiqueu el port d'escolta de l'agent (10050 per defecte).| |*Servidor o proxy per a comprovacions actives*|Especifiqueu IP/DNS del servidor/proxy Zabbix per a comprovacions d'agent actiu.| |*Activa PSK*|Marqueu la casella per habilitar el suport TLS mitjançant claus precompartides.| |*Afegeix la ubicació de l'agent al PATH*|Afegeix la ubicació de l'agent a la variable PATH.|  Introduïu la identitat i el valor de la clau prèviament compartida. Aquesta passa només és disponible si heu marcat *Habilitar PSK* a la passa anterior.  Trieu els components Zabbix per instal·lar: [Dimoni de l'agent Zabbix](/manual/concepts/agent), [Zabbix sender](/manual/concepts/sender), [Zabbix get](/manual/concepts/get).  Els components Zabbix juntament amb el fitxer de configuració s'instal·laran a la carpeta *Zabbix Agent* de fitxers de programa. zabbix\_agentd.exe es configurarà com a servei de Windows amb inici automàtic.  #### Installation The official zabbix-web-service package is available in the [Zabbix repository](https://repo.zabbix.com/zabbix/). To compile Zabbix web service [from sources](/manual/installation/install#installing_zabbix_web_service), specify the `--enable-webservice` configure option. To configure Zabbix web service, update the [`zabbix_web_service.conf`](/manual/appendix/config/zabbix_web_service) configuration file parameters. ::: noteimportant It is strongly recommended to set up encryption between Zabbix server and Zabbix web service [using certificates](/manual/encryption/using_certificates). By default, data transmitted between Zabbix server and Zabbix web service is not encrypted, which can lead to unauthorized access. ::: #### Instal·lació El servei Web Zabbix és disponible als paquets Zabbix precompilats disponibles per descarregar al [lloc Web de Zabbix](https://repo.zabbix.com/zabbix/). Per compilar el [servei de Web Zabbix](/manual/installation/install#installing_zabbix_web_service) a partir de les fonts, especifiqueu l'opció de configuració `--enable-webservice`. Per configurar el servei web de Zabbix, actualitzeu els paràmetres [`zabbix_web_service.conf`](/manual/appendix/config/zabbix_web_service) de l'arxiu de configuració. ::: noteimportant És molt recomanable configurar el xifrat entre el servidor Zabbix i el servei web Zabbix [emprant certificats](/manual/encryption/using_certificates). De manera predeterminada, les dades transmeses entre el servidor de Zabbix i el servei web de Zabbix no són pas xifrades, cosa que pot provocar un accés no autoritzat. ::: #### Installation To install Zabbix agent 2, the following options are available: Windows: - from a pre-compiled binary - download the binary and follow the general guidelines for installing software on Windows - from sources - see [Building Zabbix agent 2 on Windows](/manual/installation/install/building_zabbix_agent_2_on_windows) Linux: - from distribution packages - follow the instructions on the [Zabbix packages](https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent_2&db=&ws=) page, available by choosing your distribution and the Agent 2 component - from sources - see [Installation from sources](/manual/installation/install#configure-the-sources); note that you must configure the sources by specifying the `--enable-agent2` configuration option ::: noteclassic Zabbix agent 2 monitoring capabilities can be extended with plugins. While built-in plugins are available out-of-the-box, loadable plugins must be installed separately. For more information, see [Plugins](/manual/config/items/plugins#loadable). ::: #### Instal·lació Per instal·lar l'agent Zabbix 2, hi ha disponibles les opcions següents: Windows: - des d'un binari precompilat: descarregueu el binari i seguiu les directrius generals per instal·lar programari a Windows - des de fonts - veieu [Creació de l'agent Zabbix 2 a Windows](/manual/installation/install/building_zabbix_agent_2_on_windows) Linux: - des dels paquets de distribució: seguiu les instruccions de la pàgina [Paquets Zabbix](https://www.zabbix.com/download?zabbix=6.0&os_distribution=alma_linux&os_version=9&components=agent_2&db=&ws=), disponible escollint la vostra distribució i el component Agent 2 - des de les fonts - veieu les instruccions d'[onstal·lació des de les fonts](/manual/installation/install#configure-the-sources); tingueu en compte que heu de configurar les fonts especificant l'opció de configuració `--enable-agent2` ::: noteclassic Les capacitats de monitoratge de l'agent 2 de Zabbix es poden ampliar amb connectors. Tot i que els plugins integrats són disponibles per defecte, els plugins carregables s'han d'instal·lar per separat. Per obtindre més informació, veieu [Plugins](/manual/config/items/plugins#loadable). ::: # Installation with OpenShift # Instal·lació amb OpenShift #### Install If installing Zabbix from sources, download the configuration file and place it under conf/ in the webserver HTML documents subdirectory where you copied Zabbix PHP files to. {width="550"} {width="350"} ::: notetip Providing the webserver user has write access to conf/ directory the configuration file would be saved automatically and it would be possible to proceed to the next step right away. ::: Finish the installation. {width="550"} #### Instal·lació Si sou instal·lant Zabbix des de la font, descarregueu el fitxer de configuració i poseu-lo a conf/ al subdirectori de documents HTML del servidor web on heu copiat els fitxers PHP de Zabbix. {width="550"} {width="350"} ::: notetip Si l'usuari del servidor web té accés d'escriptura al directori conf/, el fitxer de configuració es desarà automàticament i es podrà passar immediatament a la següent passa. ::: Completar la instal·lació. {width="550"} #### Installing agent as Windows service To install a single instance of Zabbix agent with the default configuration file `c:\zabbix_agentd.conf`: zabbix_agentd.exe --install ::: noteimportant On a 64-bit system, a 64-bit Zabbix agent version is required for all checks related to running 64-bit processes to work correctly. ::: If you wish to use a configuration file other than `c:\zabbix_agentd.conf`, you should use the following command for service installation: zabbix_agentd.exe --config <your_configuration_file> --install A full path to the configuration file should be specified. Multiple instances of Zabbix agent can be installed as services like this: zabbix_agentd.exe --config <configuration_file_for_instance_1> --install --multiple-agents zabbix_agentd.exe --config <configuration_file_for_instance_2> --install --multiple-agents ... zabbix_agentd.exe --config <configuration_file_for_instance_N> --install --multiple-agents The installed service should now be visible in Control Panel. #### Instal·lant l'agent com un servei de Windows Per instal·lar una instància sola de l'agent de Zabbix amb l'arxiu de configuració per defecte `c:\zabbix_agentd.conf`: zabbix_agentd.exe --install ::: noteimportant A un sistema de 64-bits, empreu la versió de 64-bits de l'agent de Zabbix, per tal que totes les verificacions relatives al sistema de 64-bits funcionin correctament. ::: Si voleu emprar un fitxer de configuració diferent de `c:\zabbix_agentd.conf`, hauríeu d'emprar l'ordre següent per instal·lar del servei: zabbix_agentd.exe --config <el_vostre_fitxer_de_configuració> --install S'ha d'especificar un camí complet al fitxer de configuració. Es poden instal·lar diverses instàncies de l'agent Zabbix com a serveis, així: zabbix_agentd.exe --config <fitxer_de_configuració_per_instància_1> --install --multiple-agents zabbix_agentd.exe --config <fitxer_de_configuració_per_instància_2> --install --multiple-agents ... zabbix_agentd.exe --config <fitxer_de_configuració_per_instància_N> --install --multiple-agents El servei instal·lat ara hauria d'esser visible al tauler de control. #### Installing agent The agent can be installed using the graphical user interface or from the command line, for example: sudo installer -pkg zabbix_agent-6.0.12-macos-amd64-openssl.pkg -target / Make sure to use the correct Zabbix package version in the command. It must match the name of the downloaded package. #### Instal·lant l'agent L'agent es pot instal·lar mitjançant la interfície gràfica d'usuari o des de la línia de comandes, per exemple: sudo installer -pkg zabbix_agent-6.0.12-macos-amd64-openssl.pkg -target / Assegureu-vos d'emprar la versió correcta del paquet Zabbix a l'ordre. Ha de coincidir amb el nom del paquet descarregat. ### Installing debuginfo packages :::noteclassic Debuginfo packages are currently available for RHE versions 7, 6 and 5. ::: To enable debuginfo repository, edit */etc/yum.repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.5/rhel/7/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 This will allow you to install the zabbix-debuginfo package. dnf install zabbix-debuginfo This single package contains debug information for all binary Zabbix components. ### Instal·lació dels paquets debuginfo :::noteclassic Els paquets Debuginfo són disponibles actualment per a les versions 7, 6 i 5 d'RHE. ::: Per habilitar el repositori debuginfo, editeu el fitxer */etc/yum.repos.d/zabbix.repo*. Substituïu `enabled=0` per `enabled=1` per al repositori zabbix-debuginfo. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo - $basearch baseurl=http://repo.zabbix.com/zabbix/5.5/rhel/7/$basearch/debuginfo/ enabled=0 gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-ZABBIX-A14FE591 gpgcheck=1 Això us permetrà instal·lar el paquet zabbix-debuginfo. dnf install zabbix-debuginfo Aquest paquet conté informació de depuració de tots els components binaris de Zabbix. ### Installing debuginfo packages To enable debuginfo repository edit */etc/zypp/repos.d/zabbix.repo* file. Change `enabled=0` to `enabled=1` for zabbix-debuginfo repository. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo type=rpm-md baseurl=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/ gpgcheck=1 gpgkey=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/repodata/repomd.xml.key enabled=0 update=1 This will allow you to install zabbix-***<component>***-debuginfo packages. ### Instal·lació dels paquets debuginfo Per habilitar el repositori debuginfo, editeu el fitxer */etc/zypp/repos.d/zabbix.repo*. Substituïu `enabled=0` per `enabled=1` per al repositori zabbix-debuginfo. [zabbix-debuginfo] name=Zabbix Official Repository debuginfo type=rpm-md baseurl=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/ gpgcheck=1 gpgkey=http://repo.zabbix.com/zabbix/6.0/sles/15/x86_64/debuginfo/repodata/repomd.xml.key enabled=0 update=1 Això us permetrà instal·lar els paquets zabbix-***<component>***-debuginfo. ##### Installing Elasticsearch and creating mapping Final two steps of making things work are installing Elasticsearch itself and creating mapping process. To install Elasticsearch, please refer to [Elasticsearch installation guide](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html). ::: noteclassic Mapping is a data structure in Elasticsearch (similar to a table in a database). Mapping for all history data types is available here: `database/elasticsearch/elasticsearch.map`. ::: ::: notewarning Creation of mapping is mandatory. Some functionality will be broken if mapping is not created according to the instruction. ::: To create mapping for `text` type, send the following request to Elasticsearch: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/text \ -H 'content-type:application/json' \ -d '{ "settings": { "index": { "number_of_replicas": 1, "number_of_shards": 5 } }, "mappings": { "properties": { "itemid": { "type": "long" }, "clock": { "format": "epoch_second", "type": "date" }, "value": { "fields": { "analyzed": { "index": true, "type": "text", "analyzer": "standard" } }, "index": false, "type": "text" } } } }' ``` Similar request is required to be executed for `Character` and `Log` history values mapping creation with corresponding type correction. ::: noteclassic To work with Elasticsearch, please refer to the [Requirements](/manual/installation/requirements#serverproxy) for additional information. ::: ::: noteclassic [Housekeeper](/manual/web_interface/frontend_sections/administration/general#housekeeper) is not deleting any data from Elasticsearch. ::: ##### Instal·lació d'Elasticsearch i creació del mapatge Les dues darreres etapes per fer funcionar les coses consisteix en instal·lar Elasticsearch i crear un procés de mapatge. Perr instal·lar Elasticsearch, fixeu-vos en la [guia d'instal·lació d'Elasticsearch](https://www.elastic.co/guide/en/elasticsearch/reference/current/setup.html). ::: noteclassic El mapatge és una estructura de dades dins d'Elasticsearch (semblant a una taula dins una base de dades). El mapatge de tots els tipus de dades d'històric és disponible aquí: `database/elasticsearch/elasticsearch.map`. ::: ::: notewarning La creació del mapatge és obligatòria. Algunes funcionalitats s'interrompran si el mapatge no és pas creat conforme a les instruccions: Per crear un mapatge per al tipus `text`, envieu la petició següent a Elasticsearch: ``` {.java} curl -X PUT \ http://your-elasticsearch.here:9200/text \ -H 'content-type:application/json' \ -d '{ "settings": { "index": { "number_of_replicas": 1, "number_of_shards": 5 } }, "mappings": { "properties": { "itemid": { "type": "long" }, "clock": { "format": "epoch_second", "type": "date" }, "value": { "fields": { "analyzed": { "index": true, "type": "text", "analyzer": "standard" } }, "index": false, "type": "text" } } } }' ``` Una petició similar s'ha d'executar per la creació del mapatge dels valors d'històric `Character` i`Log` amb la correcció de tipus corresponent. ::: noteclassic Per treballar amb Elasticsearch, consulteu la [pàgina de requisits](/manual/installation/requirements#server) per tindre més informació. ::: ::: noteclassic [La neteja](/manual/installation/requirements?s[]=housekeeper) no esborra pas cap dada d'Elasticsearch. ::: ##### Installing frontend Please see [Web interface installation](/manual/installation/frontend) page for information about Zabbix frontend installation wizard. ##### Instal·lació de la interfície Consulteu la pàgina [instal·lació de la interfície Web](/manual/installation/frontend) per obtindre més informació de l'assistent d'instal·lació de la interfície de Zabbix. #### Installing Java gateway It is required to install Java gateway only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. To install from sources, first [download](/manual/installation/install#download-the-source-archive) and extract the source archive. To compile Java gateway, run the `./configure` script with `--enable-java` option. It is advisable that you specify the `--prefix` option to request installation path other than the default /usr/local, because installing Java gateway will create a whole directory tree, not just a single executable. ./configure --enable-java --prefix=$PREFIX To compile and package Java gateway into a JAR file, run `make`. Note that for this step you will need `javac` and `jar` executables in your path. make Now you have a zabbix-java-gateway-$VERSION.jar file in src/zabbix\_java/bin. If you are comfortable with running Java gateway from src/zabbix\_java in the distribution directory, then you can proceed to instructions for configuring and running [Java gateway](/manual/concepts/java/from_sources#overview-of-files). Otherwise, make sure you have enough privileges and run `make install`. make install Proceed to [setup](/manual/concepts/java/from_sources) for more details on configuring and running Java gateway. #### Instal·lant la passarel·la Java Només cal instal·lar la passarel·la Java si voleu monitorar les aplicacions JMX. La passarel·la Java és lleugera i no requereix una base de dades. Per instal·lar des de les fonts, primer [descarregueu](/manual/installation/install#download-the-source-archive) i extraieu l'arxiu font. Per compilar la passarel·la Java, executeu l'script `./configure` amb l'opció `--enable-java`. És recomanable que especifiqueu l'opció `--prefix` per incloure-hi una ruta d'instal·lació diferent del /usr/local per defecte, perquè instal·lar la passarel·la Java crearà un arbre de directoris sencer, no només un executable. ./configure --enable-java --prefix=$PREFIX Per compilar i empaquetar la passarel·la Java en un fitxer JAR, executeu `make`. Tingueu en compte que per a aquesta passa necessitareu executables `javac` i `jar` a la vostra ruta. make Ara teniu un fitxer zabbix-java-gateway-$VERSION.jar a src/zabbix\_java/bin. Si us sentiu còmodes amb l'execució de la passarel·la Java des de src/zabbix\_java al directori de distribució, podeu procedir a les instruccions per configurar i executar la [passarel·la Java](/manual/concepts/java/from_sources#overview-of-files). En cas contrari, assegureu-vos que teniu prou privilegis i executeu `make install`. make install Aneu a [configuració](/manual/concepts/java/from_sources) per obtindre més detalls sobre la configuració i l'execució de la passarel·la Java. #### 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. #### Instal·lació dels paràmetres regionals Per llistar totes les llengües instal·lades, executeu: locale -a Si algunes llengües necessàries no són pas llistades, obriu el fitxer */etc/locale.gen* i descomenteu els paràmetres regionals que voleu. Com Zabbix empra la codificació UTF-8, haureu de triar els paràmetres regionals amb el joc de caracters UTF-8. Ara, executeu: locale-gen Reinicieu el servidor Web. Els paràmetres regionals ja s'haurien d'haver instal·lat. Potser haureu de recarregar la pàgina del frontal Zabbix al navegador, emprant Ctrl + F5 per tal que les noves llengües hi apareguin. #### Installing MIB files On Debian-based systems: apt install snmp-mibs-downloader download-mibs On RedHat-based systems: dnf install net-snmp-libs #### Instal·lar fitxers MIB Sota sistemes basats en Debian: apt install snmp-mibs-downloader download-mibs Sota sistemes basats en RedHat: dnf install net-snmp-libs #### Installing MinGW Compiler 1\. Download MinGW-w64 with SJLJ (set jump/long jump) Exception Handling and Windows threads (for example *x86\_64-8.1.0-release-win32-sjlj-rt\_v6-rev0.7z*)\ 2. Extract and move to *c:\\mingw*\ 3. Setup environmental variable @echo off set PATH=%PATH%;c:\mingw\bin cmd When compiling use Windows prompt instead of MSYS terminal provided by MinGW #### Instal·lació del compilador MinGW 1\. Descarregar MinGW-w64 amb el Gestor d'Excepcions SJLJ (set jump/long jump) i els threads de windows (per exemple *x86\_64-8.1.0-release-win32-sjlj-rt\_v6-rev0.7z*)\ 2\. Extreure-ho a *c:\\mingw*\ 3\. Configurar la variable d'entorn @echo off set PATH=%PATH%;c:\mingw\bin cmd Quan compileu, empreu la línia de comandes de Windows enlloc del terminal MSYS proporcionat per MinGW. #### Installing OpenSSL development libraries 1. Download 32 and 64 bit builds from <https://curl.se/windows/>. 2. Extract files into *c:\\dev\\openssl32* and *c:\\dev\\openssl* directories accordingly. 3. After that remove extracted *\*.dll.a* (dll call wrapper libraries) as MinGW prioritizes them before static libraries. ::: noteimportant Make sure to revoke write access from non-administrator users to the OpenSSL install directory (`C:\dev\openssl32` or `C:\dev\openssl`). Otherwise, Zabbix agent 2 will load SSL settings from a path that can be modified by unprivileged users, resulting in a potential security vulnerability. ::: #### Instal·lació de les biblioteques de desenvolupament OpenSSL 1. Baixeu les versions de 32 i 64 bits des de <https://curl.se/windows/>. 2. Extraieu els fitxers als directoris *c:\\dev\\openssl32* i *c:\\dev\\openssl* en conseqüència. 3. Després d'això, esborreu les biblioteques d'embolcall de crides dll (*\*.dll.a*), ja que MinGW els prioritza abans que les biblioteques estàtiques. ::: noteimportant Assegureu-vos de revocar l'accés d'escriptura dels usuaris que no són administradors al directori d'instal·lació d'OpenSSL (`C:\dev\openssl32` o `C:\dev\openssl`).En cas contrari, l'agent 2 de Zabbix carregarà la configuració SSL des d'una ruta que poden modificar usuaris sense privilegis, cosa que pot donar lloc a una vulnerabilitat de seguretat. ::: #### Installing unixODBC drivers A unixODBC database driver should be installed for the database, which will be monitored. unixODBC has a list of supported databases and drivers: <http://www.unixodbc.org/drivers.html>. In some Linux distributions database drivers are included in package repositories. Installing MySQL database driver on Ubuntu/Debian systems using the *apt* package manager: apt install odbc-mariadb Installing MySQL database driver on RedHat/Fedora-based systems using the *dnf* package manager: dnf install mariadb-connector-odbc Installing MySQL database driver on SUSE-based systems using the *zypper* package manager: zypper in mariadb-connector-odbc #### Instal·lar els drivers unixODBC S'ha d'instal·lar un controlador de base de dades unixODBC per a la base de dades que es controlarà. unixODBC té una llista de bases de dades i controladors compatibles: <http://www.unixodbc.org/drivers.html>. En algunes distribucions de Linux, els controladors de bases de dades s'inclouen als repositoris de paquets. Instal·lació del controlador de base de dades MySQL als sistemes basats en Ubuntu/Debian mitjançant el gestor de paquets *apt*: apt install odbc-mariadb Instal·lació del controlador de base de dades MySQL als sistemes basats en RedHat/Fedora mitjançant el gestor de paquets *dnf*: dnf install mariadb-connector-odbc Instal·lació del controlador de base de dades MySQL als sistemes basats en SUSE mitjançant el gestor de paquets *zypper*: zypper in mariadb-connector-odbc #### Installing unixODBC The suggested way of installing unixODBC is to use the Linux operating system default package repositories. In the most popular Linux distributions unixODBC is included in the package repository by default. If it's not available, it can be obtained at the unixODBC homepage: <http://www.unixodbc.org/download.html>. Installing unixODBC on Ubuntu/Debian systems using the *apt* package manager: apt install unixodbc unixodbc-dev Installing unixODBC on RedHat/Fedora-based systems using the *dnf* package manager: dnf install unixODBC unixODBC-devel Installing unixODBC on SUSE-based systems using the *zypper* package manager: zypper in unixODBC-devel ::: noteclassic The unixodbc-dev or unixODBC-devel package is needed to compile Zabbix with unixODBC support. ::: #### Instal·lació de unixODBC Es suggereix instal·lar unixODBC amb el paquet dels repositoris de Linux, per defecte. Les distribucions més populars de Linux inclouen al repositori els paquets de unixODBC per defecte. Si no és disponible, es pot obtindre al lloc web de unixODBC: <http://www.unixodbc.org/download.html>. Instal·lació de unixODBC sota sistemes Ubuntu/Debian emprant el gestor de paquets *apt*: apt installl unixodbc unixodbc-dev Instal·lació de unixODBC sota RedHat/Fedora emprant el gestor de paquets *dnf*: dnf install unixODBC unixODBC-devel Instal·lació de unixODBC sota SUSE emprant el gestor de paquets *zypper*: zypper in unixODBC-devel ::: noteclassic El paquest unixodbc-dev o unixODBC-devel és requisit per compliar Zabbix amb suport unixODBC. ::: #### Installing Zabbix daemons #### Instal·lació dels dimonis Zabbix #### Installing Zabbix If installing Zabbix directly from [Zabbix git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), translation files should be generated manually. To generate translation files, run: make gettext locale/make_mo.sh This step is not needed when installing Zabbix from packages or source tar.gz files. #### Instal·lar Zabbix Si instal·leu Zabbix directament des del [repositori git de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), els arxius de traducció s'hauran de generar manualment. Per generar els arxius de traducció, executeu: make gettext locale/make_mo.sh Aquesta passa només cal amb la instal·lació de Zabbix a partir de paquets o dels arxius d'origen tar.gz. #### Installing Zabbix Operator #### Instal·lació de l'operador Zabbix #### Installing Zabbix web interface #### Instal·lar la interfície web de Zabbix #### Installing Zabbix web service Installing Zabbix web service is only required if you want to use [scheduled reports](/manual/web_interface/frontend_sections/reports/scheduled). To install from sources, first [download](/manual/installation/install#download_the_source_archive) and extract the source archive. To compile Zabbix web service, run the `./configure` script with `--enable-webservice` option. ::: noteclassic A [supported Go version](/manual/installation/requirements#agent-2) must be installed to build Zabbix web service. ::: Run zabbix\_web\_service on the machine, where the web service is installed: zabbix_web_service Proceed to [setup](/manual/appendix/install/web_service) for more details on configuring Scheduled reports generation. #### Instal·lació del servei Web Zabbix La instal·lació del servei web Zabbix només cal si voleu emprar [informes programats](/manual/web_interface/frontend_sections/reports/scheduled). Per instal·lar des de la font, comenceu [descarregant](/manual/installation/install#download_the_source_archive) i extraieu l'arxiu font. Per compilar el servei web Zabbix, executeu l'script `./configure` amb l'opció `--enable-webservice`. :::noteclassic Cal una [versió de Go compatible](/manual/installation/requirements#agent-2) per crear el servei web Zabbix. ::: Executeu zabbix\_web\_service a la màquina on és instal·lat el servei web: zabbix_web_service Aneu a [configuració](/manual/appendix/install/web_service) per obtindre més informació sobre la configuració de la generació d'informes programada. ### Integer history The integer history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |ns|integer|Nanoseconds when the value was received.| |value|integer|Received value.| ### Històric d'enters L'objecte d'històric enter té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |clock|timestamp|Hora en que el valor s'ha rebut.| |itemid|string|ID de l'element associat.| |ns|integer|Nanosegons de quan es va rebre el valor.| |value|integer|Valor rebut.| ### Integer trend The integer 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. E. g. timestamp of 04:00:00 means values calculated for period 04:00:00-04:59:59.| |itemid|integer|ID of the related item.| |num|integer|Number of values that were available for the hour.| |value\_min|integer|Hourly minimum value.| |value\_avg|integer|Hourly average value.| |value\_max|integer|Hourly maximum value.| ### Tendència enter L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |clock|timestamp|La marca de temps d'una hora per a la qual es va calcular el valor. Per exemple: la marca de temps de 04:00:00 significa valors calculats per al període 04:00:00-04:59:59.| |itemid|integer|Id de l'element relacionat.| |num|integer|Nombre de valors disponibles per al temps.| |value\_min|integer|Valor horari mínim.| |value\_avg|integer|Valor horari mitjà.| |value\_max|integer|Valor horari màxim.| #### Integrations The following integrations are available, allowing predefined webhook media types to be used for pushing Zabbix notifications to: - [brevis.one](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/brevis.one/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Discord](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/discord/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Event-Driven Ansible](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/event_driven_ansible/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Express.ms messenger](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/express.ms/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Github issues](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/github/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [GLPI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [iLert](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/ilert/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Mantis Bug Tracker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mantisbt/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Mattermost](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mattermost/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Microsoft Teams](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [MS Teams Workflows](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams-workflow?at=refs%2Fheads%2Frelease%2F6.0) - [LINE](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/line/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Opsgenie](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/opsgenie/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [OTRS](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/otrs_ce/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Pagerduty](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pagerduty/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Pushover](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Redmine](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/redmine/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Rocket.Chat](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/rocketchat/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [ServiceNow](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/servicenow/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SIGNL4](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/signl4/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Slack](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/slack/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SolarWinds](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [SysAid](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/sysaid/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Telegram](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/telegram/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [TOPdesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/topdesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [VictorOps](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/victorops/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zammad](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zammad/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Zendesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zendesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) ::: notetip In addition to the services listed here, Zabbix can be integrated with **Spiceworks** (no webhook is required). To convert Zabbix notifications into Spiceworks tickets, create an [email media type](/manual/config/notifications/media/email) and enter Spiceworks helpdesk email address (e.g. help@zabbix.on.spiceworks.com) in the profile settings of a designated Zabbix user. ::: #### Integracions Les integracions següents són disponibles per permetre emprar tipus de suport web predefinits per enviar les notificacions de Zabbix a: -[brevis.one](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/brevis.one/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Discord](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/discord/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Event-Driven Ansible](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/event_driven_ansible/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Express.ms messenger](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/express.ms/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Github issues](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/github/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[GLPI](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/glpi/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[iLert](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/ilert/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[iTop](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/itop/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Jira](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Jira Service Desk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/jira_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[ManageEngine ServiceDesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/manageengine_servicedesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Mantis Bug Tracker](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mantisbt/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Mattermost](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/mattermost/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Microsoft Teams](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[MS Teams Workflows](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/msteams-workflow?at=refs%2Fheads%2Frelease%2F6.0) -[LINE](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/line/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Opsgenie](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/opsgenie/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[OTRS](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/otrs_ce/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Pagerduty](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pagerduty/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Pushover](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/pushover/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Redmine](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/redmine/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Rocket.Chat](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/rocketchat/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[ServiceNow](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/servicenow/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[SIGNL4](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/signl4/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Slack](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/slack/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[SolarWinds](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/solarwinds/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[SysAid](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/sysaid/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Telegram](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/telegram/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[TOPdesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/topdesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[VictorOps](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/victorops/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Zammad](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zammad/README.md?at=refs%2Fheads%2Frelease%2F6.0) -[Zendesk](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/media/zendesk/README.md?at=refs%2Fheads%2Frelease%2F6.0) ::: notetip A més dels serveis llistats aquí, Zabbix es pot integrar amb **Spiceworks** (no cal cap webhook). Per convertir les notificacions de Zabbix en entrades d'Spiceworks, creeu un [tipus de suport de correu-e](/manual/config/notifications/media/email) i introduïu l'adreça de correu electrònic del servei d'assistència de Spiceworks (p. ex. help@zabbix.on.spiceworks.com) a la configuració del perfil d'un usuari designat de Zabbix. ::: ##### Interface creation when adding hosts When hosts are added as a result of network discovery, they get interfaces created according to these rules: - the services detected - for example, if an SNMP check succeeded, an SNMP interface will be created - if a host responded both to Zabbix agent and SNMP requests, both types of interfaces will be created - if uniqueness criteria are Zabbix agent or SNMP-returned data, the first interface found for a host will be created as the default one. Other IP addresses will be added as additional interfaces. Action's conditions (such as Host IP) do not impact adding interfaces. *Note* that this will work if all interfaces are discovered by the same discovery rule. If a different discovery rule discovers a different interface of the same host, an additional host will be added. - if a host responded to agent checks only, it will be created with an agent interface only. If it would start responding to SNMP later, additional SNMP interfaces would be added. - if 3 separate hosts were initially created, having been discovered by the "IP" uniqueness criteria, and then the discovery rule is modified so that hosts A, B and C have identical uniqueness criteria result, B and C are created as additional interfaces for A, the first host. The individual hosts B and C remain. In *Monitoring → Discovery* the added interfaces will be displayed in the "Discovered device" column, in black font and indented, but the "Monitored host" column will only display A, the first created host. "Uptime/Downtime" is not measured for IPs that are considered to be additional interfaces. ##### Creació d'interfícies quan s'afegeixen equips Quan s'afegeixen equips mitjançant la descoberta de xarxa, obtinguent interfícies creades d'acord amb aquestes regles: - serveis detectats: per exemple, si una comprovació SNMP té èxit, es crearà una interfície SNMP - si un equip respon tant a les consultes d'agent Zabbix com a SNMP, es crearan ambdós tipus d'interfícies - si el criteri d'unicitat és l'agent Zabbix o les dades retornades per SNMP, la primera interfície que es trobi per a un equip es crearà com a interfície predeterminada. S'afegiran altres adreces IP com a interfícies addicionals. Les condicions d'acció (com ara la IP de l'equip) no afecten l'addició d'interfícies. *Tingueu en compte* que això funcionarà si totes les interfícies són descobertes per la mateixa regla de descoberta. Si una regla de descoberta diferent troba una interfície diferent del mateix equip, s'afegirà un equip addicional. - si un equip només respon a les comprovacions d'agent, es crearà amb una interfície només d'agent. Si hagués de començar a respondre a SNMP més tard, s'afegirien interfícies SNMP addicionals en aquell moment. - si es van crear originalment 3 equips diferents, després d'ésser trobats pel criteri d'unicitat "IP", llavors la regla de descoberta es modifica de manera que els equips A, B i C tinguin criteris d'unicitat idèntics, B i C es creen com a interfícies addicionals per a A, que és el primer equip. Els equips individuals B i C romanen sense canvis. A *Monitoratge* → *Descoberta*, les interfícies afegides es mostren a la columna "Dispositiu trobat", en negre i sagnat, però la columna "Equip monitorat Host" només mostra A, el primer equip creat. El "temps d'activitat/temps d'inactivitat" no es mesura per a les adreces IP que es consideren interfícies addicionals. ### Internal authentication The *Authentication* tab allows defining custom password complexity requirements for internal Zabbix users.  The following password policy options can be configured: |Parameter|Description| |--|--------| |*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 *Administration→Users* menu. ### Autenticació interna La pestanya *Autenticació* permet establir requisits de complexitat de mot de pas personalitzats per als usuaris interns de Zabbix.  Es poden configurar les opcions de política de mot de pas següents: |Paràmetre|Descripció| |--|---------| |*Longitud mínim del mot de pas*|De manera predeterminada, la longitud mínima del mot de pas s'estableix en 8. Interval compatible: 1-70. Tingueu en compte que els mots de pas de més de 72 caràcters es truncaran.| |*El mot de pas ha de contindre*|Marqueu una o més caselles per requerir l'ús dels caràcters especificats en un mot de pas:<br>-una lletra llatina majúscula i minúscula<br>-un nombre<br>-un caràcter especial<br> <br>Passeu el cursor per damunt del signe d'interrogació per veure una pista amb la llista de caràcters per a cada opció.| |*Eviteu els mot de pas fàcils d'endevinar*|Si és marcada, un mot de pas es comprovarà amb els requisits següents:<br>- no ha de contindre el cognom, el nom o el nom d'usuari de l'usuari <br>- no ha de ser un dels mot de pas comuns o específics del context.<br><br>La llista de contrasenyes comunes i específiques del context es genera automàticament a partir de la llista de NCSC "Els cent-mil mots de pas principals", la llista SecLists "Els mots de pas principals d'1M" i els mot de pas específics de context de Zabbix llista. Els usuaris interns no podran establir cap mot de pas inclòs en aquesta llista, ja que aquests mots de pas es consideren febles a causa de l'ús comú.| Els canvis als requisits de complexitat del mot de pas no afectaran els mots de pas d'usuari existents, però si un usuari existent decideix canviar el mot de pas, el nou mot de pas ha de complir els requisits actuals. Es mostrarà una pista amb la llista de requisits al costat del camp *Mot de pas* al [perfil d'usuari](/manual/web_interface/user_profile) i al [formulari de configuració de l'usuari](/manual/config/users_and_usergroups/user ) accessible des del menú *Administració→Usuaris*. #### 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.| #### Accions d'esdeveniments interns Es poden establir les condicions següents per a les accions basades en esdeveniments: |Tipus de condició|Operadors admesos|Descripció| |--|--|------| |*Tipus d'esdeveniment*|és igual|**Element en estat "no admès"** - coincideix amb els esdeveniments en què un element passa de l'estat "normal" a "no admès"<br>**Regla de descoberta de baix nivell en estat "no compatible" ** - coincideix amb els esdeveniments en què una regla de descoberta de baix nivell passa de l'estat "normal" a l'estat "no admès". 'desconegut'| |*Grup d'equips*| és igual a<br>no és igual|Especifica els grups d'equips o els grups d'equips a excloure.<br>**igual** - l'esdeveniment pertany a aquest grup d'equips.<br>**no és igual** - l'esdeveniment no pertany a aquest grup d'equips.| |*El nom de l'etiqueta*|és igual<br>no és igual<br>conté<br>no conté|Especifiqueu l'etiqueta d'esdeveniment o l'etiqueta d'esdeveniment que voleu excloure.<br>**equals** - l'esdeveniment té aquesta etiqueta<br> **no és igual** - l'esdeveniment no té aquesta etiqueta<br>**conté** - l'esdeveniment té una etiqueta que conté aquesta cadena<br> **no conté** - l'esdeveniment no té cap etiqueta que contingui això corda| |*El valor de l'etiqueta*|és igual a<br>no és igual a<br>conté<br>no conté|Especifiqueu la combinació de valors d'etiqueta i d'etiqueta d'esdeveniment o la combinació d'etiqueta i valor d'etiqueta per excloure.<br>**igual** - l'esdeveniment té aquesta etiqueta i aquest valor<br>**no és igual** - l'esdeveniment no té aquesta etiqueta i aquest valor<br>**conté** - l'esdeveniment té una etiqueta i un valor que conté aquestes cadenes<br>**no conté** - l'esdeveniment no té cap etiqueta ni valor que contingui aquestes cadenes | |*Patró*|és igual a<br>no és igual|Especifica patrons o patrons a excloure.<br>**igual a** - l'esdeveniment pertany a un element/trigger/regla de descoberta de baix nivell heretat d'aquesta plantilla.<br> **no és igual** - l'esdeveniment no pertany a un element/trigger/regla de descoberta de baix nivell heretat d'aquesta plantilla.| |*L'equip*|es igual a<br>no és igual|Especifiqueu els equips a excloure.<br>**igual** - l'esdeveniment pertany a aquest equip.<br>**no és igual** - l'esdeveniment no pertany a aquest equip.| #### Internal events Internal events happen when: - an item changes state from 'normal' to 'unsupported' - an item changes state from 'unsupported' to 'normal' - a low-level discovery rule changes state from 'normal' to 'unsupported' - a low-level discovery rule changes state from 'unsupported' to 'normal' - a trigger changes state from 'normal' to 'unknown' - a trigger changes state from 'unknown' to 'normal' Internal events are supported since Zabbix 2.2. The aim of introducing internal events is to allow users to be notified when any internal event takes place, for example, an item becomes unsupported and stops gathering data. Internal events are only created when internal actions for these events are enabled. To stop generation of internal events (for example, for items becoming unsupported), disable all actions for internal events in Configuration → Actions → Internal actions. ::: noteclassic If internal actions are disabled, while an object is in the 'unsupported' state, recovery event for this object will still be created. If internal actions are enabled, while an object is in the 'unsupported' state, recovery event for this object will be created, even though 'problem event' has not been created for the object. ::: See also: [Receiving notification on unsupported items](/manual/config/notifications/unsupported_item) #### Esdeveniments interns Els esdeveniments interns es produeixen quan: - un element canvia d'estat "normal" a "no compatible" - un element canvia d'estat "no compatible" a "normal" - una regla de descobriment de baix nivell canvia d'estat "normal" a "no compatible" - una regla de descobriment de baix nivell canvia d'estat "no compatible" a "normal" - un trigger canvia d'estat "normal" a "desconegut" - un trigger canvia d'estat "desconegut" a "normal" Els esdeveniments interns són compatibles des de Zabbix 2.2. L'objectiu d'introduir esdeveniments interns és permetre que els usuaris rebin notificacions quan es produeix un esdeveniment intern, per exemple, si un element no s'admet i deixa de recollir dades. Els esdeveniments interns només es creen quan les accions internes per a aquests esdeveniments són habilitades. Per aturar la generació d'esdeveniments interns (per exemple, per als elements que ja no són compatibles), desactiveu totes les accions dels esdeveniments interns a Configuració → Accions → Accions internes. :::noteclassic Si les accions internes són desactivades, mentre un objecte es troba en estat "no admès", encara es crearà un esdeveniment de recuperació per a aquest objecte.<br> Si les accions internes són habilitades, mentre un objecte es troba en estat "no admès", es crearà un esdeveniment de recuperació per a aquest objecte, fins i tot si no s'ha creat un "esdeveniment problema" per a l'objecte. ::: Veieu també: [Rebre notificacions d'elements no compatibles](/manual/config/notifications/unsupported_item) #### Internal item for monitoring high-availability manager The `ha manager` (high-availability manager) process now can be monitored by the zabbix[process*] [internal item](/manual/config/items/itemtypes/internal#supported-checks). #### Element intern per monitorar el gestor d'alta disponibilitat El procés `ha manager` (gestor d'alta disponibilitat) ara es pot monitorar amb l'[element intern](/manual/config/items/itemtypes/internal#supported-checks) zabbix[process*]. #### Internal queue items There are also another two items specifically allowing to remote query internal queue stats on another Zabbix instance: - `zabbix[stats,<ip>,<port>,queue,<from>,<to>]` internal item - for direct internal queue queries to remote Zabbix server/proxy - `zabbix.stats[<ip>,<port>,queue,<from>,<to>]` agent item - for agent-based internal queue queries to remote Zabbix server/proxy See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent) #### Elements de la cua interna Existeixen també altres dos elements que permeten demanar a distància les estadístiques de la cua sobre una altra instància Zabbix: - Element intern `zabbix[stats,<ip>,<port>,queue,<from>,<to>]` - per les peticions de cua internes vers el servidor/proxy Zabbix remot - Element agent `zabbix.stats[<ip>,<port>,queue,<from>,<to>]` - per les peticions de cues internes basades en l'agent d'un servidor/proxy Zabbix remot Veieu també: [Elements interns](/manual/config/items/itemtypes/internal), [elements d'agent Zabbix](/manual/config/items/itemtypes/zabbix_agent) #### Internal workings of bulk processing Zabbix server and proxy query SNMP devices for multiple values in a single request. This affects several types of SNMP items: - regular SNMP items - SNMP items [with dynamic indexes](/manual/config/items/itemtypes/snmp/dynamicindex) - SNMP [low-level discovery rules](/manual/discovery/low_level_discovery/examples/snmp_oids) All SNMP items on a single interface with identical parameters are scheduled to be queried at the same time. The first two types of items are taken by pollers in batches of at most 128 items, whereas low-level discovery rules are processed individually, as before. On the lower level, there are two kinds of operations performed for querying values: getting multiple specified objects and walking an OID tree. For "getting", a GetRequest-PDU is used with at most 128 variable bindings. For "walking", a GetNextRequest-PDU is used for SNMPv1 and GetBulkRequest with "max-repetitions" field of at most 128 is used for SNMPv2 and SNMPv3. Thus, the benefits of bulk processing for each SNMP item type are outlined below: - regular SNMP items benefit from "getting" improvements; - SNMP items with dynamic indexes benefit from both "getting" and "walking" improvements: "getting" is used for index verification and "walking" for building the cache; - SNMP low-level discovery rules benefit from "walking" improvements. However, there is a technical issue that not all devices are capable of returning 128 values per request. Some always return a proper response, but others either respond with a "tooBig(1)" error or do not respond at all once the potential response is over a certain limit. In order to find an optimal number of objects to query for a given device, Zabbix uses the following strategy. It starts cautiously with querying 1 value in a request. If that is successful, it queries 2 values in a request. If that is successful again, it queries 3 values in a request and continues similarly by multiplying the number of queried objects by 1.5, resulting in the following sequence of request sizes: 1, 2, 3, 4, 6, 9, 13, 19, 28, 42, 63, 94, 128. However, once a device refuses to give a proper response (for example, for 42 variables), Zabbix does two things. First, for the current item batch it halves the number of objects in a single request and queries 21 variables. If the device is alive, then the query should work in the vast majority of cases, because 28 variables were known to work and 21 is significantly less than that. However, if that still fails, then Zabbix falls back to querying values one by one. If it still fails at this point, then the device is definitely not responding and request size is not an issue. The second thing Zabbix does for subsequent item batches is it starts with the last successful number of variables (28 in our example) and continues incrementing request sizes by 1 until the limit is hit. For example, assuming the largest response size is 32 variables, the subsequent requests will be of sizes 29, 30, 31, 32, and 33. The last request will fail and Zabbix will never issue a request of size 33 again. From that point on, Zabbix will query at most 32 variables for this device. If large queries fail with this number of variables, it can mean one of two things. The exact criteria that a device uses for limiting response size cannot be known, but we try to approximate that using the number of variables. So the first possibility is that this number of variables is around the device's actual response size limit in the general case: sometimes response is less than the limit, sometimes it is greater than that. The second possibility is that a UDP packet in either direction simply got lost. For these reasons, if Zabbix gets a failed query, it reduces the maximum number of variables to try to get deeper into the device's comfortable range, but (starting from 2.2.8) only up to two times. In the example above, if a query with 32 variables happens to fail, Zabbix will reduce the count to 31. If that happens to fail, too, Zabbix will reduce the count to 30. However, Zabbix will not reduce the count below 30, because it will assume that further failures are due to UDP packets getting lost, rather than the device's limit. If, however, a device cannot handle bulk requests properly for other reasons and the heuristic described above does not work, since Zabbix 2.4 there is a "Use bulk requests" setting for each interface that allows to disable bulk requests for that device. #### Procés intern de processament massiu El servidor Zabbix i el proxy consulten dispositius SNMP per a diversos valors en una sola petició. Això afecta diversos tipus d'elements SNMP: - Elements SNMP habituals - Elements SNMP [amb índexs dinàmics](/manual/config/items/itemtypes/snmp/dynamicindex) - SNMP [regles de descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/snmp_oids) Tots els elements SNMP d'una única interfície amb paràmetres idèntics són programats per ésser consultats a la vegada. Els enquestadors prenen els dos primers tipus d'elements en lots de com a màxim 128 articles, mentre que les regles de descoberta de baix nivell es processen individualment, com abans. Al nivell inferior, hi ha dos tipus d'operacions fetes per consultar valors: obtindre diversos objectes especificats i executar per un arbre OID. Per "obtindre", s'empra una GetRequest-PDU amb un màxim de 128 enllaços variables. Per a "executar", s'empra una GetNextRequest-PDU per a SNMPv1 i GetBulkRequest amb un camp "max-repetitions" com a màxim de 128 per a SNMPv2 i SNMPv3. Així, els avantatges del processament massiu per a cada tipus d'element SNMP es descriuen a continuació: - Els elements SNMP habituals es beneficien d'"obtindre" millores; - Els elements SNMP amb índexs dinàmics es beneficien tant de les millores de "obtindre" com d'"executar": "obtindre" s'empra per a la verificació de l'índex i "executar" per crear la memòria cau; - Les regles de descoberta de baix nivell SNMP es beneficien de les millores "a peu". Tanmateix, hi ha un problema tècnic que no tots els dispositius són capaços de retornar 128 valors per pteició. Alguns sempre retornen una resposta adequada, però d'altres responen amb un error "tooBig(1)" o no responen gens quan la resposta potencial supera un cert límit. Per trobar un nombre òptim d'objectes per consultar per a un dispositiu determinat, Zabbix empra l'estratègia següent: comença amb cura consultant 1 valor en una petició. Si això té èxit, consulta 2 valors en una petició. Si torna a tindre èxit, consulta 3 valors en una petició i continua de manera similar multiplicant el nombre d'objectes consultats per 1,5, donant lloc a la següent seqüència de mides de petició: 1, 2, 3, 4, 6, 9, 13, 19 , 28, 42, 63, 94, 128. Tanmateix, una vegada que un dispositiu es nega a donar una resposta adequada (per exemple, per a 42 variables), Zabbix fa dues coses. En primer lloc, per al lot d'articles actual redueix a la meitat el nombre d'objectes en una sola petició i consulta 21 variables. Si el dispositiu és viu, aleshores la consulta hauria de funcionar en la gran majoria dels casos, perquè sabia que funcionaven 28 variables i 21 és significativament menor que això. Tanmateix, si això encara falla, Zabbix torna a consultar els valors un per un. Si encara falla en aquest moment, el dispositiu definitivament no respon i la mida de la petició no és un problema. La segona cosa que fa Zabbix per als lots d'articles posteriors és que comença amb el darrer nombre de variables exitosos (28 en el nostre exemple) i continua incrementant les mides de petició en 1 fins que arriba al límit. Per exemple, suposant que la mida de resposta més gran és de 32 variables, les peticions posteriors seran de mida 29, 30, 31, 32 i 33. La darrera petició fallarà i Zabbix no tornarà a emetre cap petició de mida 33. A partir d'aquest moment, Zabbix consultarà com a màxim 32 variables per a aquest dispositiu. Si les consultes grans fallen amb aquest nombre de variables, pot voler dir una de dues coses. Els criteris exactes que empra un dispositiu per limitar la mida de la resposta no es poden conèixer, però intentem aproximar-ho mitjançant el nombre de variables. Per tant, la primera possibilitat és que aquest nombre de variables sigui al voltant del límit de mida de resposta real del dispositiu en el cas general: de vegades la resposta és inferior al límit, de vegades és superior. La segona possibilitat és que un paquet UDP en qualsevol direcció simplement es perdi. Per aquests motius, si Zabbix rep una consulta fallida, redueix el nombre màxim de variables per intentar aprofundir en el rang còmode del dispositiu, però (a partir de la 2.2.8) només fins a dos cops. A l'exemple anterior, si una consulta amb 32 variables falla, Zabbix reduirà el recompte a 31. Si això també falla, Zabbix reduirà el recompte a 30. Tanmateix, Zabbix no reduirà el recompte per sota de 30, perquè suposarà que la majoria d'errors es deuen a la pèrdua de paquets UDP i no pas al límit del dispositiu. Tanmateix, si un dispositiu no pot gestionar correctament les peticions massives per altres motius i l'heurística descrita anteriorment no funciona, des de Zabbix 2.4 hi ha una configuració "Empra peticions massives" per a cada interfície que permet desactivar les peticions massives per a aquest dispositiu. In [trigger action](/manual/config/notifications/action/conditions#trigger-actions) configuration, the condition type *Trigger name* has been renamed *Event name* to better describe its function. Note that by default, the event name matches the trigger name unless a custom event name is specified in [trigger configuration](/manual/config/triggers/trigger). A la configuració de [l'acció de trigger](/manual/config/notifications/action/conditions#trigger-actions), el tipus de condició *Nom de trigger* s'ha reanomenat a *Nom d'esdeveniment* per descriure millor la seva funció. Tingueu en compte que, per defecte, el nom de l'esdeveniment coincideix amb el nom del trigger tret que s'especifiqui un nom d'esdeveniment personalitzat a [configuració del trigger](/manual/config/triggers/trigger). #### Introduction MIB stands for the Management Information Base. MIB files allow to use textual representation of an OID (Object Identifier). It is possible to use raw OIDs when monitoring SNMP devices with Zabbix, but if you feel more comfortable using textual representation, you need to install MIB files. For example, ifHCOutOctets is textual representation of the OID 1.3.6.1.2.1.31.1.1.1.10 #### Introducció Els arxius MIB (Management Information Base) ens permeten emprar una representació textual de l'OID (Object Identifier). És possible emprar OIDs en brut quan es monitoren dispositius SNMP amb Zabbix, però si us sembla més còmode emprar una representació textual, heu d'instal·lar els arxius MIB. Per exemple, ifHCOutOctets és una representació textual de l'OID 1.3.6.1.2.1.31.1.1.1.10 Introduction of loadable plugins caused the following configuration parameter changes: - *Plugins.\<PluginName>.Path* parameter has been moved to *Plugins.\<PluginName>.System.Path*. - *Plugins.\<PluginName>.Capacity* parameter, while still supported, has been deprecated, please use *Plugins.\<PluginName>.System.Capacity* instead. La introducció de connectors carregables ha provocat els canvis de paràmetres de configuració següents: - El paràmetre *Plugins.\<PluginName>.Path* s'ha mogut a *Plugins.\<PluginName>.System.Path*. - El paràmetre *Plugins.\<PluginName>.Capacity*, tot i que encara és compatible, ha quedat obsolet; enlloc d'aquest feu anar *Plugins.\<PluginName>.System.Capacity*. #### Invalid regular expression in proc.* items **proc.\*** agent items will now become 'not supported' if an invalid regular expression is supplied. #### Expressió regular no vàlida als elements proc.* Els elements d'agent **proc.\*** passaran ara a ser 'no compatibles' si es proporciona una expressió regular no vàlida. #### Invalid regular expressions after switching to PCRE2 In Zabbix 6.0 support for PCRE2 has been added. Even though PCRE is still supported, Zabbix installation packages for RHEL 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer have been updated to use PCRE2. While providing many benefits, switching to PCRE2 may cause certain existing PCRE regexp patterns becoming invalid or behaving differently. In particular, this affects the pattern *^[\\w-\\.]*. In order to make this regexp valid again without affecting semantics, change the expression to *^[-\\w\\.]* . This happens due to the fact that PCRE2 treats the dash sign as a delimiter, creating a range inside a character class. The following Zabbix installation packages have been updated and now use PCRE2: RHEL 7 and newer, SLES (all versions), Debian 9 and newer, Ubuntu 16.04 and newer. #### Expressions regulars no vàlides després de canviar a PCRE2 A Zabbix 6.0, es va afegir suport per a PCRE2. Tot i que PCRE encara és compatible, els paquets d'instal·lació de Zabbix per a RHEL 7 i posteriors, SLES (totes les versions), Debian 9 i posteriors, Ubuntu 16.04 i posteriors s'han actualitzat per emprar PCRE2. Tot i que ofereix molts avantatges, canviar a PCRE2 pot invalidar alguns patrons d'expressió regular PCRE existents o comportar-se de manera diferent. En particular, això afecta el patró *^[\\w-\\.]*. Per tal que aquesta expressió regular torni a ser vàlida sense afectar la semàntica, substituïu l'expressió per *^[-\\w\\.]*. Això es deu al fet que PCRE2 tracta el guió com un delimitador, creant un interval dins d'una classe de caràcters. Els següents paquets d'instal·lació de Zabbix s'han actualitzat i ara empren PCRE2: RHEL 7 i posteriors, SLES (totes les versions), Debian 9 i posteriors, Ubuntu 16.04 i posteriors. #### Inventory details The **Overview** tab contains some general information about the host, latest monitoring data, and host configuration options: {width="600"} The **Details** tab contains all available inventory details for the host: {width="600"} The completeness of inventory data depends on how much inventory information is maintained with the host. If no information is maintained, the *Details* tab is disabled. #### Detalls de l'inventari La pestanya **Visió general** conté informació general sobre l'equip, dades de monitoratge més recents i opcions de configuració de l'equip: {width="600"} La pestanya **Detalls** conté tots els detalls d'inventari disponibles per a l'equip: {width="600"} La integritat de les dades d'inventari depèn de la quantitat d'informació d'inventari que es mantingui sobre l'equip. Si no es conserva cap informació, la pestanya *Detalls* és desactivada. #### Inventory macros There are host inventory macros {INVENTORY.\*} available for use in notifications, for example: "Server in {INVENTORY.LOCATION1} has a problem, responsible person is {INVENTORY.CONTACT1}, phone number {INVENTORY.POC.PRIMARY.PHONE.A1}." For more details, see the [Supported macros](/manual/appendix/macros/supported_by_location) page. #### Macros d'inventari Les macros d'inventari d'equip {INVENTORY.\*} es poden emprar a les notificacions; per exemple: "El servidor de {INVENTORY.LOCATION1} té un problema; la persona responsable és {INVENTORY.CONTACT1}, i el nombre de telèfon és {INVENTORY.POC.PRIMARY.PHONE.A1}." Per obtindre més detalls, consulteu la pàgina de [macros admeses](/manual/appendix/macros/supported_by_location). ##### Inventory mode selection Inventory mode can be selected in the host configuration form. Inventory mode by default for new hosts is selected based on the *Default host inventory mode* setting in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*. For hosts added by network discovery or autoregistration actions, it is possible to define a *Set host inventory mode* operation selecting manual or automatic mode. This operation overrides the *Default host inventory mode* setting. ##### Tria del mode d'inventari El mode d'inventari es pot triar al formulari de configuració de l'equip. El mode d'inventari predeterminat per als equips nous es tria segons la configuració *Mode d'inventari d'equip predeterminat* a *Administració* → *General* → *[Altres](/manual/web_interface/frontend_sections/administration /general#other_parameters)*. Per als equips afegits per accions de descobriment de xarxa o de registre automàtic, és possible establir una operació *Estableix el mode d'inventari de l'equip* triant el mode manual o automàtic. Aquesta operació anul·la la configuració del *Mode d'inventari de l'equip predeterminat*. #### Inventory overview The details of all existing inventory data are available in the *Inventory* menu. In *Inventory → Overview* you can get a host count by various fields of the inventory. In *Inventory → Hosts* you can see all hosts that have inventory information. Clicking on the host name will reveal the inventory details in a form. {width="600"} The **Overview** tab shows: |Parameter|Description| |--|--------| |*Host name*|Name of the host.<br>Clicking on the name opens a menu with the scripts defined for the host.<br>Host name is displayed with an orange icon, if the host is in maintenance.| |*Visible name*|Visible name of the host (if defined).| |*Host (Agent, SNMP, JMX, IPMI)<br>interfaces*|This block provides details of the interfaces configured for the host.| |*OS*|Operating system inventory field of the host (if defined).| |*Hardware*|Host hardware inventory field (if defined).| |*Software*|Host software inventory field (if defined).| |*Description*|Host description.| |*Monitoring*|Links to monitoring sections with data for this host: *Web*, *Latest data*, *Problems*, *Graphs*, *Dashboards*.| |*Configuration*|Links to configuration sections for this host: *Host*, *Items*, *Triggers*, *Graphs*, *Discovery*, *Web*.<br>The number of configured entities is listed after each link.| The **Details** tab shows all inventory fields that are populated (are not empty). #### Vista d'inventari Els detalls de totes les dades d'inventari existents són disponibles al menú *Inventari*. A *Inventari → Visió general* podeu obtindre un recompte d'equips per diversos camps de l'inventari. A *Inventari → Equips* podeu veure tots els equips que tenen informació d'inventari. Si feu clic al nom de l'equip, es mostraran els detalls de l'inventari en un formulari. {width="600"} La pestanya **Vista general** mostra: |Paràmetre|Descripció| |--|---------| |*Nom de l'equip*|Nom de l'equip.<br>Fent clic al nom s'obre un menú amb els scripts definits per a l'equip.<br>El nom de l'equip es mostra amb una icona taronja, si l'equip és en manteniment.| |*Nom visible*|Nom visible de l'equip (si és definit).| |*Equip (agent, SNMP, JMX, IPMI)<br>interfícies*|Aquest bloc proporciona detalls de les interfícies configurades per a l'equip.| |*OS*|Camp d'inventari del sistema operatiu de l'equip (si és definit).| |*Maquinari*|Camp d'inventari de maquinari de l'equip (si és definit).| |*Programari*|Camp d'inventari de programari de l'equip (si és definit).| |*Descripció*|Descripció de l'equip.| |*Monitoratge*|Enllaços a seccions de monitoratge amb dades d'aquest equip: *Web*, *Dades més recents*, *Problemes*, *Gràfics*, *Taulers de control*.| |*Configuració*|Enllaços a seccions de configuració d'aquest equip: *Equip*, *Elements*, *Triggers*, *Gràfics*, *Descoberta*, *Web*.<br>El nombre d'entitats configurades apareix després de cada enllaç.| La pestanya **Detalls** mostra tots els camps d'inventari que són emplenats (no són pas buits). #### IPMI checks IPMI checks will not work with the standard OpenIPMI library package on Debian prior to 9 (stretch) and Ubuntu prior to 16.04 (xenial). To fix that, recompile OpenIPMI library with OpenSSL enabled as discussed in [ZBX-6139](https://support.zabbix.com/browse/ZBX-6139). #### Verificacions IPMI Les comprovacions IPMI no funcionaran amb el paquet estàndard de la biblioteca OpenIPMI a Debian abans de la versió 9 (stretch) i Ubuntu anterior a la 16.04 (xenial). Per resoldre aquest problema, torneu a compilar la biblioteca OpenIPMI amb OpenSSL habilitat, tal com es mostra a [ZBX-6139](https://support.zabbix.com/browse/ZBX-6139). #### IPMI remote commands For IPMI remote commands the following syntax should be used: <command> [<value>] where - <command> - one of IPMI commands without spaces - <value> - 'on', 'off' or any unsigned integer. <value> is an optional parameter. #### Comandes remotes IPMI Per les comandes remotes IPMI, haureu d'emprar aquesta sintaxi: <command> [<value>] on - <command> - una de les comandes IPMI sense espais - <value> - 'on', 'off' o un enter sense signe. <value> és un paràmetre facultatiu. #### IPv6 address issue in SNMPv3 traps Due to a net-snmp bug, IPv6 address may not be correctly displayed when using SNMPv3 in SNMP traps. For more details and a possible workaround, see [ZBX-14541](https://support.zabbix.com/browse/ZBX-14541). #### Problema d'adreça IPv6 als paquets SNMPv3 A causa d'un error net-snmp, és possible que l'adreça IPv6 no es mostri correctament quan s'empra SNMPv3 a les trampes SNMP. Per obtindre més detalls i una possible solució, veieu [ZBX-14541](https://support.zabbix.com/browse/ZBX-14541). #### Issues in Zabbix 6.0.11 ##### JSONPath parsing errors JSONPath parsing errors occur in case of leading whitespace and empty array/object. Fixed in Zabbix 6.0.12. ##### AND/OR evaluation in LLD filters The evaluation of AND/OR expressions in the low-level discovery filters/overrides may fail in this version. Fixed in Zabbix 6.0.12. #### Problemes a Zabbix 6.0.11 ##### Errors d'anàlisi JSONPath Els errors d'anàlisi de JSONPath es produeixen amb espais en blanc inicials i matriu/objecte buit. S'ha corregit a Zabbix 6.0.12. ##### I/O avaluació en filtres LLD L'avaluació de les expressions I/O en filtres/substitucions de descoberta de baix nivell pot fallar en aquesta versió. S'ha corregit a Zabbix 6.0.12. #### item Bug fixes:<br> [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `item.create`, `item.update`: property `interfaceid` is no longer required to create/update a HTTP agent type item. #### element Correccions d'errades:<br> [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `item.create`, `item.update`: Ja no cal fer ús de la propietat `interfaceid` per a crear o actualitzar un element del tipus agent HTTP. #### item Changes:<br> [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `item.get`, `item.create`, `item.update`: added the third parameter to the Prometheus pattern preprocessing step. The second parameter will now determine an aggregation method: `value`, `label`, `function`. The third parameter will now contain Prometheus output for the aggregation method `label` or an aggregation function for the aggregation method `function`. #### element Canvis:<br> [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `item.get`, `item.create`, `item.update`: afegit un tercer paràmetre a l'etapa de pretractament del patró Prometheus. El segon paràmetre determinarà ara un mètode d'agregació: : `value`, `label`, `function`. El tercer paràmetre tindrà la sortida de Prometheus per el mètode `label` o una funció d'afegir per al mètode d'agregació `function`. #### item Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `item.update`: the parameter `uuid` can now be updated. #### element Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `item.update`: el paràmetre `uuid` ara es pot actualitzar. #### Item changes Native support for the [items](/manual/config/items/itemtypes/zabbix_agent) **net.dns** and **net.dns.record** has been added to Zabbix agent 2. On Zabbix agent 2 for Windows, these items now allow custom DNS IP addresses in the `ip` parameter and no longer ignore `timeout` and `count` parameters. #### Canvis d'elements S'ha afegit suport natiu per als [elements](/manual/config/items/itemtypes/zabbix_agent) **net.dns** i **net.dns.record** a l'agent Zabbix 2 i l'agent Zabbix 2 per a Windows. Ara permeten adreces IP DNS personalitzades al paràmetre `ip` i ja no ignoren els paràmetres `timeout` i `count`. ##### Item configuration Actual command(s) to be executed must be placed in the *Executed script* field in the item configuration. Multiple commands can be executed one after another by placing them on a new line. In this case returned values will also be formatted as multilined. {width="600"} All mandatory input fields are marked with a red asterisk. The fields that require specific information for SSH items are: |Parameter|Description|Comments| |--|------|------| |*Type*|Select **SSH agent** here.| | |*Key*|Unique (per host) item key in the format **ssh.run\[unique short description,<ip>,<port>,<encoding>,<ssh options>\]**|**unique short description** is required and should be unique for each SSH item per host.<br><br>Default port is 22, not the port specified in the interface to which this item is assigned.<br><br>**ssh options** (supported since version 6.0.25; require libssh of version 0.9.0 and higher or libssh2) allow passing additional SSH options in the format *key1=value1;key2=value2,value3*. Multiple values for one key can be passed separated by comma (in this case, the parameter must be [quoted](/manual/config/items/item/key#parameter---quoted-string)); multiple option keys can be passed separated by semicolon.<br><br>The following option keys are supported: `KexAlgorithms`, `HostkeyAlgorithms`, `Ciphers`, `MACs`. Option key and value support depends on the SSH library; if an option is not supported, an error will be returned, and the item will become unsupported.<br><br>Note that "+" sign for appending cipher settings and "!" for disabling specific cipher settings (as in GnuTLS and OpenSSL) are not supported.<br><br>Examples:<br>=> `ssh.run[KexAlgorithms,127.0.0.1,,,Ciphers=aes128-ctr]`<br>=> `ssh.run[KexAlgorithms,,,,"KexAlgorithms=diffie-hellman-group1-sha1;HostkeyAlgorithms=ssh-rsa,ssh-dss,ecdh-sha2-nistp256"]`| |*Authentication method*|One of the "Password" or "Public key".| | |*User name*|User name to authenticate on remote host. Required.| | |*Public key file*|File name of public key if *Authentication method* is "Public key". Required.|Example: *id\_rsa.pub* - default public key file name generated by a command [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen).| |*Private key file*|File name of private key if *Authentication method* is "Public key". Required.|Example: *id\_rsa* - default private key file name.| |*Password* or<br>*Key passphrase*|Password to authenticate or<br>Passphrase **if** it was used for the private key.|Leave the *Key passphrase* field empty if passphrase was not used.<br>See also [known issues](/manual/installation/known_issues#ssh_checks) regarding passphrase usage.| |*Executed script*|Executed shell command(s) using SSH remote session.|The return value of the executed shell command(s) is limited to 16MB (including trailing whitespace that is truncated); [database limits](/manual/config/items/item#text_data_limits) also apply.<br><br>Note that the libssh2 library may truncate executable scripts to ~32kB.<br><br>Examples:<br>*date +%s*<br>*systemctl status mysql-server*<br>*ps auxww \| grep httpd \| wc -l*| ##### Configuració de l'element Les ordres reals a executar s'han de posar al camp *Script Executat* de la configuració de l'element. Es poden executar diverses ordres una darrere l'altra posant-les en una línia nova. En aquest cas, els valors retornats també es formataran en diverses línies. {width="600"} Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els camps que requereixen informació específica per als elements SSH són: |Paràmetre|Descripció|Comentaris| |--|-------|------| |*Tipus*|Trieu aquí **Agent SSH**.| | |*Clau*|Clau d'element única (per equip) en format **ssh.run\[descripció curta única,<ip>,<port>,<codificació>,<opcions ssh>\]**|**descripció curta única* és obligatori i ha d'ésser única en tots els elements SSH per equip.<br>El port predeterminat és el 22, no pas el port especificat a la interfície a la qual és assignat aquest element.<br><br>**opcions ssh** (admès des de la versió 6.0.25; cal libssh versió 0.9.0 i superior o libssh2) permet passar opcions SSH addicionals en format *key1=value1;key2=value2,value3*. Es poden passar valors mútiples per una clau separats per comes (en aquest cas, el paràmetre ha d'ésser [comentat](/manual/config/items/item/key#parameter---quoted-string)); claus múltiples d'opció es poden passar separades per punt i coma.<br><br>S'admeten les següents claus d'opcions: `KexAlgorithms`, `HostkeyAlgorithms`, `Ciphers`, `MACs`. El suport de claus i valors d'opció depèn de la biblioteca SSH; si una opció no és compatible, es retornarà un error i l'element no s'admetrà.<br><br>Tingueu en compte que el signe "+" per afegir configuració de xifrat i "!" per deshabilitar configuració de xifrats específiques (com a GnuTLS i OpenSSL) no s'admeten pas.<br><br>Exemples:<br>=> `ssh.run[KexAlgorithms,127.0.0.1,,,Ciphers=aes128-ctr]`<br>=> `ssh.run[KexAlgorithms,,,,"KexAlgorithms=diffie-hellman-group1-sha1;HostkeyAlgorithms=ssh-rsa,ssh-dss,ecdh-sha2-nistp256"]`| |*Mètode d'autenticació*|O "Mot de pas" o "Clau pública"| | |*Nom d'usuari*|Nom de l'usuari que s'ha d'autenticar a l'equip remot.<br>Obligatori| | |*Fitxer de clau pública*|Nom del fitxer o clau pública si el *Mètode d'autenticació* és "Clau pública". Obligatori|Exemple: *id\_rsa.pub* - per defecte el nom del fitxer de clau pública es genera mitjançant l'ordre [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen)| |*Fitxer de clau privada*|Nom del fitxer o clau privada si el *Mètode d'autenticació* és "Clau privada". Obligatori|Exemple: *id\_rsa* - nom de fitxer de clau privada predeterminat.| |*Mot de pas* o<br>*Frase de pas*|Mot de pas per a l'autenticació o<br>Frase de pas **si** s'ha emprat per a la clau privada|Deixeu buit el camp *Frase de pas de la clau* si no s'empra el mot de pas.<br>Veieu també els [problemes coneguts](/manual/installation/known_issues#ssh_checks) sobre l'ús de frases de pas.| |*script executat*|Comandes d'intèrpret d'ordres executades mitjançant sessió remota SSH|El valor retornat de les comandes executades es limita a 16Mo (incloent els espais truncats al final); també s'apliquen [límits de la base de dades](/manual/config/items/item#text_data_limits).<br><br>Fixeu-vos que la biblioteca libssh2 truncarà els scripts executables a ~32Ko.<br><br>Exemples:<br>*data +%s*<br>*systemctl status mysql-server*<br> *ps auxww \| grep httpd \| wc -l*| #### Item configuration A dependent item depends on its master item for data. That is why the **master item** must be configured (or exist) first: - Go to: *Configuration* → *Hosts* - Click on *Items* in the row of the host - Click on *Create item* - Enter parameters of the item in the form  All mandatory input fields are marked with a red asterisk. Click on *Add* to save the master item. Then you can configure a **dependent item**.  All mandatory input fields are marked with a red asterisk. The fields that require specific information for dependent items are: | | | |--|--------| |*Type*|Select **Dependent item** here.| |*Key*|Enter a key that will be used to recognize the item.| |*Master item*|Select the master item. Master item value will be used to populate dependent item value.| |*Type of information*|Select the type of information that will correspond the format of data that will be stored.| You may use item value [preprocessing](/manual/config/items/item#item_value_preprocessing) to extract the required part of the master item value. {width="600"} Without preprocessing, the dependent item value will be exactly the same as the master item value. Click on *Add* to save the dependent item. A shortcut to creating a dependent item quicker can be accessed by clicking on the  button in the item list and selecting *Create dependent item*.  #### Configuració d'element Un element dependent depèn del seu element mestre per a les dades. És per això que primer s'ha de configurar (o existir) l'**element principal**: - Vés a: *Configuració* → *Equips* - Feu clic a *Items* a la fila de l'equip - Feu clic a *Crear element* - Introduïu els paràmetres de l'element al formulari  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Feu clic a *Afegeix* per desar l'element principal. A continuació, podeu configurar un **element dependent**.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els camps que requereixen informació específica per als elements dependents són: | | | |--|---------| |*Type*|Trieu **Element dependent** aquí.| |*Key*|Introduïu una clau que s'emprarà per reconèixer l'element.| |*Master item*|Trieu l'element mestre. El valor de l'element mestre s'emprarà per emplenar el valor de l'element dependent.| |*Type of information*|Trieu el tipus d'informació que correspondrà al format de dades que s'emmagatzemaran.| Podeu emprar el valor de l'element [preprocessament](/manual/config/items/item#item_value_preprocessing) per extreure la part necessària del valor de l'element mestre. {width="600"} Sense preprocessament, el valor de l'element dependent serà exactament el mateix que el valor de l'element principal. Feu clic a *Afegeix* per desar l'element dependent. Es pot accedir a una drecera per crear un element dependent més ràpidament fent clic al  botó a la llista d'elements i triant *Crea un element dependent*.  ##### Item configuration Configure a log monitoring [item](/manual/config/items/item#overview).  All mandatory input fields are marked with a red asterisk. Specifically for log monitoring items you enter: | | | |--|--------| |*Type*|Select **Zabbix agent (active)** here.| |*Key*|Use one of the following item keys:<br>**log\[\]** or **logrt\[\]**:<br>These two item keys allow to monitor logs and filter log entries by the content regexp, if present.<br>For example: `log[/var/log/syslog,error]`. Make sure that the file has read permissions for the 'zabbix' user otherwise the item status will be set to 'unsupported'.<br>**log.count\[\]** or **logrt.count\[\]**:<br>These two item keys allow to return the number of matching lines only.<br>See supported [Zabbix agent item](zabbix_agent#supported_item_keys) key section for details on using these item keys and their parameters.| |*Type of information*|Prefilled automatically:<br>For log\[\] or logrt\[\] items - `Log`;<br>For log.count\[\] or logrt.count\[\] items - `Numeric (unsigned)`.<br>If optionally using the `output` parameter, you may manually select the appropriate type of information other than `Log`.<br>Note that choosing a non-Log type of information will lead to the loss of local timestamp.| |*Update interval (in sec)*|The parameter defines how often Zabbix agent will check for any changes in the log file. Setting it to 1 second will make sure that you get new records as soon as possible.| |*Log time format*|In this field you may optionally specify the pattern for parsing the log line timestamp. 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 character except "yMdhms".| ##### Configuració d'un element Configurar un [element](/manual/config/items/item#overview) de supervisió d'arxiu de registre:  Tots els camps obligatoris són marcats amb un asterisc vermell. Específicament per els elements de supervisió d'arxius de registre, heu d'entrar: | · | · | |--|--------| |*Tipus*|Trieu **agent Zabbix (actiu)** aquí.| |*Clau*|Empreu una de les següents claus:<br>**log\[\]** o **logrt\[\]** :<br>Aquestes dues claus d'element permeten monitorar els arxius de registre i filtrar el contingut de les entrades de registre via una expressió regular (si és present).<br>Per exemple: `log[/var/log/syslog,error]`. Assegureu-vos que l'usuari 'zabbix' té permisos de lectura sobre l'arxiu, o l'estat de l'element serà definit com a 'no admès'.<br><br>**log.count\[\]** o **logrt.count\[\]** :<br>Aquestes dues claus d'element permeten tornar només el nombre de línies que correspongui.<br>Veieu la secció relativa a les claus d'[elements d'agent Zabbix](zabbix_agent#supported_item_keys) admeses, per més detalls sobre com emprar les claus d'elements i els seus paràmetres.| |*Tipus d'informació*|Omplir automàticament:<br>Per els elements log\[\] o logrt\[\] - `Registre` ; per els elements log.count\[\] o logrt.count\[\] - `Numèric (sense signe)`.<br>Si empreu eventualment el paràmetre `output`, podeu triar manualment el tipus d'informació adequat enlloc de "Registre".<br>Veieu que triar un tipus d'informació diferent que "Registre" es perdrà la marca de temps local.| |*Interval d'actualització*|El paràmetre defineix la freqüència (en segons) en la que l'agent Zabbix verificarà les modificacions de l'arxiu de registre. Establir-ho a 1 segon farà que tinguem nous registres tan aviat com sigui possible.| |*Format de marca de temps del registre*|En aquest camp, podem especificar el model per l'anàlisi de marca de temps de la línia de registre.<br>Si és buida, la marca de temps no s'analitzarà pas.<br>Espais reservats admesos:<br>\* **y**: *Any (0001-9999)*<br>\* **M**: *Mes (01-12)*<br>\* **d**: *Dia (01-31)*<br>\* **h**: *Hora (00-23)*<br>\* **m**: *Minut (00-59)*<br>\* **s**: *Segon (00-59)*<br>Si es deixa en blanc, la marca de temps s'establirà a 0 de temps Unix, que representa l'1 de gener de 1970.<br>Per exemple, considereu la línia següent de l'arxiu de registre de l'agent Zabbix :<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>Comença per sis posicions de caràcters del PID, segueix la data, l'hora i la resta de la línia.<br>El format de l'hora de registre d'aquesta línia és “pppppp:yyyyMMdd:hhmmss”.<br>Veieu que els caràcters "p" i ":" no són més que espais reservats i poden ésser qualsevol cosa excepte "yMdhms".| #### Item configuration in Zabbix frontend Configure a database monitoring [item](/manual/config/items/item#overview).  All mandatory input fields are marked with a red asterisk. Specifically for database monitoring items you must enter: | | | |--|--------| |*Type*|Select *Database monitor* here.| |*Key*|Enter one of the supported item keys:<br>**db.odbc.select**\[<unique short description>,<dsn>,<connection string>\] - this item is designed to return one value, i.e. the first column of the first row of the SQL query result. 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.<br>**db.odbc.get**\[<unique short description>,<dsn>,<connection string>\] - this item is capable of returning multiple rows/columns in JSON format. Thus it 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. This item is supported since Zabbix 4.4.<br>The unique description will serve to identify the item in triggers, etc.<br>Although `dsn` and `connection string` are optional parameters, at least one of them should be present. If both data source name (DSN) and connection string are defined, the DSN will be ignored.<br>The data source name, if used, must be set as specified in odbc.ini.<br>The connection string may contain driver-specific arguments.<br>**db.odbc.discovery**[<unique short description>,<dsn>,<connection string>] - this item returns [low-level discovery](/manual/discovery/low_level_discovery/examples/sql_queries) data.<br><br>Example (connection for MySQL ODBC driver 5):<br>=> db.odbc.get\[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"\]| |*User name*|Enter the database user name<br>This parameter is optional if user is specified in odbc.ini.<br>If connection string is used, and *User name* field is not empty, it is appended to the connection string as `UID=<user>`| |*Password*|Enter the database user password<br>This parameter is optional if password is specified in odbc.ini.<br>If connection string is used, and *Password* field is not empty, it is appended to the connection string as `PWD=<password>`.<br>Since Zabbix 6.0.34, special characters are supported in this field.<br><br>Before Zabbix 6.0.34, if the password contains a semicolon, it should be wrapped in curly brackets, for example, `{P?;)*word}`. After 6.0.34, wrapping the password in this case is still supported, but not required. The password will be appended to connection string after the username as `UID=<username>;PWD={P?;)*word}`. To test the resulting string, you can run the following command:<br>`isql -v -k 'Driver=libmaodbc.so;Database=zabbix;UID=zabbix;PWD={P?;)*word}'`| |*SQL query*|Enter the SQL query.<br>Note that with the `db.odbc.select[]` item the query must return one value only.| |*Type of information*|It is important to know what type of information will be returned by the query, so that it is selected correctly here. With an incorrect *type of information* the item will turn unsupported.| #### Configuració dels elements a la interfície Zabbix Configureu un [element](/manual/config/items/item#overview) de monitoratge de base de dades.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Específicament per als elements de monitoratge de bases de dades, heu d'introduir: | | | |--|---------| |*Tipus*|Trieu *Monitoratge de bases de dades* aquí.| |*Clau*|Introduïu una de les dues claus d'element admeses:<br>**db.odbc.select**\[\<descripció curta única\>,\<dsn\>,\<cadena de connexió\>\] - aquest element és dissenyat per retornar un valor, és a dir, la primera columna de la primera filera del resultat de la consulta SQL. Si una consulta retorna diverses columnes, només es llegeix la primera columna. Si una consulta retorna diverses fileres, només es llegeix la primera filera.<br>**db.odbc.get**\[\<descripció curta única\>,\<dsn\>,\<cadena de connexió\>\] - aquest element és capaç de retornar diverses fileres/columnes en format JSON. Així, es pot emprar com a element principal que recull totes les dades en una única crida al sistema, mentre que el preprocessament JSONPath es pot emprar en elements dependents per extreure valors individuals. Per obtindre més informació, consulteu un [exemple](/manual/discovery/low_level_discovery/examples/sql_queries#using_dbodbcget) del format retornat emprat a la descoberta de baix nivell. Aquest element és compatible des de Zabbix 4.4.<br>La descripció única s'emprarà per identificar l'element a triggers, etc.<br>Tot i que "dsn" i "cadena de connexió" són paràmetres opcionals, almenys un d'ells ha d'ésser present. Si s'estableixen el nom de la font de dades (DSN) i la cadena de connexió, el DSN s'ignorarà.<br>El nom de la font de dades, si s'empra, s'ha d'establir tal com s'especifica a odbc.ini .<br>La cadena de connexió pot contindre un controlador amb arguments específics.<br><br>**db.odbc.discovery**[<descripció curta única>,<dsn>,<cadena de connexió>] - aquest element retorna informació de la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/sql_queries).<br><br>Exemple (connexió per al controlador ODBC MySQL 5):<br>=> db.odbc.get\[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"\]| |*Nom d'usuari*|Introduïu el nom d'usuari de la base de dades<br>Aquest paràmetre és opcional si l'usuari s'especifica a odbc.ini.<br>Si s'empra la cadena de connexió i el camp *Nom d'usuari* no és pas buit, s'afegeix al cadena de connexió com a `UID=<usuari>`| |*Mot de pas*|Introduïu el mot de pas de l'usuari de la base de dades<br>Aquest paràmetre és opcional si s'especifica el mot de pas a odbc.ini.<br>Si s'empra la cadena de connexió i el camp *Mot de pas* no és pas buit, s'adjunta a la connexió cadena com a `PWD=<mot_de_pas>`.<br>Des de Zabbix 6.0.34, s'admeten caràcters especials en aquest camp.<br><br>Abans de Zabbix 6.0.34, si el mot de pas conté un punt i coma, s'hauria d'embolcallar entre claudàtors; per exemple, `{P?;)*word}`. Després de la 6.0.34, en aquest cas encara s'admet l'embolcall del mot de pas, però no és obligatori. El mot de pas s'adjuntarà a la cadena de connexió després del nom d'usuari com a `UID=<nom d'usuari>;PWD={P?;)*paraula}`. Per provar la cadena resultant, podeu executar l'ordre següent:<br>`isql -v -k 'Driver=libmaodbc.so;Database=zabbix;UID=zabbix;PWD={P?;)*word}'`| |*Consulta SQL*|Introduïu la consulta SQL.<br>Tingueu en compte que amb l'element `db.odbc.select[]`, la consulta només ha de retornar un valor.| |*Tipus d'informació*|És important sapiguer quin tipus d'informació retornarà la consulta, perquè aquí estigui correctament seleccionada. Amb un *Tipus d'informació* incorrecte, l'element no s'admetrà pas.| ##### Item configuration To configure a trapper item: - Go to: *Configuration* → *Hosts* - Click on *Items* in the row of the host - Click on *Create item* - Enter parameters of the item in the form  All mandatory input fields are marked with a red asterisk. The fields that require specific information for trapper items are: | | | |--|--------| |*Type*|Select **Zabbix trapper** here.| |*Key*|Enter a key that will be used to recognize the item when sending in data.| |*Type of information*|Select the type of information that will correspond the format of data that will be sent in.| |*Allowed hosts*|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 since Zabbix 2.2.0.<br>Host macros {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} are allowed in this field since Zabbix 4.0.2.| ::: noteclassic You may have to wait up to 60 seconds after saving the item until the server picks up the changes from a configuration cache update, before you can send in values. ::: ##### Configuració de l'element Per configurar un element trapper: - Aneu a: *Configuració* → *Equips* - Feu clic a *Elements* al rang de l'equip - Cliqueu*Crear un element* - Poseu els paràmetres de l'element al formulari  Tots els camps obligatoris són marcats amb un asterisc vermell. Els camps que necessiten informació específica per els elements Trapper són: | | | |---|---| |*Tipus*|Trieu **Zabbix trapper** aquí.| |*Clau*|Poseu la clau que s'emprarà per reconèixer l'element quan s'enviïn les dades.| |*Tipus d'informació*|Trieu el tipus d'informació que correspon al format de dades que s'enviaran.| |*Equips autoritzats*|Llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms d'equips.<br>Si s'especifica, les connexions entrants només s'acceptaran per els equips llistats aquí.<br>Si el suport IPv6 és actiu, '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' es tracten de la mateixa manera i '::/0' autoritzarà qualsevol adreça IPv4 o IPv6.<br>'0.0.0.0/0' es pot emprar per autoritzar qualsevol adreça IPv4.<br>Veieu que "les adreces IPv6 compatibles amb IPv4" (prefix 0000::/96) s'admeten però es desaconsellen per l'[RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Exemple: Server=127.0.0.1,192.168.1.0/24,192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32,zabbix.domain<br>Els espais i [les macros d'usuari](/manual/config/macros/user_macros) sóno autoritzades al camp des de Zabbix 2.2.0.<br>Les macros d'equips: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} s'autoritzen dins del camp des de Zabbix 4.0.2.| ::: noteclassic És possible que hàgiu d'esperar fins a 60 segons després de desar l'element fins que el servidor prengui els canvis d'una actualització de la memòria cau de configuració, abans de poder enviar valors. ::: ##### Item configuration When [configuring an item](/manual/config/items/item) on a host level: - Select 'IPMI agent' as the *Type* - Enter an item [key](/manual/config/items/item/key) that is unique within the host (say, ipmi.fan.rpm) - For *Host interface* select the relevant IPMI interface (IP and port). Note that an IPMI interface must exist on the host. - Specify the *IPMI sensor* (for example 'FAN MOD 1A RPM' on Dell Poweredge) to retrieve the metric from. By default, the sensor ID should be specified. It is also possible to use prefixes before the value: - `id:` - to specify sensor ID; - `name:` - to specify sensor full name. This can be useful in situations when sensors can only be distinguished by specifying the full name. - Select the respective type of information ('Numeric (float)' in this case; for discrete sensors - 'Numeric (unsigned)'), units (most likely 'rpm') and any other required item attributes ##### Configuració de l'element Quan fem la [configuració d'un element](/manual/config/items/item) a nivell d'equip: - Trieu 'IPMI agent' com a *Tipus* - Entre una [clau](/manual/config/items/item/key) única sobre l'equip (com ara ipmi.fan.rpm) - Per la *interfície de l'equip*, trieu la interfície IPMI adequada (IP i port). Veieu que la interfície IPMI ha d'existir a l'equip. - Especifiqueu el *sensor IPMI* (per exemple 'FAN MOD 1A RPM' de Dell Poweredge) sobre quin recuperar el valor. Per defecte, l'ID del sensor s'ha d'especificar. També es poden emprar prefixes davant del valor: - `id:` - per especificar l'ID del sensor; - `name:` - per especificar el nom sencer del sensor. Pot ésser útil a determinades situacions quan els sensors només es puguin distingir amb el nom sencer. - Trieu el tipus d'informació corresponent ('Numèrica (flotant)' en aquest cas, per tots els sensors discrets - 'Numèric (sense signe)'), unitats (probablement 'rpm') i qualsevol altre atribut d'elements necessaris # item.create # item.create # item.delete # item.delete ##### Item filter syntax The item filter: /host/key[parameters]?[conditions] consists of four parts, where: * host - host name * key - item key (without parameters) * parameters - item key parameters * conditions - host group and/or item tag based conditions (as expression) Spaces are allowed only inside the conditions expression. **Wildcard usage** * Wildcard can be used to replace the host name, item key or an individual item key parameter. * Either the host or item key must be specified without wildcard. So `/host/*` and `/*/key` are valid filters, but `/*/*` is invalid. * Wildcard cannot be used for a *part* of host name, item key, item key parameter. * Wildcard does not match more than a single item key parameter. So a wildcard must be specified for each parameter in separation (i.e. `key[abc,*,*]`). **Conditions expression** The conditions expression supports: * operands: * group - host group * tag - item tag * `"<text>"` - string constant, with the `\` escape character to escape `"` and `\` * case-sensitive string comparison operators: `=`, `<>` * logical operators: `and`, `or`, `not` * grouping with parentheses: `(` `)` Quotation of string constants is mandatory. Only case-sensitive full string comparison is supported. :::notewarning When specifying tags in the filter (i.e. `tag="tagname:value"`), the colon ":" is used as a delimiter. Everything after it is considered the tag value. Thus it is currently not supported to specify a tag name containing ":" in it. ::: **Examples** A complex filter may be used, referencing the item key, host group and tags, as illustrated by the examples: |Syntax example|Description| |--|--| |`/host/key[abc,*]`|Matches similar items on this host.| |`/*/key`|Matches the same item of any host.| |`/*/key?[group="ABC" and tag="tagname:value"]`|Matches the same item of any host from the ABC group having 'tagname:value' tags.| |`/*/key[a,*,c]?[(group="ABC" and tag="Tag1") or (group="DEF" and (tag="Tag2" or tag="Tag3:value"))]`|Matches similar items of any host from the ABC or DEF group with the respective tags.| All referenced items must exist and collect data. Only enabled items on enabled hosts are included in the calculations. ::: noteimportant If the item key of a referenced item is changed, the filter must be updated manually. ::: Specifying a parent host group includes the parent group and all nested host groups with their items. ##### Sintaxi del filtre d'elements El filtre d'elements: /host/key[parameters]?[conditions] consta de quatre parts, on: * host - nom d'equip * key - clau d'element (sense paràmetres) * parameters - paràmetres clau de l'element * conditions - condicions basades en el grup d'equips i/o l'etiqueta d'element (com a expressió) Els espais només es permeten dins de l'expressió de condicions. **Ús del comodí** * El comodí es pot emprar per substituir el nom d'equip, la clau d'element o un paràmetre de clau d'element individual. * S'ha d'especificar l'equip o la clau de l'element sense comodí. Per tant, `/host/*` i `/*/key` són filtres vàlids, però `/*/*` no és vàlid. * El comodí no es pot emprar per a una *part* del nom d'equip, la clau d'element o el paràmetre de la clau d'element. * El comodí no ha de coincidir amb més d'un paràmetre clau d'element. Per tant, s'ha d'especificar un comodí per a cada paràmetre separat (és a dir, `key[abc,*,*]`). **Expressió de condicions** L'expressió de condicions admet: * operands: * group - grup d'equips * tag - etiqueta d'element * `"<text>"` - constant de cadena, amb el caràcter d'escapada `\` per escapar `"` i `\` * Operadors de comparació de cadenes que distingeixen entre majúscules i minúscules: `=`, `<>` * operadors lògics: `i`, `o`, `no` * agrupació amb parèntesis: `(` `)` La citació de les constants de cadena és obligatòria. Només s'admet la comparació de cadenes completes que distingeix entre majúscules i minúscules. :::notewarning Quan especifiquem les etiquetes al filtre, (p.e. `tag="tagname:value"`), s'empra com a delimitador els dos punts ":". Qualsevol cosa després d'aquest es considera el valor d'etiqueta. Per això, no s'admet cap nom d'etiqueta que contingui ":". ::: **Exemples** Es pot emprar un filtre complex, fent referència a la clau de l'element, el grup d'equips i etiquetes, tal com ho il·lustren els exemples: |Exemple de sintaxi|Descripció| |--|--| |`/host/key[abc,*]`|Coincideix amb elements similars en aquest equip.| |`/*/key`|Coincideix amb el mateix element de qualsevol equip.| |`/*/key?[group="ABC" and tag="tagname:value"]`|Coincideix amb el mateix element de qualsevol equip del grup ABC que tingui etiquetes 'tagname:value'.| |`/*/key[a,*,c]?[(group="ABC" i tag="Tag1") o (group="DEF" i (tag="Tag2" o tag="Tag3:value" ))]`|Fa coincidir elements similars de qualsevol equip del grup ABC o DEF amb les etiquetes respectives.| Tots els elements referenciats han d'existir i recollir dades. Només els elements activats dels hosts habilitats s'inclouran als càlculs. ::: noteimportant Si es canvia la clau d'element d'un element de referència, el filtre s'ha d'actualitzar manualment. ::: L'especificació d'un grup d'equips principal inclou el grup principal i tots els grups descendents amb els seus articles. # item.get # item.get #### Item key In [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) configuration, select **JMX agent** in the *Type* field. Two item keys are supported for JMX object discovery - jmx.discovery\[\] and jmx.get\[\]: |**Item key**|<|<|<| |-|--------|--------|----------| |<|Return value|Parameters|Comment| |**jmx.discovery**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|This item returns a JSON array with LLD macros describing MBean objects or their attributes.|**discovery mode** - one of the following: *attributes* (retrieve JMX MBean attributes, default) or *beans* (retrieve JMX MBeans)<br>**object name** - object name pattern (see [documentation](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identifying the MBean names to be retrieved (empty by default, retrieving all registered beans)<br>**unique short description** - a unique description that allows multiple JMX items with the same discovery mode and object name on the host (optional)|Examples:<br>→ jmx.discovery - retrieve all JMX MBean attributes<br>→ jmx.discovery\[beans\] - retrieve all JMX MBeans<br>→ jmx.discovery\[attributes,"\*:type=GarbageCollector,name=\*"\] - retrieve all garbage collector attributes<br>→ jmx.discovery\[beans,"\*:type=GarbageCollector,name=\*"\] - retrieve all garbage collectors<br><br>There are some [limitations](#limitations) to what MBean properties this item can return based on limited characters that are supported in macro name generation (supported characters can be described by the following regular expression: `A-Z0-9_\.`). So, for example, to discover MBean properties with a hyphenated word or non-ASCII characters, you need to use `jmx.get[]`.<br><br>Supported since Zabbix Java gateway 3.4.| |**jmx.get**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|This item returns a JSON array with MBean objects or their attributes.<br><br>Compared to `jmx.discovery[]` it does not define LLD macros.|**discovery mode** - one of the following: *attributes* (retrieve JMX MBean attributes, default) or *beans* (retrieve JMX MBeans)<br>**object name** - object name pattern (see [documentation](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identifying the MBean names to be retrieved (empty by default, retrieving all registered beans)<br>**unique short description** - a unique description that allows multiple JMX items with the same discovery mode and object name on the host (optional)|When using this item, it is needed to define custom low-level discovery macros, pointing to values extracted from the returned JSON using JSONPath.<br><br>Supported since Zabbix Java gateway 4.4.| ::: noteimportant If no parameters are passed, all MBean attributes from JMX are requested. Not specifying parameters for JMX discovery or trying to receive all attributes for a wide range like `*:type=*,name=*` may lead to potential performance problems. ::: #### Clau d'element A la configuració de la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule), trieu **agent JMX** al camp *Tipus*. S'admeten dues claus d'element per a la descoberta d'objectes JMX: jmx.discovery\[\] i jmx.get\[\]: |**Clau d'element**|<|<|<| |------------|-|-|-| |<|Valor de retorn|Paràmetres|Comentari| |**jmx.discovery**\[\<mode de descoberta\>,\<nom de l'objecte\>,\<descripció breu única\>\]|<|<|<| |<|Aquest element retorna una matriu JSON amb macros LLD que descriuen objectes MBean o els seus atributs.|**mode de descoberta** - un dels següents: *atributs* (obtinguent els atributs MBean JMX, per defecte) o *beans* (obtinguent JMX). MBeans)<br>**nom de l'objecte** - patró de nom d'objecte (veieu la [documentació](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) que identifica el Noms de MBean per recuperar (buit per defecte, recuperant tots els beans registrats)<br>**descripció curta única** - una descripció única que permet diversos elements JMX amb el mateix mode de descoberta i el mateix nom d'objecte a l'equip (opcional)|Exemples: <br>→ jmx.discovery - recupera tots els atributs JMX MBean<br>→ jmx.discovery\[beans\] - recupera tots els MBeans JMX<br>→ jmx.discovery\[atributs,"\*:type=GarbageCollector,nom =\*"\] - recupera tots els atributs del col·lector d'escombraries<br>→ jmx.discovery\[beans,"\ *:type=GarbageCollector,name=\*"\] - recupera tots els col·lectors d'escombraries<br><br> Hi ha algunes [limitacions](#limitations) pel que fa a les propietats de MBean que aquest element pot retornar en funció dels caràcters limitats admesos en la generació de noms de macro (els caràcters admesos es poden descriure amb la següent expressió regular: `A-Z0-9_\.`). Així, per exemple, per descobrir propietats de MBean amb paraules amb guionet o caràcters no ASCII, hauríeu d'emprar `jmx.get[]`.<br><br>Admès des de la passarel·la Java de Zabbix 3.4 .| |**jmx.get**\[\<mode de descoberta\>,\<nom de l'objecte\>,\<descripció curta única\>\]|<|<|<| |<|Aquest element retorna una matriu JSON amb objectes MBean o els seus atributs.<br><br>En comparació amb `jmx.discovery[]` no defineix macros LLD.|**mode de descoberta** - un dels següents: *atributs* (obté els atributs JMX MBean, per defecte) o *beans* (obté els MBeans JMX)<br>**nom de l'objecte** - patró de nom d'objecte (veieu [documentació](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identificant els noms MBean que cal recuperar (buit per defecte, recuperant tots els beans registrats)<br>**descripció curta única** - una descripció única que permet diversos elements JMX amb el mateix mode de descoberta i el mateix nom d'objecte a l'equip (opcional)|Quan s'empra aquest element, cal definir macros de descoberta de baix nivell personalitzades, que apunten als valors extrets de JSON retornat mitjançant JSONPath.<br><br>Admès des de Zabbix Java Gateway 4.4.| ::: noteimportant Si no es passa cap paràmetre, es demanen tots els atributs JMX MBean. No especificar paràmetres per a la descoberta de JMX o intentar rebre tots els atributs d'una àmplia gamma com ara `*:type=*,name=*` pot provocar problemes de rendiment potencials. ::: #### Item key SQL queries are performed using a "Database monitor" item type. Therefore, most of the instructions on [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks) page apply in order to get a working "Database monitor" discovery rule. Two item keys may be used in "Database monitor" discovery rules: - **db.odbc.discovery**\[<unique short description>,<dsn>,<connection string>\] - this item transforms the SQL query result into a JSON array, turning the column names from the query result into low-level discovery macro names paired with the discovered field values. These macros can be used in creating item, trigger, etc prototypes. See also: [Using db.odbc.discovery](#using_dbodbcdiscovery). ```{=html} <!-- --> ``` - **db.odbc.get**\[<unique short description>,<dsn>,<connection string>\] - this item transforms the SQL query result into a JSON array, keeping the original column names from the query result as a field name in JSON paired with the discovered values. Compared to `db.odbc.discovery[]`, this item does not create low-level discovery macros in the returned JSON, therefore there is no need to check if the column names can be valid macro names. The low-level discovery macros can be defined as an additional step as required, using the [custom LLD macro](/manual/discovery/low_level_discovery#custom_macros) functionality with JSONPath pointing to the discovered values in the returned JSON. See also: [Using db.odbc.get](#using_dbodbcget). #### clau d'element Les consultes SQL es realitzen mitjançant un element de tipus "Monitoratge de bases de dades". Per tant, la majoria de les instruccions de la pàgina [monitoratge ODBC](/manual/config/items/itemtypes/odbc_checks) s'apliquen per obtindre una regla de descoberta de "monitoratge de bases de dades" que funcioni. Es poden emprar dues claus d'elements a les regles de descoberta "Monitoratge de bases de dades": - **db.odbc.discovery**\[<descripció curta única>,<dsn>,<cadena de connexió>\] - aquest element transforma el resultat de la consulta SQL en una matriu JSON, transformant els noms de columna de la consulta donant lloc a noms de macro de descoberta de baix nivell associats amb valors de camp descoberts. Aquestes macros es poden emprar per crear prototips d'elements, triggers, etc. Veieu també: [emprar odb.odbc.discovery](#using_dbodbcdiscovery). ```{=html} <!-- --> ``` - **db.odbc.get**\[<descripció curta única>,<dsn>,<cadena de connexió>\] - aquest element transforma el resultat de la consulta SQL en una matriu JSON, conservant l'origen dels noms de columna de la resultat de la consulta com el nom del camp en JSON associat amb els valors descoberts. En comparació amb `db.odbc.discovery[]`, aquest element no crea macros de descoberta de baix nivell al JSON retornat, de manera que no cal comprovar si els noms de columnes poden ser noms de macro vàlids . Les macros de descoberta de baix nivell es poden definir com una passa addicional si cal, emprant la funció [macro LLD personalitzada](/manual/discovery/low_level_discovery#custom_macros) amb JSONPath apuntant als valors descoberts al JSON retornat. Veieu també: [emprant db.odbc.get](#using_dbodbcget). ### Item keys The table provides details on the item keys that you can use with Zabbix Windows agent only. See also: [Minimum permission level for Windows agent items](/manual/appendix/items/win_permissions) |Key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |eventlog\[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>\]|<|<|<| |Event log monitoring.|Log|**name** - name of event log<br>**regexp** - regular expression describing the required pattern<br>**severity** - regular expression describing severity (case-insensitive).<br>This parameter accepts a regular expression based on the following values: "Information", "Warning", "Error", "Critical", "Verbose" (since Zabbix 2.2.0 running on Windows Vista or newer)<br>**source** - regular expression describing source identifier (case-insensitive; regular expression is supported since Zabbix 2.2.0)<br>**eventid** - regular expression describing the event identifier(s)<br>**maxlines** - 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:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br><br>Examples:<br>=> eventlog\[Application\]<br>=> eventlog\[Security,,"Failure Audit",,^(529\|680)$\]<br>=> eventlog\[System,,"Warning\|Error"\]<br>=> eventlog\[System,,,,^1$\]<br>=> eventlog\[System,,,,@TWOSHORT\] - here a [custom regular expression](/manual/regular_expressions) named `TWOSHORT` is referenced (defined as a *Result is TRUE* type, the expression itself being `^1$\|^70$`).<br><br>*Note* that the agent is unable to send in events from the "Forwarded events" log.<br><br>The `mode` parameter is supported since Zabbix 2.0.0.<br>"Windows Eventing 6.0" is supported since Zabbix 2.2.0.<br><br>Note that 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.<br><br>See also additional information on [log monitoring](/manual/config/items/itemtypes/zabbix_agent/log_items).| |net.if.list|<|<|<| |Network interface list (includes interface type, status, IPv4 address, description).|Text| |Supported since Zabbix agent version 1.8.1. Multi-byte interface names supported since Zabbix agent version 1.8.6. Disabled interfaces are not listed.<br><br>Note that enabling/disabling some components may change their ordering in the Windows interface name.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |perf\_counter\[counter,<interval>\]|<|<|<| |Value of any Windows performance counter.|Integer, float, string or text (depending on the request)|**counter** - path to the counter<br>**interval** - last N seconds for storing the average value.<br>The `interval` must be between 1 and 900 seconds (included) and the default value is 1.|Performance Monitor can be used to obtain list of available counters. Until version 1.6 this parameter will return correct value only for counters that require just one sample (like \\System\\Threads). It will not work as expected for counters that require more than one sample - like CPU utilization. Since 1.6, `interval` is used, so the check returns an average value for last "interval" seconds every time.<br>This item follows UNC paths, which can be a [security risk](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).<br><br>See also: [Windows performance counters](/manual/config/items/perfcounters).| |perf\_counter\_en\[counter,<interval>\]|<|<|<| |Value of any Windows performance counter in English.|Integer, float, string or text (depending on the request)|**counter** - path to the counter in English<br>**interval** - last N seconds for storing the average value.<br>The `interval` must be between 1 and 900 seconds (included) and the default value is 1.|This item is only supported on **Windows Server 2008/Vista** and above.<br><br>You can find the list of English strings by viewing the following registry key: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.<br>This item follows UNC paths, which can be a [security risk](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).<br><br>Supported since Zabbix agent versions 4.0.13 and 4.2.7.| |perf\_instance.discovery\[object\]|<|<|<| |List of object instances of Windows performance counters. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|JSON object|**object** - object name (localized)|Supported since Zabbix agent version 5.0.1.| |perf\_instance\_en.discovery\[object\]|<|<|<| |List of object instances of Windows performance counters, discovered using object names in English. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|JSON object|**object** - object name (in English)|Supported since Zabbix agent version 5.0.1.| |proc\_info\[process,<attribute>,<type>\]|<|<|<| |Various information about specific process(es).|Float|**process** - process name<br>**attribute** - requested process attribute<br>**type** - representation type (meaningful when more than one process with the same name exists)|The following `attributes` are supported:<br>*vmsize* (default) - size of process virtual memory in Kbytes<br>*wkset* - size of process working set (amount of physical memory used by process) in Kbytes<br>*pf* - number of page faults<br>*ktime* - process kernel time in milliseconds<br>*utime* - process user time in milliseconds<br>*io\_read\_b* - number of bytes read by process during I/O operations<br>*io\_read\_op* - number of read operation performed by process<br>*io\_write\_b* - number of bytes written by process during I/O operations<br>*io\_write\_op* - number of write operation performed by process<br>*io\_other\_b* - number of bytes transferred by process during operations other than read and write operations<br>*io\_other\_op* - number of I/O operations performed by process, other than read and write operations<br>*gdiobj* - number of GDI objects used by process<br>*userobj* - number of USER objects used by process<br><br>Valid `types` are:<br>*avg* (default) - average value for all processes named <process><br>*min* - minimum value among all processes named <process><br>*max* - maximum value among all processes named <process><br>*sum* - sum of values for all processes named <process><br><br>Examples:<br>=> proc\_info\[iexplore.exe,wkset,sum\] - to get the amount of physical memory taken by all Internet Explorer processes<br>=> proc\_info\[iexplore.exe,pf,avg\] - to get the average number of page faults for Internet Explorer processes<br><br>Note that on a 64-bit system, a 64-bit Zabbix agent is required for this item to work correctly.| |service.discovery|<|<|<| |List of Windows services. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_services).|JSON object| |Supported since Zabbix agent version 3.0.| |service.info\[service,<param>\]|<|<|<| |Information about a service.|Integer - with `param` as *state*, *startup*<br><br>String - with `param` as *displayname*, *path*, *user*<br><br>Text - with `param` as *description*<br><br>Specifically for *state*:<br>0 - running,<br>1 - paused,<br>2 - start pending,<br>3 - pause pending,<br>4 - continue pending,<br>5 - stop pending,<br>6 - stopped,<br>7 - unknown,<br>255 - no such service<br><br>Specifically for *startup*:<br>0 - automatic,<br>1 - automatic delayed,<br>2 - manual,<br>3 - disabled,<br>4 - unknown,<br>5 - automatic trigger start,<br>6 - automatic delayed trigger start,<br>7 - manual trigger start|**service** - a real service name or its display name as seen in MMC Services snap-in<br>**param** - *state* (default), *displayname*, *path*, *user*, *startup* or *description*|Examples:<br>=> service.info\[SNMPTRAP\] - state of the SNMPTRAP service<br>=> service.info\[SNMP Trap\] - state of the same service, but with display name specified<br>=> service.info\[EventLog,startup\] - startup type of the EventLog service<br><br>Items service.info\[service,state\] and service.info\[service\] will return the same information.<br><br>Note that only with `param` as *state* this item returns a value for non-existing services (255).<br><br>This item is supported since Zabbix 3.0.0. It should be used instead of the deprecated service\_state\[service\] item.| |services\[<type>,<state>,<exclude>\]|<|<|<| |Listing of services.|0 - if empty<br><br>Text - list of services separated by a newline|**type** - *all* (default), *automatic*, *manual* or *disabled*<br>**state** - *all* (default), *stopped*, *started*, *start\_pending*, *stop\_pending*, *running*, *continue\_pending*, *pause\_pending* or *paused*<br>**exclude** - services to exclude from the result. Excluded services should be listed in double quotes, separated by comma, without spaces.|Examples:<br>=> services\[,started\] - list of started services<br>=> services\[automatic, stopped\] - list of stopped services, that should be run<br>=> services\[automatic, stopped, "service1,service2,service3"\] - list of stopped services, that should be run, excluding services with names service1, service2 and service3<br><br>The `exclude` parameter is supported since Zabbix 1.8.1.| |wmi.get\[<namespace>,<query>\]|<|<|<| |Execute WMI query and return the first selected object.|Integer, float, string or text (depending on the request)|**namespace** - WMI namespace<br>**query** - WMI query returning a single object<br>|WMI queries are performed with [WQL](https://en.wikipedia.org/wiki/WQL).<br><br>Example:<br>=> wmi.get\[root\\cimv2,select status from Win32\_DiskDrive where Name like '%PHYSICALDRIVE0%'\] - returns the status of the first physical disk<br><br>This key is supported since Zabbix 2.2.0.| |wmi.getall\[<namespace>,<query>\]|<|<|<| |Execute WMI query and return the whole response.<br><br>Can be used for [low-level discovery](/manual/discovery/low_level_discovery/examples/wmi).|JSON object|**namespace** - WMI namespace<br>**query** - WMI query<br>|WMI queries are performed with [WQL](https://en.wikipedia.org/wiki/WQL).<br><br>Example:<br>=> wmi.getall\[root\\cimv2,select \* from Win32\_DiskDrive where Name like '%PHYSICALDRIVE%'\] - returns status information of physical disks<br><br>JSONPath [preprocessing](/manual/config/items/item#item_value_preprocessing) can be used to point to more specific values in the returned JSON.<br><br>This key is supported since Zabbix 4.4.0.| |vm.vmemory.size\[<type>\]|<|<|<| |Virtual memory size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**type** - possible values:<br>*available* (available virtual memory), *pavailable* (available virtual memory, in percent), *pused* (used virtual memory, in percent), *total* (total virtual memory, default), *used* (used virtual memory)|Example:<br>=> vm.vmemory.size\[pavailable\] → available virtual memory, in percentage<br><br>Monitoring of virtual memory statistics is based on:<br>\* Total virtual memory on Windows (total physical + page file size);<br>\* The maximum amount of memory Zabbix agent can commit;<br>\* The current committed memory limit for the system or Zabbix agent, whichever is smaller.<br><br>This key is supported since Zabbix 3.0.7 and 3.2.3.| #### Claus d'element La taula té els detalls de les claus d'element que podem emprar només amb l'agent Zabbix Windows. Veieu també: [Nivell d'autorització mínim per als elements de l'agent Windows](/manual/appendix/items/win_permissions) |Clau|<|<|<| |--|--|------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |eventlog\[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>\]|<|<|<| |Monitoratge del registre d'esdeveniments.|Registre|**name** - nom del registre d'esdeveniments<br>**regexp** - expressió regular descrivint el model demanat<br>**severity** - expressió regular descrivint la gravetat (insensible a majúscules i minúscules)<br>Aquest paràmetre admet els valors següents: "Information", "Warning", "Error", "Critical", "Verbose" (des de Zabbix 2.2.0 funciona sota Windows Vista o posterior)<br>**source** - expressió regular descrivint l'identificador de la font (insensible a majúscules i minúscules; l'expressió regular s'admet des de Zabbix 2.2.0)<br>**eventid** - expressió regular descrivint el o les identificadors d'esdeveniment<br>**maxlines** - màxim nombre de noves línies per segon que l'agent enviarà al servidor o al proxy Zabbix. Aquest paràmetre substitueix el valor de 'MaxLinesPerSecond' a [zabbix\_agentd.win.conf](/manual/appendix/config/zabbix_agentd_win)<br>**mode** - valors possibles:<br>*all* (per defecte) , *skip* - ignora el tractament de les dades més antigues(només afecta els elements nous creats).|L'element s'ha de configurar com a [verificació activa](/manual/appendix/items/activepassive#active_checks).<br><br>Exemples:<br>=> eventlog\[Application\]<br>=> eventlog\[Security,,"Failure Audit",,\^(529\|680)\$\]<br>=> eventlog\[System,,"Warning\|Error"\]<br>=> eventlog\[System,,,,^1\$\]<br>=> eventlog\[System,,,,\@TWOSHORT\] - aquí una [expressió regular personalitzada](/manual/regular_expressions) anomenada `TWOSHORT` és referenciada (definida com un tipus *Resultat és CERT*, l'expressió pròpia essent `^1$\|^70$`).<br><br>*Veieu* que l'agent no pot pas enviar els esdeveniments a partir del registre "Esdeveniments transferits".<br><br>El paràmetre `mode` s'admet des de Zabbix 2.0.0.<br>"Windows Eventing 6.0" s'admet des de Zabbix 2.2.0.<br><br>Veieu que la secció d'un [tipus d'informacions](/manual/config/items/item#configuration) no-registre d'aquest element provocarà la pèrdua de la marca de temps local, així com la gravetat del registre i la informació d'origen.<br><br>Veieu també les informacions addicionals a [monitoratge dels registres](/manual/config/items/itemtypes/zabbix_agent/log_items).| |net.if.list|<|<|<| |Llista de les interfícies de xarxa (conté el tipus interfície, estat, adreça IPv4, descripció).|Text| |A més des de la versió 1.8.1 de l'agent Zabbix. Noms d'interfície multi-octets admesos des de la versió 1.8.6 de l'agent Zabbix. Les interfícies desactivades no són pas llistades.<br><br>Veieu que l'activació/desactivació d'alguns components pot modificar el seu ordre dins el nom de la interfície Windows.<br><br>Algunes versions de Windows (per exemple, Server 2008) poden requerir les darreres actualitzacions instal·lades per admetre caràcters no ASCII als noms d'interfície.| |perf\_counter\[counter,\<interval\>\]|<|<|<| |Valor de qualsevol comptador de rendiment de Windows.|Enter, flotant, cadena o text (segons la petició)|**counter** - ruta cap al comptador <br>**interval** - darrers N segons per emmagatzemar la mitjana.<br>L'interval ha d'estar entre 1 i 900 segons (inclosos) i el valor per defecte és 1.|Monitor de Rendiment es pot emprar per obtindre la llista de comptadors disponibles. Fins la versió 1.6, aquest paràmetre tornarà un valor correcte només per els comptadors que necessiten només una sola mostra (com ara \\System\\Threads). No funcionarà pas com és previst per els comptadors que necessiten més d'una mostra, com l'ús del processador. Des de la versió 1.6, `interval` s'empra, doncs la verificació torna un valor mitjà per els darrers "intervals" cada vegada.<br>Aquest element segueix camins UNC, que podria ésser un [risc de seguretat](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).<br><br>Veieu també: [Comptadors de rendiment Windows](/manual/config/items/perfcounters). | |perf\_counter\_en\[counter,\<interval\>\]|<|<|<| |Valor de qualsevol comptador de rendiment de Windows en anglès.|Enter, flotant, cadena o text (segons la petició)|**counter** - camí cap al comptador en anglès<br>**interval** - darrers N segons per emmagatzemar la mitjana.<br>L'interval ha d'ésser entre 1 i 900 segons (inclosos) i el valor per defecte és 1.|Aques element només s'admet a **Windows Server 2008/Vista** i superiors.<br><br>Podeu trobar una llista de les cadenes en anglès afegint la clau de registre següent: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.<br>Aquest element segueix camins UNC, que podria ésser un [risc de seguretat](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).<br><br>Admès des de les versions 4.0.13 de l'agent Zabbix i 4.2.7.| |perf\_instance.discovery\[object\]|<|<|<| |Llista de les instàncies d'objectes dels comptadors de rendiment Windows. Emprat per la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|Objecte JSON|**object** - nom de l'objecte (localitzat)|Admès des de la versió 5.0.1 de l'agent Zabbix.| |perf\_instance\_en.discovery\[object\]|<|<|<| |Llista d'instàncies d'objectes de comptadors de rendiment de Windows, descobertes amb noms d'objectes en anglès. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|Objecte JSON|**object** - nom de l'objecte (en anglès)|Admès des de la versió 5.0.1 de l'agent Zabbix.| |proc\_info\[process,\<attribute\>,\<type\>\]|<|<|<| |Informacions diverses dels processos específics.|Flotant|**process** - nom del procés<br>**attribut** - atribut de procés demanat<br>**type** - tipus de representació (significatiu quan existeixen diversos processos amb el mateix nom)|Els `atributs` següents s'admeten:<br>*vmsize* (per defecte) - mida de la memòria virtual dels processos, en Ko<br>*wkset* - mida del conjunt de treball dels processos (quantitat de memòria física emprada per els processos) en Ko<br>*pf* - nombre d'errors de pàgina<br>*ktime* - temps de tractament del nucli, en mil·lisegons<br>*utime* - temps de tractament de l'usuari, en mil·lisegons<br>*io\_read\_b* - nombre d'octets llegits per el procés durant les operacions d'E/S<br>*io\_read\_op* - nombre d'operacions de lectura fetes per el procés<br>*io\_write\_b* - nombre d'octets escrits per el procés durant les operacions d'E/S<br>*io\_write\_op* - nombre d'operacions d'escriptura fetes per el procés<br>*io\_other\_b* - nombre de bytes transferits pel procés durant operacions diferents de les operacions de lectura i escriptura<br>*io\_other\_op* - nombre d'operacions d'E/S fetes per el procés, excepte les operacions de lectura i escriptura<br>*gdiobj* - nombre d'objectes GDI emprats per el procés<br>*userobj* - nombre d'objectes USER emprats per el procés<br><br>Els `types` vàlids són:<br>*avg* (per defecte) - valor mitjà per tots els processos nomenats\<process\><br>*min* - valor mínim per tots els processos nomenats\<process\><br>*max* - valor màxim per tots els processos nomenats\<process\><br>*sum* - alguns dels valors de tots els processos nomenats\<process\><br><br>Exemples:<br>=> proc\_info\[iexplore.exe,wkset,sum\] - per obtindre la quantitat de memòria física emprada per tots els processos d'Internet Explorer<br>=> proc\_info\[iexplore.exe,pf,avg\] - per obtindre la mitjana d'errades de pàgina per els processos d'Internet Explorer<br><br>Veieu que en un sistema de 64 bits, un agent Zabbix de 64 bits és obligatori per tal que aquest element funcioni correctament.| |service.discovery|<|<|<| |Llista de serveis Windows. Emprat per la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_services).|Objecte JSON| |Admès des de la versió 3.0 de l'agent Zabbix.| |service.info\[service,\<param\>\]|<|<|<| |Informacions d'un servei.|Enter - amb `param` definit a *state*, *startup*<br><br>Cadena - amb `param` definit a *displayname*, *path*, *user*<br><br> Test - amb `param` definit a *description*<br><br>Específicament per *state* :<br>0 - executant-se,<br>1 - pausat,<br>2 - pendent d'inici,<br>3 - pausat d'inici,<br>4 - continuar d'inici,<br>5 - aturar en inici,<br>6 - aturat,<br>7 - desconegut,<br>255 - cap servei d'aquest tipus<br><br>Específicament per *startup* :<br>0 - automàtic,<br>1 - automàtic endarrerit,<br>2 - manual,<br>3 - desactivat,<br>4 - desconegut,<br>5 - trigger automàtic,<br>6 - inici automàtic del trigger endarrerit,<br>7 - inici manual del trigger|**service** - un nom de servei real o el seu nom de visualització tal com apareix al complement de Serveis MMC<br>**param** - *state * (per defecte), *displayname*, *path*, *user*, *startup* o *description*|Exemples:<br>=> service.info\[SNMPTRAP\] - estat del servei SNMPTRAP<br>=> service.info\[SNMP Trap\] - estat del mateix servei, però amb el nom de visualització especificat<br>=> service.info\[EventLog,startup\ ] - tipus d'inici del servei EventLog<br><br>Els elements service.info\[service,state\] i service.info\[service\] tornaran la mateixa informació.<br><br>Veieu que només amb `param` definit a *state* aquest element retorna un valor per els serveis inexistents (255).<br><br>S'admet aquest element des de Zabbix 3.0.0. S'ha d'emprar en lloc de l'element obsolet service\_state\[service\].| |services\[\<type\>,\<state\>,\<exclude\>\]|<|<|<| |Llistat dels serveis.|0 - si vide<br><br>Texte - llista dels serveis separats per una nova línia|**type** - *all* (per defecte), *automatic*, *manual* ou *disabled* <br>**state** - *all* (per defecte), *stopped*, *started*, *start\_pending*, *stop\_pending*, *running*, *continue\_pending*, *pause\_pending* o *paused*<br>**exclude** - serveix a excloure del resultat. Els serveis exclosos s'han de llistat entre cometes dobles, separades per una coma, sense espais.|Exemples:<br>=> services\[,started\] - llista dels serveis engegats<br>=> services\[automatic, stopped\] - llista dels serveis aturats, que s'han d'engegar<br>=> services\[automatic, stopped, "service1,service2,service3"\] - llista dels serveis aturats, que s'han d'engegar, excloent els serveis anomenats service1, service2 i service3 <br><br>El paràmetre `exclude` s'admet es de Zabbix 1.8.1.| |wmi.get\[\<namespace\>,\<query\>\]|<|<|<| |Executa la petició WMI i retorna el primer objecte trobat.|Enter, flotant, cadena o text (segons la petició)|**namespace** - Espai de noms WMI<br>**query** - Petció WMI retornant un sol objecte<br>|Les peticions WMI es fan amb [WQL](https://ca.wikipedia.org/wiki/WQL).<br><br>Exemple:<br>=> wmi.get\[root\\cimv2,select status from Win32\_DiskDrive where Name like '%PHYSICALDRIVE0%'\] - retorna l'estat del primer disc físic<br><br>Auesta clau s'admet des de Zabbix 2.2.0.| |wmi.getall\[\<namespace\>,\<query\>\]|<|<|<| |Executa la petició WMI i retorna la resposta sencera.<br><br>Es pot emprar per la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/wmi).|Objecte JSON|**namespace** - Espai de noms WMI<br>**query** - Petició WMI<br>|Les peticions WMI es fan via [WQL](https://ca.wikipedia.org/wiki/WQL).<br><br>Exemple:<br>=> wmi.getall\[root\\cimv2,select \* from Win32\_DiskDrive where Name like '%PHYSICALDRIVE%'\] - retorna la informació d'estat dels discs físics<br><br>Le [tractament previ](/manual /config/items/item#item_value_preprocessing) JSON es pot emprar per apuntar a valors més específics al JSON retornat.<br><br>Aquesta clau s'admet des de Zabbix 4.4.0.| |vm.vmemory.size\[\<type\>\]|<|<|<| |Mida de la memòria virtual en octets o en percentatge del total.|Enter - per els octets<br><br>Flotant - per el percentatge|**type** - valors possibles :<br>*available* (memòria virtual disponible), * pavailable* (memòria virtual disponible, en percentatge), *pused* (memòria virtual emprada, en percentatge), *total* (memòria virtual total, per defecte), *used* (memòria virtual emprada)|Exemple:<br>=> vm.vmemory.size\[pavailable\] → memòria virtual disponible, en percentatge<br><br>El monitoratge de les estadístiques de la memòria virtual es basa en:<br>\* Memòria virtual total sota Windows (física total + mida de l'arxiu d'intercanvi) ;<br>\* La quantitat màxima de memòria que l'agent Zabbix pot validar;<br>\* El límit actual de memòria validada per el sistema o l'agent Zabbix, segons el valor més petit.<br><br>Aquesta clau s'admet des de Zabbix 3.0.7 i 3.2.3.| #### Item keys The table provides details on the simple checks that can be used to monitor [VMware environments](/manual/vm_monitoring). Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. |Key|<|<|<|<| |-|------|--|------|------| |<|Description|Return value|Parameters|Comments| |vmware.cl.perfcounter\[url,id,path,<instance>\]|<|<|<|<| |<|VMware cluster performance counter metrics.|Integer|**url** - VMware service URL<br>**id** - VMware cluster ID<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance|`id` can be received from vmware.cluster.discovery\[\] as {\#CLUSTER.ID}| |vmware.cluster.discovery\[url\]|<|<|<|<| |<|Discovery of VMware clusters.|JSON object|**url** - VMware service URL|<| |vmware.cluster.status\[url,name\]|<|<|<|<| |<|VMware cluster status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**name** - VMware cluster name|<| |vmware.datastore.discovery\[url\]|<|<|<|<| |<|Discovery of VMware datastores.|JSON object|**url** - VMware service URL|<| |vmware.datastore.hv.list\[url,datastore\]|<|<|<|<| |<|List of datastore hypervisors.|JSON object|**url** - VMware service URL<br>**datastore** - datastore name|<| |vmware.datastore.read\[url,datastore,<mode>\]|<|<|<|<| |<|Amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.datastore.size\[url,datastore,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.datastore.write\[url,datastore,<mode>\]|<|<|<|<| |<|Amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.dc.discovery\[url\]|<|<|<|<| |<|Discovery of VMware datacenters.|JSON object|**url** - VMware service URL|<| |vmware.eventlog\[url,<mode>\]|<|<|<|<| |<|VMware event log.|Log|**url** - VMware service URL<br>**mode** - *all* (default), *skip* - skip processing of older data|There must be only one vmware.eventlog\[\] item key per URL.<br><br>See also: [example of filtering](/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records) VMware event log records.| |vmware.fullname\[url\]|<|<|<|<| |<|VMware service full name.|String|**url** - VMware service URL|<| |vmware.hv.cluster.name\[url,uuid\]|<|<|<|<| |<|VMware hypervisor cluster name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.cpu.usage\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.cpu.usage.perf\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.cpu.utilization\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval, depends on power management or HT.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datacenter.name\[url,uuid\]|<|<|<|<| |<|VMware hypervisor datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.list\[url,uuid\]|<|<|<|<| |<|List of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.multipath\[url,uuid,<datastore>,<partitionid>\]|<|<|<|<| |<|Number of available datastore paths.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore UUID or name<br>**partitionid** - internal ID of physical device from vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[url,uuid,datastore,<mode>\]|<|<|<|<| |<|Average amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore UUID or name<br>**mode** - latency (default)|<| |vmware.hv.datastore.size\[url,uuid,datastore,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore UUID or name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.hv.datastore.write\[url,uuid,datastore,<mode>\]|<|<|<|<| |<|Average amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore UUID or name<br>**mode** - latency (default)|<| |vmware.hv.discovery\[url\]|<|<|<|<| |<|Discovery of VMware hypervisors.|JSON object|**url** - VMware service URL|<| |vmware.hv.fullname\[url,uuid\]|<|<|<|<| |<|VMware hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.freq\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor frequency (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.model\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.num\[url,uuid\]|<|<|<|<| |<|Number of processor cores on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.threads\[url,uuid\]|<|<|<|<| |<|Number of processor threads on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.memory\[url,uuid\]|<|<|<|<| |<|VMware hypervisor total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.model\[url,uuid\]|<|<|<|<| |<|VMware hypervisor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.uuid\[url,uuid\]|<|<|<|<| |<|VMware hypervisor BIOS UUID.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.vendor\[url,uuid\]|<|<|<|<| |<|VMware hypervisor vendor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.maintenance\[url,uuid\]|<|<|<|<| |<|VMware hypervisor maintenance status.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|Returns '0' - not in maintenance or '1' - in maintenance| |vmware.hv.memory.size.ballooned\[url,uuid\]|<|<|<|<| |<|VMware hypervisor ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.memory.used\[url,uuid\]|<|<|<|<| |<|VMware hypervisor used memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.network.in\[url,uuid,<mode>\]|<|<|<|<| |<|VMware hypervisor network input statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**mode** - bps (default)|<| |vmware.hv.network.out\[url,uuid,<mode>\]|<|<|<|<| |<|VMware hypervisor network output statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**mode** - bps (default)|<| |vmware.hv.perfcounter\[url,uuid,path,<instance>\]|<|<|<|<| |<|VMware hypervisor performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.hv.power\[url,uuid,<max>\]|<|<|<|<| |<|VMware hypervisor power usage (W).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**max** - maximum allowed power usage|<| |vmware.hv.sensor.health.state\[url,uuid\]|<|<|<|<| |<|VMware hypervisor health state rollup sensor.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|The item might not work in the VMware vSphere 6.5 and newer, because VMware has deprecated the *VMware Rollup Health State* sensor. | |vmware.hv.sensors.get\[url,uuid\]|<|<|<|<| |<|VMware hypervisor HW vendor state sensors.|JSON|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.status\[url,uuid\]|<|<|<|<| |<|VMware hypervisor status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|Uses the host system overall status property.| |vmware.hv.uptime\[url,uuid\]|<|<|<|<| |<|VMware hypervisor uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.version\[url,uuid\]|<|<|<|<| |<|VMware hypervisor version.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.vm.num\[url,uuid\]|<|<|<|<| |<|Number of virtual machines on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.version\[url\]|<|<|<|<| |<|VMware service version.|String|**url** - VMware service URL|<| |vmware.vm.cluster.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.latency\[url,uuid\]|<|<|<|<| |<|Percentage of time the virtual machine is unable to run because it is contending for access to the physical CPU(s).|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.num\[url,uuid\]|<|<|<|<| |<|Number of processors on VMware virtual machine.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.readiness\[url,uuid,<instance>\]|<|<|<|<| |<|Percentage of time that the virtual machine was ready, but could not get scheduled to run on the physical CPU.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - CPU instance|<| |vmware.vm.cpu.ready\[url,uuid\]|<|<|<|<| |<|Time (in milliseconds) that the virtual machine was ready, but could not get scheduled to run on the physical CPU. CPU ready time is dependent on the number of virtual machines on the host and their CPU loads (%).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.swapwait\[url,uuid,<instance>\]|<|<|<|<| |<|Percentage of CPU time spent waiting for swap-in.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - CPU instance|<| |vmware.vm.cpu.usage\[url,uuid\]|<|<|<|<| |<|VMware virtual machine processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.usage.perf\[url,uuid\]|<|<|<|<| |<|VMware virtual machine processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.datacenter.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.discovery\[url\]|<|<|<|<| |<|Discovery of VMware virtual machines.|JSON object|**url** - VMware service URL|<| |vmware.vm.guest.memory.size.swapped\[url,uuid\]|<|<|<|<| |<|Amount of guest physical memory that is swapped out to the swap space (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.guest.osuptime\[url,uuid\]|<|<|<|<| |<|Total time elapsed since the last operating system boot-up (in seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.hv.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size\[url,uuid\]|<|<|<|<| |<|VMware virtual machine total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.ballooned\[url,uuid\]|<|<|<|<| |<|VMware virtual machine ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.compressed\[url,uuid\]|<|<|<|<| |<|VMware virtual machine compressed memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.consumed\[url,uuid\]|<|<|<|<| |<|Amount of host physical memory consumed for backing up guest physical memory pages (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.private\[url,uuid\]|<|<|<|<| |<|VMware virtual machine private memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.shared\[url,uuid\]|<|<|<|<| |<|VMware virtual machine shared memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.swapped\[url,uuid\]|<|<|<|<| |<|VMware virtual machine swapped memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.usage.guest\[url,uuid\]|<|<|<|<| |<|VMware virtual machine guest memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.usage.host\[url,uuid\]|<|<|<|<| |<|VMware virtual machine host memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.usage\[url,uuid\]|<|<|<|<| |<|Percentage of host physical memory that has been consumed.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.net.if.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware virtual machine network interfaces.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.net.if.in\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface input statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.out\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface output statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.usage\[url,uuid,<instance>\]|<|<|<|<| |<|VMware virtual machine network utilization (combined transmit-rates and receive-rates) during the interval (KBps).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - network interface instance|<| |vmware.vm.perfcounter\[url,uuid,path,<instance>\]|<|<|<|<| |<|VMware virtual machine performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.vm.powerstate\[url,uuid\]|<|<|<|<| |<|VMware virtual machine power state.|Integer:<br>0 - poweredOff;<br>1 - poweredOn;<br>2 - suspended|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.committed\[url,uuid\]|<|<|<|<| |<|VMware virtual machine committed storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.readoio\[url,uuid,instance\]|<|<|<|<| |<|Average number of outstanding read requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalreadlatency\[url,uuid,instance\]|<|<|<|<| |<|The average time a read from the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalwritelatency\[url,uuid,instance\]|<|<|<|<| |<|The average time a write to the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.uncommitted\[url,uuid\]|<|<|<|<| |<|VMware virtual machine uncommitted storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.unshared\[url,uuid\]|<|<|<|<| |<|VMware virtual machine unshared storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.writeoio\[url,uuid,instance\]|<|<|<|<| |<|Average number of outstanding write requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.uptime\[url,uuid\]|<|<|<|<| |<|VMware virtual machine uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.vfs.dev.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware virtual machine disk devices.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.vfs.dev.read\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device read statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.dev.write\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device write statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.fs.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware virtual machine file systems.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|VMware Tools must be installed on the guest virtual machine.| |vmware.vm.vfs.fs.size\[url,uuid,fsname,<mode>\]|<|<|<|<| |<|VMware virtual machine file system statistics (bytes/percentages).|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**fsname** - file system name<br>**mode** - total/free/used/pfree/pused|VMware Tools must be installed on the guest virtual machine.| #### Claus d'element La taula proporciona detalls de comprovacions senzilles que es poden emprar per monitorar [entorns VMware](/manual/vm_monitoring). Els paràmetres sense claudàtors angulars són obligatoris. Els paràmetres marcats amb claudàtors angulars **<** **>** són opcionals. |Clau|<|<|<|<| |-|------|--|------|------| |<|Descripció|Valor de retorn|Paràmetres|Comentaris| |vmware.cl.perfcounter\[\<url\>,\<id\>,\<camí\>,\<instància\>\]|<|<|<|<| |<|Mètriques del comptador de rendiment del clúster de VMware.|Enter|**url** - URL del servei de VMware<br>**id** - identificador del clúster de VMware<br>**camí** - camí del comptador <br>**instància** - la instància del comptador de rendiment|`id` es pot rebre des de vmware.cluster.discovery\[\] com a {\#CLUSTER.ID}| |vmware.cluster.discovery\[\<url\>\]|<|<|<|<| |<|Es descobreixen clústers de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.cluster.status\[\<url\>, \<nom\>\]|<|<|<|<| |<|Estat del clúster de VMware.|Enter:<br>0 - gris;<br>1 - verd;<br>2 - groc;<br>3 - vermell|**url** - URL del servei de VMware< br> **nom** - nom del clúster de VMware|<| |vmware.datastore.discovery\[\<url\>\]|<|<|<|<| |<|Es descobreixen magatzems de dades de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.datastore.hv.list\[\<url\>,\<datastore\>\]|<|<|<|<| |<|Llista d'hipervisors del magatzem de dades.|Objecte JSON|**url** - URL del servei VMware<br>**datastore** - nom o UUID del magatzem de dades|<| |vmware.datastore.read\[\<url\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Durada d'una operació de lectura des del magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br> **datastore** - nom o UUID del magatzem de dades<br>**mode** - latència (valor mitjà, predeterminat), latència màxima (valor màxim)|<| |vmware.datastore.size\[\<url\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Espai del magatzem de dades VMware en octets o percentatge del total.|Enter - per octets<br>Flotant - per percentatge|**url** - URL del servei VMware<br>**datastore** - nom o UUID del magatzem de dades<br> **mode** - valors possibles:<br>total (predeterminat), lliure, pfree (lliure, percentatge), no compromès|<| |vmware.datastore.write\[\<url\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Durada d'una operació d'escriptura al magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br> **datastore** - nom o UUID del magatzem de dades<br>**mode** - latència (valor mitjà, predeterminat), latència màxima (valor màxim)|<| |vmware.dc.discovery\[\<url\>\]|<|<|<|<| |<|Descobrint centres de dades de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.eventlog\[\<url\>,\<mode\>\]|<|<|<|<| |<|Registre d'esdeveniments de VMware.|Registre|**url** - URL del servei de VMware<br>**mode** - *tot* (per defecte), *omet* - omet el processament de dades més antigues| Només hi hauria d'haver un vmware.eventlog\[\] element vle per URL.<br><br>Veieu també: [exemple de filtrat](/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records) Registres del registre d'esdeveniments de VMware.| |vmware.fullname\[\<url\>\]|<|<|<|<| |<|Nom complet del servei VMware.|String|**url** - URL del servei VMware|<| |vmware.hv.cluster.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del clúster de l'hipervisor VMware.|String|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.cpu.usage\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de la CPU de VMware Hypervisor (Hz).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor|<| |vmware.hv.cpu.usage.perf\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de la CPU de l'hipervisor VMware en percentatge durant l'interval.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware| <| |vmware.hv.cpu.utilization\[\<url\>,\<uuid\>\]|<|<|<|<| |<|L'ús de la CPU de l'hipervisor VMware en percentatge durant l'interval, depèn de la gestió d'energia o de l'HT.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datacenter.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del centre de dades de l'hipervisor VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datastore.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Es descobreixenmagatzems de dades de l'hipervisor de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datastore.list\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Llista de magatzems de dades de l'hipervisor de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datastore.multipath\[\<url\>,\<uuid\>,\<datastore\>,\<partitionid\>\]|<|<|<|<| |<|Nombre de camins de magatzem de dades disponibles.|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor de VMware<br>**magatzem de dades** - Nom del magatzem de dades<br>**partitionid** - Identificador intern del dispositiu físic de vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[\<url\>,\<uuid\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Temps mitjà per a una operació de lectura des del magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br >**uuid** - Nom d'equip de l'hipervisor VMware<br>**magatzem de dades** - Nom del magatzem de dades<br>**mode** - latència (per defecte)|<| |vmware.hv.datastore.size\[\<url\>,\<uuid\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Espai del magatzem de dades de VMware en octets o percentatge del total.|Enter - per octets<br>Flotant - per percentatge|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware<br> **datastore** - nom o UUID del magatzem de dades<br>**mode** - valors possibles:<br>total (predeterminat), lliure, pfree (gratuït, percentatge), no compromès|<| |vmware.hv.datastore.write\[\<url\>,\<uuid\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Durada mitjana d'una operació d'escriptura de magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>* *uuid** - VMware nom d'equip de l'hipervisor<br>**magatzem de dades** - nom del magatzem de dades<br>**mode** - latència (per defecte)|<| |vmware.hv.discovery\[\<url\>\]|<|<|<|<| |<|Descoberta d'hipervisors de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.hv.nom complet\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom de l'hipervisor VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.cpu.freq\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Freqüència de CPU de VMware Hypervisor (Hz).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor|<| |vmware.hv.hw.cpu.model\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Model de CPU de l'hipervisor VMware.|String|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.cpu.num\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de nuclis de CPU a l'hipervisor VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.cpu.threads\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de fils de processador a l'hipervisor VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.memory\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida total de la memòria de l'hipervisor VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|< | |vmware.hv.hw.model\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Model d'hipervisor VMware.|String|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.uuid\[\<url\>,\<uuid\>\]|<|<|<|<| |<|VMware Hypervisor BIOS UUID.|String|**url** - URL del servei VMware<br>**uuid** - VMware Hypervisor Hostname|<| |vmware.hv.hw.vendor\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del proveïdor de l'hipervisor VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.maintenance\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Estat de manteniment de VMware Hypervisor.|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor|Retorna '0' - no és en manteniment o '1' - és en manteniment| |vmware.hv.memory.size.ballooned\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria inflada de l'hipervisor VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.memory.used\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria emprada de l'hipervisor VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware| <| |vmware.hv.network.in\[\<url\>,\<uuid\>,\<mode\>\]|<|<|<|<| |<|Estadístiques d'entrada a la xarxa d'hipervisor VMware (octets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br>* *uuid** - nom d'equip de l'hipervisor de VMware<br>**mode** - bps (per defecte)|<| |vmware.hv.network.out\[\<url\>,\<uuid\>,\<mode\>\]|<|<|<|<| |<|Estadístiques de sortida de la xarxa de l'hipervisor VMware (octets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>* *uuid** - VMware nom d'equip de l'hipervisor<br>**mode** - bps (per defecte)|<| |vmware.hv.perfcounter\[\<url\>,\<uuid\>,\<camí\>,\<instància\>\]|<|<|<|<| |<|Valor del comptador de rendiment de l'hipervisor VMware.|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware<br >**path** - camí del comptador de rendiment ^**[1](vmware_keys#footnotes)**^<br>**instància** - rendiment de la instància del comptador de rendiment. Empreu una instància buida per als valors afegits (per defecte)|<| |vmware.hv.power\[\<url\>,\<uuid\>,\<max\>\]|<|<|<|<| |<|Consum d'energia de VMware Hypervisor (W).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor<br> **max** - Consum d'energia màxim permès| << |vmware.hv.sensor.health.state\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Sensor acumulatiu de salut de l'hipervisor VMware.|Enter:<br>0 - gris;<br>1 - verd;<br>2 - groc;<br>3 - vermell|* *url** - URL del servei VMware < br>**uuid** - Nom d'equip de VMware Hypervisor|És possible que l'element no funcioni a VMware vSphere 6.5 i posterior perquè VMware ha deixat obsolet el sensor * VMware Rollup HealthState*.| |vmware.hv.sensors.get\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Sensors d'estat del proveïdor de maquinari de l'hipervisor VMware.|JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.status\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Estat de l'hipervisor VMware.|Enter:<br>0 - gris;<br>1 - verd;<br>2 - groc;<br>3 - vermell|**url** - URL del servei VMware<br> **uuid** - nom d'equip de l'hipervisor VMware|Empra la propietat d'estat general del sistema equip.| |vmware.hv.uptime\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Temps d'activitat de l'hipervisor VMware (segons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware|<| |vmware.hv.version\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Versió de l'hipervisor de VMware.|String|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor de VMware|<| |vmware.hv.vm.num\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de màquines virtuals a l'hipervisor VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.version\[\<url\>\]|<|<|<|<| |<|Versió del servei VMware.|String|**url** - URL del servei VMware|<| |vmware.vm.cluster.name\[\<url\>,\<uuid>\]|<|<|<|<| |<|Nom de VMware VM.|String|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.cpu.latency\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Percentatge de temps que la màquina virtual no es pot executar perquè està en disputa per accedir a les CPU físiques.|Flotant|**url** - URL del servei de VMware<br> **uuid** - nom d'equip de la màquina virtual VMware|<| |vmware.vm.cpu.num\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de processadors a la màquina virtual VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de la màquina virtual VMware|<| |vmware.vm.cpu.readiness\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Percentatge de temps que la VM va estar a punt, però no s'ha pogut programar per executar-se a la CPU física.|Flotant|**url** - URL del servei de VMware<br>**uuid ** - Nom d'equip de la màquina virtual de VMware< br>**instància** - instància de CPU|<| |vmware.vm.cpu.ready\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Durada (en mil·lisegons) que la màquina virtual estava preparada, però no s'ha pogut programar per executar-se a la CPU física. El temps d'activitat de la CPU depèn del nombre de màquines virtuals de l'equip i de les seves càrregues de CPU (%).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL VMware Service<br >**uuid** - Nom d'equip de la màquina virtual de VMware|<| |vmware.vm.cpu.swapwait\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Percentatge de temps de CPU dedicat a l'espera del canvi.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància de CPU|<| |vmware.vm.cpu.usage\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de la CPU de VMware VM (Hz).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.cpu.usage.perf\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de CPU de VMware VM en percentatge durant l'interval.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM| <| |vmware.vm.datacenter.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del datacenter de VMware VM.|String|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.discovery\[\<url\>\]|<|<|<|<| |<|Descoberta de màquines virtuals VMware.|Objecte JSON|**url** - URL del servei VMware|<| |vmware.vm.guest.memory.size.swapped\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Quantitat de memòria física convidada que s'intercanvia per espai d'intercanvi (Ko).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom de l'equip de la màquina virtual de vmware|<| |vmware.vm.guest.osuptime\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Temps total transcorregut des de la darrera engegada del sistema operatiu (en segons).|Enter|**url** - URL del servei VMware<br>**uuid** - Nom d'equip de la màquina virtual vmware|<| |vmware.vm.hv.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom de l'hipervisor de la màquina virtual VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware|<| |vmware.vm.memory.size\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida total de la memòria de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.memory.size.ballooned\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria inflada de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.memory.size.compressed\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria comprimida de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|< | |vmware.vm.memory.size.consumed\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Quantitat de memòria física de l'equip consumida per fer còpies de seguretat de pàgines de memòria física convidada (KB).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware|<| |vmware.vm.memory.size.private\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria privada de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|< | |vmware.vm.memory.size.shared\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria compartida de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|< | |vmware.vm.memory.size.swapped\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria bescanviada de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|< | |vmware.vm.memory.size.usage.guest\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de memòria convidada de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VM vmware|<| |vmware.vm.memory.size.usage.host\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de memòria de l'equip de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom de l'equip de la màquina vmware virtual|<| |vmware.vm.memory.usage\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Percentatge de memòria física de l'equip que s'ha consumit.|Flotant|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.net.if.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Descoberta d'interfícies de xarxa de màquines virtuals VMware.|Objecte JSON|**url** - URL del servei VMware<br>**uuid** - nom d'equip de la màquina virtual VMware|<| |vmware.vm.net.if.in\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques d'entrada de la interfície de xarxa de la màquina virtual de VMware (octets/paquets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei vmware<br>* *uuid** - nom d'equip de VM de vmware<br>**instància** - instància de la interfície de xarxa<br>**mode** - bps (per defecte)/pps - octets/paquets per segon|<| |vmware.vm.net.if.out\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques de sortida de la interfície de xarxa VMware VM (octets/paquets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància de la interfície de xarxa<br>**mode** - bps (per defecte)/pps - octets/paquets per segon|<| |vmware.vm.net.if.usage\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Ús de la xarxa de VMware VM (taxes combinades de transmissió i recepció) durant l'interval (Kops).|Enter|**url** - URL del servei de VMware<br>**uuid* * - Nom d'equip de la màquina virtual de VMware<br> **instància** - instància de la interfície de xarxa|<| |vmware.vm.perfcounter\[\<url\>,\<uuid\>,\<camí\>,\<instància\>\]|<|<|<|<| |<|Valor del comptador de rendiment de la màquina virtual VMware.|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware < br>**path** - camí del comptador de rendiment ^**[1](vmware_keys#footnotes)**^<br>**instància** - rendiment de la instància del comptador de rendiment. Empreu una instància buida per als valors afegits (per defecte)|<| |vmware.vm.powerstate\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Estat d'alimentació de VMware VM.|Enter:<br>0 - apagat;<br>1 - engegat;<br>2 - suspès|**url** - URL del servei de VMware <br>**uuid** - Nom d'equip de la màquina virtual VMware|<| |vmware.vm.storage.committed\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Emmagatzematge dedicat de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.storage.readoio\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Nombre mitjà de peticions de lectura pendents al disc virtual durant l'interval de recollida.|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip del servei de VMware Màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatòria)|<| |vmware.vm.storage.totalreadlatency\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Temps mig d'una lectura del disc virtual (mil·lisegons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatori)|<| |vmware.vm.storage.totalwritelatency\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Durada mitjana d'una escriptura al disc virtual (mil·lisegons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatori)|<| |vmware.vm.storage.uncommitted\[<url>,<uuid>\]|<|<|<|<| |<|Espai d'emmagatzematge no compromès de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.storage.unshared\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Espai d'emmagatzematge no compartit de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.storage.writeoio\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Nombre mitjà de peticions d'escriptura pendents al disc virtual durant l'interval de recollida.|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip del servei de VMware la màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatori)|<| |vmware.vm.uptime\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Temps d'activitat de VMware VM (segons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.vfs.dev.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Descoberta de dispositius de disc de la màquina virtual de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.vfs.dev.read\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques de lectura del dispositiu de disc VMware VM (octets/operacions per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware <br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància del dispositiu de disc<br>**mode** - bps (per defecte)/ops - octets/operacions per segon|<| |vmware.vm.vfs.dev.write\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques d'escriptura del dispositiu de disc VMware VM (octets/operacions per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància del dispositiu de disc<br>**mode** - bps (per defecte)/ops - octets/operacions per segon|<| |vmware.vm.vfs.fs.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Descoberta dels sistemes de fitxers de la màquina virtual de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|VMware Tools s'ha d'instal·lar a la màquina virtual convidada.| |vmware.vm.vfs.fs.size\[\<url\>,\<uuid\>,\<fsname\>,\<mode\>\]|<|<|<|<| |<|Estadístiques del sistema de fitxers de VMware VM (octets/percentatge).|Enter - per octets<br>Flotant - per percentatge|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de VMware VM <br>**fsname** - nom del sistema de fitxers< br>**mode** - total/free/used/pfree/pused|VMware Tools s'ha d'instal·lar a la màquina virtual convidada.| #### Item key The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is net.if.discovery This item is supported since Zabbix agent 2.0. #### Clau d'element La clau de l'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és net.if.discovery Aquest element és compatible des de l'agent Zabbix 2.0. #### Item key The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is system.cpu.discovery This item is supported since Zabbix agent 2.4. #### Clau d'element La clau de l'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és system.cpu.discovery Aquest element és compatible des de l'agent Zabbix 2.4. #### Item key The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is vfs.dev.discovery This item is supported on Linux platforms only, since Zabbix agent 4.4. You may create discovery rules using this discovery item and: - filter: **{\#DEVNAME} matches `sd[\D]$`** - to discover devices named "sd0", "sd1", "sd2", ... - filter: **{\#DEVTYPE} matches `disk` AND {\#DEVNAME} does not match `^loop.*`** - to discover disk type devices whose name does not start with "loop" #### Clau d'element La clau de l'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és vfs.dev.discovery Aquest element només és compatible amb plataformes Linux, des de l'agent Zabbix 4.4. Podeu crear regles de descoberta mitjançant aquest element de descoberta i: - filtre: **{\#DEVNAME} coincideix amb `sd[\D]$`** - per descobrir dispositius anomenats "sd0", "sd1", "sd2",... - filtre: **{\#DEVTYPE} coincideix amb `disk` I {\#DEVNAME} no coincideix amb `^loop.*`** - per descobrir dispositius de tipus disc el nom dels quals no comenci per "bucle" #### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is service.discovery This item is supported since Zabbix Windows agent 3.0. #### Clau d'element L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és service.discovery Aquest element és compatible des de l'agent Zabbix 3.0 per a Windows. ### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is the systemd.unit.discovery ::: noteimportant This [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) key is only supported in Zabbix agent 2. ::: This item returns a JSON with information about systemd units, for example: [{ "{#UNIT.NAME}": "mysqld.service", "{#UNIT.DESCRIPTION}": "MySQL Server", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "", "{#UNIT.JOBPATH}": "/", "{#UNIT.UNITFILESTATE}": "enabled" }, { "{#UNIT.NAME}": "systemd-journald.socket", "{#UNIT.DESCRIPTION}": "Journal Socket", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "", "{#UNIT.JOBPATH}": "/", "{#UNIT.UNITFILESTATE}": "enabled" }] ### Clau d'element L'element a emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és systemd.unit.discovery ::: noteimportant Aquesta clau d'[element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) només s'admet amb l'agent Zabbix 2. ::: Aquest element retorna un JSON amb la informació de les unitats systemd, per exemple: [{ "{#UNIT.NAME}": "mysqld.service", "{#UNIT.DESCRIPTION}": "MySQL Server", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "", "{#UNIT.JOBPATH}": "/", "{#UNIT.UNITFILESTATE}": "enabled" }, { "{#UNIT.NAME}": "systemd-journald.socket", "{#UNIT.DESCRIPTION}": "Journal Socket", "{#UNIT.LOADSTATE}": "loaded", "{#UNIT.ACTIVESTATE}": "active", "{#UNIT.SUBSTATE}": "running", "{#UNIT.FOLLOWED}": "", "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket", "{#UNIT.JOBID}": 0, "{#UNIT.JOBTYPE}": "", "{#UNIT.JOBPATH}": "/", "{#UNIT.UNITFILESTATE}": "enabled" }] #### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is the zabbix[host,discovery,interfaces] internal item. This item is supported since Zabbix server 3.4. This item returns a JSON with the description of interfaces, including: - IP address/DNS hostname (depending on the “Connect to” host setting) - Port number - Interface type (Zabbix agent, SNMP, JMX, IPMI) - If it is the default interface or not - If the bulk request feature is enabled - for SNMP interfaces only. For example: [{"{#IF.CONN}":"192.168.3.1","{#IF.IP}":"192.168.3.1","{#IF.DNS}":"","{#IF.PORT}":"10050","{#IF.TYPE}":"AGENT","{#IF.DEFAULT}":1}] With multiple interfaces their records in JSON are ordered by: - Interface type, - Default - the default interface is put before non-default interfaces, - Interface ID (in ascending order). #### Clau d'element L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery-rule) és l'element intern zabbix[equip,descoberta,interfícies] Aquest element és compatible des del servidor Zabbix 3.4. Aquest element retorna un JSON amb la descripció de les interfícies, que inclou: - Adreça IP/nom d'equip DNS (segons la configuració de l'equip "Connexió a") - Nombre de port - Tipus d'interfície (agent Zabbix, SNMP, JMX, IPMI) - Si és la interfície predeterminada o no - Si la funcionalitat de consulta massiva és habilitada, només per a interfícies SNMP. Per exemple: {"data":[{"{#IF.CONN}":"192.168.3.1","{#IF.IP}":"192.168.3.1","{#IF.DNS}":"","{#IF.PORT}":"10050","{#IF.TYPE}":"AGENT","{#IF.DEFAULT}":1}]} Amb diverses interfícies, els seus registres JSON estan ordenats per: - tipus d'interfície, - Per defecte: la interfície predeterminada es col·loca abans que les interfícies no predeterminades, - ID de la interfície (en ordre ascendent). #### Item key The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is wmi.getall[<namespace>,<query>] This [item](/manual/config/items/itemtypes/zabbix_agent/win_keys) transforms the query result into a JSON array. For example: select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%' may return something like this: ```json [ { "DeviceID" : "\\.\PHYSICALDRIVE0", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : 0, "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 0, "InterfaceType" : "IDE" }, { "DeviceID" : "\\.\PHYSICALDRIVE1", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : 0, "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 1, "InterfaceType" : "IDE" } ] ``` This item is supported since Zabbix Windows agent 4.4. #### Clau d'element L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és wmi.getall[<namespace>,<query>] L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%' pot retornar quelcom com ara: ``` {.java} [ { "DeviceID" : "\\.\PHYSICALDRIVE0", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : "0", "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 0, "InterfaceType" : "IDE" }, { "DeviceID" : "\\.\PHYSICALDRIVE1", "BytesPerSector" : 512, "Capabilities" : [ 3, 4 ], "CapabilityDescriptions" : [ "Random Access", "Supports Writing" ], "Caption" : "VBOX HARDDISK ATA Device", "ConfigManagerErrorCode" : "0", "ConfigManagerUserConfig" : "False", "CreationClassName" : "Win32_DiskDrive", "Description" : "Disk drive", "FirmwareRevision" : "1.0", "Index" : 1, "InterfaceType" : "IDE" } ] ``` Aquest element s'admet des de l'agent Zabbix Windows 4.4. #### Item key To configure the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule), use the following item: - `perf_instance.discovery[object]` Note that the object name may be localized. For example: ```bash perf_instance.discovery[Processor] # The object name is in English. perf_instance.discovery[Processador] # The object name is in Portuguese. ``` Alternatively, to ensure that the object name is provided in English, independent of OS localization, use the following item: - `perf_instance_en.discovery[object]` For example: ```bash perf_instance_en.discovery[Processor] perf_instance_en.discovery[Memory] ``` These items are supported since Zabbix Windows agent 5.0.1. #### Clau d'element Per configurar la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule), empreu l'element següent: - `perf_instance.discovery[objecte]` Tingueu en compte que el nom de l'objecte es pot localitzar. Per exemple: ```bash perf_instance.discovery[Processor] # El nom de l'objecte és en anglès. perf_instance.discovery[Processador] # El nom de l'objecte és en portuguès. ``` Alternativament, per assegurar-vos que el nom de l'objecte es proporciona en anglès, independentment de la localització del sistema operatiu, empreu l'element següent: - `perf_instance_en.discovery[objecte]` Per exemple: ```bash perf_instance_en.discovery[Processor] perf_instance_en.discovery[Memory] ``` Aquests elements són compatibles des de l'agent Zabbix 5.0.1 de Windows. #### Item key Unlike with file system and network interface discovery, the item does not necessarily has to have an "snmp.discovery" key - item type of SNMP agent is sufficient. To configure the discovery rule, do the following: - Go to: *Configuration* → *Templates* - Click on *Discovery* in the row of an appropriate template  - Click on *Create discovery rule* in the upper right corner of the screen - Fill in the discovery rule form with the required details as in the screenshot below  All mandatory input fields are marked with a red asterisk. The OIDs to discover are defined in SNMP OID field in the following format: `discovery[{#MACRO1}, oid1, {#MACRO2}, oid2, …,]` where *{\#MACRO1}*, *{\#MACRO2}* … are valid lld macro names and *oid1*, *oid2*... are OIDs capable of generating meaningful values for these macros. A built-in macro *{\#SNMPINDEX}* containing index of the discovered OID is applied to discovered entities. The discovered entities are grouped by *{\#SNMPINDEX}* macro value. To understand what we mean, let us perform few snmpwalks on our switch: $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr IF-MIB::ifDescr.1 = STRING: WAN IF-MIB::ifDescr.2 = STRING: LAN1 IF-MIB::ifDescr.3 = STRING: LAN2 $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifPhysAddress IF-MIB::ifPhysAddress.1 = STRING: 8:0:27:90:7a:75 IF-MIB::ifPhysAddress.2 = STRING: 8:0:27:90:7a:76 IF-MIB::ifPhysAddress.3 = STRING: 8:0:27:2b:af:9e And set SNMP OID to: `discovery[{#IFDESCR}, ifDescr, {#IFPHYSADDRESS}, ifPhysAddress]` Now this rule will discover entities with {\#IFDESCR} macros set to **WAN**, **LAN1** and **LAN2**, {\#IFPHYSADDRESS} macros set to **8:0:27:90:7a:75**, **8:0:27:90:7a:76**, and **8:0:27:2b:af:9e**, {\#SNMPINDEX} macros set to the discovered OIDs indexes **1**, **2** and **3**: ``` {.java} [ { "{#SNMPINDEX}": "1", "{#IFDESCR}": "WAN", "{#IFPHYSADDRESS}": "8:0:27:90:7a:75" }, { "{#SNMPINDEX}": "2", "{#IFDESCR}": "LAN1", "{#IFPHYSADDRESS}": "8:0:27:90:7a:76" }, { "{#SNMPINDEX}": "3", "{#IFDESCR}": "LAN2", "{#IFPHYSADDRESS}": "8:0:27:2b:af:9e" } ] ``` If an entity does not have the specified OID, then the corresponding macro will be omitted for this entity. For example if we have the following data: ifDescr.1 "Interface #1" ifDescr.2 "Interface #2" ifDescr.4 "Interface #4" ifAlias.1 "eth0" ifAlias.2 "eth1" ifAlias.3 "eth2" ifAlias.5 "eth4" Then in this case SNMP discovery `discovery[{#IFDESCR}, ifDescr, {#IFALIAS}, ifAlias]` will return the following structure: ``` {.java} [ { "{#SNMPINDEX}": 1, "{#IFDESCR}": "Interface #1", "{#IFALIAS}": "eth0" }, { "{#SNMPINDEX}": 2, "{#IFDESCR}": "Interface #2", "{#IFALIAS}": "eth1" }, { "{#SNMPINDEX}": 3, "{#IFALIAS}": "eth2" }, { "{#SNMPINDEX}": 4, "{#IFDESCR}": "Interface #4" }, { "{#SNMPINDEX}": 5, "{#IFALIAS}": "eth4" } ] ``` #### Clau d'element A diferència del sistema de fitxers i la descoberta de la interfície de xarxa, l'element no necessita necessàriament una clau "snmp.discovery"; amb el tipus d'element de l'agent SNMP n'hi ha prou. Per configurar la regla de descoberta, feu el següent: - Aneu a: *Configuració* → *Models* - Feu clic a *Descoberta* a la línia del model adequat  - Feu clic a *Crear una regla de descoberta* a la cantonada superior dreta de la pantalla. - Ompliu el formulari de regles de descoberta amb els detalls necessaris com a la captura de pantalla següent  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Els OID per descobrir es defineixen al camp OID SNMP amb el format següent: `discovery[{#MACRO1}, oid1, {#MACRO2}, oid2, ...,]` on *{#MACRO1}*, *{#MACRO2}* ... són noms de macro lld vàlids i *oid1*, *oid2*... són OID capaços de generar valors significatius per a aquestes macros. A les entitats descobertes s'hi aplica una macro integrada *{#SNMPINDEX}* que conté l'índex de l'OID descobert. Les entitats descobertes s'agrupen per valor de macro *{#SNMPINDEX}*. Per entendre què volem dir, executem unes quantes ordres snmpwalks al nostre switch: $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr IF-MIB::ifDescr.1 = STRING: WAN IF-MIB::ifDescr.2 = STRING: LAN1 IF-MIB::ifDescr.3 = STRING: LAN2 $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifPhysAddress IF-MIB::ifPhysAddress.1 = STRING: 8:0:27:90:7a:75 IF-MIB::ifPhysAddress.2 = STRING: 8:0:27:90:7a:76 IF-MIB::ifPhysAddress.3 = STRING: 8:0:27:2b:af:9e I configureu l'OID SNMP a: `discovery[{#IFDESCR}, ifDescr, {#IFPHYSADDRESS}, ifPhysAddress]` Aquesta regla ara detecta entitats amb {#IFDESCR} macros establertes a **WAN**, **LAN1** i **LAN2**, les macros {#IFPHYSADDRESS} s'estableixen a **8:0:27: 90:7a :75**, **8:0:27:90:7a:76** i **8:0:27:2b:af:9e** Les macros {#SNMPINDEX} són configurades per a índexs OID descoberts **1**, **2** i **3**: ``` {.java} [ { "{#SNMPINDEX}": "1", "{#IFDESCR}": "WAN", "{#IFPHYSADDRESS}": "8:0:27:90:7a:75" }, { "{#SNMPINDEX}": "2", "{#IFDESCR}": "LAN1", "{#IFPHYSADDRESS}": "8:0:27:90:7a:76" }, { "{#SNMPINDEX}": "3", "{#IFDESCR}": "LAN2", "{#IFPHYSADDRESS}": "8:0:27:2b:af:9e" } ] ``` Si una entitat no té l'OID especificat, s'ometrà la macro corresponent per a aquesta entitat. Per exemple, si tenim les dades següents: ifDescr.1 "Interface #1" ifDescr.2 "Interface #2" ifDescr.4 "Interface #4" ifAlias.1 "eth0" ifAlias.2 "eth1" ifAlias.3 "eth2" ifAlias.5 "eth4" En aquest cas, la descoberta SNMP de `discovery[{#IFDESCR}, ifDescr, {#IFALIAS}, ifAlias]` retornarà l'estructura següent: ``` {.java} [ { "{#SNMPINDEX}": 1, "{#IFDESCR}": "Interface #1", "{#IFALIAS}": "eth0" }, { "{#SNMPINDEX}": 2, "{#IFDESCR}": "Interface #2", "{#IFALIAS}": "eth1" }, { "{#SNMPINDEX}": 3, "{#IFALIAS}": "eth2" }, { "{#SNMPINDEX}": 4, "{#IFDESCR}": "Interface #4" }, { "{#SNMPINDEX}": 5, "{#IFALIAS}": "eth4" } ] ``` #### Item net.tcp.service parameters **ftp** Creates a TCP connection and expects the first 4 characters of the response to be "220 ", then sends "QUIT\\r\\n". Default port 21 is used if not specified. **http** Creates a TCP connection without expecting and sending anything. Default port 80 is used if not specified. **https** Uses (and only works with) libcurl, does not verify the authenticity of the certificate, does not verify the host name in the SSL certificate, only fetches the response header (HEAD request). Default port 443 is used if not specified. **imap** Creates a TCP connection and expects the first 4 characters of the response to be "\* OK", then sends "a1 LOGOUT\\r\\n". Default port 143 is used if not specified. **ldap** Opens a connection to an LDAP server and performs an LDAP search operation with filter set to (objectClass=\*). Expects successful retrieval of the first attribute of the first entry. Default port 389 is used if not specified. **nntp** Creates a TCP connection and expects the first 3 characters of the response to be "200" or "201", then sends "QUIT\\r\\n". Default port 119 is used if not specified. **pop** Creates a TCP connection and expects the first 3 characters of the response to be "+OK", then sends "QUIT\\r\\n". Default port 110 is used if not specified. **smtp** Creates a TCP connection and expects the first 3 characters of the response to be "220", followed by a space, the line ending or a dash. The lines containing a dash belong to a multiline response and the response will be re-read until a line without the dash is received. Then sends "QUIT\\r\\n". Default port 25 is used if not specified. **ssh** Creates a TCP connection. If the connection has been established, both sides exchange an identification string (SSH-major.minor-XXXX), where major and minor are protocol versions and XXXX is a string. Zabbix checks if the string matching the specification is found and then sends back the string "SSH-major.minor-zabbix\_agent\\r\\n" or "0\\n" on mismatch. Default port 22 is used if not specified. **tcp** Creates a TCP connection without expecting and sending anything. Unlike the other checks requires the port parameter to be specified. **telnet** Creates a TCP connection and expects a login prompt (':' at the end). Default port 23 is used if not specified. #### Paràmetres de l'element net.tcp.service **ftp** Crea una connexió TCP i espera que els 4 primer caràcters de la resposta siguin "220 ", llavors envia "QUIT\\r\\n". S'empra per defecte el port 21 si no se n'especifica cap. **http** Crea una connexió TCP sense esperar ni rebre res. S'empra per defecte el port 80 si no se n'especifica cap. **https** Empra (i funciona únicament amb) libcurl, no verifica pas l'autenticitat del certificat, no verifica pas el nom d'equip dins el certificat SSL, recupera només la capçalera de la resposta (petició HEAD). S'empra per defecte el port 443 si no se n'especifica cap. **imap** Crea una connexió TCP i espera que els primers 4 caràcters de la resposta siguin "\* OK", després envia "a1 LOGOUT\\r\\n". S'empra per defecte el port 143 si no se n'especifica cap. **ldap** Obre una connexió a un servidor LDAP i fa una operació de recerca LDAP amb el filtre definit sobre (objectClass=\*). Espera una resposta correcta del primer atribut de la primera entrada. S'empra per defecte el port 389 si no se n'especifica cap. **nntp** Crea una connexió TCP i s'espera a que els 3 primer caràcters de la resposta siguin "200" o "201", després envia "QUIT\\r\\n". S'empra per defecte el port 119 si no se n'especifica cap. **pop** Crea una connexió TCP i s'espera a que els 3 primer caràcters de la resposta siguin "+OK", després envia "QUIT\\r\\n". S'empra per defecte el port 110 si no se n'especifica cap. **smtp** Crea una connexió TCP i s'espera a que els 3 primer caràcters de la resposta siguin "220", seguits d'un espai, la línia final o un guió. Les línies que tinguin un guió pertanyen a una resposta multilínia i la resposta es rellegeix fins que es rebi una línia sense guió. Després envia "QUIT\\r\\n". S'empra per defecte el port 25 si no se n'especifica cap. **ssh** Crea una connexió TCP. Si la connexió s'ha establert, les dues bandes bescanvien una cadena d'identificació (SSH-major.minor-XXXX), on major i menor són les versions del protocol i XXXX és una cadena. Zabbix verifica si la cadena corresponent a l'especificació és present, llavors envia la cadena "SSH-major.minor-zabbix\_agent\\r\\n" o "0\\n" en cas de no trobar-la. S'empra per defecte el port 22 si no se n'especifica cap. **tcp** Crea una connexió TCP sense esperar ni enviar res. al contrari que les altres verificacions, el paràmetre de port s'ha d'especificar. **telnet** Crea una connexió TCP i espera un convit de connexió (':' al final). S'empra per defecte el port 23 si no se n'especifica cap. #### Item net.udp.service parameters **ntp** Sends an SNTP packet over UDP and validates the response according to [RFC 4330, section 5](http://tools.ietf.org/html/rfc4330#section-5). Default port 123 is used if not specified. #### Paràmetres de l'element net.udp.service **ntp** Envia un paquet SNTP sobre UDP i valida la resposta segons l'[RFC 4330, secció 5](http://tools.ietf.org/html/rfc4330#section-5). El port per defecte 123 s'empra si no se n'especifica cap. ### Item ::: noteclassic Web items cannot be directly created, updated or deleted via the Zabbix API. ::: The item object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the item.| |**delay**<br>(required)|string|Update interval of the item. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host or template that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item's host interface.<br><br>Used only for host items. Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, calculated, dependent, database monitor and script items. Optional for HTTP agent items.| |**key\_**<br>(required)|string|Item key.| |**name**<br>(required)|string|Name of the item.| |**type**<br>(required)|integer|Type of the item.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - Simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - Telnet agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script| |**url**<br>(required)|string|URL string, required only for HTTP agent item type. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent items or HTTP agent items.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM<br>3 - Kerberos| |description|string|Description of the item.| |error|string|*(readonly)* Error text if there are problems updating the item value.| |flags|integer|*(readonly)* Origin of the item.<br><br>Possible values:<br>0 - a plain item;<br>4 - a discovered item.| |follow\_redirects|integer|HTTP agent item field. Follow response redirects while polling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item field. HTTP(S) proxy connection string.| |inventory\_link|integer|ID of the host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.<br><br>Default: 0.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI items.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lastclock|timestamp|*(readonly)* Time when the item value was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastns|integer|*(readonly)* Nanoseconds when the item value was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastvalue|string|*(readonly)* Last value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |logtimefmt|string|Format of the time in log entries. Used only by log items.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.<br><br>Required by dependent items.| |output\_format|integer|HTTP agent item field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the item:<br>- executed script for SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items;<br>- the script for script item.| |parameters|array|Additional parameters for script items. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br>When used by JMX, username should also be specified together with password or both properties should be left blank.| |post\_type|integer|HTTP agent item field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent item field. HTTP(S) request body data. Used with post\_type.| |prevvalue|string|*(readonly)* Previous value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent item field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item field. Password for SSL Key file.| |state|integer|*(readonly)* State of the item.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the item.<br><br>Possible values:<br>0 - *(default)* enabled item;<br>1 - disabled item.| |status\_codes|string|HTTP agent item field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item.<br><br>*Hint*: Use the `hostid` property to specify the template that the item belongs to.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script items. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper items or HTTP agent items.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX, password should also be specified together with username or both properties should be left blank.| |uuid|string|Universal unique identifier, used for linking imported item to already existing ones. Used only for items on templates. Auto-generated, if not given.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item field. Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent item field. Whether to validate that the host's certificate is authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Element ::: noteclassic Els elements web no es poden crear, actualitzar o esborrar directament mitjançant l'API de Zabbix. ::: L'objecte element té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|string|*(només lectura)* ID de l'element.| |**delay**<br>(obligatori)|string|Interval d'actualització de l'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com una programació.<br>Múltiples intervals estan separats per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).<br><br >Opcional per a Zabbix trapper, elements dependents i per a agent Zabbix (actiu) amb la clau `mqtt.get`.| |**hostid**<br>(obligatori)|string|ID de l'equip o del model al qual pertany l'element.<br><br>Per a les operacions d'actualització, aquest camp és *només lectura*.| |**interfaceid**<br>(obligatori)|string|Id de la interfície d'equip de l'element.<br><br>Només s'empra per als elements de l'equip. No és necessari per a l'agent Zabbix (actiu), Zabbix intern, Zabbix trapper, calculat, dependent, monitor de base de dades i elements d'script. Opcional per als elements de l'agent HTTP.| |**key\_**<br>(obligatori)|string|clau d'element.| |**name**<br>(obligatori)|string|Nom de l'element.| |**type**<br>(obligatori)|integer|Tipus d'element<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br>3 - Verificació simple; <br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>9 - Element web;<br>10 - Verificació externa;<br>11 - Monitor de base de dades;< 12 - Agent IPMI;< br>13 - Agent SSH;<br>14 - Agent Telnet;<br>15 - Calculat;<br>16 - Agent JMX;<br>17 - Trampa SNMP;<br>18 - Element dependent;<br>19 - Agent HTTP;<br>20 - Agent SNMP;<br>21 - Script| |**url**<br>(obligatori)|string|cadena d'URL, necessària només per al tipus d'element d'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(obligatori)|integer|Tipus d'informació de l'element.<br><br>Valors possibles:<br>0 - nombre flotant;<br>1 - caràcter; <br> 2 - diari;<br>3 - digital sense signe;<br>4 - text.| |allow\_traps|integer|camp d'element de l'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper.<br><br>0 - *(per defecte)* No permet acceptar dades entrants.<br>1 - Permet acceptar dades entrants.| |authtype|integer|Només l'empren els elements de l'agent SSH o els elements de l'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - mot de pas *(per defecte)*;<br>1 - clau pública.<br><br> Valors possibles del mètode d'autenticació de l'agent HTTP:<br>0 - *(per defecte)* cap<br> 1 - Bàsic<br>2 - NTLM<br>3 - Kerberos| |description|string|Descripció de l'element.| |error|string|*(només lectura)* Text d'error si hi ha problemes per actualitzar el valor de l'element.| |flags|integer|*(només lectura)* Origen de l'objecte.<br><br>Valors possibles:<br>0 - Objecte normal;<br>4 - Objecte descobert.| |follow\_redirects|integer|Camp d'element de l'agent HTTP. Seguiu les redireccions de respostes mentre afegiu dades.<br><br>0 - No seguiu les redireccions.<br>1 - *(per defecte)* Seguiu les redireccions.| |headers|object|Camp d'element de l'agent HTTP. Objecte amb capçaleres de petició HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br><br>Exemple:<br>{ " User-Agent": "Zabbix" }| |history|string|Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'històric. També accepta macros d'usuari.<br><br>Per defecte: 90d.| |http\_proxy|string|camp d'element de l'agent HTTP. Cadena de connexió del proxy HTTP(S).| |inventory\_link|integer|ID del camp d'inventari de l'equip emplenat per l'element.<br><br>Consulteu la [pàgina d'inventari d'equip](/manual/api/reference/host/object#host_inventory) per obtindre una llista de camps d'inventari d'equip admesos i els seus identificadors.<br><br>Per defecte: 0.| |ipmi\_sensor|string|sensor IPMI. Emprat només per elements IPMI.| |jmx\_endpoint|string|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi| |lastclock|timestamp|*(només lectura)* Hora en què el valor de l'element es va actualitzar per darrer cop.<br><br>Per defecte, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastns|integer|*(només lectura)* Nanosegons de la darrera actualització del valor de l'element.<br><br>De manera predeterminada, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastvalue|string|*(només lectura)* Darrer valor de l'element.<br><br>Per defecte, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |logtimefmt|string|Format d'hora a les entrades de registre. Emprat només per elements de registre.| |master\_itemid|integer|Identificador d'element principal.<br>Es permet la recurrència de fins a 3 elements dependents i el nombre màxim d'elements dependents de 29.999.<br><br>Obligatori per elements dependents.| |output\_format|integer|Camp d'element de l'agent HTTP. En cas de convertir la resposta a JSON.<br><br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.| |params|string|Paràmetres addicionals en funció del tipus d'element:<br>- script executat per a elements SSH i Telnet;<br>- consulta SQL per a elements de supervisió de la base de dades;<br>- fórmula per als elements calculats;<br>- l'script per a un element d'script.| |parameters|array|Paràmetres addicionals per als elements de l'script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha d'ésser únic.| |password|string|Mot de pas per a l'autenticació. S'empra per simple comprovació, SSH, Telnet, monitor de base de dades, elements de l'agent JMX i HTTP.<br>Quan s'empra per JMX, el nom d'usuari també s'ha d'especificar amb mot de pas o ambdues propietats s'han de deixar buides.| |post\_type|integer|camp d'element de l'agent HTTP. Tipus de cos de dades de publicació emmagatzemat a la propietat de publicacions.<br><br>0 - *(per defecte)* Dades en brut.<br>2 - Dades JSON.<br>3 - Dades XML.| |posts|string|camp d'element de l'agent HTTP. HTTP(S) demana dades del cos. S'empra amb post\_type.| |prevvalue|string|*(només lectura)* Valor anterior de l'element.<br><br>Per defecte, només es veuen els valors de les últimes 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |privatekey|string|Nom del fitxer de clau privada.| |publickey|string|Nom del fitxer de clau pública.| |query\_camps|array|Camp d'element de l'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ésser una cadena buida.| |request\_method|integer|Camp d'element de l'agent HTTP. Tipus de mètode de petició.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|camp d'element de l'agent HTTP. Quina part de la resposta s'ha d'emmagatzemar.<br><br>0 - *(per defecte)* Cos.<br>1 - Capçaleres.<br>2 - S'emmagatzemaran el cos i les capçaleres.< br><br>Per request\_method HEAD only 1 és el valor permès.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|Camp d'element de l'agent HTTP. Camí al fitxer de clau SSL pública.| |ssl\_key\_file|string|Camp d'element de l'agent HTTP. Camí al fitxer de clau SSL privada.| |ssl\_key\_password|string|Camp d'element de l'agent HTTP. Mot de pas per al fitxer de clau SSL.| |state|integer|*(només lectura)* Estat de l'element.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - no compatible.| |state|integer|Estat de l'element.<br><br>Valors possibles:<br>0 - element activat *(per defecte)*;<br>1 - element desactivat.| |status\_codes|string|camp d'element de l'agent HTTP. Intervals de codis d'estat HTTP obligatoris separats per comes. També admet macros d'usuari com a part d'una llista separada per comes.<br><br>Exemple: 200.200-{$M},{$M},200-400| |templateid|string|(només lectura) ID de l'element de la plantilla principal.<br><br>*Consell*: Empreu la propietat `hostid` per especificar la plantilla a la qual pertany l'element.| |timeout|string|Temps d'espera de la petició de consulta de dades d'element. S'empra per a agents HTTP i elements d'script. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s| |trapper\_hosts|string|Equips permesos. Emprat per elements trapper o elements d'agent HTTP.| |trends|string|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendències. També accepta macros d'usuari.<br><br>Per defecte: 365d.| |units|string|Unitats de valor.| |username|string|Nom d'usuari per a l'autenticació. Emprat per elements de Simple Check, SSH, Telnet, Database Monitor, JMX i Agent HTTP.<br><br>Obligatori per elements SSH i Telnet.<br>Quan empra JMX, el mot de pas també s'ha d'especificar amb el nom d'usuari o ambdues les propietats s'han de deixar en blanc.| |uuid|string|Identificador únic universal, emprat per enllaçar un element importat amb elements ja existents. S'empra només per a articles de model. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només lectura*.| |valuemapid|string|ID de la taula. coincidència de valors associats.| |verify\_host|integer|camp d'element d'agent HTTP. Valideu que el nom d'equip a l'URL estigui al camp Nom comú o Nom alternatiu del subjecte del certificat d'equip.<br><br>0 - *(per defecte)* No valida. <br>1 - Valida.| |verify\_peer|integer|camp d'element de l'agent HTTP. Valida si el certificat de l'equip és autèntic.<br><br>0 - *(per defecte)* No valida.<br>1 - Valida.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Item object The following objects are directly related to the `item` API. # Objecte element Els següents objectes tenen relació directa amb l'API `item`. ### Item preprocessing The item preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1, 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1, 6^|max^1, 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5, 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6, 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3| ^1^ floating-point number (integers are converted to float values implicitly)<br> ^2^ string<br> ^3^ regular expression<br> ^4^ JSONPath or XML XPath<br> ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)<br> ^6^ user macro<br> ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.<br> ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro) if `label` is selected as the second parameter.<br> ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter. ### Preprocessament de l'element L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tipus**<br>(obligatori)|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Retalla a la dreta;< br>3 - Retalla a l'esquerra;<br>4 - Retalla;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br> 9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;< br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha errors en JSON;<br>17 - Comprova si hi ha errors en XML;<br>18 - Comprova si hi ha errors mitjançant una expressió regular;<br>19 - Descartar sense canvis;<br>20 - Descartar sense canvis amb un heartbeat;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br>24 - CSV a JSON;<br> 25 - Substituïu;<br> >26 - No s'admet la verificació;<br>27 - XML ​​​​a JSON.| |**params**<br>(obligatori)|string|Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats pel caràcter LF (\\n).| |**error\_handler**<br>(obligatori)|integer|Tipus d'acció que s'empra quan falla el pas de preprocessament.<br><br>Valors possibles:<br>0 - Zabbix defineix el missatge d'error del missatge;< br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat.| |**error\_handler\_params**<br>(obligatori)|string|Paràmetres del gestor d'errors. S'empra amb `error_handler`.<br><br>Ha d'ésser buit, si `error_handler` és 0 o 1.<br>Pot ésser buit si `error_handler` és 2.<br>No pot ésser buit, si `error_handler ` és 3.| Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament. |Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos| |------------------|----|------------|-----------|-- ---------|---------| |1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3| |2|Retalla a la dreta|llista de caràcters^2^|<|<|<| |3|Retalla a l'esquerra|llista de caràcters^2^|<|<|<| |4|Retalla|llista de caràcters^2^|<|<|<| |5|Expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |6|Booleà a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi únic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|camí^4^|<|<|0, 1, 2, 3| |12|JSONPath|camí^4^|<|<|0, 1, 2, 3| |13|Dins de l'interval|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |16|Comprova l'error a JSON|camí^4^|<|<|0, 1, 2, 3| |17|Comprova l'error en XML|camí^4^|<|<|0, 1, 2, 3| |18|Comprova si hi ha errors emprant l'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |19|Descarta el que no ha canviat|<|<|<|<| |20|Descarta el no canviat amb un heartbeat|segons^5, 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Patró de Prometheus|patró^6, 7^|`valor`, `etiqueta`, `funció`|sortida^8, 9^|0, 1, 2, 3| |23|Prometheus a JSON|patró^6, 7^|<|<|0, 1, 2, 3| |24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |26|La verificació no és compatible|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3| ^1^ nombre de coma flotant (els enters es converteixen implícitament a valors flotants)<br> ^2^ cadena<br> ^3^ expressió regular<br> ^4^ JSONPath o XML XPath<br> ^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)<br> ^6^ macro d'usuari<br> ^7^ El model de Prometheus segueix la sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ser una macro d'usuari.<br> ^8^ Prometheus mostra la següent sintaxi: `<nom de l'etiqueta>` (pot ser una macro d'usuari) si `etiqueta` està seleccionada com a segon paràmetre.<br> ^9^ Una de les funcions agregades: `sum`, `min`, `max`, `avg`, `count` si `function` està seleccionat com a segon paràmetre. #### itemprototype Bug fixes:<br> [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: property `interfaceid` is no longer required to create/update a HTTP agent type item prototype. #### prototip d'element Correcció d'errades:<br> [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: Ja no cal pas fer ús de la propietat `interfaceid` per a crear o actualitzar un prototip d'element del tipus agent HTTP. #### item prototype Changes:<br> [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: added the third parameter to the Prometheus pattern preprocessing step. The second parameter will now determine an aggregation method: `value`, `label`, `function`. The third parameter will now contain Prometheus output for the aggregation method `label` or an aggregation function for the aggregation method `function`. #### prototipus d'element Canvis:<br> [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: afegit un tercer paràmetre a l'etapa de pretractament del patró Prometheus. El segon paràmetre determinarà ara un mètode d'agregació: : `value`, `label`, `function`. El tercer paràmetre tindrà la sortida de Prometheus per el mètode `label` o una funció d'afegir per al mètode d'agregació `function`. #### itemprototype Changes:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `itemprototype.update`: the parameter `uuid` can now be updated. #### prototip d'elements Canvis:<br> [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `itemprototype.update`: el paràmetre `uuid` ara es pot actualitzar. # itemprototype.create # itemprototype.create # itemprototype.delete # itemprototype.delete # itemprototype.get # itemprototype.get # Item prototype object The following objects are directly related to the `itemprototype` API. # Objecte prototip d'elements Els següents objectes són relacionats amb l'API `itemprototype`. ### Item prototype preprocessing The item prototype preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1, 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1, 6^|max^1, 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5, 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6, 7^|`value`, `label`, `function`|output^8, 9^|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6, 7^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3| ^1^ integer or floating-point number<br> ^2^ string<br> ^3^ regular expression<br> ^4^ JSONPath or XML XPath<br> ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)<br> ^6^ user macro, LLD macro<br> ^7^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro or LLD macro.<br> ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro or an LLD macro) if `label` is selected as the second parameter.<br> ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter. ### Preprocessament del prototip d'element L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**type**<br>(obligatori)|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Elimina els espais finals;<br> 3 - Eliminació d'espais inicials;<br>4 - Eliminació d'espais finals i posteriors;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br>9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;<br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha un error a JSON;<br>17 - Comprova si hi ha un error a XML;<br>18 - Troba un error emprant una expressió regular;<br>19 - Esborra sense modificacions;<br>20 - Esborra sense modificacions amb heartbeat;<br>21 - JavaScript;< 22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br> 24 - CSV a JSON; <br>25 - Substitueix;<br>26 - Comprova si hi ha valors no admesos;<br>27 - XML ​​​​a JSON. | |**params**<br>(obligatori)|string|Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats pel caràcter LF (\\n).| |**error\_handler**<br>(obligatori)|integer|Tipus d'acció emprat en cas d'error del pas de preprocessament:<br>0 - El servidor Zabbix ha establert el missatge d'error ;<br>1 - Elimina el valor;< br>2 - Estableix un valor personalitzat;<br>3 - Estableix un missatge d'error personalitzat. |**error\_handler\_params**<br>(obligatori)|string|Paràmetres del gestor d'errors. S'empra amb `error_handler`.<br><br>Ha d'ésser buit, si `error_handler` és 0 o 1.<br>Pot ésser buit si `error_handler` és 2.<br>No pot pas ésser buit, si `error_handler ` és 3.| Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament. |Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos| |-------------------|----|-----------|------------|- ----------|----------| |1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3| |2|Eliminació d'espais finals|llista de caràcters^2^|<|<|<| |3|Eliminació dels espais inicials|llista de caràcters^2^|<|<|<| |4|Eliminació dels espais inicials i finals|llista de caràcters^2^|<|<|<| |5|Concordança d'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |6|Booleà a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi únic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|camí^4^|<|<|0, 1, 2, 3| |12|JSONPath|camí^4^|<|<|0, 1, 2, 3| |13|Dins de l'interval|min^1, 6^|max^1, 6^|<|0, 1, 2, 3| |14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular^3^|<|<|0, 1, 2, 3| |16|Cerca un error a JSON|camí^4^|<|<|0, 1, 2, 3| |17|Cerca un error a XML|camí^4^|<|<|0, 1, 2, 3| |18|Cerca un error emprant una expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |19|Esborra sense modificacions|<|<|<|<| |20|Esborra sense canvis amb el heratbeat|segons^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Patró de Prometheus|patró^6, 7^|`valor`, `etiqueta`, `funció`|sortida^8, 9^|0, 1, 2, 3| |23|Prometheus a JSON|patró^6, 7^|<|<|0, 1, 2, 3| |24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |26|Comprova si hi ha valors no admesos|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3| ^1^ nombre enter o coma flotant<br> ^2^ cadena<br> ^3^ expressió regular<br> ^4^ JSONPath o XML XPath<br> ^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)<br> ^6^ macro d'usuari, macro LLD<br> ^7^ Patró Prometheus següent sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ésser una macro d'usuari o una macro LLD.<br> ^8^ Prometheus dóna la següent sintaxi: `<nom de l'etiqueta>` (pot ésser una macro d'usuari o una macro LLD) si `label` és seleccionada com a segon paràmetre.<br> ^9^ Una de les funcions d'agregació: `sum`, `min`, `max`, `avg`, `count` si `function` és seleccionada com a segon paràmetre. ### Item prototypes Item prototypes that can be created based on systemd service discovery include, for example: - Item name: `{#UNIT.DESCRIPTION} active state info`; item key: `systemd.unit.info["{#UNIT.NAME}"]` - Item name: `{#UNIT.DESCRIPTION} load state info`; item key: `systemd.unit.info["{#UNIT.NAME}",LoadState]` `systemd.unit.info` [agent items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) are supported since Zabbix 4.4. ### Prototipus d'elements Els prototips d'elements que es poden crear basant-se en la descoberta de serveis de systemd inclouen, per exemple: - Nom de l'element: `{#UNIT.DESCRIPTION} active stat info`; Clau d'element: `systemd.unit.info["{#UNIT.NAME}"]` - Nom de l'element: `{#UNIT.DESCRIPTION} active stat info`; Clau d'element: `systemd.unit.info["{#UNIT.NAME}",LoadState]` Els [elements de l'agent](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) `systemd.unit.info` són compatibles des de Zabbix 4.4. #### Item prototypes The following screenshot illustrates how we can use these macros in item prototypes:  You can create as many item prototypes as needed: {width="600"} #### Prototips d'elements La següent captura de pantalla il·lustra com podem emprar aquestes macros en prototips d'elements:  Podeu crear tants prototips d'article com us calgui: {width="600"} ### Item prototype tag The item prototype tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Item prototype tag name.| |value|string|Item prototype tag value.| ### Etiqueta de prototip d'element L'objecte d'etiqueta de prototip d'element té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta de prototip d'element.| |value|string|Valor de l'etiqueta de prototip d'element.| ### Item prototype The item prototype object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the item prototype.| |**delay**<br>(required)|string|Update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros and LLD macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host that the item prototype belongs to.<br><br>For update operations this field is *readonly*.| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item prototype's host interface. Used only for host item prototypes.<br><br>Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, calculated, dependent, database monitor and script item prototypes. Optional for HTTP agent item prototypes.| |**key\_**<br>(required)|string|Item prototype key.| |**name**<br>(required)|string|Name of the item prototype.| |**type**<br>(required)|integer|Type of the item prototype.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - external check;<br>11 - database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>15 - calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script.| |**url**<br>(required)|string|URL string required only for HTTP agent item prototypes. Supports LLD macros, user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item prototype.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item prototype field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent item prototypes or HTTP agent item prototypes.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM<br>3 - Kerberos| |description|string|Description of the item prototype.| |follow\_redirects|integer|HTTP agent item prototype field. Follow response redirects while polling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item prototype field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item prototype field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI item prototypes.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |logtimefmt|string|Format of the time in log entries. Used only by log item prototypes.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and item prototypes and maximum count of dependent items and item prototypes equal to 29999 are allowed.<br><br>Required by Dependent items.| |output\_format|integer|HTTP agent item prototype field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the item prototype:<br>- executed script for SSH and Telnet item prototypes;<br>- SQL query for database monitor item prototypes;<br>- formula for calculated item prototypes.| |parameters|array|Additional parameters for script item prototypes. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.| |post\_type|integer|HTTP agent item prototype field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent item prototype field. HTTP(S) request body data. Used with post\_type.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item prototype field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item prototype field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item prototype field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent item prototype field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item prototype field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item prototype field. Password for SSL Key file.| |status|integer|Status of the item prototype.<br><br>Possible values:<br>0 - *(default)* enabled item prototype;<br>1 - disabled item prototype;<br>3 - unsupported item prototype.| |status\_codes|string|HTTP agent item prototype field. Ranges of required HTTP status codes separated by commas. Also supports user macros or LLD macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item prototype.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script item prototypes. Supports user macros and LLD macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper item prototypes or HTTP item prototypes.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.<br><br>Required by SSH and Telnet item prototypes.| |uuid|string|Universal unique identifier, used for linking imported item prototypes to already existing ones. Used only for item prototypes on templates. Auto-generated, if not given.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item prototype field. Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.<br>| |verify\_peer|integer|HTTP agent item prototype field. Whether to validate that the host's certificate is authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |discover|integer|Item prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new items will be discovered;<br>1 - new items will not be discovered and existing items will be marked as lost.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Prototip d'element L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|string|*(només lectura)* ID del prototip d'element.| |**delay**<br>(obligatori)|string|Interval d'actualització del prototip d'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com una programació.<br>Múltiples intervals estan separats per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).<br><br >Opcional per a Zabbix trapper, elements dependents i per a agent Zabbix (actiu) amb la clau `mqtt.get`.| |**hostid**<br>(obligatori)|string|Id de l'equip o de la plantilla a la qual pertany el prototip d'element.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*.| |**ruleid**<br>(obligatori)|string|ID de la regla LLD a la qual pertany l'element.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*. |**interfaceid**<br>(obligatori)|string|Identificador d'interfície equip del prototip d'element.<br><br>Només s'empra per als prototips d'element equip. No és necessari per a l'agent Zabbix (actiu), Zabbix intern, Zabbix trapper, calculat, dependent, monitor de base de dades i prototips d'elements d'script. Opcional per als elements de prototip d'agent HTTP.| |**key\_**<br>(obligatori)|string|Clau del prototip d'element.| |**name**<br>(obligatori)|string|Nom del prototip de l'element.| |**type**<br>(obligatori)|entier|Tipus de prototip d'element<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br>3 - Verificació simple;<br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>9 - Element web;<br>10 - Verificació externa;<br>11 - Monitor de base de dades; <br>12 - IPMI Agent;<br>13 - Agent SSH;<br>14 - Agent Telnet;<br>15 - Calculat;<br>16 - Agent JMX;<br>17 - Trampa SNMP;<br> 18 - Element dependent;< br>19 - Agent HTTP;<br>20 - Agent SNMP;<br>21 - Script| |**url**<br>(obligatori)|string|cadena d'URL, necessària només per al tipus de prototip d'element d'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**valor\_tipus**<br>(obligatori)|entier|Tipus d'informació del prototip d'element.<br><br>Valors possibles:<br>0 - nombre flotant;<br>1 - caràcter ;<br >2 - diari;<br>3 - digital sense signar;<br>4 - text.| |allow\_traps|integer|camp de prototip d'element d'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper.<br><br>0 - *(per defecte)* No permet acceptar dades entrants.<br>1 - Permet acceptar dades entrants.| |authtype|integer|Només s'empren per elements d'agent SSH prototip o elements d'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - mot de pas *(per defecte)*;<br>1 - clau pública.<br><br> Valors possibles del mètode d'autenticació de l'agent HTTP:<br>0 - *(per defecte)* cap <br>1 - Bàsic<br>2 - NTLM<br>3 - Kerberos| |description|string|Descripció del prototip d'element.| |follow\_redirects|integer|Prototip de camp d'element d'agent HTTP. Seguiu les redireccions de respostes mentre aegiu dades.<br><br>0 - No seguir les redireccions.<br>1 - *(per defecte)* Seguir les redireccions.| |headers|object|Camp de prototip d'element d'agent HTTP. Objecte amb capçaleres de petició HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br><br>Exemple:<br>{ " User-Agent": "Zabbix" }| |history|string|Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'històric. També admet macros d'usuari.<br><br>Per defecte: 90d.| |http\_proxy|string|Camp de prototip d'element d'agent HTTP. Cadena de connexió del proxy HTTP(S).| |ipmi\_sensor|string|sensor IPMI. Emprat només pels prototips d'elements IPMI.| |jmx\_endpoint|string|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi| |logtimefmt|string|Format d'hora a les entrades de registre. S'empren només per prototips d'elements de diari.| |master\_itemid|integer|Identificador d'element principal.<br>Es permet la recursivitat fins a 3 elements dependents i el nombre màxim d'elements i prototips d'elements dependents de 29.999.<br>< br>Requerit per elements dependents.| |output\_format|integer|Camp d'element de prototip d'agent HTTP. En cas de convertir la resposta a JSON.<br><br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.| |params|string|Paràmetres addicionals en funció del tipus de prototip d'element:<br>- script executat per a prototips d'elements SSH i Telnet;<br>- Consulta SQL per a dades de prototips d'elements de supervisió bàsica;<br>- fórmula per a prototips d'elements calculats.| |parameters|array|Paràmetres addicionals per a prototips d'elements de script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha d'ésser únic.| |password|string|Mot de pas per a l'autenticació. Emprat per Simple Check, SSH, Telnet, Database Monitor, JMX i HTTP Agent Item Prototypes.| |post\_type|integer|Camp de prototip d'element d'agent HTTP. Tipus de cos de dades de publicació emmagatzemat a la propietat de publicacions.<br><br>0 - *(per defecte)* Dades en brut.<br>2 - Dades JSON.<br>3 - Dades XML.| |posts|string|Camp de prototip d'element d'agent HTTP. HTTP(S) demana dades del cos. S'empra amb post\_type.| |privatekey|string|Nom del fitxer de clau privada.| |publickey|string|Nom del fitxer de clau pública.| |query\_fields|array|Camp de prototip d'element d'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ésser una cadena buida.| |request\_method|integer|Camp de prototip d'element d'agent HTTP. Tipus de mètode de petició.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|Camp de prototip d'element d'agent HTTP. Quina part de la resposta s'ha d'emmagatzemar.<br><br>0 - *(per defecte)* Cos.<br>1 - Capçaleres.<br>2 - S'emmagatzemaran el cos i les capçaleres.< br><br>Per request\_method HEAD només s'admet el valor 1.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|Camp de prototip d'element d'agent HTTP. Camí al fitxer de clau SSL pública.| |ssl\_key\_file|string|Camp de prototip d'element d'agent HTTP. Camí al fitxer de clau SSL privada.| |ssl\_key\_password|string|Camp de prototip d'element d'agent HTTP. Mot de pas per al fitxer de clau SSL.| |status|integer|Estat del prototip d'element.<br><br>Valors possibles:<br>0 - prototip d'element habilitat *(per defecte)*;<br>1 - prototip d'element desactivat;< br>2 - prototip d'element no compatible.| |status\_codes|string|Camp de prototip d'element d'agent HTTP. Intervals de codis d'estat HTTP obligatoris separats per comes. També admet macros d'usuari com a part d'una llista separada per comes.<br><br>Exemple: 200.200-{$M},{$M},200-400| |templateid|string|(només lectura) ID del prototip d'element de plantilla principal.| |timeout|string|Temps d'espera de la consulta de dades d'element. S'empra per a l'agent HTTP i els prototips d'elements d'script. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s| |trapper\_hosts|string|Equips permesos. Emprat per prototips d'elements trapper o prototips d'elements d'agent HTTP.| |trends|string|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendències. També admet macros d'usuari.<br><br>Per defecte: 365d.| |units|string|Unitats de valor.| |username|string|Nom d'usuari per a l'autenticació. S'empra per simple verificació, SSH, Telnet, monitor de base de dades, prototips d'elements d'agent JMX i HTTP.<br><br>Requerit pels prototips d'elements SSH i Telnet.| |uuid|string|Identificador únic universal, que s'empra per enllaçar un prototip d'element importat amb prototips d'element ja existents. S'empra només per a prototips d'elements de model. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només lectura*.| |valuemapid|string|ID de la taula. coincidència de valors associats.| |verify\_host|integer|Camp de prototip d'element d'agent HTTP. Valida que el nom d'equip a l'URL sigui al camp Nom comú o Nom alternatiu del subjecte del certificat d'equip.<br><br>0 - *(per defecte)* No valideu. <br>1 - Valida.| |verify\_peer|integer|Camp de prototip d'element d'agent HTTP. Valideu si el certificat d'equip és autèntic.<br><br>0 - *(per defecte)* No validar.<br>1 - Validar.| |discover|integer|Estat de descobriment del prototip d'element.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran nous elements;<br>1 - no es descobriran elements nous i els elements existents es marcaran com a perduts.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Item prototype This class is designed to work with item prototypes. Object references: - [Item prototype](/manual/api/reference/itemprototype/object#item_prototype) Available methods: - [itemprototype.create](/manual/api/reference/itemprototype/create) - creating new item prototypes - [itemprototype.delete](/manual/api/reference/itemprototype/delete) - deleting item prototypes - [itemprototype.get](/manual/api/reference/itemprototype/get) - retrieving item prototypes - [itemprototype.update](/manual/api/reference/itemprototype/update) - updating item prototypes # Prototipus d'element Aquesta classe és dissenyada per treballar amb prototipus d'elements. Referències d'objectes: - [Prototipus d'element](/manual/api/reference/itemprototype/object#item_prototype) Mètodes disponibles: - [itemprototype.create](/manual/api/reference/itemprototype/create) - crear nous prototipus d'elements - [itemprototype.delete](/manual/api/reference/itemprototype/delete) - esborrar prototips d'elements - [itemprototype.get](/manual/api/reference/itemprototype/get) - recuperar prototipus d'elements - [itemprototype.update](/manual/api/reference/itemprototype/update) - actualitzar prototipus d'elements # itemprototype.update # itemprototype.update ##### Item prototype You may want to create an item prototype like this:  with preprocessing options:  ##### Prototip d'element És possible que vulgueu crear un prototip d'element com aquest:  amb opcions de preprocessament:  ## Items ## Elements ## Items ## Elements ## Items ## Elements ## Items ## Elements ## Items ## Elements ## Items ## Elements ## Items ## Elements #### Items Define items to monitor. [Item API](/manual/api/reference/item) #### Elements Defineix els elements a monitorar. [API Element](/manual/api/reference/item) ### Items ##### docker.container_stats The [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) item on Zabbix agent 2 now also returns a `pids_stats` property with the current number of processes/threads on the container. ### Elements ##### docker.container_stats L'element [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) a l'agent 2 de Zabbix ara retorna la propietat `pids_stats` amb el nombre de processos/fils actuals del contenidor. #### Items / item prototypes In an [item](/manual/config/items/item) or an [item prototype](/manual/discovery/low_level_discovery/item_prototypes) configuration, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Item key parameters|<|yes| |Update interval|<|no| |Custom intervals|<|no| |History storage period|<|no| |Trend storage period|<|no| |Description|<|yes| |*Calculated/aggregate item*|<|<| | |Formula (expression constants and function parameters; item key parameters; (*aggregate item only*) filter conditions (host group name and tag name))|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|yes| |*HTTP agent*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|Query fields|yes| |^|Timeout|no| |^|Request body|yes| |^|Headers (names and values)|yes| |^|Required status codes|yes| |^|HTTP proxy|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |^|SSl certificate file|yes| |^|SSl key file|yes| |^|SSl key password|yes| |^|Allowed hosts|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*Script item*|<|<| | |Parameter names and values|yes| |*SNMP agent*|<|<| | |SNMP OID|yes| |*SSH agent*|<|<| | |Username|yes| |^|Public key file|yes| |^|Private key file|yes| |^|Password|yes| |^|Script|yes| |*TELNET agent*|<|<| | |Username|yes| |^|Password|yes| |^|Script|yes| |*Zabbix trapper*|<|<| | |Allowed hosts|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| |*Preprocessing*|<|<| | |Step parameters (including custom scripts)|yes| #### Elements / prototips d'elements En una configuració d'[element](/manual/config/items/item) o [prototips d'elements](/manual/discovery/low_level_discovery/item_prototypes), les macros d'usuari es poden emprar als camps següents: |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Paràmetres de clau d'element|<|sí| |Intèrval d'actualització|<|no| |Intèrvals personalitzats|<|no| |Període d'emmagatzematge de l'històric|<|no| |Període d'emmagatzematge de les tendències|<|no| |Descripció|<|sí| |*element calculat/agregat*|<|<| | |Fórmula (constants d'expressió i paràmetres de funció; paràmetres clau d'element; (*només element agregat*) condicions de filtre (nom del grup d'equip i nom de l'etiqueta))|sí| |*Monitoratge de base de dades*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Petició SQL|sí| |*Agent HTTP*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|sí| |^|Camps de petició|sí| |^|Temps d'espera|no| |^|Cos de la petició|sí| |^|Capçalera (noms i valors)|sí| |^|Codis d'estat demanats|sí| |^|Proxy HTTP|sí| |^|Nom d'usuari d'autenticació HTTP|sí| |^|Mot de pas d'autenticació HTTP|sí| |^|Arxiu de certificat SSL|sí| |^|Arxiu de clau SSL|sí| |^|Mot de pas de la clau SSL|sí| |^|Equips autoritzats|sí| |*Agent JMX*|<|<| | |Punt d'acabament JMX|sí| |*Element Script*|<|<| | |Noms i valors dels paràmetres|sí| |*Agent SNMP*|<|<| | |OID SNMP|sí| |*Agent SSH*|<|<| | |Nom d'usuari|sí| |^|Arxiu de clau pública|sí| |^|Arxiu de clau privada|sí| |^|Paraula de pas|sí| |^|Script|sí| |*Agent TELNET*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Script|sí| |*Trap Zabbix*|<|<| | |Equips autoritzats|sí| |*Etiquetes*^[2](supported_by_location_user#footnotes)^|<|<| | |Noms d'etiquetes|sí| |^|Valors d'etiquetes|sí| |*Preprocés*|<|<| | |Paràmetres d'etapa (inclosos els scripts personalitzats)|sí| #### Items To configure querying of internal stats on another Zabbix instance, you may use two items: - `zabbix[stats,<ip>,<port>]` internal item - for direct remote queries of Zabbix server/proxy. <ip> and <port> are used to identify the target instance. - `zabbix.stats[<ip>,<port>]` agent item - for agent-based remote queries of Zabbix server/proxy. <ip> and <port> are used to identify the target instance. See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent) The following diagram illustrates the use of either item depending on the context.  -  - Server → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -  - Server → proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -  - Server → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) -  - Server → proxy → agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) To make sure that the target instance allows querying it by the external instance, list the address of the external instance in the 'StatsAllowedIP' parameter on the target instance. #### Elements Per configurar la consulta de les estadístiques internes sobre una altra instància Zabbix, podeu emprar dos elements: - L'element intern `zabbix[stats,<ip>,<port>]` - per les peticions directes a distància del servidor/proxy Zabbix. <ip> i <port> són emprades per indentificar la instància destí. - L'element agent `zabbix.stats[<ip>,<port>]` - per les peticions basades en l'agent del servidor/proxy Zabbix. <ip> i<port> són emprades per identificar la instància destí. Veieu també: [Elements interns](/manual/config/items/itemtypes/internal), [Elements d'agent Zabbix](/manual/config/items/itemtypes/zabbix_agent) L'sequema següent mostra l'ús d'un o altre element en funció del context.  -  - Servidor → instància Zabbix externa (`zabbix[stats,<ip>,<port>]`) -  - Servidor → proxy → instància Zabbix externa (`zabbix[stats,<ip>,<port>]`) -  - Servidor → agent → instància Zabbix externa (`zabbix.stats[<ip>,<port>]`) -  - Servidor → proxy → agent → instància Zabbix externa (`zabbix.stats[<ip>,<port>]`) Per assegurar-vos que la instància destí permet ésser consultada per la instància externa, especifiqueu l'adreça externa al paràmetre 'StatsAllowedIP' de la instància destí. ### Item tag The item tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Item tag name.| |value|string|Item tag value.| ### Etiqueta d'element L'objecte d'etiqueta d'element té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta d'element.| |value|string|Valor de l'etiqueta d'element.| # Item This class is designed to work with items. Object references: - [Item](/manual/api/reference/item/object#item) Available methods: - [item.create](/manual/api/reference/item/create) - creating new items - [item.delete](/manual/api/reference/item/delete) - deleting items - [item.get](/manual/api/reference/item/get) - retrieving items - [item.update](/manual/api/reference/item/update) - updating items # Element Aquesta classe és dissenyada per treballar amb elements. Referències d'objectes: - [Element](/manual/api/reference/item/object#item) Mètodes disponibles: - [item.create](/manual/api/reference/item/create) - crear nous elements - [item.delete](/manual/api/reference/item/delete) - esborrar elements - [item.get](/manual/api/reference/item/get) - recuperar elements - [item.update](/manual/api/reference/item/update) - actualitzar elements ##### Item To begin with, you may want to set up an item that monitors a log file, for example: log[/var/log/syslog]  With the item set up, wait a minute for the configuration changes to be picked up and then go to [Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) to make sure that the item has started collecting data. ##### Element Per començar, voleu poder configurar un element que monitora un arxiu de registre, per exemple: log[/var/log/syslog]  Una vegada l'element és configurat, espereu un minut que les modificacions de configuració siguin recuperades, i accediu a les [Darreres dades](/manual/web_interface/frontend_sections/monitoring/latest_data) per assegurar-vos que l'element comença a recollir dades. # item.update # item.update #### Item value An *Item value* widget has been added to dashboard widgets. This type of widget is useful for displaying values of single items prominently. Different visual styles of display are possible:  For more information, see [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value). ##### Valor de l'element S'ha afegit el giny *Valor de l'element* als ginys del tauler. Aquest tipus de giny és útil per ressaltar valors d'elements únics. Són possibles diferents estils de visualització:  Per obtindre més informació, consulteu el [giny valor d'element](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value). ##### Item value preprocessing The **Preprocessing** tab allows to define [transformation rules](/manual/config/items/preprocessing) for the received values. ##### Preprocessament del valor de l'element La pestanya **Preprocessament** permet definir [regles de transformació](/manual/config/items/preprocessing) per als valors rebuts. #### Item value preprocessing To visualize the data preprocessing process, we can use the following simplified diagram:  The diagram above shows only processes, objects and main actions related to item value preprocessing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. Only one preprocessing worker is shown on this diagram (multiple preprocessing workers can be used in real-life scenarios), only one item value is being processed and we assume that this item requires to execute at least one preprocessing step. The aim of this diagram is to show the idea behind item value preprocessing pipeline. - Item data and item value is passed to preprocessing manager using socket-based IPC mechanism. - Item is placed in the preprocessing queue. ::: noteclassic Item can be placed at the end or at the beginning of the preprocessing queue. Zabbix internal items are always placed at the beginning of preprocessing queue, while other item types are enqueued at the end. ::: - At this point data flow stops until there is at least one unoccupied (that is not executing any tasks) preprocessing worker. - When preprocessing worker is available, preprocessing task is being sent to it. - After preprocessing is done (both failed and successful execution of preprocessing steps), preprocessed value is being passed back to preprocessing manager. - Preprocessing manager converts result to desired format (defined by item value type) and places result in preprocessing queue. If there are dependent items for current item, then dependent items are added to preprocessing queue as well. Dependent items are enqueued in preprocessing queue right after the master item, but only for master items with value set and not in NOT SUPPORTED state. #### Preprocessament del valor de l'element Per visualitzar el procés de preprocessament de dades, podem emprar el següent diagrama simplificat:  El diagrama anterior només mostra els principals processos, objectes i accions relacionades amb el preprocessament del valor de l'element de manera **simplificada**. El diagrama no mostra canvis de direcció condicionals, tractament d'errades ni bucles. En aquest diagrama només es mostra un preprocessador (es poden emprar diversos preprocessadors en escenaris del món real), només s'és processant un valor d'element i suposem que aquest element requereix almenys un per executar la passa de preprocessament. L'objectiu d'aquest diagrama és mostrar què hi ha darrera de la canalització de preprocessament del valor de l'article. - Les dades i el valor de l'element es passen al controlador de preprocessament mitjançant el mecanisme IPC basat en socket. - L'element es posa a la cua de preprocessament. :::noteclassic L'element es pot posar al final o al començament de la cua de preprocessament. Els elements interns de Zabbix sempre es posen al principi de la cua de preprocessament, mentre que altres tipus d'elements es posen a la cua al final. ::: - En aquest punt, el flux de dades s'atura fins que hi hagi almenys un agent de preprocessament inactiu (no realitza cap tasca). - Quan el treballador de preprocessament és disponible, se li envia la tasca de preprocessament. - Un cop finalitzat el preprocessament (error i execució correcta de les passes de preprocessament), el valor preprocessat es retorna al controlador de preprocessament. - El controlador de preprocessament converteix el resultat al format desitjat (definit pel tipus de valor de l'element) i col·loca el resultat a la cua de preprocessament. Si hi ha elements dependents per a l'element actual, els elements dependents també s'afegeixen a la cua de preprocessament. Els elements dependents es posen a la cua de preprocessament just després de l'element principal, però només per als elements principals amb un valor definit i no en l'estat NO ADMÈS. #### Item value processing To visualize the data flow from data source to the Zabbix database, we can use the following simplified diagram:  The diagram above shows only processes, objects and actions related to item value processing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. Local data cache of preprocessing manager is not shown either because it doesn't affect data flow directly. The aim of this diagram is to show processes involved in item value processing and the way they interact. - Data gathering starts with raw data from a data source. At this point, data contains only ID, timestamp and value (can be multiple values as well) - No matter what type of data gatherer is used, the idea is the same for active or passive checks, for trapper items and etc, as it only changes the data format and the communication starter (either data gatherer is waiting for a connection and data, or data gatherer initiates the communication and requests the data). Raw data is validated, item configuration is retrieved from configuration cache (data is enriched with the configuration data). - Socket-based IPC mechanism is used to pass data from data gatherers to preprocessing manager. At this point data gatherer continue to gather data without waiting for the response from preprocessing manager. - Data preprocessing is performed. This includes execution of preprocessing steps and dependent item processing. ::: noteclassic Item can change its state to NOT SUPPORTED while preprocessing is performed if any of preprocessing steps fail. ::: - History data from local data cache of preprocessing manager is being flushed into history cache. - At this point data flow stops until the next synchronization of history cache (when history syncer process performs data synchronization). - Synchronization process starts with data normalization storing data in Zabbix database. Data normalization performs conversions to desired item type (type defined in item configuration), including truncation of textual data based on predefined sizes allowed for those types (HISTORY\_STR\_VALUE\_LEN for string, HISTORY\_TEXT\_VALUE\_LEN for text and HISTORY\_LOG\_VALUE\_LEN for log values). Data is being sent to Zabbix database after normalization is done. ::: noteclassic Item can change its state to NOT SUPPORTED if data normalization fails (for example, when textual value cannot be converted to number). ::: - Gathered data is being processed - triggers are checked, item configuration is updated if item becomes NOT SUPPORTED, etc. - This is considered the end of data flow from the point of view of item value processing. #### Processament del valor de l'element Per visualitzar el flux de dades de la font de dades a la base de dades Zabbix, podem emprar el següent diagrama simplificat:  El diagrama anterior només mostra els processos, objectes i accions relacionades amb el processament del valor de l'element en una forma **simplificada**. El diagrama no mostra canvis de direcció condicionals, tractament d'errors ni bucles. Tampoc es mostra la memòria cau de dades locals del gestor de preprocessament perquè no afecta directament el flux de dades. L'objectiu d'aquest diagrama és mostrar els processos implicats en el processament del valor dels elements i com interactuen. - La recollida de dades comença amb dades en brut d'una font de dades. En aquest moment, les dades només contenen ID, marca de temps i valor (també poden ser diversos valors) - Independentment del tipus de col·lector de dades emprat, la idea és la mateixa per a controls actius o passius, per a elements trapper, etc., ja que només canvia el format de les dades i l'inici de la comunicació (o el col·lector de dades és esperant una connexió i dades, o el recollidor de dades inicia la comunicació i demana les dades). Les dades en brut es validen, la configuració de l'element es recupera de la memòria cau de configuració (les dades s'enriqueixen amb dades de configuració). - El mecanisme IPC basat en socket s'empra per passar dades dels col·lectors de dades al gestor de preprocessament. En aquest punt, el recopilador de dades continua recopilant dades sense esperar la resposta del gestor de preprocessament. - Es fa un pretractament de dades. Això inclou fer passes de preprocessament i processar elements dependents. :::noteclassic L'element pot canviar d'estat a NO SOPORTAT durant el preprocessament si alguna de les passes de preprocessament falla. ::: - Les dades de l'historial de la memòria cau de dades local del gestor de preprocessament s'envien a la memòria cau de l'historial. - En aquest punt, el flux de dades s'atura fins a la següent sincronització de la memòria cau de l'historial (quan el procés de sincronització de l'historial realitza la sincronització de dades). - El procés de sincronització comença amb la normalització de dades emmagatzemant dades a la base de dades Zabbix. La normalització de dades realitza conversions al tipus d'element esperat (tipus definit a la configuració de l'element), inclòs el truncament de les dades textuals segons les mides predefinides permeses per a aquests tipus (HISTORY\_STR\_VALUE\_LEN per a la cadena, HISTORY\_TEXT\_VALUE\_LEN per a text i HISTORY\_LOG\_VALUE\_LEN per als valors de registre). Les dades s'envien a la base de dades Zabbix després de la normalització. :::noteclassic L'element pot canviar d'estat a NO SOPORTAT si la normalització de dades falla (per exemple, quan el valor del text no es pot convertir a nombre). ::: - S'estan processant les dades recollides: es comproven els triggers, s'actualitza la configuració de l'element si l'element no és compatible, etc. - Es considera el final del flux de dades des del punt de vista del processament del valor de l'element. #### Item values displayed as HTML using iframes Item data in the [Plain text](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text) widget, when displayed as HTML-formatted text, is now isolated in iframes. #### Valors dels elements que es veuen com a HTML mitjançant iframes Les dades dels elements del giny [Text sense format](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/plain_text), quan es mostren com a text amb format HTML, ara s'aïllen als iframes. #### Item values The following information is exported for a collected item value: |Field|<|Type|Description| |-|---------|---------|---------------------------| |*host*|<|object|Host name of the item host.| | |host|string|Host name.| |^|name|string|Visible host name.| |*groups*|<|array|List of host groups of the item host; there should be at least one element in array.| | |\-|string|Host group name.| |*itemid*|<|number|Item ID.| |*name*|<|string|Visible item name.| |*clock*|<|number|Number of seconds since Epoch to the moment when value was collected (integer part).| |*ns*|<|number|Number of nanoseconds to be added to `clock` to get a precise value collection time.| |*timestamp*<br>(*Log* only)|<|number|0 if not available.| |*source*<br>(*Log* only)|<|string|Empty string if not available.| |*severity*<br>(*Log* only)|<|number|0 if not available.| |*eventid*<br>(*Log* only)|<|number|0 if not available.| |*value*|<|number (for numeric items) or<br>string (for text items)|Collected item value.| |*type*|<|number|Collected value type:<br>0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text| #### Valors d'element S'exporta la informació següent per al valor d'un element recollit: |Camp|<|Tipus|Descripció| |-|----------|----------|----------------------------- | |*host*|<|object|Nom d'equip de l'equip de l'element.| | |host|string|Nom de l'equip.| |^|nom|string|Nom visible de l'equip.| |*groups*|<|array|Llista de grups d'equips de l'element equip; hi ha d'haver almenys un element a la matriu.| | |\-|string|Nom del grup d'equips.| |*itemid*|<|number|ID de l'element.| |*nom*|<|string|Nom de l'element visible.| |*clock*|<|number|Nombre de segons des de l'Època fins que es va recopilar el valor (part entera).| |*ns*|<|number|Nombre de nanosegons que cal afegir a `clock` per obtindre un temps de recollida de valors precís.| |*timestamp*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*font*<br>(només *Journal*)|<|string|Cadena buida si no és pas disponible.| |*severity*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*eventid*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*value*|<|number (per a elements numèrics) o<br>string (per a elements de text)|Valor de l'element recollit.| |*types*|<|number|Tipus de valor recollit:<br>0 - nombre flotant, 1 - caràcter, 2 - registre, 3 - numèric sense signe, 4 - text| #### Item value suffixes Suffixes can also be used to display numeric item values in a human-readable format. To enable this, use one of the following suffixes in the *Units* field when [configuring an item](/manual/config/items/item#configuration): - **B** - bytes - **Bps** - bytes per second - **s** - seconds, displayed using up to three largest non-zero time units - **uptime** - elapsed time in hh:mm:ss or N days, hh:mm:ss - **unixtime** - Unix timestamp, formatted as yyyy.mm.dd hh:mm:ss The following additional rules apply to how these suffixes are interpreted and displayed: - For B and Bps, Zabbix uses base-2 conversion (1K = 1024B), following the [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards) standard. - For other units (such as Hz, W, etc.), Zabbix uses base-10 conversion (1K = 1000). - For s (seconds): - The format includes yyy mmm ddd hhh mmm sss ms; only up to three largest non-zero time units are displayed (e.g., 1M 10d 4h). - If a unit is zero and between two non-zero units, it is omitted (e.g., 10d 56m instead of 10d 0h 56m). When *Units* are used, the following multiplier suffixes are automatically applied to item values: - **K**, **M**, **G**, **T** - kilo, mega, giga, tera - **P**, **E**, **Z**, **Y** - peta, exa, zetta, yotta *(these are applied in frontend only)* #### Sufixos de valor d'element Els sufixos també es poden utilitzar per veure els valors numèrics d'element en un format llegible per humans. Per habilitar-ho, utilitzeu un dels sufixos següents al camp *Unitats* quan [configureu un element](/manual/config/items/item#configuration): - **O** - octets - **Ops** - octets per segon - **s** - segons, que es mostren utilitzant fins a tres unitats de temps més grans diferents de zero - **uptime** - temps transcorregut en hh:mm:ss o N dies, hh:mm:ss - **unixtime** - marca de temps d'Unix, amb el format aaaa.mm.dd hh:mm:ss Les regles addicionals següents s'apliquen a la manera com s'interpreten i es mostren aquests sufixos: - Per a O i Ops, Zabbix utilitza la conversió base-2 (1K = 1024O), seguint l'estàndard [JEDEC](https://en.wikipedia.org/wiki/JEDEC_memory_standards). - Per a altres unitats (com ara Hz, W, etc.), Zabbix utilitza la conversió en base 10 (1K = 1000). - Per a s (segons): - El format inclou yyy mmm ddd hhh mmm sss ms; només es mostren fins a tres unitats de temps diferents de zero més grans (per exemple, 1M 10d 4h). - Si una unitat és zero i es troba entre dues unitats diferents de zero, s'omet (per exemple, 10d 56m en lloc de 10d 0h 56m). Quan s'utilitzen *Unitats*, els següents sufixos multiplicadors s'apliquen automàticament als valors dels elements: - **K**, **M**, **G**, **T** - quilo, mega, giga, tera - **P**, **E**, **Z**, **Y** - peta, exa, zetta, yotta *(només s'apliquen al frontend)* ##### Item value The following parameters are supported if *Data* is set to "Item value". ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.color.0.0) references the column for which thresholds are configured, while the second number references 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. `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). ::: |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.item.0|Valid item name.| |***Time shift***<br>(required)|<|1|columns.timeshift.0|Valid numeric or time string value (e.g. `3600` or `1h`).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| |*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|<|1|columns.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Parameter *Aggregation interval* not available if *Aggregation function* is set to *none*.<br><br>Default: `1h`.| |*Display*|<|0|columns.display.0|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators.| |*Min*|<|1|columns.min.0|Any numeric value.<br><br>Parameter *Min* not available if *Display* is set to "As is".| |*Max*|<|1|columns.max.0|Any numeric value.<br><br>Parameter *Max* not available if *Display* is set to "As is".| |*History data*|<|0|columns.history.0|1 - *(default)* Auto;<br>2 - History;<br>3 - Trends.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|Any string value.| ##### Valor de l'element Els paràmetres següents són compatibles si *Data* s'estableix a "Valor de l'element". ::: noteclassic El primer nombre del nom de propietat *Llindars* (p. ex. columnsthresholds.color.0.0) fa referència a la columna per a la qual es configuren els llindars, mentre que el segon nombre fa referència al lloc llindar en una llista, ordenada en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (p. ex., `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold. 1": "5"`). ::: |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Element*|<|1 |columns.item.0|Nom d'element vàlid.| |***Desplaçament de temps***<br>(obligatori)|<|1|columns.timeshift.0|Valor numèric o de cadena de temps vàlid (p. ex., `3600` o `1h`).<br>Podeu emprar [sufixos de temps](/manual/appendix/sufixes#time-suffixes). Es permeten valors negatius.| |*Funció d'agregació*|<|0|columns.aggregate_function.0|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte;<br>5 - suma;<br>6 - primer;<br>7 - darrer.| |*Interval d'agregació*|<|1|columns.aggregate_interval.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes #time-sufixes).<br><br>El paràmetre *Interval d'agregació* no és pas disponible si la *funció d'agregació* és establerta a *cap*.<br><br>Per defecte: `1h`.| |*Vista*|<|0|columns.display.0|1 - *(per defecte)* Tal com és;<br>2 - Barra;<br>3 - Indicadors.| |*Min*|<|1|columns.min.0|Qualsevol valor numèric.<br><br>El paràmetre *Min* no és disponible si *Vista* s'estableix a "Tal com és".| |*Max*|<|1|columns.max.0|Qualsevol valor numèric.<br><br>El paràmetre *Max* no és disponible si *Vista* és establert a "Tal com és".| |*Dades de l'historial*|<|0|columns.history.0|1 - *(per defecte)* Automàtic;<br>2 - Historial;<br>3 - Tendències.| |*Llindars*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Codi de color hexadecimal (per exemple, `FF0000`).<br><br>Per defecte: `""` (buida).| |^|*Llindar*|1|columnsthresholds.threshold.0.0|Qualsevol valor de cadena.| It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset the initial view*. When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  És possible ampliar i allunyar el mapa emprant els botons més i menys a la cantonada superior esquerra del giny o emprant la roda del ratolí o el touchpad. Per establir la vista actual com a predeterminada, feu clic amb el botó dret a qualsevol lloc del mapa i seleccioneu *Establir aquesta vista com a predeterminada*. Aquesta configuració anul·larà la configuració del giny *Vista inicial* per a l'usuari actual. Per desfer aquesta acció, torneu a fer clic amb el botó dret a qualsevol lloc del mapa i trieu *Restablir la vista inicial*. Quan s'estableix *Visualització inicial* o *Visualització per defecte*, podeu tornar a aquesta vista en qualsevol moment tocant la icona d'inici a l'esquerra.  #### Java 11 required for Java gateway Zabbix Java gateway now requires Java 11 for runtime (building from source is still possible with Java 8), due to updated minimum logback library versions: |Library|New minimum version|Old minimum version| |------|--|--| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|**1.5.16**|1.2.9| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|**1.5.16**|1.2.9| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|**2.0.16**|1.7.32| #### Java 11 necessari per a la passarel·la Java La passarel·la Java de Zabbix ara requereix Java 11 per al temps d'execució (encara és possible la creació des de la font amb Java 8), a causa de les versions mínimes actualitzades de la biblioteca de retrocés: |Biblioteca|Versió mínima nova|Versió mínima antiga| |------|--|--| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|**1.5.16**|1.2.9| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|**1.5.16**|1.2.9| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|**2.0.16**|1.7.32| ##### Java gateway If you obtained Zabbix from the source repository or an archive, then the necessary dependencies are already included in the source tree. If you obtained Zabbix from your distribution's package, then the necessary dependencies are already provided by the packaging system. In both cases above, the software is ready to be used and no additional downloads are necessary. If, however, you wish to provide your versions of these dependencies (for instance, if you are preparing a package for some Linux distribution), below is the list of library versions that Java gateway is known to work with. Zabbix may work with other versions of these libraries, too. The following table lists JAR files that are currently bundled with Java gateway in the original code: |Library|Mandatory status|Comments| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Yes|Version 4.3r1 or higher.<br>JSON (JavaScript Object Notation) is a lightweight data-interchange format. This is the org.json compatible Android implementation extracted from the Android SDK.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|Version 1.5.16 or higher.| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|Version 1.5.16 or higher.| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|Version 2.0.16 or higher.| Java gateway can be built using either Oracle Java or open source OpenJDK (version 1.6 or newer). Packages provided by Zabbix are compiled using OpenJDK. The following table lists OpenJDK packages used for building Zabbix packages by distribution: |Distribution|OpenJDK package| |---|--------| |Debian 12|`default-jdk-headless` (amd64, arm64: 2:1.17-74)| |Debian 11|`default-jdk-headless` (amd64: 2:1.11-72)| |Debian 10|`default-jdk-headless` (amd64, i386: 2:1.11-71)| |OpenSUSE Leap 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |Oracle Linux 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4.0.1; arm64: 11.0.20.0.8-2.0.1)| |Oracle Linux 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4.0.1); `java-11-openjdk-devel` (arm64: 11.0.20.0.8-3.0.1)| |Oracle Linux 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |Raspberry Pi OS 12|`default-jdk-headless` (arm64, armhf: 2:1.17-74)| |Raspberry Pi OS 11|`default-jdk-headless` (arm64: 2:1.11-72; armhf: 2:1.11-72+b4)| |Raspberry Pi OS 10|`default-jdk` (armhf: 2:1.11-71+b2)| |RHEL 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4; arm64: 11.0.20.0.8-3)| |RHEL 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4; arm64: 1.8.0.382.b05-2)| |RHEL 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |SLES 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |SLES 12|`java-1_8_0-openjdk-devel` (amd64: 1.8.0.252-27.45.6)| |Ubuntu 24.04|`default-jdk-headless` (amd64, arm64: 2:1.21-75+exp1)| |Ubuntu 22.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72build2)| |Ubuntu 20.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72)| |Ubuntu 18.04|`default-jdk` (amd64: 2:1.11-68ubuntu1~18.04.1; i386: 2:1.10-63ubuntu1~02)| ##### Passerel·la Java Si heu obtingut Zabbix del repositori font o d'un arxiu, les dependències necessàries ja s'inclouen a la font. Si teniu Zabbix del paquet de la vostra distribució, el sistema de paquets ja proporciona les dependències necessàries. En els dos casos anteriors, el programari és llest per usar-lo i no cal descarregar-lo. Tanmateix, si voleu proporcionar les vostres versions d'aquestes dependències (per exemple, si sou preparant un paquet per a determinades distribucions de Linux), a continuació es mostra el llistat de versions de biblioteca amb les quals se sap que la passarel·la de Java pot funcionar. Zabbix també pot treballar amb altres versions d'aquestes biblioteques. La taula següent llista els fitxers JAR que s'envien actualment amb Java Gateway al codi original: |Biblioteca|Obligatori|Comentaris| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Sí|Versió 4.3r1 o superior.<br>JSON (JavaScript Object Notation) és un format intercanvi de dades lleuger. Aquesta és la implementació d'Android compatible amb org.json extreta de l'SDK d'Android.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|Versió 1.5.16 o superior.| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|Versió 1.5.16 o superior.| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|Versió 2.0.16 o superior.| La passarel·la de Java es pot crear amb Oracle Java o OpenJDK de codi obert (versió 1.6 o posterior). Els paquets proporcionats per Zabbix es compilen mitjançant OpenJDK. La taula següent proporciona informació sobre les versions d'OpenJDK emprades per crear paquets Zabbix per distribució: |Distribució|Versió OpenJDK| |-----------|---------------| |Debian 12|`default-jdk-headless` (amd64, arm64: 2:1.17-74)| |Debian 11|`default-jdk-headless` (amd64: 2:1.11-72)| |Debian 10|`default-jdk-headless` (amd64, i386: 2:1.11-71)| |OpenSUSE Leap 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |Oracle Linux 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4.0.1; arm64: 11.0.20.0.8-2.0.1)| |Oracle Linux 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4.0.1); `java-11-openjdk-devel` (arm64: 11.0.20.0.8-3.0.1)| |Oracle Linux 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |Raspberry Pi OS 12|`default-jdk-headless` (arm64, armhf: 2:1.17-74)| |Raspberry Pi OS 11|`default-jdk-headless` (arm64: 2:1.11-72; armhf: 2:1.11-72+b4)| |Raspberry Pi OS 10|`default-jdk` (armhf: 2:1.11-71+b2)| |RHEL 9|`java-11-openjdk-devel` (amd64: 11.0.19.0.7-4; arm64: 11.0.20.0.8-3)| |RHEL 8|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.372.b07-4; arm64: 1.8.0.382.b05-2)| |RHEL 7|`java-1.8.0-openjdk-devel` (amd64: 1.8.0.282.b08-1)| |SLES 15|`java-17-openjdk-devel` (amd64: 17.0.5.0-150400.3.9.3; arm64: 17.0.8.0-150400.3.27.1)| |SLES 12|`java-1_8_0-openjdk-devel` (amd64: 1.8.0.252-27.45.6)| |Ubuntu 24.04|`default-jdk-headless` (amd64, arm64: 2:1.21-75+exp1)| |Ubuntu 22.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72build2)| |Ubuntu 20.04|`default-jdk-headless` (amd64, arm64: 2:1.11-72)| |Ubuntu 18.04|`default-jdk` (amd64: 2:1.11-68ubuntu1~18.04.1; i386: 2:1.10-63ubuntu1~02)| ### Java gateway installation It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. Once the required repository is added, you can install Zabbix Java gateway by running: apt install zabbix-java-gateway Proceed to [setup](/manual/concepts/java/from_debian_ubuntu) for more details on configuring and running Java gateway. ###Instal·lació de la passarel·la Java Cal instal·lar la [passarel·la de Java](/manual/concepts/java) només si voleu monitorar les aplicacions JMX. La passarel·la de Java és lleugera i no li cal una base de dades. Un cop afegit el dipòsit necessari, podeu instal·lar Zabbix Java Gateway executant: apt install zabbix-java-gateway Aneu a [configuració](/manual/concepts/java/from_debian_ubuntu) per obtindre detalls sobre la configuració i l'execució de la passarel·la Java. ### Java gateway installation It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database. Once the required repository is added, you can install Zabbix Java gateway by running: dnf install zabbix-java-gateway Proceed to [setup](/manual/concepts/java/from_rhel) for more details on configuring and running Java gateway. ###Instal·lació de la passarel·la Java Cal instal·lar la [passarel·la de Java](/manual/concepts/java) només si voleu monitorar les aplicacions JMX. La passarel·la de Java és lleugera i no li cal una base de dades. Un cop afegit el dipòsit necessari, podeu instal·lar Zabbix Java Gateway executant: dnf install zabbix-java-gateway Aneu a [configuració](/manual/concepts/java/from_rhel) per obtindre detalls sobre la configuració i l'execució de la passarel·la Java. #### JavaScript methods HTTP methods PATCH, HEAD, OPTIONS, TRACE, CONNECT have been added to the JavaScript engine. Also, the engine now allows sending custom HTTP method requests with the new JS method HttpRequest.customRequest. See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects). ### Mètodes JavaScript Els mètodes HTTP PATCH, HEAD, OPTIONS, TRACE, CONNECT s'han afegit al motor de JavaScript. A més, el motor permet enviar peticions personalitzades de mètode HTTP amb el nou mètode JS HttpRequest.customRequest. Veieu també: [Objectes addicionals de JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects). #### JavaScript preprocessing: built-in object methods are now read-only Built-in JavaScript object methods in [preprocessing](/manual/config/items/preprocessing/javascript) scripts are now read-only. If you have already modified built-in methods on JavaScript prototypes in item preprocessing scripts, you may encounter issues, as modifying built-in prototype methods is no longer allowed. ####Preprocessament de JavaScript: els mètodes d'objecte integrats ara només són de només lectura Els mètodes d'objecte JavaScript integrats en els scripts de [preprocessament](/manual/config/items/preprocessing/javascript) són ara només de lectura. Si ja heu modificat els mètodes integrats en prototips de JavaScript en scripts de preprocessament d'elements, és possible que trobeu problemes, ja que ja no es permet modificar els mètodes de prototip integrats. #### JavaScript preprocessing JavaScript preprocessing is done by invoking JavaScript function with a single parameter 'value' and user provided function body. The preprocessing step result is the value returned from this function, for example, to perform Fahrenheit to Celsius conversion user must enter: return (value - 32) * 5 / 9 in JavaScript preprocessing parameters, which will be wrapped into a JavaScript function by server: ``` {.java} function (value) { return (value - 32) * 5 / 9 } ``` The input parameter 'value' is always passed as a string. The return value is automatically coerced to string via ToString() method (if it fails then the error is returned as string value), with a few exceptions: - returning undefined value will result in an error - returning null value will cause the input value to be discarded, much like 'Discard value' preprocessing on 'Custom on fail' action. Errors can be returned by throwing values/objects (normally either strings or Error objects). For example: ``` {.java} if (value == 0) throw "Zero input value" return 1/value ``` Each script has a 10 second execution timeout (depending on the script it might take longer for the timeout to trigger); exceeding it will return error. A 512-megabyte heap limit is enforced (64 megabytes before Zabbix 6.0.19). The JavaScript preprocessing step bytecode is cached and reused when the step is applied next time. Any changes to the item's preprocessing steps will cause the cached script to be reset and recompiled later. Consecutive runtime failures (3 in a row) will cause the engine to be reinitialized to mitigate the possibility of one script breaking the execution environment for the next scripts (this action is logged with DebugLevel 4 and higher). JavaScript preprocessing is implemented with Duktape (<https://duktape.org/>) JavaScript engine. ::: noteclassic Built-in JavaScript object method definitions cannot be redefined in item preprocessing scripts. ::: See also: [Additional JavaScript objects and global functions](/manual/config/items/preprocessing/javascript/javascript_objects) #### Preprocessament de JavaScript El preprocessament de JavaScript es realitza invocant la funció JavaScript amb un únic paràmetre "valor" i un cos de funció subministrat per l'usuari. El resultat de la passa de preprocessament és el valor que retorna aquesta funció, per exemple, per fer una conversió de Fahrenheit a Celsius, l'usuari introduiria: return (value - 32) * 5 / 9 als paràmetres de preprocessament de JavaScript, que s'embolcallen en una funció JavaScript per servidor: ``` {.java} function (value) { return (value - 32) * 5 / 9 } ``` El paràmetre d'entrada "valor" sempre es passa com a cadena. El valor de retorn es converteix automàticament a una cadena mitjançant el mètode ToString() (si falla, l'error es retorna com a valor de cadena), amb algunes excepcions: - retornar un valor no definit donarà lloc a un error - retornar un valor nul farà que el valor d'entrada s'esborri, de la mateixa manera que el preprocessament "Esborra el valor" a l'acció "Personalitzar en cas d'error". Els errors es poden retornar iniciant valors/objectes (normalment cadenes o objectes d'error). Per exemple: ``` {.java} if (value == 0) throw "Zero input value" return 1/value ``` Cada script té un temps d'espera d'execució de 10 segons (depenent de l'script, el temps d'espera pot trigar més a activar-se); superar-lo retornarà un error. S'aplica un límit d'emmagatzematge dinàmic de 64 Mo. El bytecode de la passa de preprocessament de JavaScript s'emmagatzema a la memòria cau i es reutilitza la propera vegada que s'aplica el pas. Qualsevol canvi als passos de preprocessament de l'element farà que l'script desat a la memòria cau es restableixi i es torni a compilar posteriorment. Els errors d'execució consecutius (3 de seguits) faran que el motor es restableixi per esmorteir la possibilitat que un script trenqui l'entorn d'execució per als scripts posteriors (aquesta acció es registra amb DebugLevel a 4 i posteriors). El preprocessament de JavaScript s'implementa amb el motor JavaScript de Duktape (<https://duktape.org/>). ::: noteclassic Les definicions de mètode d'objecte JavaScript integrades no es poden redefinir en scripts de preprocessament d'elements. :: Veieu també: [Objectes JavaScript addicionals i funcions globals](/manual/config/items/preprocessing/javascript/javascript_objects) ### JavaScript preprocessing The heap limit for scripts has been upped from 64 to 512 megabytes. ### Preprocessament JavaScript El límit dels scripts s'ha augmentat de 64 a 512 megaoctets. #### Jira webhook (custom)  This script will create a JIRA issue and return some info on the created issue. ``` {.java} try { Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; if (params.HTTPProxy) { req.setProxy(params.HTTPProxy); } 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; return JSON.stringify(result); } catch (error) { Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields})); Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error); throw 'Failed with error: ' + error; } ``` #### Jira webhook (personalitzat)  Aquest script crearà un problema JIRA i retornarà la informació del problema creat. ``` {.java} try { Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value); var result = { 'tags': { 'endpoint': 'jira' } }, params = JSON.parse(value), req = new HttpRequest(), fields = {}, resp; if (params.HTTPProxy) { req.setProxy(params.HTTPProxy); } 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; return JSON.stringify(result); } catch (error) { Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields})); Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error); throw 'Failed with error: ' + error; } ``` #### JMX item keys in more detail #### Claus de l'element JMX detallats #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### Monitoratge JMX Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls. #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### Monitoratge JMX Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls. #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### Monitoratge JMX Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls. #### JMX monitoring See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details. #### Monitoratge JMX Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls. ### JMX monitoring The template *Generic Java JMX* now contains discovery rules for low-level discovery of memory pools and garbage collectors. ### Monitoratge JMX La plantilla *Generic Java JMX* ara conté regles de descoberta per a la descoberta de baix nivell d'agrupacions de memòria i col·lectors d'escombraries. #### JSON format The JSON export format contains the following objects: - Root object for Zabbix JSON export - Export version - Date when export was created in ISO 8601 long format ```json { "zabbix_export": { "version": "6.0", "date": "2020-04-22T06:20:11Z" } } ``` Other objects are dependent on exported objects. #### Format de base JSON El format d'exportació JSON conté els objectes següents: - Objecte arrel per l'exportació Zabbix JSON. - Versió de l'exportació. Data en que l'exportació s'ha creat, en format llarg ISO 8601. ```json { "zabbix_export": { "version": "6.0", "date": "2020-04-22T06:20:11Z" } } ``` La resta d'objectes depenen dels objectes exportats. ### JSONPath parsing errors JSONPath parsing errors occur in this version in case of leading whitespace and empty array/object. Fixed in Zabbix 6.0.12. ### Errors d'anàlisi JSONPath Els errors d'anàlisi de JSONPath es produeixen en aquesta versió en cas d'espai d'encapçalament i de taula/objecte buit. Corregit a Zabbix 6.0.12. #### Keeping history You can set for how many days history will be kept: - in the item properties [form](/manual/config/items/item) - when mass-updating items - when [setting up](/manual/web_interface/frontend_sections/administration/general#housekeeper) housekeeper tasks Any older data will be removed by the housekeeper. The general strong advice is to keep history for the smallest possible number of days and that way not to overload the database with lots of historical values. Instead of keeping a long history, you can keep longer data of trends. For example, you could keep history for 14 days and trends for 5 years. You can get a good idea of how much space is required by history versus trends data by referring to the [database sizing page](/manual/installation/requirements#database_size). While keeping shorter history, you will still be able to review older data in graphs, as graphs will use trend values for displaying older data. ::: noteimportant If history is set to '0', the item will update only dependent items and inventory. No trigger functions will be evaluated because trigger evaluation is based on history data only. ::: ::: notetip As an alternative way to preserve history consider to use [history export](/manual/config/items/loadablemodules#providing_history_export_callbacks) functionality of loadable modules. ::: #### Conservar l'històric Podeu definir durant quant de temps s'ha de conservar l'històric: - al formulari de propietats de l'[element](/manual/config/items/item) - quan s'actualitzen elements de forma massiva - quan es fa la [configuració](/manual/web_interface/frontend_sections/administration/general#housekeeper) de les tasques de neteja Totes les dades més antigues s'esborraran per la neteja. El consell general és conservar l'històric durant el mínim de dies possibles i no sobrecarregar la basse de dades amb nombrosos valors històrics. En lloc de conservar un històric llarg, podeu configurar dates més llargues a les tendències. Per exemple, podeu conservar l'històric de 14 dies i les tendències durant 5 anys. Podeu tindre una bona ideia de l'espai que cal per les dades d'històric segons l'informe de les dades de tendències, veient la [pàgina de dimensionament de la base de dades](/manual/installation/requirements#database_size). Conservant l'històric més curt, podeu veure les dades més antigues als gràfics, doncs els gràfics empren els valors de tendències per mostrar les dades més antigues. ::: noteimportant Si l'històric es defineix a '0', l'element actualitzarà només elements dependents i inventari. Cap funció de trigger s'avaluarà, doncs l'avaluació del trigger es basa només en les dades d'històric. ::: ::: notetip Una altra manera de preservar l'històric ésemprar la funcionalitat [exportar l'històric](/manual/config/items/loadablemodules#providing_history_export_callbacks) dels mòduls carregables. ::: #### Keeping trends Trends is a built-in historical data reduction mechanism which stores minimum, maximum, average and the total number of values per every hour for numeric data types. You can set for how many days trends will be kept: - in the item properties [form](/manual/config/items/item) - when mass-updating items - when setting up Housekeeper tasks Trends usually can be kept for much longer than history. Any older data will be removed by the housekeeper. Zabbix server accumulates trend data in runtime in the trend cache, as the data flows in. Server flushes **previous hour** trends of every item into the database (where frontend can find them) in these situations: - server receives the first current hour value of the item - 5 or less minutes of the current hour left and still no current hour values of the item - server stops To see trends on a graph you need to wait at least to the beginning of the next hour (if item is updated frequently) and at most to the end of the next hour (if item is updated rarely), which is 2 hours maximum. When server flushes trend cache and there are already trends in the database for this hour (for example, server has been restarted mid-hour), server needs to use update statements instead of simple inserts. Therefore on a bigger installation if restart is needed it is desirable to stop server in the end of one hour and start in the beginning of the next hour to avoid trend data overlap. History tables do not participate in trend generation in any way. ::: noteimportant If trends are set to '0', Zabbix server does not calculate or store trends at all. ::: ::: noteclassic The trends are calculated and stored with the same data type as the original values. As a result the average value calculations of unsigned data type values are rounded and the less the value interval is the less precise the result will be. For example if item has values 0 and 1, the average value will be 0, not 0.5. Also restarting server might result in the precision loss of unsigned data type average value calculations for the current hour. ::: #### Desar les tendències Les tendències són un mecanisme de reducció de dades de l'històric integrat que emmagatzema valors horaris mínims, màxims, mitjans i totals per a tipus de dades numèriques. Podeu definir durant quants dies es mantindran les tendències: - al [formulari](/manual/config/items/item) de les propietats de l'element - quan s'actualitzen elements a comptagotes - en configurar tasques de neteja Les tendències normalment es poden mantindre molt més temps que l'històric. Totes les dades més antigues s'esborraran amb la neteja. El servidor Zabbix acumula dades de tendències en temps d'execució a la memòria cau de tendències a mesura que arriben les dades. El servidor aboca les tendències de l'**hora anterior** de cada element a la base de dades (on la interfície les pot trobar) en aquestes situacions: - el servidor rep el primer valor de temps actual de l'element - Queden 5 minuts o menys de l'hora actual i encara no hi ha valor de temps actual per a l'element - el servidor s'atura Per veure les tendències en un gràfic, hauríeu d'esperar almenys fins a l'inici de l'hora següent (si l'element s'actualitza amb freqüència) i com a màxim fins al final de l'hora següent (si l'element s'actualitza amb poca freqüència); és a dir, 2 hores com a màxim. Quan el servidor esborra la memòria cau de tendències i ja hi ha tendències a la base de dades per a aquesta hora (per exemple, el servidor s'ha reiniciat fa mitja hora), el servidor hauria d'emprar declaracions d'actualització en lloc d'insercions simples. Per tant, en una instal·lació més gran, si es requereix un reinici, és desitjable aturar el servidor després d'una hora i començar al principi de l'hora següent per evitar la superposició de dades de tendència. Les taules històriques no participen de cap manera en la generació de tendències. ::: noteimportant Si les tendències s'estableixen a "0", el servidor Zabbix no calcula ni emmagatzema tendències en absolut. ::: :::noteclassic Les tendències es calculen i s'emmagatzemen amb el mateix tipus de dades que els valors originals. Com a resultat, els càlculs de valors mitjans dels valors de tipus de dades sense signar s'arrodoneixen i com més petit sigui el rang de valors, menys precís serà el resultat. Per exemple, si l'element té els valors 0 i 1, el valor mitjà serà 0 i no 0,5. Reiniciar el servidor també pot provocar que els càlculs del valor mitjà dels tipus de dades sense signar per a l'hora actual siguin inexactes. ::: ##### Kernel data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**kernel.maxfiles**|<|<|<| |Maximum number of opened files supported by OS.|Integer| | | |**kernel.maxproc**|<|<|<| |Maximum number of processes supported by OS.|Integer| | | |**kernel.openfiles**|<|<|<| |Return the number of currently open file descriptors.|Integer| |This item is supported since Zabbix 6.0.| ##### Dades del kernel |Clau de l'element|<|<|<| |--|--|------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |**kernel.maxfiles**|<|<|<| |Nombre màxim de fitxers oberts compatibles amb el sistema operatiu.|Enter| | | |**kernel.maxproc**|<|<|<| |Nombre màxim de processos compatibles amb el sistema d'explotació.|Enter| | | |**kernel.openfiles**|<|<|<| |Retorna el nombre de descriptors de fitxers oberts actualment.|Enter| |Aquest element s'admet des de Zabbix 6.0.| ### Keyboard navigation Keyboard control has been implemented for info icons in the frontend. Thus it is now possible to focus on info icons, and open the hints, using the keyboard. ### Navegació amb teclat S'ha implementat el control del teclat per a les icones d'informació a la interfície. Així, ara és possible centrar-se en les icones d'informació i obrir consells emprant el teclat. ##### Key file authentication To use key based authentication for SSH items, certain changes to the server configuration are required. Open the Zabbix server configuration file ([*zabbix\_server.conf*](/manual/appendix/config/zabbix_server)) as `root` and look for the following line: ```ini # SSHKeyLocation= ``` Uncomment it and set the full path to the folder where the public and private keys will be located: ```ini SSHKeyLocation=/home/zabbix/.ssh ``` Save the file and restart Zabbix server afterwards. The path */home/zabbix* here is the home directory for the *zabbix* user account, and *.ssh* is a directory where by default public and private keys will be generated by an [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) command inside the home directory. Usually installation packages of Zabbix server from different OS distributions create the *zabbix* user account with a home directory elsewhere, for example, */var/lib/zabbix* (as for system accounts). Before generating the keys, you could reallocate the home directory to */home/zabbix*, so that it corresponds with the `SSHKeyLocation` Zabbix server configuration parameter mentioned above. ::: noteclassic The following steps can be skipped if *zabbix* account has been added manually according to the [installation section](/manual/installation/install#create_user_account). In such a case the home directory for the *zabbix* account is most likely already */home/zabbix*. ::: To change the home directory of the *zabbix* user account, all working processes which are using it have to be stopped: ```bash systemctl stop zabbix-agent systemctl stop zabbix-server ``` To change the home directory location with an attempt to move it (if it exists) the following command should be executed: ```bash usermod -m -d /home/zabbix zabbix ``` It is also possible that a home directory did not exist in the old location, so it should be created at the new location. A safe attempt to do that is: ```bash test -d /home/zabbix || mkdir /home/zabbix ``` To be sure that all is secure, additional commands could be executed to set permissions to the home directory: ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ``` Previously stopped processes can now be started again: ```bash systemctl start zabbix-agent systemctl start zabbix-server ``` Now, the steps to generate the public and private keys can be performed with the following commands (for better readability, command prompts are commented out): ```bash sudo -u zabbix ssh-keygen -t rsa # Generating public/private rsa key pair. # Enter file in which to save the key (/home/zabbix/.ssh/id_rsa): /home/zabbix/.ssh/id_rsa # Enter passphrase (empty for no passphrase): <Leave empty> # Enter same passphrase again: <Leave empty> # Your identification has been saved in /home/zabbix/.ssh/id_rsa. # Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. # The key fingerprint is: # 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 # The key's randomart image is: # +--[ RSA 2048]----+ # | | # | . | # | o | # | . o | # |+ . S | # |.+ o = | # |E . * = | # |=o . ..* . | # |... oo.o+ | # +-----------------+ ``` ::: noteclassic The public and private keys (*id\_rsa.pub* and *id\_rsa*) have been generated by default in the */home/zabbix/.ssh* directory, which corresponds to the Zabbix server `SSHKeyLocation` configuration parameter. ::: ::: noteimportant Key types other than "rsa" may be supported by the ssh-keygen tool and SSH servers but they may not be supported by libssh2 used by Zabbix. ::: ##### Autenticació d'arxiu de clau Per emprar una autenticació basada en clau per elements SSH, s'han de fer alguns canvis a la configuració del servidor. Obriu l'arxiu de configuració del servidor Zabbix ([zabbix\_server.conf](/manual/appendix/config/zabbix_server)) com a `root`, i cerqueu la línia següent: ```ini # SSHKeyLocation= ``` Traieu-li el comentari i poseu-hi la ruta sencera cap a la carpeta on hi haurà les claus públiques i privades: ```ini SSHKeyLocation=/home/zabbix/.ssh ``` Deseu l'arxiu i reinicieu el zabbix\_server. */home/zabbix* aquest és el directori arrel de l'usuari *zabbix*, i *.ssh* és el directori on s'hi generen per defecte les claus públiques i privades amb la comanda [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) dins del directori de l'usuari. Generalment, els paquets d'instal·lació del zabbix-server de diferents distribucions de Sistema Operatiu creen el compte d'usuari *zabbix* amb un directori arrel en un lloc no gaire habitual (com per a comptes del sistema; per exemple, */var/lib/zabbix*). Abans de generar les claus, estaria bé moure el directori base de l'usuari a un lloc més intuïtiu. Aquest hauria de correspondre amb el paràmetre de configuració *SSHKeyLocation* del servidor Zabbix, tal com s'ha dit més amunt. ::: noteclassic Les passes poden saltar-se si el compte *zabbix* s'ha afegit manualment d'acord amb la [secció d'instal·lació](/manual/installation/install#create_user_account), doncs en aquest cas el directori base sigui a */home/zabbix*. ::: Per canviar aquest paràmetre del compte d'usuari *zabbix*, tots els processos que sigui emprant s'han d'aturar: ```bash service zabbix-agent stop service zabbix-server stop ``` Per canviar el directori base movent-lo, la comanda hauria d'ésser: ```bash usermod -m -d /home/zabbix zabbix ``` És possible que el directori base no existeixi al lloc antic, pel que s'hauria de crear a la nova ubicació. Una manera de fer-ho és: ```bash test -d /home/zabbix || mkdir /home/zabbix ``` Per assegurar-vos que és segur, exxecuteu comandes addicionals per establir els permisos al directori base: ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ``` Com hem aturat els processos abans, ara els hauríem d'engegar: ```bash service start zabbix-agent systemctl start zabbix-server ``` Ara, les passes per generar les claus públiques i privades es poden fer amb aquesta comand: ```bash # sudo -u zabbix ssh-keygen -t rsa Generating public/private rsa key pair. Enter file in which to save the key (/home/zabbix/.ssh/id_rsa): # <enter the created directory '/home/zabbix/.ssh'> Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /home/zabbix/.ssh/id_rsa. Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. The key fingerprint is: 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 The key's randomart image is: +--[ RSA 2048]----+ | | | . | | o | | . o | |+ . S | |.+ o = | |E . * = | |=o . ..* . | |... oo.o+ | +-----------------+ ``` :::noteclassic Nota: les claus públiques i privades (*id\_rsa.pub* i *id\_rsa* respectivament) s'han generat per defecte al directori */home/zabbix/.ssh*, que correspon al paràmetre de configuració *SSHKeyLocation* del servidor Zabbix. ::: ::: noteimportant Els tipus de claus diferents d'"rsa" es poden admetre per l'eina ssh-keygen i els servidors SSH però no seran suportades per libssh2, que és la que empra el Zabbix. ::: #### Key name The key name itself has a limited range of allowed characters, which just follow each other. Allowed characters are: 0-9a-zA-Z_-. Which means: - all numbers; - all lowercase letters; - all uppercase letters; - underscore; - dash; - dot.  #### Nom de la clau El nom de la clau té una limitació de caràcters permesos, que es segueixen els uns als altres. Els caràcters permesos són: 0-9a-zA-Z_-. Que vol dir: - tots les nombres ; - totes les lletres minúscules; - totes les lletres majúscules; - guió baix; - guió; - punt.  #### Key parameters An item key can have multiple parameters that are comma separated.  Each key parameter can be either a quoted string, an unquoted string or an array.  The parameter can also be left empty, thus using the default value. In that case, the appropriate number of commas must be added if any further parameters are specified. For example, item key **icmpping\[,,200,,500\]** would specify that the interval between individual pings is 200 milliseconds, timeout - 500 milliseconds, and all other parameters are left at their defaults. It is possible to include macros in the parameters. Those can be [user macros](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) or some of the built-in macros. To see what particular built-in macros are supported in item key parameters, search the page [Supported macros](/manual/appendix/macros/supported_by_location) for "item key parameters". #### Paràmetres de les claus Una clau d'element pot tindre diversos paràmetres, separats per comes.  Cada paràmetre de clau pot ésser una cadena entre cometes, una cadena sense cometes o una taula.  El paràmetre es pot deixar buit, emprant el valor per defecte. En aquest cas, el nombre adequat de comes s'ha d'ajustar si s'especifiquen altres paràmetres. Per exemple, la clau d'element **icmpping\[,,200,,500\]** especifica que l'interval entre pings individuals és de 200 mil·lisegons, amb un timeout de 500 mil·lisegons, i tots els altres paràmetres es deixen amb els seus valors per defecte. Es poden incloure macros als paràmetres. Aquestes poden ser [macros d'usuari](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) o algunes de les macros integrades. Per veure concretament quines macros integrades s'admeten als paràmetres clau de l'element, cerqueu a la pàgina de [Macros admeses](/manual/appendix/macros/supported_by_location) "paràmetres clau de l'element". #### Kiosk mode The kiosk mode in supported frontend pages can be activated using URL parameters. For example, in dashboards: - `/zabbix.php?action=dashboard.view&kiosk=1` - activate kiosk mode - `/zabbix.php?action=dashboard.view&kiosk=0` - activate normal mode #### Mode quiosc El mode quiosc a les pàgines d'interfície compatibles es pot activar mitjançant els paràmetres d'URL. Per exemple, als taulers de control: - `/zabbix.php?action=dashboard.view&kiosk=1` - activa el mode kiosque - `/zabbix.php?action=dashboard.view&kiosk=0` - activa el mode normal #### Known issues 1. Zabbix agent does not have the possibility to determine proper node name. It always has dynamic hostname. #### Problemes coneguts 1. L'agent Zabbix no té la possibilitat de determinar el nom adequat del node. Sempre té un nom d'equip dinàmic. #### Known issues See [known issues](/manual/installation/known_issues#graphs) for graphs. #### Problemes coneguts Veieu els [problemes coneguts](/manual/installation/known_issues#graphs) dels gràfics. #### Known issues To improve performance, you can convert the field types from *nclob* to *nvarchar2*, see [known issues](/manual/installation/known_issues#slow-configuration-sync-with-oracle). #### Problemes coneguts Per millorar el rendiment, podeu convertir els tipus d'arxius de *nclob* a *nvarchar2*, veieu els [problemes coneguts](/manual/installation/known_issues#slow-configuration-sync-with-oracle). #### Kubernetes - *Kubernetes nodes by HTTP* - *Kubernetes cluster state by HTTP* - *Kubernetes API server by HTTP* - *Kubernetes Controller manager by HTTP* - *Kubernetes Scheduler by HTTP* - *Kubernetes kubelet by HTTP* To enable Kubernetes monitoring, you need to use the new tool [Zabbix Helm Chart](https://git.zabbix.com/projects/ZT/repos/kubernetes-helm/browse?at=refs%2Fheads%2Frelease%2F6.0), which installs Zabbix proxy and Zabbix agents in the Kubernetes cluster. To learn more about configuring templates, see [HTTP template operation](/manual/config/templates_out_of_the_box/http). ##### Kubernetes - *Kubernetes nodes by HTTP* - *Kubernetes cluster state by HTTP* - *Kubernetes API server by HTTP* - *Kubernetes Controller manager by HTTP* - *Kubernetes Scheduler by HTTP* - *Kubernetes kubelet by HTTP* Per habilitar el monitoratge de Kubernetes, heu d'emprar la nova eina [Zabbix Helm Chart](https://git.zabbix.com/projects/ZT/repos/kubernetes-helm/browse?at=refs%2Fheads%2Frelease%2F6.0), que instal·la el proxy Zabbix i els agents Zabbix al clúster de Kubernetes. Per obtindre més informació sobre la configuració de plantilles, veieu [com funcionen les plantilles HTTP](/manual/config/templates_out_of_the_box/http). ##### Large file support Zabbix has large file support for SNMP trapper files. The maximum file size that Zabbix can read is 2^63 (8 EiB). Note that the filesystem may impose a lower limit on the file size. ##### Suport d'arxius grossos Zabbix admet fitxers grossos per a fitxers trapper SNMP. El límit de mida màxim que pot llegir Zabbix és 2^63 (8 EiB). Tingueu en compte que el sistema de fitxers pot imposar un límit inferior a la mida del fitxer. ### Latest data link for hosts shows numbers The latest data link for hosts in [*Monitoring* -> *Hosts*](/manual/web_interface/frontend_sections/monitoring/hosts) now shows the number of items with latest data. ### L'enllaç de dades més recent per als equips mostra nombres El darrer enllaç de dades per als equips a [*Monitoratge* -> *Equips*](/manual/web_interface/frontend_sections/monitoring/hosts) ara mostra el nombre d'elements amb dades més recents. ### LDAP authentication External LDAP authentication can be used to check user names and passwords. Note that a user must exist in Zabbix as well, however its Zabbix password will not be used. Zabbix LDAP authentication works at least with Microsoft Active Directory and OpenLDAP.  Configuration parameters: |Parameter|Description| |--|--------| |*Enable LDAP authentication*|Mark the checkbox to enable LDAP authentication.| |*LDAP host*|Name of LDAP server. For example: ldap://ldap.zabbix.com<br>For secure LDAP server use *ldaps* protocol.<br>ldaps://ldap.zabbix.com<br>With OpenLDAP 2.x.x and later, a full LDAP URI of the form ldap://hostname:port or ldaps://hostname:port may be used.| |*Port*|Port of LDAP server. Default is 389.<br>For secure LDAP connection port number is normally 636.<br>Not used when using full LDAP URIs.| |*Base DN*|Base path to search accounts:<br>ou=Users,ou=system (for OpenLDAP),<br>DC=company,DC=com (for Microsoft Active Directory)| |*Search attribute*|LDAP account attribute used for search:<br>uid (for OpenLDAP),<br>sAMAccountName (for Microsoft Active Directory)| |*Bind DN*|LDAP account for binding and searching over the LDAP server, examples:<br>uid=ldap\_search,ou=system (for OpenLDAP),<br>CN=ldap\_search,OU=user\_group,DC=company,DC=com (for Microsoft Active Directory)<br>Anonymous binding is also supported. Note that anonymous binding potentially opens up domain configuration to unauthorized users (information about users, computers, servers, groups, services, etc.). For security reasons, disable anonymous binds on LDAP hosts and use authenticated access instead.| |*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."| |*Bind password*|LDAP password of the account for binding and searching over the LDAP server.| |*Test authentication*|Header of a section for testing| |*Login*|Name of a test user (which is currently logged in the Zabbix frontend). This user name must exist in the LDAP server.<br>Zabbix will not activate LDAP authentication if it is unable to authenticate the test user.| |*User password*|LDAP password of the test user.| ::: notewarning In case of trouble with certificates, to make a secure LDAP connection (ldaps) work you may need to add a `TLS_REQCERT allow` line to the /etc/openldap/ldap.conf configuration file. It may decrease the security of connection to the LDAP catalog. ::: ::: notetip It is recommended to create a separate LDAP account (*Bind DN*) to perform binding and searching over the LDAP server with minimal privileges in the LDAP instead of using real user accounts (used for logging in the Zabbix frontend).<br> Such an approach provides more security and does not require changing the *Bind password* when the user changes his own password in the LDAP server.<br> In the table above it's *ldap\_search* account name. ::: ### Autenticació LDAP L'autenticació LDAP externa es pot emprar per verificar els noms d'usuari i els mots de pas. Tingueu en compte que un usuari també ha d'existir a Zabbix, però el seu mot de pas de Zabbix no s'emprarà. L'autenticació LDAP de Zabbix funciona almenys amb Microsoft Active Directory i OpenLDAP.  Paràmetres de configuració: |Paràmetre|Descripció| |--|---------| |*Activa l'autenticació LDAP*|Marqueu la casella per habilitar l'autenticació LDAP.| |*LDAP Host*|Nom del servidor LDAP. Per exemple: ldap://ldap.zabbix.com<br>Per a un servidor LDAP segur, empreu el protocol *ldaps*.<br>ldaps://ldap.zabbix.com<br>Amb OpenLDAP 2.x.x i versions posteriors , es pot emprar un URI LDAP complet en el format ldap://nomhost:port o ldaps://nomhost:port.| |*Port*|Port del servidor LDAP. El valor predeterminat és 389.<br>Per a una connexió LDAP segura, el nombre de port normalment és 636.<br>No s'empra amb URI LDAP complets.| |*DN base*|Camí base per cercar comptes:<br>ou=Usuaris,ou=sistema (per a OpenLDAP),<br>DC=empresa,DC=com (per a Microsoft Active Directory)| |*Atribut cercat*|Atribut del compte LDAP emprat per a la cerca:<br>uid (per a OpenLDAP),<br>sAMAccountName (per a Microsoft Active Directory)| |*Link DN*|Compte LDAP per enllaçar i cercar al servidor LDAP, exemples:<br>uid=ldap\_search,ou=system (per a OpenLDAP),<br>CN=ldap\_search,OU=user\_group,DC=company,DC=com (per a Microsoft Active Directory)<br>També s'admet l'enllaç anònim. Tingueu en compte que l'enllaç anònim pot obrir la configuració del domini a usuaris no autoritzats (informació sobre usuaris, ordinadors, servidors, grups, serveis, etc.). Per motius de seguretat, desactiveu els enllaços anònims als equips LDAP i empreu l'accés autenticat.| |*Inici de sessió sensible a majúscules i minúscules*|Desmarqueu la casella per desactivar l'inici de sessió sensible a majúscules i minúscules (activat de manera predeterminada) per als noms d'usuari.<br>Ex. desactiveu l'inici de sessió que distingeix entre majúscules i minúscules i l'inici de sessió amb, per exemple, l'usuari 'ADMIN', fins i tot si l'usuari de Zabbix és 'Administrador'.<br>*Tingueu en compte* que amb l'inici de sessió que distingeix entre majúscules i minúscules desactivat, la connexió es rebutjarà si hi ha diversos usuaris a la base de dades de Zabbix amb noms d'usuari similars (p. Admin, admin).| |*Mot de pas d'enllaç*|Mot de pas LDAP del compte per enllaçar i cercar el servidor LDAP.| |*Autenticació de prova*|Capçalera d'una secció a provar| |*Inici de sessió*|Nom d'un usuari de prova (que actualment és connectat a la interfície Zabbix). Aquest nom d'usuari ha d'existir al servidor LDAP.<br>Zabbix no activarà l'autenticació LDAP si no pot autenticar l'usuari de prova.| |*Mot de pas d'usuari*|Mot de pas LDAP de l'usuari de prova.| ::: notewarning Si hi ha un problema amb els certificats, perquè funcioni una connexió LDAP segura (ldaps), potser haureu d'afegir una línia `TLS_REQCERT allow` al fitxer de configuració /etc/openldap/ldap.conf. Això pot disminuir la seguretat de la connexió del catàleg LDAP. ::: ::: notetip Es recomana crear un compte LDAP independent (*Link DN*) per vincular i cercar el servidor LDAP amb privilegis mínims al LDAP en comptes d'emprar comptes d'usuari reals (emprats per iniciar sessió a la interfície Zabbix).<br> Aquest enfocament proporciona més seguretat i no requereix canviar el *Mot de pas d'enllaç* quan l'usuari canvia el seu propi mot de pas al servidor LDAP.<br> A la taula anterior, aquest és el nom del compte *ldap\_search*. ::: #### Legend The following parameters are supported for configuring *Legend*. |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Show legend*|0|legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Number of rows*|0|legend_lines|Valid values range from 1-5.<br><br>Default: 1.| #### Llegenda Els paràmetres següents són compatibles per configurar la *Llegenda*. |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Mostra la llegenda*|0|legend|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Nombre de files*|0|legend_lines|Els valors vàlids van d'1 a 5.<br><br>Per defecte: 1.| #### Library in a non-standard location Zabbix allows you to specify a library located in a non-standard location. In the example below, Zabbix will run `curl-config` from the specified non-standard location and use its output to determine the correct libcurl to use. $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config This will work if it is the only libcurl installed in the system, but might not if there is another libcurl installed in a standard location (by the package manager, for example). Such is the case when you need a newer version of the library for Zabbix and the older one for other applications. Therefore, specifying a component in a non-standard location will not always work when the same component also exists in a standard location. For example, if you use a newer libcurl installed in `/usr/local` with the libcurl package still installed, Zabbix might pick up the wrong one and compilation will fail: usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): in function 'zbx_http_convert_to_utf8': /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header' collect2: error: ld returned 1 exit status Here, the function `curl_easy_header()` is not available in the older `/usr/lib/x86_64-linux-gnu/libcurl.so`, but is available in the newer `/usr/local/lib/libcurl.so`. The problem lies with the order of linker flags, and one solution is to specify the full path to the library in an LDFLAGS variable: $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config Note the `-Wl,--no-as-needed` option which might be needed on some systems (see also: default linking options on [Debian-based](https://wiki.debian.org/ToolChain/DSOLinking) systems). #### Biblioteca en una ubicació no estàndard Zabbix us permet especificar una biblioteca situada en una ubicació no estàndard. Al següent exemple, Zabbix executarà `curl-config` des de la ubicació no estàndard especificada i utilitzarà la seva sortida per determinar el libcurl correcte a utilitzar. $ ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin/curl-config Això funcionarà si és l'únic libcurl instal·lat al sistema, però potser no si hi ha un altre libcurl instal·lat en una ubicació estàndard (pel gestor de paquets, per exemple). Aquest és el cas quan necessiteu una versió més nova de la biblioteca per a Zabbix i la més antiga per a altres aplicacions. Per tant, especificar un component en una ubicació no estàndard no sempre funcionarà quan el mateix component també existeix en una ubicació estàndard. Per exemple, si empreu un libcurl més nou instal·lat a `/usr/local` amb el paquet libcurl encara instal·lat, Zabbix podria agafar-ne l'equivocat i la compilació fallarà: usr/bin/ld: ../../src/libs/zbxhttp/libzbxhttp.a(http.o): a la funció 'zbx_http_convert_to_utf8': /tmp/zabbix-master/src/libs/zbxhttp/http.c:957: undefined reference to 'curl_easy_header' collect2: error: ld returned 1 exit status Aquí, la funció `curl_easy_header()` no és disponible a l'antiga `/usr/lib/x86_64-linux-gnu/libcurl.so`, però és disponible a la nova `/usr/local/lib/libcurl.so`. El problema rau en l'ordre dels indicadors d'enllaç i una solució és especificar el camí complet a la biblioteca en una variable LDFLAGS: $ LDFLAGS="-Wl,--no-as-needed /usr/local/lib/libcurl.so" ./configure --enable-server --with-mysql --with-libcurl=/usr/local/bin /curl-config Tingueu en compte l'opció `-Wl,--no-as-needed` que potser cal en alguns sistemes (veieu també: opcions d'enllaç predeterminades a sistemes [basats en Debian](https://wiki.debian.org/ToolChain/DSOLinking)). ##### Limitations - Only same host (template) dependencies are allowed - An item prototype can depend on another item prototype or regular item from the same host - Maximum count of dependent items for one master item is limited to 29999 (regardless of the number of dependency levels) - Maximum 3 dependency levels allowed - Dependent item on a host with master item from template will not be exported to XML ##### Limitacions - Només es permeten dependències del mateix equip (model). - Un prototip d'element pot dependre d'un altre prototip d'element o d'un element estàndard del mateix equip - El nombre màxim d'elements dependents per a un element principal és limitat a 29999 (independentment del nombre de nivells de dependència) - Màxim 3 nivells de dependència permesos - L'element dependent de l'equip amb l'element del model principal no s'exportarà com a XML #### Limitations on using X.509 v3 certificate extensions When implementing X.509 v3 certificates within Zabbix, certain extensions may not be fully supported or could result in inconsistent behavior. **Subject Alternative Name extension** Zabbix does not support the *Subject Alternative Name* extension, which is used to specify alternative DNS names such as IP addresses or email addresses. Zabbix can only validate the value in the *Subject* field of the certificate (see [Restricting Allowed Certificate Issuer and Subject](#restricting-allowed-certificate-issuer-and-subject)). If certificates include the `subjectAltName` field, the outcome of certificate validation may vary depending on the specific crypto toolkits used to compile Zabbix components. As a result, Zabbix may either accept or reject certificates based on these combinations. **Extended Key Usage extension** Zabbix supports the *Extended Key Usage* extension. However, if used, it is generally required that both *clientAuth* (for TLS WWW client authentication) and *serverAuth* (for TLS WWW server authentication) attributes are specified. For example: - In passive checks, where Zabbix agent operates as a TLS server, the *serverAuth* attribute must be included in the agent's certificate. - For active checks, where the agent operates as a TLS client, the *clientAuth* attribute must be included in the agent's certificate. While GnuTLS may issue a warning for key usage violations, it typically allows communication to proceed despite these warnings. **Name Constraints extension** Support for the *Name Constraints* extension varies among crypto toolkits. Ensure that your chosen toolkit supports this extension. This extension may restrict Zabbix from loading CA certificates if this section is marked as critical, depending on the specific toolkit in use. #### Limitacions en l'ús de les extensions de certificat X.509 v3 Quan s'implementen certificats X.509 v3 dins de Zabbix, és possible que algunes extensions no siguin totalment compatibles o poden provocar un comportament inconsistent. **Extensió Subject Alternative Name** Zabbix no admet l'extensió *Subject Alternative Name*, que s'empra per especificar noms DNS alternatius, com ara adreces IP o adreces de correu electrònic. Zabbix només pot validar el valor del camp *Assumpte* del certificat (vegeu [Restricció de l'emissor i l'assumpte de certificats permesos](#restriction-allowed-certificate-issuer-and-subject)). Si els certificats inclouen el camp `subjectAltName`, el resultat de la validació del certificat pot variar en funció dels conjunts d'eines de criptografia específics utilitzats per compilar components Zabbix. Com a resultat, Zabbix pot acceptar o rebutjar certificats basats en aquestes combinacions. **Extensió Extended Key Usage** Zabbix admet l'extensió *Extended Key Usage*. Tanmateix, si s'empra, generalment es requereix que s'especifiquin tant els atributs *clientAuth* (per a l'autenticació de client TLS WWW) com *serverAuth* (per a l'autenticació de servidor TLS WWW). Per exemple: - A les comprovacions passives, on l'agent Zabbix funciona com a servidor TLS, l'atribut *serverAuth* s'ha d'incloure al certificat de l'agent. - A les comprovacions actives, on l'agent opera com a client TLS, l'atribut *clientAuth* s'ha d'incloure al certificat de l'agent. Tot i que GnuTLS pot emetre un avís per infraccions d'ús de claus, normalment permet que la comunicació continuï malgrat aquests avisos. **Extensió Name Constraints** El suport per a l'extensió *Name Constraints* varia entre els kits d'eines de criptografia. Assegureu-vos que el conjunt d'eines que trieu admet aquesta extensió. Aquesta extensió pot restringir Zabbix de carregar certificats de CA si aquesta secció és marcada com a crítica, depenent del conjunt d'eines específic que s'empra. #### Limitations - Private keys are stored in plain text in files readable by Zabbix components during startup - Pre-shared keys are entered in Zabbix frontend and stored in Zabbix database in plain text - Built-in encryption does not protect communications: - Between the web server running Zabbix frontend and user web browser - Between Zabbix frontend and Zabbix server - Currently each encrypted connection opens with a full TLS handshake, no session caching and tickets are implemented - Adding encryption increases the time for item checks and actions, depending on network latency: - For example, if packet delay is 100ms then opening a TCP connection and sending unencrypted request takes around 200ms. With encryption about 1000 ms are added for establishing the TLS connection; - Timeouts may need to be increased, otherwise some items and actions running remote scripts on agents may work with unencrypted connections, but fail with timeout with encrypted. - Encryption is not supported by [network discovery](/manual/discovery/network_discovery). Zabbix agent checks performed by network discovery will be unencrypted and if Zabbix agent is configured to reject unencrypted connections such checks will not succeed. #### Limitacions - Les claus privades s'emmagatzemen en text sense format en fitxers llegibles pels components Zabbix durant l'inici - Les claus precompartides s'introdueixen a la interfície Zabbix i s'emmagatzemen a la base de dades de Zabbix en text sense format - El xifrat integrat no protegeix les comunicacions: - Entre el servidor web que executa la interfície Zabbix i el navegador web de l'usuari - Entre la interfície Zabbix i el servidor Zabbix - Actualment, totes les connexions xifrades s'obren amb una verificació TLS completa, no s'implementa cap emmagatzematge en memòria cau de sessió ni tiquets - L'addició de xifrat augmenta la verificació de l'element i el temps d'acció, depenent de la latència de la xarxa: - Per exemple, si l'endarrerimet del paquet és de 100 ms, obrir una connexió TCP i enviar una petició sense xifrar triga uns 200 ms. Amb el xifrat, s'afegeixen aproximadament 1000 ms per establir la connexió TLS; - Pot ser que sigui necessari augmentar els temps d'espera, en cas contrari, alguns elements i accions que executen scripts remots als agents poden funcionar amb connexions sense xifrar, però fallar amb un temps d'espera xifrat. - El xifrat no és compatible amb [descoberta de xarxa](/manual/discovery/network_discovery). Les comprovacions de l'agent Zabbix fetes per la descoberta de la xarxa no es xifraran i si l'agent Zabbix és configurat per rebutjar connexions no xifrades, aquestes comprovacions fallaran. #### Limitations Support of loadable modules is implemented for the Unix platform only. It means that it does not work for Windows agents. In some cases a module may need to read module-related configuration parameters from *zabbix\_agentd.conf*. It is not supported currently. If you need your module to use some configuration parameters you should probably implement parsing of a module-specific configuration file. #### Limitacions El suport de mòduls carregables només s'implementa per a la plataforma Unix. Això vol dir que no funciona amb els agents de Windows. En alguns casos, un mòdul pot necessitar llegir els paràmetres de configuració relacionats amb el mòdul des de *zabbix\_agentd.conf*. Això no s'admet actualment. Si necessiteu que el vostre mòdul empri determinats paràmetres de configuració, probablement haureu d'implementar l'anàlisi d'un fitxer de configuració específic del mòdul. ##### Limitations There are some limitations associated with the algorithm of creating LLD macro names from MBean property names: - attribute names are changed to uppercase - attribute names are ignored (no LLD macros are generated) if they consist of unsupported characters for LLD macro names. Supported characters can be described by the following regular expression: `A-Z0-9_\.` - if an attribute is called "obj" or "domain" they will be ignored because of the overlap with the values of the reserved Zabbix properties {\#JMXOBJ} and {\#JMXDOMAIN} (supported since Zabbix 3.4.3.) Please consider this jmx.discovery (with "beans" mode) example. MBean has the following properties defined (some of which will be ignored; see below): name=test тип=Type attributes []=1,2,3 Name=NameOfTheTest domAin=some As a result of JMX discovery, the following LLD macros will be generated: - {\#JMXDOMAIN} - Zabbix internal, describing the domain of MBean - {\#JMXOBJ} - Zabbix internal, describing MBean object - {\#JMXNAME} - created from "name" property Ignored properties are: - тип : its name contains unsupported characters (non-ASCII) - attributes\[\] : its name contains unsupported characters (square brackets are not supported) - Name : it's already defined (name=test) - domAin : it's a Zabbix reserved name ##### Limitacions Hi ha algunes limitacions associades a l'algoritme per crear noms de macro LLD a partir de noms de propietat MBean: - els noms dels atributs són en majúscula - els noms d'atributs s'ignoren (no es genera cap macro LLD) si contenen caràcters no compatibles amb els noms de macro LLD. Els caràcters admesos es poden descriure amb l'expressió regular següent: `A-Z0-9_\.` - si un atribut s'anomena "obj" o "domini", s'ignorarà a causa de la superposició amb els valors de les propietats reservades de Zabbix {\#JMXOBJ} i {\#JMXDOMAIN} (admesos des de Zabbix 3.4.3.) Si us plau, tingueu en compte aquest exemple jmx.discovery (amb mode "beans"). MBean té definides les propietats següents (algunes de les quals seran ignorades; veieu més avall): name=test тип=Type attributes []=1,2,3 Name=NameOfTheTest domAin=some Com a resultat de la descoberta de JMX, es generaran les macros LLD següents: - {\#JMXDOMAIN} - Zabbix intern, que descriu el domini MBean - {\#JMXOBJ} - Zabbix intern, que descriu l'objecte MBean - {\#JMXNAME} - creat a partir de la propietat "name". Les propietats ignorades són: - тип: el seu nom conté caràcters no admesos (no ASCII) - attributes\[\]: el seu nom conté caràcters no admesos (no s'admeten els claudàtors) - Name: ja és definit (name=test) - domAin: és un nom reservat de Zabbix #### Limitations Zabbix agent for Windows does not support non-standard Windows configurations where CPUs are distributed non-uniformly across NUMA nodes. If logical CPUs are distributed non-uniformly, then CPU performance metrics may not be available for some CPUs. For example, if there are 72 logical CPUs with 2 NUMA nodes, both nodes must have 36 CPUs each. #### Limitacions L'agent Zabbix per a Windows no admet configuracions de Windows no estàndard on les CPU es distribueixen de manera no uniforme entre els nodes NUMA. Si les CPU lògiques es distribueixen de manera no uniforme, és possible que les mètriques de rendiment de la CPU no siguin disponibles per a algunes CPU. Per exemple, si hi ha 72 CPU lògiques amb 2 nodes NUMA, tots dos nodes han de tindre 36 CPU cadascun. #### Limiting access to API Update role with ID "5", deny to call any "create", "update" or "delete" methods. Request: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "api.access": "1", "api.mode": "0", "api": ["*.create", "*.update", "*.delete"] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` #### Limitar l'accés a API Actualitzar el rol amb l'ID "5", denegant les crides als mètodes "crear", "actualitzar" o "esborrar" methods. Petició: ```json { "jsonrpc": "2.0", "method": "role.update", "params": [ { "roleid": "5", "rules": { "api.access": "1", "api.mode": "0", "api": ["*.crear", "*.actualitzar", "*.esborrar"] } } ], "auth": "3a57200802b24cda67c4e4010b50c065", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "roleids": [ "5" ] }, "id": 1 } ``` ### Limits for JavaScript objects in preprocessing The following limits for [JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) in preprocessing have been introduced: - The total size of all messages that can be logged with the `log()` method has been limited to 8 MB per script execution. - The initialization of multiple `HttpRequest` objects has been limited to 10 per script execution. - The total length of header fields that can be added to a single `HttpRequest` object with the `addHeader()` method has been limited to 128 Kbytes (special characters and header names included). ### Límits per als objectes JavaScript en preprocessament S'han introduït els límits següents per a [objectes JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) al preprocessament: - La mida total de tots els missatges que es poden registrar amb el mètode `log()` s'ha limitat a 8 Mo per execució de l'script. - La inicialització de diversos objectes `HttpRequest` s'ha limitat a 10 per execució de l'script. - La longitud total dels camps de capçalera que es poden afegir a un únic objecte `HttpRequest` amb el mètode `addHeader()` s'ha limitat a 128 Ko (inclosos caràcters especials i noms de capçalera). ### Limits for JavaScript objects in preprocessing The following limits for [JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) in preprocessing have been introduced: - The total size of all messages that can be logged with the `log()` method has been limited to 8 MB per script execution. - The initialization of multiple `HttpRequest` objects has been limited to 10 per script execution. - The total length of header fields that can be added to a single `HttpRequest` object with the `addHeader()` method has been limited to 128 Kbytes (special characters and header names included). ### Límits per als objectes JavaScript en preprocessament S'han introduït els límits següents per a [objectes JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects#additional-javascript-objects) al preprocessament: - La mida total de tots els missatges que es poden registrar amb el mètode `log()` s'ha limitat a 8 Mo per execució de l'script. - La inicialització de diversos objectes `HttpRequest` s'ha limitat a 10 per execució de l'script. - La longitud total dels camps de capçalera que es poden afegir a un únic objecte `HttpRequest` amb el mètode `addHeader()` s'ha limitat a 128 Ko (inclosos caràcters especials i noms de capçalera). #### Limits of filtering with utf8mb4 collations Filters (e.g., in *Configuration* → [*Maintenance*](/manual/web_interface/frontend_sections/configuration/maintenance#using-filter)) may not function correctly when applied to entities containing certain Unicode characters (e.g., ȼ, ɇ). This issue arises due to how the default utf8mb4\_bin collation for MySQL or MariaDB databases handles sorting and comparison of Unicode characters. To address this limitation, users can change the collation of database columns to alternatives such as utf8mb4\_0900\_bin, utf8mb4\_0900\_ai\_ci, or utf8mb4\_unicode\_520\_ci. Note, however, that changing the collation may cause unexpected behavior in the handling of empty spaces, as well as sorting and filtering for other characters. For more information on changing collations, see [MySQL documentation](https://dev.mysql.com/doc/refman/8.4/en/alter-table.html#alter-table-character-set) or [MariaDB documentation](https://mariadb.com/kb/en/alter-database/). For details on collation differences, see [Unicode Character Sets](https://dev.mysql.com/doc/refman/8.4/en/charset-unicode-sets.html) in MySQL documentation. #### Límits de filtrat amb col·lacions utf8mb4 Els filtres (p. ex., a *Configuració* → [*Manteniment*](/manual/web_interface/frontend_sections/configuration/maintenance#using-filter)) poden no funcionar correctament quan s'apliquen a entitats que contenen determinats caràcters Unicode (p. ex., ȼ, ɇ) . Aquest problema sorgeix a causa de com la col·lació utf8mb4\_bin predeterminada per a les bases de dades MySQL o MariaDB gestiona l'ordre i la comparació de caràcters Unicode. Per solucionar aquesta limitació, els usuaris poden canviar la classificació de les columnes de la base de dades a alternatives com ara utf8mb4\_0900\_bin, utf8mb4\_0900\_ai\_ci o utf8mb4\_unicode\_520\_ci. Tingueu en compte, però, que canviar la intercalació pot provocar un comportament inesperat en la gestió dels espais buits, així com l'ordenació i el filtratge d'altres caràcters. Per obtindre més informació sobre com canviar les intercalades, veieu [Documentació de MySQL](https://dev.mysql.com/doc/refman/8.4/en/alter-table.html#alter-table-character-set) o [Documentació de MariaDB] (https://mariadb.com/kb/en/alter-database/). Per obtindre més informació sobre les diferències de classificació, veieu [Conjunts de caràcters Unicode](https://dev.mysql.com/doc/refman/8.4/en/charset-unicode-sets.html) a la documentació de MySQL. #### Link a group to a templates Add host group "2" to a two templates. Request: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10085" }, { "templateid": "10086" } ], "groups": [ { "groupid": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085", "10086" ] }, "id": 1 } ``` #### Enllaçar un grup a una plantilla Afegir el grup d'equips "2" a dues plantilles. Petició: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10085" }, { "templateid": "10086" } ], "groups": [ { "groupid": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10085", "10086" ] }, "id": 1 } ``` #### Link a two tempalates to a template Link templates "10106" and "10104" to template. Request: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10073" } ], "templates_link": [ { "templateid": "10106" }, { "templateid": "10104" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10073" ] }, "id": 1 } ``` #### Enllaçar dues plantilles a una plantilla Enllaçar les plantilles "10106" i "10104" a la plantilla "10073". Petició: ```json { "jsonrpc": "2.0", "method": "template.massadd", "params": { "templates": [ { "templateid": "10073" } ], "templates_link": [ { "templateid": "10106" }, { "templateid": "10104" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "templateids": [ "10073" ] }, "id": 1 } ``` #### Linking a template To link a template to the host, do the following: - Go to *Configuration → Hosts* - Click on the required host - Start typing the template name in the *Templates* field. A list of matching templates will appear; scroll down to select. - Alternatively, you may click on *Select* next to the field and select one or several templates from the list in a popup window - Click on *Add/Update* in the host attributes form The host will now have all the entities (items, triggers, graphs, etc) of the template. ::: noteimportant Linking multiple templates to the same host will fail if in those templates there are items with the same item key. And, as triggers and graphs use items, they cannot be linked to a single host from multiple templates either, if using identical item keys. ::: When entities (items, triggers, graphs etc.) are added from the template: - previously existing identical entities on the host are updated as entities of the template, and **any existing host-level customizations to the entity are lost** - entities from the template are added - any directly linked entities that, prior to template linkage, existed only on the host remain untouched In the lists, all entities from the template now are prefixed by the template name, indicating that these belong to the particular template. The template name itself (in gray text) is a link allowing to access the list of those entities on the template level. If some entity (item, trigger, graph etc.) is not prefixed by the template name, it means that it existed on the host before and was not added by the template. #### Enllaçar una plantilla Per enllaçar una plantilla a l'equip, feu el següent: - Aneu a *Configuració → Equips* - Feu clic a l'equip requerit - Comenceu a escriure el nom de la plantilla al camp *Plantilles*. Apareixerà una llista de plantilles coincidents; desplaça't cap avall per triar-ne una. - Alternativament, podeu fer clic a *Triar* al costat del camp i triar una o més plantilles de la llista en una finestra emergent - Feu clic a *Afegir/Actualitzar* al formulari d'atributs de l'equip L'equip ara tindrà totes les entitats (elements, triggers, gràfics, etc.) a la plantilla. ::: noteimportant L'enllaç de diverses plantilles al mateix equip fallarà si algun element té la mateixa clau d'element. I, com que els triggers i els gràfics empren elements, tampoc no es poden enllaçar a un sol equip des de diverses plantilles, si s'empren claus d'elements idèntiques. ::: Quan s'afegeixen entitats (elements, triggers, gràfics, etc.) des de la plantilla: - Les entitats idèntiques existents anteriorment a l'equip s'actualitzen com a entitats plantilla - S'afegeixen plantilles - Totes les entitats directament relacionades que abans de l'acoblament de la plantilla només existien a l'equip romanen intactes A les llistes, ara totes les entitats de la plantilla tenen el prefix del nom de la plantilla, indicant que pertanyen a la plantilla en qüestió. El nom de la mateixa plantilla (en gris) és un enllaç per accedir a la llista d'aquestes entitats a nivell de plantilla. Si una entitat (element, trigger, gràfic, etc.) no té el prefix del nom de la plantilla, vol dir que existia anteriorment a l'equip i que la plantilla no l'ha afegida. #### Linking elements Once you have put some elements on the map, it is time to start linking them. To link two elements you must first select them. With the elements selected, click on *Add* next to Link. With a link created, the single element form now contains an additional *Links* section. Click on *Edit* to edit link attributes. {width="600"} Link attributes: |Parameter|Description| |--|--------| |*Label*|Label that will be rendered on top of the link.<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)}`).| |*Connect to*|The element that the link connects to.| |*Type (OK)*|Default link style:<br>**Line** - single line<br>**Bold line** - bold line<br>**Dot** - dots<br>**Dashed line** - dashed line| |*Color (OK)*|Default link color.| |*[Link indicators](links)*|List of triggers linked to the link. In case a trigger has status PROBLEM, its style is applied to the link.| #### Enllaçar elements Un cop hagueu posat algunes coses al mapa, és hora de començar a connectar-les. Per enllaçar dos elements, primer cal triar-los. Un cop triat, feu clic a *Afegir* al costat de l'enllaç. Amb un enllaç creat, el formulari d'element únic ara conté una secció addicional *Enllaços*. Feu clic a *Editar* per editar els atributs de l'enllaç. {width="600"} Atributs de l'enllaç: |Paràmetre|Descripció| |--|---------| |*Etiqueta*|Etiqueta que es representarà a sobre de l'enllaç.<br>Les expressions [macros](/manual/appendix/macros/supported_by_location) s'admeten en aquest camp, però només amb les funcions `avg`, `last`, ` min` i `max`, amb el temps com a paràmetre (per exemple, `{?avg(/host/key,1h)}`).| |*Es connecta a*|L'element al qual es connecta l'enllaç.| |*Escriviu (D'acord)*|Estil d'enllaç predeterminat:<br>**Línia** - línia única<br>**Línia negreta** - línia negreta<br>**Punt** - punts <br>**Línia de punts** - línia de punts| |*Color (D'acord)*|Color d'enllaç predeterminat.| |*[Indicadors d'enllaç](enllaços)*|Llista de triggers relacionats amb l'enllaç. Si un activador té l'estat PROBLEMA, el seu estil s'aplica a l'enllaç.| ##### Linking pre-defined templates to hosts As you may have noticed, Zabbix comes with a set of predefined templates for various OS, devices and applications. To get started with monitoring very quickly, you may link the appropriate one of them to a host, but beware that these templates need to be fine-tuned for your environment. Some checks may not be needed, and polling intervals may be way too frequent. More information about [templates](/manual/config/templates) is available. ##### Enllaçar plantilles predefinides als equips Com haureu vist, Zabbix inclou un conjunt de plantilles predefinides per a diversos sistemes operatius, dispositius i aplicacions. Per començar a monitorar molt ràpidament, podeu associar la plantilla més adequada a un equip, però aneu amb compte, aquestes plantilles han de ser adequades al vostre entorn. Algunes comprovacions poden no ser necessàries i els intervals d'enquesta poden ser massa freqüents. Llegiu més informació sobre [plantilles](/manual/config/templates). ##### Linking templates to several hosts To update template linkage of many hosts, in *Configuration → Hosts* select some hosts by marking their checkboxes, then click on **[Mass update](/manual/config/hosts/hostupdate)** below the list and then select *Link templates*:  To link additional templates, start typing the template name in the auto-complete field until a dropdown appears offering the matching templates. Just scroll down to select the template to link. The *Replace* option will allow to link a new template while unlinking any template that was linked to the hosts before. The *Unlink* option will allow to specify which templates to unlink. The *Clear when unlinking* option will allow to not only unlink any previously linked templates, but also remove all elements inherited from them (items, triggers, etc.). ::: notetip Zabbix offers a sizable set of predefined templates. You can use these for reference, but beware of using them unchanged in production as they may contain too many items and poll for data too often. If you feel like using them, fine-tune them to fit your real needs. ::: ##### Vincular les plantilles a diversos equips Per actualitzar l'enllaç de plantilla de diversos equips, a *Configuració → Equips*, trieu alguns equips marcant les seves caselles i, a continuació, feu clic a **[Actualització massiva](/manual/config/hosts/hostupdate)** a sota de la llista i, a continuació, trieu *Models d'enllaç*:  Per enllaçar plantilles addicionals, comenceu a escriure el nom de la plantilla al camp d'emplenament automàtic fins que aparegui una llista desplegable amb plantilles coincidents. Simplement desplaceu-vos cap avall per triar el model que voleu enllaçar. L'opció *Reemplaça* enllaçarà una plantilla nova mentre desenllaça qualsevol plantilla que s'hagués enllaçat anteriorment als equips. L'opció *Desenllaçar* us permetrà especificar els models a desenllaçar. L'opció *Esborra en desenllaçar* no només desenllaçarà totes les plantilles enllaçades anteriorment, sinó que també esborrarà tots els elements heretats d'elles (elements, triggers, etc.). ::: notetip Zabbix ofereix un gran conjunt de plantilles predefinides. Podeu emprar-les com a referència, però aneu amb compte de no emprar-les a producció tal com són, doncs poden contindre massa elements i consultar les dades massa sovint. Si us ve de gust emprar-les, ajusteu-les per satisfer les vostres necessitats reals. ::: #### Linking template to host With a template ready, it only remains to add it to a host. For that, go to *Configuration → Hosts*, click on 'New host' to open its property form and find the **Templates** field. Start typing *New template* in the *Templates* field. The name of template we have created should appear in the dropdown list. Scroll down to select. See that it appears in the *Templates* field.  Click *Update* in the form to save the changes. The template is now added to the host, with all entities that it holds. As you may have guessed, this way it can be applied to any other host as well. Any changes to the items, triggers and other entities at the template level will propagate to the hosts the template is linked to. #### Enllaçar una plantilla a un equip Amb una plantilla preparada, només queda afegir-la a un equip. Per fer-ho, aneu a *Configuració → Equips*, feu clic a 'Nou equip' per obrir el seu formulari de propietats i cerqueu el camp **Plantilles**. Comenceu a escriure *Nova plantilla* al camp *Plantilles*. El nom de la plantilla que hem creat hauria d'aparèixer a la llista desplegable. Desplaceu-vos cap avall per triar-la. Comproveu que aparegui al camp *Plantilles*.  Feu clic a *Actualitzar* al formulari per desar els canvis. El model s'afegeix ara a l'equip, juntament amb totes les entitats que conté. Com haureu endevinat, això també es pot aplicar a qualsevol altre equip. Qualsevol canvi fet als elements, triggers i altres entitats a nivell de plantilla es propagarà als equips als quals hi ha vinculada la plantilla. #### Links available For each entry the following links are available: - Hosts - Monitoring - Latest data - Problems - Graphs - Host dashboards - Web scenarios - Configuration - Items - Triggers - Graphs - Discovery rules - Web scenarios ```{=html} <!-- --> ``` - Host groups - Monitoring - Latest data - Problems - Web scenarios - Configuration - Hosts - Templates ```{=html} <!-- --> ``` - Templates - Configuration - Items - Triggers - Graphs - Template dashboards - Discovery rules - Web scenarios #### Enllaços disponibles Per a cada entrada hi ha disponibles els següents enllaços: - Equips - Monitoratge - Darreres dades - Problemes - Gràfics - Taulers d'allotjament - Escenaris web - Configuració - Elements - Triggers - Gràfics - Normes de descoberta - Escenaris web ```{=html} <!-- --> ``` - Grups d'acollida - Monitoratge - Darreres dades - Problemes - Escenaris web - Configuració - Equips - Plantilles ```{=html} <!-- --> ``` - Plantilles - Configuració - Elements - Triggers - Gràfics - Plantilles de tauler de control - Normes de descoberta - Escenaris web ##### Links Clicking on a map element opens a menu with some available links. ##### Enllaços Si feu clic a un element del mapa, s'obre un menú amb alguns enllaços disponibles. #### Linux kernel threads #### Fils del kernel de Linux ##### Linux On Linux systems `ps` command can be used together with `watch` command for observing how Zabbix is doing. For example, to run `ps` command 5 times per second to see process activities: watch -n 0.2 ps -fu zabbix To show only Zabbix proxy and agent processes: watch -tn 0.2 'ps -f -C zabbix_proxy -C zabbix_agentd' To show only history syncer processes: watch -tn 0.2 'ps -fC zabbix_server | grep history' The `ps` command produces a wide output (approximately 190 columns) as some activity messages are long. If your terminal has less than 190 columns of text you can try watch -tn 0.2 'ps -o cmd -C zabbix_server -C zabbix_proxy -C zabbix_agentd' to display only commandlines without UID, PID, start time etc. `top` command also can be used for observing Zabbix performance. Pressing 'c' key in `top` shows processes with their commandlines. In our tests on Linux `top` and `atop` correctly displayed changing activities of Zabbix processes, but `htop` was not displaying changing activities. ##### Linux Sota sistemes Linux, la comanda `ps` es pot emprar amb la comanda `watch` per veure el funcionament de Zabbix. Per exemple, per executar la comanda `ps` 5 cops per segon per veure l'activitat dels processos: watch -n 0.2 ps -fu zabbix Per veure només els processos de proxy i d'agent Zabbix : watch -tn 0.2 'ps -f -C zabbix_proxy -C zabbix_agentd' Per veure només els processos de l'historial de sincronització: watch -tn 0.2 'ps -fC zabbix_server | grep history' La comanda `ps` fa una sortida llarga (unes 190 columnes), doncs alguns missatges d'activitat són llargs. Si el vostre terminal té menys de 190 columnes de text, podeu provar això: watch -tn 0.2 'ps -o cmd -C zabbix_server -C zabbix_proxy -C zabbix_agentd' per veure només les línies de comanda sense UID, PID, start time, etc. La comanda `top` pot també emprar-se per veure el rendiment de Zabbix. Prement la 'c', ensenya els processos i les seves línies de comanda. A les nostres proves amb Linux, `top` i `atop` ensenyen correctament els canvis d'activitats dels processos de Zabbix, `htop` no es comporta pas així. #### Linux See values supported for 'memtype' parameter on Linux in the table. |Supported value|Description|Source in /proc/<pid>/status file| |--|------|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|VmSize| |pmem|Percentage of real memory|(VmRSS/total\_memory) \* 100| |rss|Resident set size|VmRSS| |data|Size of data segment|VmData| |exe|Size of code segment|VmExe| |hwm|Peak resident set size|VmHWM| |lck|Size of locked memory|VmLck| |lib|Size of shared libraries|VmLib| |peak|Peak virtual memory size|VmPeak| |pin|Size of pinned pages|VmPin| |pte|Size of page table entries|VmPTE| |size|Size of process code + data + stack segments|VmExe + VmData + VmStk| |stk|Size of stack segment|VmStk| |swap|Size of swap space used|VmSwap| Notes for Linux: 1. Not all 'memtype' values are supported by older Linux kernels. For example, Linux 2.4 kernels do not support `hwm`, `pin`, `peak`, `pte` and `swap` values. 2. We have noticed that self-monitoring of the Zabbix agent active check process with `proc.mem[...,...,...,...,data]` shows a value that is 4 kB larger than reported by `VmData` line in the agent's /proc/<pid>/status file. At the time of self-measurement the agent's data segment increases by 4 kB and then returns to the previous size. ####Linux En aquesta taula hi trobareu els valors admesos per el paràmetre 'memtype' sota Linux. |Valor admès|Descripció|Font de l'arxiu /proc/<pid>/status| |--|------|--| |vsize ^[1](proc_mem_notes#footnotes)^|Mida de la memòria virtual|VmSize| |pmem|Percentatge de la memòria real|(VmRSS/total\_memory) \* 100| |rss|Mida del conjunt de residents|VmRSS| |data|Mida del segment de dades|VmData| |exe|Mida del segment de codis|VmExe| |hwm|Mida màxima del conjunt de residents|VmHWM| |lck|Mida de la memòria blocada|VmLck| |lib|Mida de les biblioteques compartides|VmLib| |peak|Mida màxima de la memòria virtual|VmPeak| |pin|Mida de les pàgines fixades|VmPin| |pte|Mida de les entrades de la taula de paginació|VmPTE| |taille|Mida del codi de processos + dades + segments de la pila|VmExe + VmData + VmStk| |stk|Mida del segment de pila|VmStk| |swap|Mida de l'espai de swap emprat|VmSwap| Notes per Linux: 1. No tots els valors 'memtype' són admesos amb kernels antics de Linux. Per exemple, el kernel de Linux 2.4 no suporta els valors `hwm`, `pin`, `peak`, `pte` i `swap`. 2. Hem vist que l'automonitoratge de l'agent Zabbix actiu verifica els processos amb `proc.mem[...,...,...,...,data]` mostra un valor de 4ko de més del que indica la línia "VmData" dins l'arxiu de l'agent /proc/<pid>/status. Al moment de l'auto-mesura, el segment de dades de l'agent augmenta fins a 4ko, i retorna la mida anterior. ##### List of sorting fields available for each type of diagnostic information request Following statistic fields can be used to sort and limit requested information. |Diagnostic type|Available fields|[Type](/manual/api/reference_commentary#data_types)| |---------------|----------------|---------------------------------------------------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer| ##### Llista de camps d'ordenació disponibles per a cada tipus de sol·licitud d'informació de diagnòstic Els següents camps d'estadístiques es poden emprar per ordenar i limitar la informació sol·licitada. |Tipus de diagnòstic|Camps disponibles|[Tipus](/manual/api/reference_commentary#data_types)| |---------------|----------------|---------------------------------------------------| |historycache|values|integer| |valuecache|values|integer| |^|request.values|integer| |preprocessing|values|integer| |alerting|media.alerts|integer| |^|source.alerts|integer| |lld|values|integer| ##### List of statistic fields available for each type of diagnostic information request Following statistic fields can be requested for each type of diagnostic information request property. |Diagnostic type|Available fields|Description| |---------------|----------------|-----------| |historycache|items|Number of cached items.| |^|values|Number of cached values.| |^|memory|Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|memory.data|History data cache shared memory statistics.| |^|memory.index|History index cache shared memory statistics.| |valuecache|items|Number of cached items.| |^|values|Number of cached values.| |^|memory|Shared memory statistics (free space, number of used chunks, number of free chunks, max size of free chunk).| |^|mode|Value cache mode.| |preprocessing|values|Number of queued values.| |^|preproc.values|Number of queued values with preprocessing steps.| |alerting|alerts|Number of queued alerts.| |lld|rules|Number of queued rules.| |^|values|Number of queued values.| ##### Llista de camps estadístics disponibles per a cada tipus de sol·licitud d'informació de diagnòstic Els següents camps d'estadístiques es poden sol·licitar per a cada tipus de propietat de sol·licitud d'informació de diagnòstic. |Tipus de diagnòstic|Camps disponibles|Descripció| |----------------|-----------------|------------| |historycache|elements|Nombre d'elements a la memòria cau.| |^|values|Nombre de valors a la memòria cau.| |^|memory|Estadístiques de memòria compartida (espai lliure, nombre de blocs utilitzats, nombre de blocs lliures, mida màxima de blocs lliures).| |^|memory.data|Estadístiques de memòria compartida de la memòria cau de dades de l'historial.| |^|memory.index|Estadístiques de memòria compartida de la memòria cau d'índex d'històric.| |valuecache|items|Nombre d'elements a la memòria cau.| |^|values|Nombre de valors a la memòria cau.| |^|memory|Estadístiques de memòria compartida (espai lliure, nombre de blocs utilitzats, nombre de blocs lliures, mida màxima de blocs lliures).| |^|mode|Mode de memòria cau de valors.| |preprocessament|valors|Nombre de valors a la cua.| |^|preproc.values|Nombre de valors a la cua amb passes de preprocessament.| |alerting|alerts|Nombre d'alertes a la cua.| |lld|rules|Nombre de regles a la cua.| |^|values|Nombre de valors en cua.| ##### List of waiting items In this screen, each waiting item is listed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Scheduled check*|The time when the check was due is displayed.| |*Delayed by*|The length of the delay is displayed.| |*Host*|Host of the item is displayed.| |*Name*|Name of the waiting item is displayed.| |*Proxy*|The proxy name is displayed, if the host is monitored by proxy.| ##### Llista d'elements en espera En aquesta pantalla, es mostren els elements pendents. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Comprovació programada*|L'hora en què es mostra la comprovació deguda.| |*Endarrerit per*|Es mostra la durada del retard.| |*Equip*|Equip de l'element.| |*Nom*|Nom de l'element pendent.| |*Proxy*|Nom del proxy, si l'equip és monitorat pel proxy.| ### LLD macro path The LLD macro path has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**lld\_macro**<br>(required)|string|LLD macro.| |**path**<br>(required)|string|Selector for value which will be assigned to corresponding macro.| ### Ruta de macro LLD La ruta de la macro LLD té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**lld\_macro**<br>(obligatori)|string|Macro LLD.| |**path**<br>(obligatori)|string|Selector de valor que serà assignat a la macro corresponent.| #### LLD rule filter condition The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |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>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. ::: #### Condició de filtre de regla LLD Aquest objecte defineix una comprovació separada per dur a terme el valor d'una macro LLD. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**macro**<br>(obligatori)|cadena|Macro LLD per comprovar-ho.| |**valor**<br>(obligatori)|cadena|Valor a comparar.| |formulaid|string|ID únic arbitrari emprat per fer referència a la condició d'una expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho demani més endavant.| |operator|integer|Operador de condició.<br><br>Valors possibles:<br>8 - *(per defecte)* coincideix amb l'expressió regular;<br>9 - no coincideix amb l'expressió regular; <br>12 - existeix;< br>13 - no existeix.| ::: consell de notes Per entendre millor com emprar filtres amb diferents tipus d'expressions, consulteu els exemples a les pàgines del mètode [discoveryrule.get](get#retrieving_filter_conditions) i [discoveryrule.create](create#using_a_custom_expression_filter). ::: ### LLD rule filter The LLD rule filter object defines a set of conditions that can be used to filter discovered objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* 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.| |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>Required for custom expression filters.| ### Filtre de regla LLD L'objecte de filtre de regles LLD defineix un conjunt de condicions que es poden emprar per filtrar objectes descoberts. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**conditions**<br>(obligatori)|matriu|Conjunt de condicions de filtre que s'empren per filtrar els resultats.| |**evaltype**<br>(obligatori)|integer|Mètode d'avaluació de la condició del filtre.<br><br>Valors possibles:<br>0 - i/o;<br>1 - i; <br> 2 - o ;<br>3 - expressió personalitzada.| |eval\_formula|string|*(només de lectura)* Expressió generada que s'emprarà per avaluar les condicions del filtre. L'expressió conté identificadors que fan referència a condicions de filtre específiques per la seva "fórmula". El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.| |formula|cadena|Expressió definida per l'usuari per avaluar les condicions del filtre amb una expressió personalitzada. L'expressió ha de contindre identificadors que facin referència a condicions de filtre específiques mitjançant la seva "fórmula". Els identificadors emprats a l'expressió han de coincidir exactament amb els definits a les condicions del filtre: no es pot pas deixar ni ometre cap condició.<br><br>Necessari per als filtres d'expressió personalitzats.| # LLD rule object The following objects are directly related to the `discoveryrule` API. # Objecte de regla LLD Els següents objectes són relacionats amb l'API `discoveryrule`. #### LLD rule override filter condition The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |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>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.| #### Condició del filtre de sobrecàrrega de la regla LLD L'objecte defineix una comprovació independent per dur a terme el valor d'una macro LLD. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**macro**<br>(obligatori)|cadena|Macro LLD per realitzar la comprovació.| |**valor**<br>(obligatori)|cadena|Valor a comparar.| |formulaid|string|ID únic arbitrari emprat per fer referència a la condició d'una expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho sol·liciti més endavant.| |operador|enter|Operador de condició.<br><br>Valors possibles:<br>8 - *(per defecte)* coincideix amb l'expressió regular;<br>9 - no coincideix amb l'expressió regular; <br>12 - existeix;< br>13 - no existeix.| #### LLD rule override filter The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.| #### Filtre de sobrecàrrega de la regla LLD L'objecte defineix un conjunt de condicions que, si coincideixen amb l'objecte descobert, s'aplica la sobrecàrrega. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**evaltype**<br>(obligatori)|integer|Substitueix el mètode d'avaluació de la condició de filtre.<br><br>Valors possibles:<br>0 - i/o;<br>1 - i ;< br>2 - o ;<br>3 - expressió personalitzada.| |**conditions**<br>(obligatori)|matriu|Conjunt de condicions de filtre de sobrecàrrega que s'empren per fer coincidir els objectes descoberts.| |eval\_formula|string|*(només de lectura)* Expressió generada que s'emprarà per avaluar les condicions del filtre de sobrecàrrega. L'expressió conté identificadors que fan referència a condicions específiques de filtre de sobrecàrrega mitjançant la seva "fórmula". El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.| |formula|cadena|Expressió definida per l'usuari per avaluar les condicions del filtre de sobrecàrrega amb una expressió personalitzada. L'expressió ha de contindre identificadors que facin referència a condicions específiques del filtre de sobrecàrrega mitjançant la seva "fórmula". Els ID emprats a l'expressió han de coincidir exactament amb els definits a les condicions del filtre de sobrecàrrega: cap condició no es pot deixar sense emprar ni ometre.<br><br>Necessari per als filtres de sobrecàrrega d'expressions personalitzats.| ::: ##### LLD rule override operation discover LLD rule override operation discover status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.| ##### Operació de sobrecàrrega de descobriment de regles LLD Estat de l'operació de sobrecàrrega de descobriment de la regla LLD que s'estableix a l'objecte descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**discover**<br>(obligatori)|integer|Anul·la l'estat de descoberta de l'objecte triat.<br><br>Valors possibles:<br>0 - Sí, continuar descobrint objectes;< br>1 - No , els elements nous no es descobriran i els elements existents es marcaran com a perduts.| ##### LLD rule override operation history LLD rule override operation history value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.| ##### Operació de sobrecàrrega de l'historial de regles LLD Operació de sobrecàrrega de l'historial de regles LLD establerta a l'element descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**history**<br>(obligatori)|cadena|Substitueix l'històtic del prototip d'element, que és una unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'històric. També accepta macro d'usuari i macro LLD.| ##### LLD rule override operation inventory LLD rule override operation inventory mode value that is set to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.| ##### LLD Rule Operació de sobrecàrrega d'inventari Operació per anul·lar el valor del mode d'inventari de la regla LLD que s'estableix a l'equip descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**inventory\_mode**<br>(obligatori)|integer|Ignora el mode d'inventari del prototip de l'equip.<br><br>Els valors possibles són:<br>-1 - desactivat;< br>0 - *( per defecte)* manual;<br>1 - automàtic.| ##### LLD rule override operation period LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.| ##### Període d'operació de sobrecàrrega de la regla LLD El període d'operació de sobrecàrrega de la regla LLD és un valor d'interval d'actualització (admet intervals personalitzats) que s'estableix a l'element descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**retard**<br>(obligatori)|cadena|Anul·la l'interval d'actualització del prototip d'element. Accepta segons o una unitat de temps amb sufix (30s,1m,2h,1d), així com intervals flexibles i de programació i macros d'usuari o LLD. Els intervals múltiples són separats per un punt i coma.| ##### LLD rule override operation severity LLD rule override operation severity value that is set to discovered trigger. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| ##### Operació de sobrecàrrega de gravetat de la regla LLD L'operació s'ha establert al trigger descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**severity**<br>(obligatori)|integer|Anul·la la gravetat del prototip de trigger.<br><br>Els valors possibles són: 0 - *(per defecte)* sense classificar;<br>1 - informació ;<br>2 - avís;<br>3 - mitjana;<br>4 - alta;<br>5 - desastre.| ##### LLD rule override operation status LLD rule override operation status that is set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.| ##### Estat de l'operació de sobrecàrrega de la regla LLD Estat de l'operació de sobrecàrrega de la regla LLD que s'estableix com a objecte descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**status**<br>(obligatori)|integer|Anul·la l'estat de l'objecte seleccionat.<br><br>Valors possibles:<br>0 - Creació activada;<br>1 - Creació desactivada.| ##### LLD rule override operation tag LLD rule override operation tag object contains tag name and value that are set to discovered object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|New tag name. Also accepts user macro and LLD macro.| |value|string|New tag value. Also accepts user macro and LLD macro.| ##### Operació de sobrecàrrega d'etiquetes de regla LLD L'operació conté el nom i el valor de l'etiqueta definit a l'objecte descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|cadena|Nom d'etiqueta nou. També admet macros d'usuari i d'LLD.| |value|cadena|Valor d'etiqueta nou. També admet macros d'usuari i d'LLD.| ##### LLD rule override operation template LLD rule override operation template object that is linked to discovered host. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.| ##### Operació de sobrecàrrega del model de regles LLD Objecte d'operació de sobrecàrrega del model vinculat a l'equip descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**templateid**<br>(obligatori)|string|Substitueix la plantilla de les plantilles vinculades al prototip de l'equip.| #### LLD rule override operation The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.| #### Operació de sobrecàrrega de regles LLD L'operació és una combinació d'accions i condicions que s'han de realitzar a l'objecte prototip. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**operationobject**<br>(obligatori)|entier|Tipus d'objecte descobert per dur a terme l'acció.<br><br>Valors possibles:<br>0 - Prototip d'element;<br>1 - Prototip de trigger;< br>2 - Prototip de gràfics;<br>3 - Prototip d'equip.| |operador|nter|Operador de condició de sobrecàrrega.<br><br>Valors possibles:<br>0 - *(per defecte)* és igual;<br>1 - no és igual;<br>2 - conté;<br> 3 - no conté; <br>8 - coincideix;<br>9 - no coincideix.| |valor|cadena|Patró per fer coincidir l'element, el trigger, el gràfic o el nom del prototip d'equip basat en l'objecte triat.| |opstatus|objecte|Objecte d'estat de l'operació de sobrecàrrega per a objectes d'element, trigger i prototip d'equip.| |opdiscover|objecte|Objecte d'estat de l'operació de sobrecàrrega de descobriment (qualsevol tipus d'objecte).| |opperiod|objecte|Objecte de període d'operació de sobrecàrrega (interval d'actualització) per a l'objecte prototip d'element.| |ohistory|object|Objecte de l'històric d'operacions de sobrecàrrega per a l'objecte prototip d'element.| |optrends|objecte|Objecte de tendències d'operació de sobrecàrrega per a l'objecte prototip d'element.| |opseverity|objecte|Objecte de gravetat de l'operació de sobrecàrrega per a l'objecte prototip del trigger.| |optag|array|Objecte d'etiqueta d'operació de sobrecàrrega per a l'objecte prototip de l'equip.| |optemplate|array|Objecte de plantilla d'operació de sobrecàrrega per a l'objecte prototip de l'equip.| |opinventory|objecte|Objecte d'inventari d'operacions de sobrecàrrega per a l'objecte prototip de l'equip.| ##### LLD rule override operation trends LLD rule override operation trends value that is set to discovered item. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.| ##### Operació de sobrecàrrega de tendència de la regla LLD Operació establerta a l'element descobert. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**trends**<br>(obligatori)|cadena|Substitueix les tendències del prototip d'element, que és una unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendència. També admet macro d'usuari i macro LLD.| ### LLD rule overrides The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.| ### Sobrecàrrega de regles LLD L'objecte de sobrecàrrega de regles LLD defineix un conjunt de regles (filtres, condicions i operacions) que s'empren per anul·lar les propietats de diversos objectes prototip. Té les següents propietats: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**nom**<br>(obligatori)|cadena|Nom únic de sobrecàrrega.| |**pas**<br>(obligatori)|nombre enter|Nombre de seqüència únic de la sobrecàrrega.| |stop|enter|Atura el processament de les sobrecàrregues futures si coincideix.<br><br>Valors possibles:<br>0 - *(per defecte)* no atura el processament de les sobrecàrregues;<br>1: atura el processament de les sobrecàrregues del procés si el filtre coincideix .| |filtre|objecte|Filtre de sobrecàrrega.| |operacions|matriu|Operacions de sobrecàrrega.| ::: ### LLD rule preprocessing The LLD rule preprocessing object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>5 - Regular expression matching;<br>11 - XML XPath;<br>12 - JSONPath;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.| The following parameters and error handlers are supported for each preprocessing type. |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |5|Regular expression|pattern^1^|output^2^|<|0, 1, 2, 3| |11|XML XPath|path^3^|<|<|0, 1, 2, 3| |12|JSONPath|path^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^1^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^3^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^3^|<|<|0, 1, 2, 3| |20|Discard unchanged with heartbeat|seconds^4, 5^|<|<|<| |21|JavaScript|script^2^|<|<|<| |23|Prometheus to JSON|pattern^5, 6^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |27|XML to JSON|<|<|<|0, 1, 2, 3| ^1^ regular expression<br> ^2^ string<br> ^3^ JSONPath or XML XPath<br> ^4^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)<br> ^5^ user macro<br> ^6^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.<br> ### Preprocessament de regla LLD L'objecte de preprocessament de regles LLD té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tipus**<br>(obligatori)|enter|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>5 - Coincidència d'expressió regular;<br>11 - XML ​​​​​​XPath ;<br>12 - JSONPath;<br>15 - No coincideix amb l'expressió regular;< br>16 - Comprovar si hi ha errors JSON;<br>17 - Comprovar si hi ha errors XML;<br>20 - Descartar sense canvis amb el heartbeat;<br>23 - Prometheus a JSON;<br>24 - CSV a JSON;< br>25 - Substituïu;<br>27 - XML ​​​​a JSON.| |**params**<br>(obligatori)|string|Paràmetres addicionals emprats per l'opció de preprocessament. Múltiples paràmetres separats per caràcter LF (\\n).| |**error\_handler**<br>(obligatori)|entier|Tipus d'acció que s'empra si el pas de preprocessament falla.<br><br>Valors possibles:<br>0 - El servidor Zabbix ha establert el missatge d'error del missatge. ;<br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;< br>3 - Estableix un missatge d'error personalitzat.| |**error\_handler\_params**<br>(obligatori)|string|Paràmetres del gestor d'errors. S'empra amb `error_handler`.<br><br>Ha d'ésser buit, si `error_handler` és 0 o 1.<br>Pot ésser buit si `error_handler` és 2.<br>No pot ésser buit, si `error_handler ` és 3.| Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament. |Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos| |-------------------|----|-----------|------------|- ----------|----------| |5|Expressió regular|patró^1^|sortida^2^|<|0, 1, 2, 3| |11|XML XPath|camí^3^|<|<|0, 1, 2, 3| |12|JSONPath|camí^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular|patró^1^|<|<|0, 1, 2, 3| |16|Cerca un error en JSON |camí^3^|<|<|0, 1, 2, 3| |17|Cerca un error a XML|camí^3^|<|<|0, 1, 2, 3| |20|Descartar sense canvis amb el batec del cor|segons^4, 5^|<|<|<| |21|JavaScript|script^2^|<|<|<| |23|Prometeu a JSON|patró^5, 6^|<|<|0, 1, 2, 3| |24|CSV a JSON|caràcter^2^|caràcter^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |27|XML a JSON|<|<|<|0, 1, 2, 3| ^1^ expressió regular<br> ^2^ cadena<br> ^3^ JSONPath o XML XPath<br> ^4^ nombre enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)<br> ^5^ macro d'usuari<br> ^6^ Patró de Prometheus seguint la sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ser una macro d'usuari.<br> ::: ### LLD rule The low-level discovery rule object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the LLD rule.| |**delay**<br>(required)|string|Update interval of the LLD rule. Accepts seconds or time unit with suffix and with or without one or more [custom intervals](/manual/config/items/item/custom_intervals) that consist of either flexible intervals and scheduling intervals as serialized strings. Also accepts user macros. Flexible intervals could be written as two macros separated by a forward slash. Intervals are separated by a semicolon.<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host that the LLD rule belongs to.| |**interfaceid**<br>(required)|string|ID of the LLD rule's host interface. Used only for host LLD rules.<br><br>Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, dependent, database monitor and script LLD rules. Optional for HTTP agent LLD rules.| |**key\_**<br>(required)|string|LLD rule key.| |**name**<br>(required)|string|Name of the LLD rule.| |**type**<br>(required)|integer|Type of the LLD rule.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - external check;<br>11 - database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>16 - JMX agent;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script.| |**url**<br>(required)|string|URL string, required for HTTP agent LLD rule. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |allow\_traps|integer|HTTP agent LLD rule field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent or HTTP agent LLD rules.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM| |description|string|Description of the LLD rule.| |error|string|*(readonly)* Error text if there are problems updating the LLD rule value.| |follow\_redirects|integer|HTTP agent LLD rule field. Follow response redirects while polling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent LLD rule field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |http\_proxy|string|HTTP agent LLD rule field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI LLD rules.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lifetime|string|Time period after which items that are no longer discovered will be deleted. Accepts seconds, time unit with suffix and user macro.<br><br>Default: `30d`.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 999 are allowed.<br>Discovery rule cannot be master item for another discovery rule.<br><br>Required for Dependent item.| |output\_format|integer|HTTP agent LLD rule field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the LLD rule:<br>- executed script for SSH and Telnet LLD rules;<br>- SQL query for database monitor LLD rules;<br>- formula for calculated LLD rules.| |parameters|array|Additional parameters for script type LLD rule. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules.| |post\_type|integer|HTTP agent LLD rule field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent LLD rule field. HTTP(S) request body data. Used with post\_type.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent LLD rule field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent LLD rule field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent LLD rule field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent LLD rule field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent LLD rule field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent LLD rule field. Password for SSL Key file.| |state|integer|*(readonly)* State of the LLD rule.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the LLD rule.<br><br>Possible values:<br>0 - *(default)* enabled LLD rule;<br>1 - disabled LLD rule.| |status\_codes|string|HTTP agent LLD rule field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template LLD rule.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script LLD rules. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper LLD rules or HTTP agent LLD rules.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules.<br><br>Required by SSH and Telnet LLD rules.| |uuid|string|Universal unique identifier, used for linking imported LLD rules to already existing ones. Used only for LLD rules on templates. Auto-generated, if not given.| |verify\_host|integer|HTTP agent LLD rule field. Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent LLD rule field. Whether to validate that the host's certificate is authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Regla LLD L'objecte de regla de descobriment de baix nivell té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|cadena|*(només de lectura)* ID de regla LLD.| |**delay**<br>(obligatori)|cadena|Interval d'actualització de regles LLD. Accepta segons o unitat de temps amb sufix i amb o sense un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) que consisteixen en intervals flexibles i intervals de programació com a cadenes serialitzades. També accepta macros d'usuari. Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada. Els intervals són separats per un punt i coma.<br><br>Opcional per a Zabbix trapper, elements dependents i per a l'agent Zabbix (actiu) amb la clau `mqtt.get`.| |**hostid**<br>(obligatori)|cadena|ID de l'equip al que pertany la regla LLD.| |**interfaceid**<br>(obligatori)|cadena|ID de la interfície de l'equip de la regla LLD. S'empra només per a les regles de LLD de l'equip.<br><br>No es calen per a les regles de LLD de l'agent Zabbix (actiu), Zabbix intern, trapper de Zabbix, dependent, monitor de base de dades i scripts. Opcional per a les regles LLD de l'agent HTTP.| |**clau\_**<br>(obligatori)|cadena|clau de regla LLD.| |**nom**<br>(obligatori)|cadena|Nom de la regla LLD.| |**tipus**<br>(obligatori)|enter|Tipus de regla LLD..<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br> 3 - comprovació simple;<br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>10 - comprovació externa;<br>11 - Monitor de base de dades;<br>12 - Agent IPMI ;<br> 13 - Agent SSH;<br>14 - Agent TELNET;<br>16 - Agent JMX;<br>18 - Element dependent;< br>19 - Agent HTTP;<br>20 - Agent SNMP;< br>21 - Guió.| |**url**<br>(obligatori)|cadena|cadena d'URL, necessària per a la regla LLD de l'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |allow\_traps|enteger|Camp de regla LLD de l'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper.<br><br>0 - *(per defecte)* No permet acceptar dades entrants.<br>1 - Permet acceptar dades entrants.| |authtype|enteger|Només l'empren l'agent SSH o les regles LLD de l'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - passa mot de pas *(per defecte)*;<br>1 - clau pública.<br><br> Valors possibles del mètode d'autenticació de l'agent HTTP:<br>0 - *(per defecte)* cap<br >1 - bàsic<br>2 - NTLM| |descripció|cadena|Descripció de la regla LLD.| |error|cadena|*(només de lectura)* Text d'error si hi ha problemes per actualitzar el valor de la regla LLD.| |follow\_redirects|enteger|Camp de regla LLD de l'agent HTTP. Seguiu les redireccions de resposta en afegir dades.<br><br>0: No seguiu les redireccions.<br>1: *(per defecte)* Seguiu les redireccions.| |capçaleres|objecte|Camp de política LLD de l'agent HTTP. Objecte amb capçaleres de sol·licitud HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br><br>Exemple:<br>{ " User-Agent": "Zabbix" }| |http\_proxy|string|Camp de regla LLD de l'agent HTTP. Cadena de connexió del proxy HTTP(S).| |ipmi\_sensor|string|sensor IPMI. S'empra només per les regles IPMI LLD.| |jmx\_endpoint|cadena|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi| |lifetime|string|Període després del qual s'eliminaran els elements que ja no es descobreixen. Accepta segons, unitat de temps amb sufix i macro d'usuari.<br><br>Per defecte: `30d`.| |master\_itemid|enteger|Identificador de l'element principal.<br>Es permet la recursivitat fins a 3 elements dependents i un nombre màxim d'elements dependents igual a 999.<br>La regla de descobriment no pot ser l'element principal d'una altra regla de descobriment.<br ><br> Obligatori per a l'element dependent.| |output\_format|enteger|Camp de regla LLD de l'agent HTTP. la resposta s'ha de convertir a JSON.<br><br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.| |params|string|Paràmetres addicionals en funció del tipus de regla LLD:<br>- script executat per a regles LLD SSH i Telnet;<br>- Consulta SQL per a regles de supervisió de bases de dades LLD;<br>- fórmula per a regles LLD calculades.| |parameters|array|Paràmetres addicionals per a la regla LLD semblant a un script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha de ser únic.| |password|cadena|Mot de pas per a l'autenticació. S'empra per a Simple Check, SSH, Telnet, Database Monitor, JMX LLD Rules i HTTP Agent.| |post\_type|enteger|Camp de regla LLD de l'agent HTTP. Tipus de cos de dades de publicació emmagatzemat a la propietat de publicacions.<br><br>0 - *(per defecte)* Dades en brut.<br>2 - Dades JSON.<br>3 - Dades XML.| |posts|cadena|Camp de política LLD de l'agent HTTP. HTTP(S) sol·licita dades del cos. S'empra amb post\_type.| |privatekey|string|Nom del fitxer de clau privada.| |publickey|string|Nom del fitxer de clau pública.| |query\_fields|array|Camp de regla LLD de l'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ser una cadena buida.| |request\_method|enteger|Camp de regla LLD de l'agent HTTP. Tipus de mètode de sol·licitud.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|enteger|Camp de regla LLD de l'agent HTTP. Quina part de la resposta s'ha d'emmagatzemar.<br><br>0 - *(per defecte)* Cos.<br>1 - Capçaleres.<br>2 - S'emmagatzemaran el cos i les capçaleres.< br><br>Per request\_method HEAD només es permet el valor 1.| |snmp\_oid|cadena|SNMP OID.| |ssl\_cert\_file|string|camp de política LLD de l'agent HTTP. Camí al fitxer de clau SSL pública.| |ssl\_key\_file|string|camp de política LLD de l'agent HTTP. Camí al fitxer de clau SSL privada.| |ssl\_key\_password|string|camp de política LLD de l'agent HTTP. Contrasenya per al fitxer de clau SSL.| |state|entier|*(només de lectura)* Estat de la regla LLD.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - no compatible.| |state|entier|Estat de la regla LLD.<br><br>Valors possibles:<br>0 - *(per defecte)* Regla LLD activada;<br>1 - Regla LLD desactivada.| |state\_codis|cadena|Camp de regla LLD de l'agent HTTP. Intervals de codis d'estat HTTP obligatoris separats per comes. També admet macros d'usuari com a part d'una llista separada per comes.<br><br>Exemple: 200.200-{$M},{$M},200-400| |templateid|string|(només de lectura) ID de regla LLD de la plantilla principal.| |timeout|string|Temps d'espera de la sol·licitud de consulta de dades d'element. S'empra per a l'agent HTTP i les regles d'script LLD. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s| |trapper\_hosts|string|Equips permesos. Emprat per les regles Trapper LLD o les regles LLD de l'agent HTTP.| |username|cadena|Nom d'usuari per a l'autenticació. S'empra per les regles LLD de Simple Check, SSH, Telnet, Database Monitor, JMX i HTTP Agent LLD.<br><br>Requerit per les regles SSH i Telnet LLD.| |uuid|string|Identificador únic universal, emprat per enllaçar les regles LLD importades amb les existents. S'empra només per a regles LLD en models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només de lectura*.| |verify\_host|enteger|Camp de regla LLD de l'agent HTTP. Valida que el nom d'equip a l'URL es troba al camp Nom comú o al camp Nom alternatiu de l'assumpte del certificat d'equip.<br><br>0 - *(per defecte)* No validar. <br>1 - Validar. | |verify\_peer|enteger|Camp de regla LLD de l'agent HTTP. Vàlid si el certificat d'equip és autèntic.<br><br>0 - *(per defecte)* No validar.<br>1 - Validar.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # LLD rule This class is designed to work with low level discovery rules. Object references: - [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule) Available methods: - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - copying LLD rules - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - creating new LLD rules - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - deleting LLD rules - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - retrieving LLD rules - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - updating LLD rules # Regla LLD Aquesta classe s'ha dissenyat per treballar amb regles de descoberta de baix nivell. Referències d'objectes: - [Regla LLD](/manual/api/reference/discoveryrule/object#lld_rule) Mètodes disponibles: - [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) - copiant regles LLD - [discoveryrule.create](/manual/api/reference/discoveryrule/create) - creant noves regles LLD - [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) - esborrant regles LLD - [discoveryrule.get](/manual/api/reference/discoveryrule/get) - recuperant regles LLD - [discoveryrule.update](/manual/api/reference/discoveryrule/update) - actualitzant regles LLD ### Loadable MongoDB plugin MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*. Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change. ### Plugin de MongoDB carregable El [plugin MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) ja no forma part de l'agent Zabbix 2 i ara és disponible com a plugin carregable. La llista de versions de MongoDB compatibles s'ha ampliat a *2.6-5.3*. La funcionalitat del connector i tots els [elements] admesos (/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) no han canviat. ### Loadable MongoDB plugin MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*. Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change. The MongoDB plugin, along with other loadable plugins which may potentially be added in the future, is stored in the new repository [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). The package *zabbix-release* now adds this repository to the user's system. To continue monitoring MongoDB on the installations from official Zabbix packages, update *zabbix-release* package and install *zabbix-agent2-plugin-mongodb* package. Sources are available on [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/). ### Connector de MongoDB carregable El [connector MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) ja no forma part de l'agent Zabbix 2 i ara és disponible com a connector carregable al lloc. La llista de versions de MongoDB compatibles s'ha ampliat a *2.6-5.3*. La funcionalitat del connector i tots els [elements] admesos (/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) no han canviat. El connector MongoDB, juntament amb altres connectors carregables que es podrien afegir en el futur, s'emmagatzemen al nou repositori [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). El paquet *zabbix-release* ara afegeix aquest dipòsit al sistema de l'usuari. Per continuar monitorant MongoDB a les instal·lacions dels paquets oficials de Zabbix, actualitzeu el paquet *zabbix-release* i instal·leu el paquet *zabbix-agent2-plugin-mongodb*. Les fonts són disponibles a [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/). #### Loadable ::: notetip Loadable plugins, when launched with:<br> - *-V --version* - print plugin version and license information;<br> - *-h --help* - print help information. ::: Click on the plugin name to go to the plugin repository with additional information. |Plugin name|Description|Supported item keys|Comments| |--|--|--|----| |[Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of Ember+.|ember.get|This plugin is supported since Zabbix 6.0.30. [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.39 and are compatible with 6.0.30 version.<br><br>See also [Ember+ plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin#parameters).| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MongoDB servers and clusters (document-based, distributed database).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats,<br>mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery, mongodb.version|This plugin is loadable since Zabbix 6.0.6 (built-in previously). [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.19 and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) parameters.<br>Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](#footnotes)^.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MongoDB plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MSSQL database.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|This plugin is supported since Zabbix 6.0.27. [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.28 and are compatible with 6.0.27 version.<br><br>To configure encrypted connection to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters. Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MSSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of PostgreSQL and its forks.|pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br> pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec, pgsql.uptime, pgsql.version, pgsql.wal.stat |This plugin is loadable since Zabbix 6.0.10 (built-in previously). [Pre-compiled plugin binaries](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) for Windows are available since Zabbix 6.0.19 and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [PostgreSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters).| See also: [Building loadable plugins](/manual/config/items/plugins/build). #### Carregable ::: notetip Connectors carregables, quan s'inicien amb:<br> - *-V --version* - mostra la versió del connector i la informació de la llicència;<br> - *-h --help* - mostra informació d'ajuda. ::: Feu clic al nom del connector per accedir al repositori de connectors amb informació addicional. |Nom del connector|Descripció|Claus d'elements admesos|Comentaris| |--|--|--|----| |[Ember+](https://git.zabbix.com/projects/AP/repos/ember-plus/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitorització d'Ember+.|ember.get|Aquest connector és compatible des de Zabbix 6.0.30. Els [binaris del connector precompilats](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) per a Windows estan disponibles des de Zabbix 6.0.39 i són compatibles amb la versió 6.0.30.<br><br>Vegeu també [Paràmetres de configuració del connector Ember+](/manual/appendix/config/zabbix_agent2_plugins/ember_plus_plugin#parameters).| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitorització de servidors i clústers MongoDB (base de dades distribuïda basada en documents).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats,<br>mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery, mongodb.version|Aquest connector es pot carregar des de Zabbix 6.0.6 (integrat anteriorment). Els [binaris de complements precompilats](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) per a Windows estan disponibles des de Zabbix 6.0.19 i són compatibles amb les versions anteriors de la 6.0.<br><br>Per configurar connexions xifrades a la base de dades, especifiqueu els paràmetres TLS al fitxer de configuració de l'agent com a paràmetres [sessió amb nom](#named_sessions).<br>Compatible amb les versions de complements 1.2.0, 6.0.13 i posteriors^[1](#notes al peu)^.<br>Actualment, els paràmetres TLS no es poden passar com a paràmetres clau d'element.<br><br>Vegeu també [Paràmetres de configuració del complement MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitorització de la base de dades MSSQL.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|Aquest connector és compatible des de Zabbix 6.0.27. Els [binaris de complements precompilats](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) per a Windows estan disponibles des de Zabbix 6.0.28 i són compatibles amb la versió 6.0.27.<br><br>Per configurar la connexió xifrada a la base de dades, especifiqueu els paràmetres TLS al fitxer de configuració de l'agent com a paràmetres [named session](#named_sessions) o [default](#default-values). Actualment, els paràmetres TLS no es poden passar com a paràmetres clau d'element.<br><br>Vegeu també [Paràmetres de configuració del complement MSSQL](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitorització de PostgreSQL i les seves forks.|pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br> pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec, pgsql.uptime, pgsql.version, pgsql.wal.stat |Aquest connector es pot carregar des de Zabbix 6.0.10 (integrat anteriorment). Els [binaris de complements precompilats](https://www.zabbix.com/download_agents?version=6.0+LTS&encryption=No+encryption) per a Windows estan disponibles des de Zabbix 6.0.19 i són compatibles amb les versions anteriors de la 6.0.<br><br>Per configurar connexions xifrades a la base de dades, especifiqueu els paràmetres TLS al fitxer de configuració de l'agent com a paràmetres [named session](#named_sessions) o [default](#default-values).<br>Actualment, els paràmetres TLS no es poden passar com a paràmetres clau d'element.<br><br>Vegeu també [Paràmetres de configuració del complement PostgreSQL](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters).| Veieu també: [Creació de connectors carregables](/manual/config/items/plugins/build). ### Loadable plugins ##### Encrypted MongoDB plugin connection MongoDB plugin now supports TLS encryption when connecting to MongoDB using named sessions. Updated plugin (MongoDB plugin 1.2.1) is included into Zabbix official packages starting from Zabbix 6.0.14. Note that MongoDB is a loadable plugin and can be installed separately either from packages or from sources. The plugin will work with any minor version of Zabbix 6.0. For more details see [MongoDB plugin](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin). ## Plugins carregables ### Connexió xifrada del connector MongoDB El connector MongoDB ara admet el xifrat TLS quan es connecta a MongoDB mitjançant sessions amb nom. El connector actualitzat (connector MongoDB 1.2.1) s'inclou als paquets oficials de Zabbix a partir de Zabbix 6.0.14. Tingueu en compte que MongoDB és un connector carregable i es pot instal·lar per separat dels paquets o fonts. El connector funcionarà amb qualsevol versió menor de Zabbix 6.0. Per obtindre més informació, vegeu [Connector MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin). ##### Load on I/O Item's persistent file is updated after successful sending of every batch of data \(containing item's data\) to server. For example, default 'BufferSize' is 100. If a log item has found 70 matching records then the first 50 records will be sent in one batch, persistent file will be updated, then remaining 20 records will be sent \(maybe with some delay when more data is accumulated\) in the 2nd batch, and the persistent file will be updated again. ##### Càrrega d' E/S L'arxiu persistent de l'element s'actualitza després de l'enviament correcte de cada lot de dades \(que contenen les dades de l'element\) cap al servidor. Per exemple, 'BufferSize' per defecte és 100. Si un element de registre ha trobat 0 registres corresponents, els primers 0 s'enviaran en un sol lot, l'arxiu persistent s'actualitzarà, i els 20 registres restants s'enviaran \(potser amb un cert endarreriment quan s'acumulin més dades\) al segon lot, i l'arxiu persistent serà actualitzat de nou. #### Locale Note that the agent requires a UTF-8 locale so that some textual agent items can return the expected content. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### Entorn Local Veieu que a l'agent li cal un entorn local UTF-8 per tal que determinats elements d'agent textuals retornar el contingut esperat. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament. #### Locale Note that the proxy requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### Entorn Local Veieu que al proxy li cal un entorn local UTF-8 per tal que determinats elements textuals puguin ésser interpretats correctament. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament. #### Locale Note that the server requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically. #### Entorn Local Veieu que al servidor li cal un entorn local UTF-8 per tal que determinats elements textuals puguin ésser interpretats correctament. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament. ##### Log data See additional information on [log monitoring](log_items). |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**log**\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Monitoring of a log file.|Log|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding-settings)<br>**maxlines** - 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)<br>**mode** (since version 2.0)- possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using-maxdelay-parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active-checks).<br>If file is missing or permissions do not allow access, item turns unsupported.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> log\[/var/log/syslog\]<br>=> log\[/var/log/syslog,error\]<br>=> log\[/home/zabbix/logs/logfile,,,100\]<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> log\[/app1/app.log,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> log\[/app1/app.log,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server. | |**log.count**\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Count of matched lines in a monitored log file.|Integer|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding-settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using-maxdelay-parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active-checks).<br><br><br>Matching lines are counted in the new lines since the last log check by the agent, and thus depend on the item update interval.<br>If the file is missing or permissions do not allow access, item turns unsupported. <br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.| |**logrt**\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Monitoring of a log file that is rotated.|Log|**file\_regexp** - absolute path to file, with the file name specified using a regular [expression](/manual/regular_expressions). Note that the regular expression applies only to the file name and does not need to match the entire name (e.g., /path/to/agent will match zabbix\_agentd.log)<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding-settings)<br>**maxlines** - 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)<br>**mode** (since version 2.0) - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using-maxdelay-parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes-on-handling-copytruncate-log-file-rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active-checks).<br>Log rotation is based on the last modification time of files.<br><br>Note that logrt is designed to work with one currently active log file, with several other matching inactive files rotated. If, for example, a directory has many active log files, a separate logrt item should be created for each one. Otherwise if one logrt item picks up too many files it may lead to exhausted memory and a crash of monitoring.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>In the `file regexp` parameter, the log directory path and log file regular expression must be separated by the correct directory separator:<br> - on Windows, the separator must be a backslash (\\);<br> - on other systems, it must be a forward slash (/).<br>Forward slashes may be tolerated on Windows at other positions, except the one that separates the log directory path and the log file regular expression (see examples below).<br><br>Examples for Windows:<br>=> logrt["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → will collect data from log files in "c:/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log"<br>=> logrt["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → will collect data from log files in the network share "//example.com/share/dir1/dir2/dir3" where the file name starts with "filename" and ends with any extension matching ".log".<br><br>Examples for other systems:<br>=> logrt\["/home/zabbix/logs/^logfile\[0-9\]{1,3}$",,,100\] → will match a file like "logfile1" (will not match ".logfile1")<br>=> logrt\["/home/user/^logfile\_.\*\_\[0-9\]{1,3}$","pattern\_to\_match","UTF-8",100\] → will collect data from files such "logfile\_abc\_1" or "logfile\_\_001".<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> logrt\[/app1/^test.\*log$,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> logrt\[/app1/^test.\*log$,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server. | |**logrt.count**\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Count of matched lines in a monitored log file that is rotated.|Integer|**file\_regexp** - absolute path to file, with the file name specified using a regular [expression](/manual/regular_expressions). Note that the regular expression applies only to the file name and does not need to match the entire name (e.g., /path/to/agent will match zabbix\_agentd.log)<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding-settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using-maxdelay-parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes-on-handling-copytruncate-log-file-rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active-checks).<br><br>Matching lines are counted in the new lines since the last log check by the agent, and thus depend on the item update interval.<br><br>Log rotation is based on the last modification time of files. <br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.<br>In the `file regexp` parameter, the log directory path and log file regular expression must be separated by the correct directory separator:<br> - on Windows, the separator must be a backslash (\\);<br> - on other systems, it must be a forward slash (/).<br>Forward slashes may be tolerated on Windows at other positions, except the one that separates the log directory path and the log file regular expression (see examples below):<br><br>Examples for Windows:<br>=> logrt.count["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → will count the number of matches for the pattern "pattern_to_match" in log files located in "c:/dir1/dir2/dir3"<br>=> logrt.count["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → will count the number of matches for the pattern "pattern_to_match" in log files on the network share "//example.com/share/dir1/dir2/dir3".<br><br>Examples for other systems:<br>=> logrt.count["/home/zabbix/logs/^logfile[0-9]{1,3}\$",,,100] → will count the number of matches for the pattern "^logfile[0-9]{1,3}\$" in log files in the "/home/zabbix/logs" directory<br>=> logrt.count["/home/user/^logfile_.*_[0-9]{1,3}\$","pattern_to_match","UTF-8",100] → will count the number of occurrences of the pattern "pattern_to_match" in log files located in "/home/user".| ##### Informació del registre Veieu informació addicional sobre els [elements de registre](log_items). |Clau d'element|<|<|<| |--|--|-------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |**log**\[fitxer,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\ >,\<persistent\_dir\>\]|<|<|<| |Monitoratge d'un fitxer de registre.|Registre|**fitxer** - camí complet i nom del fitxer de registre<br>**regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el patró necessari< br >**encoding** - pàgina de codis [id](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) <br>**maxlines** - nombre màxim de noves línies per segon que l'agent enviarà al servidor o al proxy Zabbix. Aquest paràmetre substitueix el valor de 'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (des de la versió 2.0)- valors possibles:<br>*tots* (per defecte), *skip* - Omet el processament de dades més antigues (només afecta els elements de creació recent).<br>**sortida** (des de la versió 2.2) - un patró de format de sortida opcional. La seqüència d'escapada **\\0** es substitueix per la part corresponent del text (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un **\\N** (on N=1 ...9) la seqüència d'escapada es substitueix per l'enèssim grup de concordança (o una cadena buida si la N supera el nombre de grups capturats).<br>**maxdelay** (des de la versió 3.2 ) - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; > 0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - opcions addicionals:<br>*mtime-noreread* - registres no únics, només reproduïts si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, ja que ara s'ignora mtime.)<br>**persistent\_dir** (des de 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2 ) - nom de camí absolut del directori on s'emmagatzemen els fitxers persistents. Vegeu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br>Si manca el fitxer o els permisos no permeten l'accés, l'element ja no s'admet.<br><br>Si "sortida" es deixa en blanc, es retorna tota la línia que conté el text coincident. Tingueu en compte que tots els tipus d'expressions regulars globals, excepte "El resultat és TRUE", sempre retornen tota la fila coincident i el paràmetre "output" s'ignora.<br><br>L'extracció de contingut per emprar el paràmetre "output" es fa a l'agent.< br <br>Exemples:<br>=> registre\[/var/log/syslog\]<br>=> registre\[/var/log /syslog,error\]<br>=> registre\[/home /zabbix/logs/logfile,,,100\]<br><br>*Emprar el paràmetre `output` per extreure un número del registre de registre:*<br>=> log\[/app1/app.log, "execució de la tasca \[0-9.\]+ seg, registres processats (\[0-9\]+), \[0 -9\]+ errors",,,,\\1\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processats 6080 registres, 0 errors" i només enviarà més de '6080' al servidor. Com que s'envia un valor numèric, el "Tipus d'informació" d'aquest element es pot establir en "Numèric (sense signe)" i el valor es pot emprar en gràfics, triggers, etc.<br>< br>*Emprant la "sortida" paràmetre per sobreescriure el registre de registre abans d'enviar-lo al servidor:*<br>=> log\[/app1/app.log,"(\[0-9 :-\ ]+) execució de la tasca (\[0-9 .\]+) segons, registres processats (\[0-9\]+), errors (\[0-9\]+),,,,"\\ 1 REGISTRES: \\3, ERRORS: \\ 4, DURADA: \\2"\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processats 6080 registres, 0 errors " i enviarà un registre modificat "2015-11- 13 10:08:26 REGISTRES: 6080, ERRORS: 0, DURADA: 6,08" al servidor.| |**log.count**\[fitxer,\<regexp\>,\<codificació\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<opcions\>,\< persistent\_dir\>\]|<|<|<| |Nombre de línies coincidents al fitxer de registre monitorat.|Enter|**fitxer** - camí complet i nom del fitxer de registre<br>**regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el patró necessari<br>**encoding** - [id](/manual/config/items/itemtypes/zabbix_agent#encoding-settings) de la pàgina de codi<br>**maxproclines** - nombre màxim de línies noves per segon que l'"agent escanejarà (no pot superar les 10.000). El valor per defecte és 10\*'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - valors possibles:<br>*all* (predeterminat), *skip* - Omet el processament de dades més antigues (només afecta els elements de nova creació). <br>**maxdelay** - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; >0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - opcions addicionals:<br>*mtime-noreread* - registres no únics, només reproduïts si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, ja que ara s'ignora mtime.)<br>**persistent\_dir** (des de 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2) - nom de camí absolut del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br><br><br>Les files coincidents es compten en fileres noves des que l'agent va comprovar el registre per darrer cop i, per tant, depenen de l'interval d'actualització de l'element.<br>Si manca el fitxer o els permisos no permeten l'accés, l'element queda sense suport.<br><br>Aquest element no és compatible amb el registre d'esdeveniments de Windows.<br><br>S'admet des de Zabbix 3.2.0.| |**logrt**\[fitxer\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\< opcions\>,\<persistent\_dir\>\]|<|<|<| |Monitoratge d'un fitxer de registre rotatiu.|Registre|**fitxer\_regexp** - camí absolut al fitxer, amb el nom del fitxer especificat amb una [expressió regular](/manual/regular_expressions#overview). Tingueu en compte que l'expressió regular aplica només al nom d'arxiu i no cal que coincideixi amb el nom sencer (com ara /path/to/agent coincideix amb zabbix\_agentd.log)<br>**regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el model de contingut necessari<br>**codificació** - [identificador] (/manual/config/items/itemtypes/zabbix_agent#encoding-settings) pàgina de codis <br>**maxlines** - nombre màxim de línies noves per segon que l'agent s'enviarà al servidor o al proxy Zabbix. Aquest paràmetre substitueix el valor de 'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (des de la versió 2.0)- valors possibles:<br>*tots* (per defecte), *skip* - Omet el processament de dades més antigues (només afecta els elements de creació recent).<br>**sortida** (des de la versió 2.2) - un patró de format de sortida opcional. La seqüència d'escapada **\\0** es substitueix per la part corresponent del text (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un **\\N** (on N=1 ...9) la seqüència d'escapada es substitueix per l'enèssim grup de concordança (o una cadena buida si l'N supera el nombre de grups capturats).<br>**maxdelay** (des de la versió 3.2 ) - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; > 0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - opcions addicionals:<br>*mtime-noreread* - registres no únics, només reproduïts si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, ja que ara s'ignora mtime.)<br>**persistent\_dir** (des de 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2) - nom de camí absolut del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items/activepassive#active_checks). <br>La rotació del registre es basa en l'hora en què es van modificar els fitxers per darrer cop.<br><br>Tingueu en compte que logrt és actualment dissenyat per funcionar amb un fitxer de registre actiu, juntament amb diversos altres fitxers que giren inactius corresponents. Si, per exemple, un directori conté molts fitxers de registre actius, s'hauria de crear un element logrt separat per cadascun. En cas contrari, si un element logrt recupera massa fitxers, pot provocar l'esgotament de la memòria i una fallada del monitor.<br><br>Si `output` es deixa buit, es retorna la línia sencera que conté el text coincident. Tingueu en compte que tots els tipus d'expressions de respostes regulars globals, excepte "El resultat és TRUE", sempre retornen tota la filera coincident i el paràmetre `output` s'ignora.<br><br>L'extracció de contingut mitjançant l'`output parameter` es fa a l'agent.<br><br>Al paràmetre `file regexp`, la ruta del directori de registre i l'expressió regular del fitxer de registre han de ser separats pel separador de directoris correcte:<br> - a Windows, el separador ha d'ésser una barra invertida (\\);<br> - en un altre sistema, ha d'ésser una barra inclinada (/).<br>Les barres inclinades es permeten a Windows en altres posicions, excepte la que separa la ruta del directori de registre i l'expressió regular del fitxer de registre (veieu els exemples tot seguit).<br><br>Exemples per a Windows:<br>=> logrt["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → recopilarà dades dels fitxers de registre a "c:/dir1/dir2/dir3" on el nom del fitxer comença amb "filename" i acaba amb qualsevol extensió que coincideixi amb ".log"<br>=> logrt["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → recopilarà dades dels fitxers de registre a la xarxa compartida "//example.com/ share/dir1/dir2/dir3" on el nom del fitxer comença amb "filename" i acaba amb qualsevol extensió que coincideixi amb ".log".<br><br>Exemples per a altres sistemes:<br>=> logrt\["/home/zabbix/logs/^logfile\[0-9\]{1,3}\$", ,,100\] → coincidirà amb un fitxer com "logfile1" (no coincidirà amb ".logfile1")<br>=> logrt\["/home/user/^logfile\_.\*\_\[ 0-9\]{1,3}\$"," pattern\_to\_match","UTF-8",100\] → recopilarà dades de fitxers com "logfile\_abc\_1" o "logfile\_\_001".<br><br>*Usant la sortida ` ` paràmetre per extreure un número del registre de registre:*<br>=> logrt\[/app1/^test.\*log \$,"execució de la tasca \[0-9.\]+ s, processada (\ [0-9\]+) registres, \[0-9\]+ errors",,,,\\1\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, ha processat 6080 registres, 0 errors" i només envia '6080' al servidor. Com que s'envia un valor numèric, el "Tipus d'informació" d'aquest element es pot establir en "Numèric (sense signe)" i el valor es pot emprar en gràfics, triggers, etc.<br>< br>*Empreu el paràmetre `output` per reescriure el registre de registre abans d'enviar-lo al servidor:*<br>=> logrt\[/app1/^test.\*log\$,"(\[0 -9 :-\]+) execució de la tasca (\[0 -9.\]+) segons, registres processats (\[0-9\]+), errors (\[0-9\]+),, ,,"\\1 REGISTRES: \\3, ERRORS: \\4, DURADA: \\2"\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processat 6080 registres, 0 errors" i enviarà un registre editat "2015- 11-13 10:08:26 REGISTRES: 6080, ERRORS: 0, DURADA: 6,08" al servidor. | |**logrt.count**\[fitxer\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>, \<persistent\_dir\>\]|<|<|<| |Nombre de línies coincidents en un fitxer de registre monitorat que s'és girant.|Enter|**fitxer\_regexp** - camí absolut al fitxer, amb el nom del fitxer especificat amb una [expressió regular](/manual/regular_expressions#overview). Tingueu en compte que l'expressió regular aplica només al nom d'arxiu i no cal que coincideixi amb el nom sencer (com ara /path/to/agent coincideix amb zabbix\_agentd.log)<br> **regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el patró de contingut necessari<br>**encoding** - [id](/manual/config /items/itemtypes/zabbix_agent#encoding-settings) codi pàgina<br>**maxproclines** - nombre màxim de noves línies per segon que l'agent analitzarà (no pot superar les 10.000). El valor per defecte és 10\*'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - valors possibles:<br>*all* (per defecte), *skip* - Omet el processament de dades més antigues (només afecta els elements de creació recent).<br>**maxdelay** - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; > 0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - tipus de rotació del fitxer de registre i altres opcions. Valors possibles:<br>*rotate* (per defecte),<br>*copytruncate* - tingueu en compte que *copytruncate* no es pot emprar amb *maxdelay*. En aquest cas, *maxdelay* ha d'ésser 0 o no especificat; veieu les notes de [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation),<br>*mtime-reread* - registres no únics, rellegir si el temps de modificació o la mida canvia (per defecte),<br>*mtime-noreread* - registres no únics, es reprodueix només si la mida canvia (ignora el canvi de temps de modificació).<br>**persistent\_dir** (des de les versions 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2) - camí absolut al directori on emmagatzemar els fitxers persistents. Veieu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br><br>Les fileres coincidents es compten en fileres noves des que l'agent va comprovar el registre per darrera vegada i, per tant, depenen de l'interval d'actualització de l'element.<br ><br>La rotació del registre es basa en la darrera modificació dels fitxers. <br><br>Aquest element no és compatible amb el registre d'esdeveniments de Windows.<br><br>S'admet des de Zabbix 3.2.0.<br>Al paràmetre `file regexp`, la ruta del directori de registre i l'expressió regular del fitxer de registre s'han de separar pel separador de directoris correcte:<br> - a Windows, el separador ha d'éser una barra invertida (\\);<br> - en altres sistemes, ha de ser una barra inclinada (/).<br>Les barres inclinades es permeten a Windows en altres posicions, excepte la que separa la ruta del directori de registre i l'expressió regular del fitxer de registre (veieu els exemples tot seguit):<br><br>Exemples per a Windows:<br>=> logrt.count["c:/dir1/dir2/dir3&#92;filename.\*\\.log","pattern_to_match"] → comptarà el nombre de coincidències per al patró "pattern_to_match" als fitxers de registre situats a "c:/dir1/dir2/dir3"<br>=> logrt.count["//example.com/share/dir1/dir2/dir3\\filename.\*\\.log","pattern_to_match"] → comptarà el nombre de coincidències per al patró "pattern_to_match" als fitxers de registre a la xarxa compartida "//example.com/share/dir1/dir2/dir3".<br><br>Exemples per a altres sistemes:<br>=> logrt.count["/home/zabbix/logs/^logfile[0-9]{1,3}\$",,,100] → comptarà el nombre de coincidències per al patró "^logfile[0-9] {1,3}\$" als fitxers de registre del directori "/home/zabbix/logs"<br>=> logrt.count["/home/user/^logfile_.*_[0-9]{1,3}\$","pattern_to_match","UTF-8",100] → comptarà el nombre d'ocurrències del patró "patró_a_coincidir" als fitxers de registre situats a "/home/user".|| ### Log entry The log entry object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |level|integer|Log level.| |ms|string|The time elapsed in milliseconds since the script was run before log entry was added.| |message|string|Log message.| ### Entrada de registre L'objecte d'entrada de registre té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |level|integer|Nivell de registre.| |ms|string|Temps transcorregut en mil·lisegons des que s'executa l'script abans que s'afegeix l'entrada de registre.| |message|string|Missatge de registre.| #### Log file monitoring For `log[]`, `logrt[]`, `log.count[]`, `logrt.count[]` items, regular expression runtime errors are now logged in the Zabbix agent log file. See [more details](/manual/config/items/itemtypes/zabbix_agent/log_items#handling-of-regular-expression-compilation-and-runtime-errors). #### Monitoratge del fitxer de registre Per als elements `log[]`, `logrt[]`, `log.count[]`, `logrt.count[]`, els errors d'execució d'expressions regulars ara es registren al fitxer de registre de l'agent Zabbix. Veieu [més detalls](/manual/config/items/itemtypes/zabbix_agent/log_items#handling-of-regular-expression-compilation-and-runtime-errors). #### Log file monitoring `log[]` and `logrt[]` items repeatedly reread log file from the beginning if file system is 100% full and the log file is being appended (see [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884) for more information). #### Monitoratge dels arxius de registre Els elements `log[]` i `logrt[]` reprodueixen repetidament el fitxer de registre des del principi si el sistema de fitxers és ple al 100% i el fitxer de registre és en mode d'adjuntar (veieu [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884) per obtindre més informació). ##### Logging Add the "Log test" entry to the Zabbix server log and receive the item value "1" in return: - Create an item with type "Script". - In the *Script* field, enter: ```javascript Zabbix.log(3, 'Log test'); return 1; ``` ##### Registre Afegir "Log test" a l'arxiu de registre del servidor Zabbix i rebre el valor de l'element "1" de tornada: - Crear un element de tipus "Script".\ - Al camp *Script*, poseu-hi el codi següent: ```javascript Zabbix.log(3, 'Log test'); return 1; ``` #### Logging out Log out from the API. Request: ```json { "jsonrpc": "2.0", "method": "user.logout", "params": [], "id": 1, "auth": "16a46baf181ef9602e1687f3110abf8a" } ``` Response: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` #### Desconnectar Desconnectar de l'API. Petició: ```json { "jsonrpc": "2.0", "method": "user.logout", "params": [], "id": 1, "auth": "16a46baf181ef9602e1687f3110abf8a" } ``` Resposta: ```json { "jsonrpc": "2.0", "result": true, "id": 1 } ``` ### Log history The log history object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.| ### Històric dels registres L'objecte històric de registre té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |id|string|ID de l'entrada d'històric.| |clock|timestamp|Hora quan es va rebre el valor.| |itemid|string|ID de l'element relacionat.| |logeventid|integer|ID d'entrada al registre d'esdeveniments de Windows.| |ns|integer|Nanosegons de quan es va rebre el valor.| |severity|integer|Nivell d'entrada al registre d'esdeveniments de Windows.| |source|string|Font de l'entrada al registre d'esdeveniments de Windows.| |timestamp|timestamp|Hora d'entrada al registre d'esdeveniments de Windows.| |value|text|Valor rebut.| #### Login and systemd We recommend [creating](/manual/installation/install#create_user_account) a *zabbix* user as system user, that is, without ability to log in. Some users ignore this recommendation and use the same account to log in (e. g. using SSH) to host running Zabbix. This might crash Zabbix daemon on log out. In this case you will get something like the following in Zabbix server log: zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument and in Zabbix agent log: zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument This happens because of default systemd setting `RemoveIPC=yes` configured in `/etc/systemd/logind.conf`. When you log out of the system the semaphores created by Zabbix previously are removed which causes the crash. A quote from systemd documentation: RemoveIPC= Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources after the last of the user's sessions terminated. This covers System V semaphores, shared memory and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the root user and other system users are excluded from the effect of this setting. Defaults to "yes". There are 2 solutions to this problem: 1. (recommended) Stop using *zabbix* account for anything else than Zabbix processes, create a dedicated account for other things. 2. (not recommended) Set `RemoveIPC=no` in `/etc/systemd/logind.conf` and reboot the system. Note that `RemoveIPC` is a system-wide parameter, changing it will affect the whole system. #### Connexió i systemd Recomanem [crear](/manual/installation/install#create_user_account) un usuari *zabbix* com a usuari del sistema, sense possibilitat de connectar-s'hi. Alguns usuaris ignoren la recomanació i empren el mateix compte per connectar-se (per exemple per SSH) a l'equip on hi ha el Zabbix. Això pot tombar el dimoni Zabbix després al desconnectar. En aquest cas, tindreu alguna cosa com això, al registre del servidor Zabbix: zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument i al registre de l'agent Zabbix: zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument Això passa per el paràmetre per defecte de systemd `RemoveIPC=yes` configurat a `/etc/systemd/logind.conf`. Quan sortiu del sistema, els semàfors creats per Zabbix s'esborren, i provoquen l'errada. Una frase de la documentació de systemd: RemoveIPC= Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources after the last of the user's sessions terminated. This covers System V semaphores, shared memory and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the root user and other system users are excluded from the effect of this setting. Defaults to "yes". Hi ha dues solucions per aquest problema: 1. (recomanada) Deixeu d'emprar el compte *zabbix* per qualsevol cosa que no siguin els processos de Zabbix, i creeu un altre compte per fer qualsevol altra tasca. 2. (no recomanada) Definiu `RemoveIPC=no` dans `/etc/systemd/logind.conf` i reinicieu el sistema. Fixeu-vos que `RemoveIPC` és un paràmetre de tot el sistema, modificar-lo afectarà a tot el sistema. #### Login {width="350"} This is the Zabbix welcome screen. Enter the user name **Admin** with password **zabbix** to log in as a [Zabbix superuser](/manual/config/users_and_usergroups/permissions). Access to *Configuration* and *Administration* menus will be granted. For security reasons, it is strongly recommended to change the default password for the Admin account immediately after the first login. #### Inici de sessió {width="350"} Aquesta és la pantalla de benvinguda de Zabbix. Introduïu el nom d'usuari **Administrador** amb mot de pas **zabbix** per iniciar sessió com a [superusuari de Zabbix](/manual/config/users_and_usergroups/permissions). I tindreu permís per accedir als menús *Configuració* i *Administració*. Per motius de seguretat, es recomana canviar el mot de pas predeterminat del compte d'administrador tot just després del primer inici de sessió. #### Log in Zabbix frontend is ready! The default user name is **Admin**, password **zabbix**. {width="350"} Proceed to [getting started with Zabbix](/manual/quickstart/login). #### Connexió La interfície de Zabbix és llesta! El nom d'usuari per defecte és **Admin**, i el mot de pas **zabbix**. {width="350"} I ara, [engegueu amb Zabbix](/manual/quickstart/login). ### Log level control targets *process-type* All processes of specified type (active checks, collector, listener) *process-type,N* Process type and number (e.g., listener,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are: d Number with a decimal part. m Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state. s Text. Maximum length not limited. t Text. Same as **s**. u Unsigned integer. **-t**, **--test** *item-key* Test single item and exit. See **--print** for output description. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Objectes de control del nivell de registre *process-type* Tots els processos especificats per tipus (checks actius, colectors, a l'escolta) *process-type,N* Tipus de procés i nombre (ex., listener,3) *pid* Identificador del procés; fins a 65535. Per a valors més grans, especifiqueu el destí com a "process-type,N" ```{=html} <!-- --> ``` **-p**, **--print** Mostra els elements coneguts i surt. Per cada element, s'usen els valors per defecte; o els valors que s'hagin especificat. Aquests valors per defecte es llisten entre parèntesi com a paràmetres de clau d'element. Retorna els valors entre claudàtors i prefixats amb el tipus del valor retornat, separat amb una pleca (|). Per paràmetres d'usuari, el tipus és sempre **t**, doncs l'agent no pot pas determinar tots els valors de retorn possibles. Els elements, mostrats engegats, no garanteix que funcionin des del servidor de Zabbix o zabbix\_get quan un dimoni d'agent en execució en fa la consulta, doncs els permisos de l'entorn podrien ésser diferents. Els valors que retorna són: d Nombre amb una part decimal. m No compatible. Això pot ser causat per la consulta d'un element que només funciona en el mode actiu, com un element de control de registre o un element que requereix múltiples valors recollits. Problemes de permís o usuari incorrecte els paràmetres també podrien donar lloc a l'estat no compatible. s Text. Longitud màxima no limitada. t Text. Igual que **s**. u Enter sense signe. **-t**, **--test** *item-key* Prova un sol element i surt. Vegeu **--print** per a la descripció de la sortida. **-h**, **--help** Mostra aquesta ajuda i surt. **-V**, **--version** Informació de la versió de sortida, i surt. [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, ha manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller) *process-type,N* Process type and number (e.g., poller,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" Profiling control targets *process-type* All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller) *process-type,N* Process type and number (e.g., history syncer,1) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" *scope* Profiling scope (rwlock, mutex, processing) can be used with process type (e.g., history syncer,1,processing) [ ]{#lbAH} ### Fites de control del nivell de registre *process-type* Tots els processos del tipus especificat (alerter, alert manager, configuration syncer, discoverer, escalator, ha manager, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller) *process-type,N* Tipus i nombre de procés (p.e., poller,3) *pid* Identificador de procés (fins a 65535). Per a valors més grans, especificar el destí com a "process-type,N" Perfil d'objectius de control *process-type* Tots els processos d'un tipus especificat (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector, history poller, availability manager, service manager, odbc poller) *process-type, N* Tipus i nombre de procés (p. ex., history syncer, 1) *pid* Identificador de procés, fins a 65535. Per a valors més grans, especifiqueu l'objectiu com a "tipus de procés, N" *scope* L'àmbit del perfil (rwlock, mutex, processing) es pot emprar amb el tipus de procés (p. ex., history syncer, 1, processing) [ ]{#lbAH} ### Log level control targets *process-type* All processes of specified type (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Process type and number (e.g., poller,3) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" Profiling control targets *process-type* All processes of specified type (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Process type and number (e.g., history syncer,1) *pid* Process identifier, up to 65535. For larger values specify target as "process-type,N" *scope* Profiling scope (rwlock, mutex, processing) can be used with process type (e.g., history syncer,1,processing) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAH} ### Fite de control del nivell de registre *process-type* Tots els processos del tipus especificat (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type,N* Tipus i nombre de procés (p.e., poller,3) *pid* Identificador del procés; fins a 65535. Per a valors superiors, especificar el destí com a "process-type,N" Perfil d'objectius de control *process-type* Tots els processos d'un tipus especificat (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, preprocessing manager, preprocessing worker, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector, history poller, availability manager, odbc poller) *process-type, N* Tipus i nombre de procés (p. ex., history syncer, 1) *pid* Identificador de procés, fins a 65535. Per a valors més grans, especifiqueu l'objectiu com a "tipus de procés, N" *scope* L'àmbit del perfil (rwlock, mutex, processing) es pot empraramb el tipus de procés (p. ex., history syncer,1,processing) **-h**, **--help** Mostrar aqueseta ajuda i sortir. **-V**, **--version** Mostrar la informació de versió i sortir. [ ]{#lbAH} ###### Log request A request sent by a plugin to write a log message into the agent log file. | | | |---|---| |direction|plugin → agent| |response|no| Parameters specific to log requests: |Name|Type|Comments| |---------|--------|----------| |severity|uint32|The message severity (log level).| |message|string|The message to log.| *Example:* {"id":0,"type":1,"severity":3,"message":"message"} ###### Petició de registre Petició enviada per un plug-in per escriure un missatge de registre a l'arxiu registre de l'agent. | | | |---|---| |direction|plugin → agent| |response|no| Paràmetres específics de les peticions de registre: |Nom|Tipus|Comentaris| |---------|--------|----------| |severity|uint32|La gravetat del missatge (nivell de registre).| |message|string|El missatge a registrar.| *Exemple:* {"id":0,"type":1,"severity":3,"message":"message"} #### Logrotate for Zabbix server and proxy The logrotate utility is only included into packages for zabbix-agent, zabbix-agent2 and zabbix-web-service, but needs to be installed separately for Zabbix server and proxy. The logrotate dependency has been added to the server and proxy packages for RHEL and SUSE starting from Zabbix 6.4.4rc1. #### Logrotate per al servidor i proxy Zabbix La utilitat de rotació de registres (logrotate) només s'inclou als paquets per a zabbix-agent, zabbix-agent2 i zabbix-web-service, però s'ha d'instal·lar per separat per al servidor Zabbix i al proxy. La dependència logrotate s'ha afegit als paquets de servidor i proxy per a RHEL i SUSE a partir de Zabbix 6.4.4rc1. ##### Log rotation Zabbix does not provide any log rotation system - that should be handled by the user. The log rotation should first rename the old file and only later delete it so that no traps are lost: 1. Zabbix opens the trap file at the last known location and goes to step 3 2. Zabbix checks if the currently opened file has been rotated by comparing the inode number to the defined trap file's inode number. If there is no opened file, Zabbix resets the last location and goes to step 1. 3. Zabbix reads the data from the currently opened file and sets the new location. 4. The new data are parsed. If this was the rotated file, the file is closed and goes back to step 2. 5. If there was no new data, Zabbix sleeps for 1 second and goes back to step 2. ##### Rotació dels registres Zabbix no proporciona cap sistema de rotació de registres: ha d'ésser gestionat per l'usuari. En rotar el registre, primer hauria de canviar el nom del fitxer antic i només esborrar-lo més tard perquè no es perdi cap informació: 1. Obriu el fitxer Zabbix a la darrera ubicació coneguda i aneu a la passa 3 2. Zabbix comprova si el fitxer obert actualment s'ha rotat comparant el nombre d'inode amb el nombre d'inode del fitxer trap definit. Si no hi ha cap fitxer obert, Zabbix restableix la darrera ubicació i passa a la passa 1. 3. Zabbix llegeix les dades del fitxer actualment obert i estableix la nova ubicació. 4. S'analitzen les noves dades. Si aquest era el fitxer rotat, el fitxer es tanca i torna a la passa 2. 5. Si no hi ha dades noves, Zabbix s'atura durant 1 segon i torna a la passa 2. #### Low-level discovery Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities. [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype) #### Descoberta de baix nivell Configurar les regles de descoberta a baix nivell, així com els prototipus d'elements, triggers i els prototipus de gràfics; per monitorar les entitats dinàmiques. [API Regla de descoberta de baix nivell](/manual/api/reference/discoveryrule) | [API Prototip d'element](/manual/api/reference/itemprototype) | [API Prototip de trigger](/manual/api/reference/triggerprototype) | [API Prototip de gràfic](/manual/api/reference/graphprototype) | [API Prototip d'equip](/manual/api/reference/hostprototype) #### Low-level discovery In a [low-level discovery rule](/manual/discovery/low_level_discovery#configuring_low-level_discovery), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Key parameters|<|yes| |Update interval|<|no| |Custom interval|<|no| |Keep lost resources period|<|no| |Description|<|yes| |*SNMP agent*|<|<| | |SNMP OID|yes| |*SSH agent*|<|<| | |Username|yes| |^|Public key file|yes| |^|Private key file|yes| |^|Password|yes| |^|Script|yes| |*TELNET agent*|<|<| | |Username|yes| |^|Password|yes| |^|Script|yes| |*Zabbix trapper*|<|<| | |Allowed hosts|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*HTTP agent*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|Query fields|yes| |^|Timeout|no| |^|Request body|yes| |^|Headers (names and values)|yes| |^|Required status codes|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |*Filters*|<|<| | |Regular expression|yes| |*Overrides*|<|<| | |Filters: regular expression|yes| |^|Operations: update interval (for item prototypes)|no| |^|Operations: history storage period (for item prototypes)|no| |^|Operations: trend storage period (for item prototypes)|no| #### Descoberta de baix nivell En una [regla de descoberta de baix nivell](/manual/discovery/low_level_discovery#configuring_low-level_discovery), les macros d'usuari es poden emprar als camps següents: |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Paràmetres de clau|<|sí| |Interval d'actualització|<|no| |Intervals personalitzats|<|no| |Període d'emmagatzematge dels recursos perduts|<|no| |Descripció|<|sí| |*Agent SNMP*|<|<| | |OID SNMP|sí| |*Agent SSH*|<|<| | |Nom d'usuari|sí| |^|Arxiu de clau pública|sí| |^|Arxiu de clau privada|sí| |^|Paraula de pas|sí| |^|Script|sí| |*Agent TELNET*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Script|sí| |*Trap Zabbix*|<|<| | |Equips autoritzats|sí| |*Monitoratge de base de dades*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Petició SQL|sí| |*Agent JMX*|<|<| | |Punt d'acabament JMX|sí| |*Agent HTTP*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|sí| |^|Camps de petició|sí| |^|Temps d'espera|no| |^|Cos de la petició|sí| |^|Capçalera (noms i valors)|sí| |^|Codis d'estat demanats|sí| |^|Nom d'usuari d'autenticació HTTP|sí| |^|Mot de pas d'autenticació HTTP|sí| |*Filtres*|<|<| | |Expressió regular|sí| |*Anul·lar*|<|<| | |Filtres: Expressió regular|sí| |^|Operacions: interval d'actualització (per als prototips d'elements)|no| |^|Operacions: període d'emmagatzematge de l'històric (per als prototips d'elements)|no| |^|Operacions: període d'emmagatzematge de les tendències (per als prototips d'elements)|no| #### Low-level discovery macros Even though no low-level discovery macros are created in the returned JSON, these macros can be defined by the user as an additional step, using the [custom LLD macro](/manual/discovery/low_level_discovery#custom_macros) functionality with JSONPath pointing to the discovered values in the returned JSON. The macros then can be used to create item, trigger, etc prototypes. #### Macros de descoberta de baix nivell Tot i que no es creen macros de descoberta de baix nivell al JSON retornat, l'usuari pot definir aquestes macros com a passa addicional, emprant [macros LLD personalitzades](/manual/discovery/low_level_discovery# custom_macros) amb un JSONPath que apunta a alors descoberts al JSON retornat. Aleshores, les macros es poden emprar per crear prototips d'elements, triggers, etc. #### Macro functions The range of the `fmtnum` [macro function](/manual/config/macros/macro_functions#supported-macro-functions) is now limited to 0-20. #### Funcions de macro L'interval de la [funció macro](/manual/config/macros/macro_functions#supported-macro-functions) `fmtnum`és ara limitat a 0-20. ## Macros ## Macros #### Macros #### Macros ## Macros ## Macros Macros for internal actions contain the reason why an item, an LLD-rule, or a trigger became unsupported: - {ITEM.STATE.ERROR} - for item-based internal notifications; - {LLDRULE.STATE.ERROR} - for LLD-rule based internal notifications; - {TRIGGER.STATE.ERROR} - for trigger-based internal notifications. For more details, see [Supported macros](/manual/appendix/macros/supported_by_location). Les macros per a accions internes contenen el motiu pel qual ja no s'admet un element, una regla de LLD o un trigger: - {ITEM.STATE.ERROR} - per a notificacions internes basades en articles; - {LLDRULE.STATE.ERROR} - per a notificacions internes basades en regles LLD; - {TRIGGER.STATE.ERROR} - per a notificacions internes basades en triggers. Per obtindre més informació, veieu les [macros admeses](/manual/appendix/macros/supported_by_location). ### Macros in user-defined global scripts To enhance security, it is recommended to use [macro functions](/manual/config/macros/macro_functions) instead of plain macros in user-defined global [scripts](/manual/web_interface/frontend_sections/administration/scripts), as macros are not automatically escaped. ### Macros a scripts globals definits per l'usuari Per millorar la seguretat, es recomana utilitzar [funcions de macro](/manual/config/macros/macro_functions) en lloc de macros simples a [scripts](/manual/web_interface/frontend_sections/administration/scripts) globals definits per l'usuari, ja que les macros no s'escapen automàticament. #### Macros This section allows to define system-wide [user macros](/manual/config/macros/user_macros) as 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"} #### Vista general Aquesta secció permet la definició a tot el sistema de [macros d'usuari](/manual/config/macros/user_macros) com a parells nom-valor. Tingueu en compte que els valors de macro es poden mantindre com a text sense format, text secret o caixa secreta. També s'admet afegir una descripció. {width="600"} #### Macro support Built-in and user macros in tags are resolved at the time of the event. Until the event has occurred these macros will be shown in Zabbix frontend unresolved. Low-level discovery macros are resolved during discovery process. The following macros may be used in trigger tags: - {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros can be used to populate the tag name or tag value. - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) can be used to reference host inventory values from one or several hosts in a trigger expression. - [User macros](/manual/config/macros/user_macros) and user macros with context are supported for the tag name/value; context may include low-level discovery macros. - Low-level discovery macros can be used for the tag name/value in trigger prototypes. The following macros may be used in trigger-based notifications: - {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros will resolve to a comma separated list of event tags or recovery event tags - {EVENT.TAGSJSON} and {EVENT.RECOVERY.TAGSJSON} macros will resolve to a JSON array containing event tag [objects](/manual/api/reference/event/object#event_tag) or recovery event tag objects The following macros may be used in template, host, item and web scenario tags: - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - Low-level discovery macros can be used in item prototype tags The following macros may be used in host prototype tags: - {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID} macros - {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) - [User macros](/manual/config/macros/user_macros) - [Low-level discovery macros](/manual/config/macros/lld_macros) will be resolved during discovery process and then added to the discovered host #### Suport de macros Les macros integrades i d'usuari a les etiquetes es resolen en el moment de l'esdeveniment. Fins que no s'hagi produït l'esdeveniment, aquestes macros es veuran a la interfície de Zabbix sense resoldre. Les macros de descoberta de baix nivell es resolen durant el procés de descoberta. Les macros següents es poden emprar a les etiquetes de triggers: - {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} Les macros es poden emprar per emplenar el nom de l'etiqueta o el valor de l'etiqueta. - Es poden emprar les [macros](/manual/appendix/macros/supported_by_location) {INVENTORY.\*} per fer referència als valors d'inventari d'equip d'un o diversos equips en una expressió trigger. - [Macros d'usuari](/manual/config/macros/user_macros) i el context de macro d'usuari són compatibles amb al nom/valor de l'etiqueta; El context pot incloure macros de descoberta de baix nivell. - Es poden emprar macros de descoberta de baix nivell per al nom/valor de l'etiqueta de prototips de trigger. Les macros següents es poden emprar a les notificacions basades en triggers: - Les macros {EVENT.TAGS} i {EVENT.RECOVERY.TAGS} es resoldran en una llista separada per comes d'etiquetes d'esdeveniment o etiquetes d'esdeveniment de recuperació - Les macros {EVENT.TAGSJSON} i {EVENT.RECOVERY.TAGSJSON} es resoldran a una matriu JSON que conté una etiqueta d'esdeveniment amb [objectes](/manual/api/reference/event/object#event_tag) o objectes de recuperació d'etiquetes d'esdeveniment Les macros següents es poden emprar en plantilla, equip, element i etiquetes d'escenari web: - Macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} - [Macros](/manual/appendix/macros/supported_by_location) {INVENTARI.\*} - [Macros d'usuari](/manual/config/macros/user_macros) - Les macros de descoberta de baix nivell es poden emprar a les etiquetes de prototip d'elements Les macros següents es poden emprar a les etiquetes de prototip d'equips: - Macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} - [macros](/manual/appendix/macros/supported_by_location) {INVENTARI.\*} - [Macros d'usuari](/manual/config/macros/user_macros) - Les [macros de descoberta de baix nivell](/manual/config/macros/lld_macros) es resoldran durant el procés de descoberta i després s'afegirà al fitxer de l'equip descobert #### Macro support for email media types When configuring an [email media type](/manual/config/notifications/media/email), it is now possible to use macros in the [username and password fields](/manual/appendix/macros/supported_by_location_user#other-locations). #### Suport de macros per tipus de suport de correu-e Quan configurem un [tipus de suport de correu electrònic](/manual/config/notifications/media/email), ara es poden emprar macros als [camps d'usuari i mot de pas](/manual/appendix/macros/supported_by_location_user#other-locations). #### maintenance Changes:<br> [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: added strict validation of the methods parameters.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: dropped support for parameter `timeperiodid` of the timeperiod object. #### manteniment Canvis:<br> [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: afegida la validació estricta dels paràmetres dels mètodes.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: suport descartat per al paràmetre `timeperiodid` de l'objecte del període de temps. #### maintenance Changes:<br> [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `groupids` is now deprecated. Use `groups` instead.<br> [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `hostids` is now deprecated. Use `hosts` instead.<br> [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: changed the type of parameters `groups`, `hosts`, `timeperiods` and `tags` from `array` to `object/array`. #### manteniment Canvis:<br> [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: el paràmetre `groupids` és obsolet. En lloc d'aquest, empreu `groups`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: el paràmetre`hostids` és obsolet. En lloc d'aquest, empreu `hosts`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: s'ha canviat el tipus de paràmetre `groups`, `hosts`, `timeperiods` i `tags` d'`array` a `object/array`. # maintenance.create # maintenance.create # maintenance.delete # maintenance.delete # maintenance.get # maintenance.get # Maintenance object The following objects are directly related to the `maintenance` API. # Objecte manteniment Els següents objectes tenen relació directa amb l'API `maintenance`. ##### Maintenance periods The maintenance period window is for scheduling time for a recurring or a one-time maintenance. The form is dynamic with available fields changing based on the *Period type* selected.  |Period type|Description| |--|--------| |*One time only*|Define the date and time, and the length of the maintenance period.| |*Daily*|*Every day(s)* - maintenance frequency: 1 (default) - every day, 2 - every two days, etc.<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| |*Weekly*|*Every week(s)* - maintenance frequency: 1 (default) - every week, 2 - every two weeks, etc.<br>*Day of week* - on which day the maintenance should take place.<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| |*Monthly*|*Month* - select all months during which the regular maintenance is carried out.<br>*Date*: **Day of month** - Select this option if the maintenance takes place on the same date each month (for example, every 1st day of the month). Then, select the required day in the new field that appears.<br>*Date*: **Day of week** - Select this option if the maintenance takes place only on certain days (for example, every first Monday of the month). Then, in the drop-down select the required week of the month (first, second, third, fourth, or last) and mark the checkboxes for maintenance day(s).<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| When done, press *Add* to add the maintenance period to the *Periods* block. Notes: - When *Every day/Every week* parameter is greater than 1, the starting day or week is the day/week that the *Active since* time falls on. For example: - with *Active since* set to January 1 at 12:00 and a one-hour maintenance set for every two days at 23:00 will result in the first maintenance period starting on January 1 at 23:00, while the second maintenance period will start on January 3 at 23:00; - with the same *Active since* time and a one-hour maintenance set for every two days at 01:00, the first maintenance period will start on January 3 at 01:00, while the second maintenance period will start on January 5 at 01:00. - Daylight Saving Time (**DST**) changes do not affect how long the maintenance will be. - Let's say we have a two-hour maintenance that usually starts at 01:00 and finishes at 03:00: - If after one hour of maintenance (at 02:00) a DST change happens and current time changes from 02:00 to 03:00, the maintenance will continue for one more hour till 04:00; - If after two hours of maintenance (at 03:00) a DST change happens and current time changes from 03:00 to 02:00, the maintenance will stop because two hours have passed. - If a maintenance period is set to 1 day it usually starts at 00:00 and finishes at 00:00 the next day: - Since Zabbix calculates days in hours, the actual period of the maintenance is 24 hours. - If current time changes forward one hour, the maintenance will stop at 01:00 the next day. - If current time changes back one hour, the maintenance will stop at 23:00 that day. - If a maintenance period starts during the hour, skipped by DST change: - The maintenance will not start. ##### Períodes de manteniment La finestra del període de manteniment s'utilitza per programar el temps per al manteniment recurrent o únic. El formulari és dinàmic i els camps disponibles canvien en funció del *tipus de període* seleccionat.  |Tipus de període|Descripció| |--|---------| |*Només un cop*|Definiu la data i l'hora, així com la durada del període de manteniment.| |*Diari*|*Cada dia/dies* - freqüència de manteniment: 1 (per defecte) - cada dia, 2 - cada dos dies, etc.<br>*A (hora:minut)* - hora del dia en què comença el manteniment.<br> *Durada del període de manteniment* - quant de temps serà actiu el manteniment.| |*Semanal*|*Cada setmana/setmanes* - freqüència de manteniment: 1 (per defecte) - cada dia, 2 - cada dos dies, etc.<br>*Dia de la setmana* - el dia en què s'ha de fer el manteniment. <br>*A (hora:minut)* - hora del dia comença el manteniment.<br>*Durada del període de manteniment* - quant de temps serà actiu el manteniment.| |*Mensual*|*Mes* - trieu tots els mesos en què es realitza el manteniment habitual.<br>*Data*: **Dia del mes** - trieu aquesta opció si el manteniment es produeix la mateixa data cada mes (per exemple, 1r dia del mes). Tot seguit, trieu el dia requerit al camp nou que apareix.<br>*Data*: **Dia de la setmana** - trieu aquesta opció si el manteniment només es produeix en determinats dies (per exemple, cada primer dilluns de mes). A continuació, a la llista desplegable, trieu la setmana del mes requerida (primera, segona, tercera, quarta o darrera) i marqueu les caselles corresponents al(s) dia(s) de manteniment.<br>*A (hora:minut)* - hora d'inici del manteniment.<br>*Durada del període de manteniment* - quant de temps serà actiu el manteniment.| Quan hagueu acabat, premeu *Afegir per afegir el període de manteniment al bloc *Períodes*. Observacions: - Quan el paràmetre *Diari/Setmanal* és superior a 1, el dia o la setmana d'inici és el dia/setmana en què cau l'hora *Activat des de*. Per exemple: - amb *Activat des de* establert a l'1 de gener a les 12:00 i una hora de manteniment establerta cada dos dies a les 23:00, farà que la primera finestra de manteniment s'iniciï l'1 de gener a les 23:00, mentre que la segona finestra de manteniment començarà el 3 de gener a les 23:00h; - amb la mateixa hora *Actiu des de* i un manteniment d'una hora establert cada dos dies a la 01:00, la primera finestra de manteniment començarà el 3 de gener a la 01:00, mentre que la segona finestra de manteniment començarà el 5 de gener a les 01:00. :00:00. - Els canvis de DST (**DST**) no afecten la durada del manteniment. - Suposem que tenim un manteniment de dues hores que normalment comença a la 01:00 i acaba a les 03:00: - Si després d'una hora de manteniment (a les 02:00 h) es produeix un canvi d'horari d'estiu i l'hora actual canvia de les 02:00 h a les 03:00 h, el manteniment continuarà una hora més fins a les 04:00 h; - Si després de dues hores de manteniment (a les 03:00) es produeix un canvi de l'horari d'estiu i l'hora actual canvia de les 03:00 a les 02:00, el manteniment s'aturarà perquè hauran passat dues hores. - Si un període de manteniment s'estableix en 1 dia, normalment comença a les 00:00 i finalitza a les 00:00 del dia següent: - Com que Zabbix calcula els dies en hores, la durada real del manteniment és de 24 hores. - Si l'hora actual avança una hora, el manteniment s'aturarà a la 01:00 de l'endemà. - Si l'hora actual s'endarrereix una hora, el manteniment s'aturarà a les 23:00 hores d'aquell dia. - Si s'inicia un període de manteniment durant l'hora, omès pel canvi d'horari d'estiu: - El manteniment no començarà pas. ### Maintenance The maintenance object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |maintenanceid|string|*(readonly)* ID of the maintenance.| |**name**<br>(required)|string|Name of the maintenance.| |**active\_since**<br>(required)|timestamp|Time when the maintenance becomes active.<br><br>The given value will be rounded down to minutes.| |**active\_till**<br>(required)|timestamp|Time when the maintenance stops being active.<br><br>The given value will be rounded down to minutes.| |description|string|Description of the maintenance.| |maintenance\_type|integer|Type of maintenance.<br><br>Possible values:<br>0 - *(default)* with data collection;<br>1 - without data collection.| |tags\_evaltype|integer|Problem tag evaluation method.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Manteniment L'objecte manteniment té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |maintenanceid|string|*(només lectura)* ID de manteniment.| |**name**<br>(obligatori)|string|Nom del manteniment.| |**active\_since**<br>(obligatori)|marca de temps|Hora en què el manteniment s'activa.<br><br>El valor donat s'arrodonirà al minut inferior.| |**active\_till**<br>(obligatori)|timestamp|Hora en què el manteniment deixa d'ésser actiu.<br><br>El valor donat s'arrodonirà al minut inferior.| |description|string|Descripció del manteniment.| |maintenance\_type|integer|Tipus de manteniment.<br><br>Valors possibles:<br>0 - *(per defecte)* amb recollida de dades;<br>1 - sense recollida de dades.| |tags\_evaltype|integer|Mètode d'avaluació de l'etiqueta del problema.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Maintenance This class is designed to work with maintenances. Object references: - [Maintenance](/manual/api/reference/maintenance/object#maintenance) - [Time period](/manual/api/reference/maintenance/object#time_period) Available methods: - [maintenance.create](/manual/api/reference/maintenance/create) - creating new maintenances - [maintenance.delete](/manual/api/reference/maintenance/delete) - deleting maintenances - [maintenance.get](/manual/api/reference/maintenance/get) - retrieving maintenances - [maintenance.update](/manual/api/reference/maintenance/update) - updating maintenances # Manteniment Aquesta classe és dissenyada per treballar amb manteniements. Referències d'objectes: - [Manteniment](/manual/api/reference/maintenance/object#maintenance) - [Període](/manual/api/reference/maintenance/object#time_period) Mètodes disponibles: - [maintenance.create](/manual/api/reference/maintenance/create) - crear nous manteniments - [maintenance.delete](/manual/api/reference/maintenance/delete) - esborrar manteniments - [maintenance.get](/manual/api/reference/maintenance/get) - recuperar manteniments - [maintenance.update](/manual/api/reference/maintenance/update) - actualitzar manteniments # maintenance.update # maintenance.update ### Makefile targets Loadable plugins provided by Zabbix have simple makefiles with the following targets: |Target|Description| |--|--------| |make|Build plugin.| |make clean|Delete all files that are normally created by building the plugin.| |make check|Perform self-tests. A real PostgreSQL database is required.| |make style|Check Go code style with 'golangci-lint'.| |make format|Format Go code with 'go fmt'.| |make dist|Create an archive containing the plugin sources and sources of all packages needed to build the plugin and its self-tests.| ### Destins del Makefile Els plugins carregables proporcionats per Zabbix tenen fitxers de creació senzills amb els objectius següents: |Destí|Descripció| |--|--------| |make|Construeix el connector.| |make clean|Esborra tots els fitxers que es creen normalment en crear el connector.| |make check|Fa autoproves. Es requereix una base de dades PostgreSQL real.| |make style|Comprova l'estil del codi Go amb 'golangci-lint'.| |make format|Formata el codi Go amb 'go fmt'.| |make dist|Crea un arxiu que contingui les fonts del connector i les fonts de tots els paquets necessaris per crear el connector i les seves autoproves.| #### Makefile The Zabbix Dockerfiles repository also provides a [Makefile](https://github.com/zabbix/zabbix-docker/blob/6.0/Makefile) as a shortcut for common Docker Compose tasks. Instead of using the full `docker compose` command, you can use shorter `make` commands (run `make help` to see the available options): ```bash # Default deployment (Zabbix server, web interface, MySQL, all on Alpine Linux) make up # Custom deployment (Zabbix server, web interface with custom Nginx ports, PostgreSQL, all on Ubuntu) make up \ OS=ubuntu \ DB=pgsql \ ZABBIX_WEB_NGINX_HTTP_PORT=8282 \ ZABBIX_WEB_NGINX_HTTPS_PORT=8443 ``` ::: noteimportant When stopping or removing containers, always specify the same database type that was deployed (e.g., `make down DB=pgsql`). ::: By default, `make up` starts only a minimal set of services (Zabbix server, web interface, and database). This keeps the setup lightweight and avoids starting components that may not be needed. To include additional components, you can use the following [Compose profiles](https://docs.docker.com/compose/how-tos/profiles/): ```bash # Default deployment + Zabbix agent, Java gateway, web service, and SNMP traps: make up COMPOSE_PROFILES=full # COMPOSE_PROFILES=full + Zabbix proxy (MySQL and SQLite3): make up COMPOSE_PROFILES=all ``` #### Makefile El repositori Zabbix Dockerfiles també proporciona un [Makefile](https://github.com/zabbix/zabbix-docker/blob/6.0/Makefile) com a drecera per a tasques comunes de Docker Compose. En lloc d'utilitzar l'ordre completa 'docker compose', podeu utilitzar ordres `make` més curtes (executa `make help` per veure les opcions disponibles): ```bash # Implementació per defecte (servidor Zabbix, interfície web, MySQL, tot a Alpine Linux) make up # Implementació personalitzada (servidor Zabbix, interfície web amb ports Nginx personalitzats, PostgreSQL, tot a Ubuntu) make up \ OS=ubuntu \ DB=pgsql \ ZABBIX_WEB_NGINX_HTTP_PORT=8282 \ ZABBIX_WEB_NGINX_HTTPS_PORT=8443 ``` ::: noteimportant Quan s'aturen o s'esborren contenidors, especifiqueu sempre el mateix tipus de base de dades que s'ha desplegat (per exemple, `fer baixar DB=pgsql`). ::: Per defecte, `make up` comença només un conjunt mínim de serveis (servidor Zabbix, interfície web, i la base de dades). Això manté la configuració lleugera i evita els components d'inici que poden no ser necessaris. Per incloure components addicionals, podeu utilitzar els següents [Perfils de composició](https://docs.docker.com/compose/how-tos/profiles/): ```bash # Desplegament per defecte + Zabbix agent, Java gateway, web service, i SNMP traps: make up COMPOSE_PROFILES=full # COMPOSE_PROFILES=tot + Zabbix proxy (MySQL i SQLite3): make up COMPOSE_PROFILES=all ``` ### Managing HA cluster The current status of the HA cluster can be managed using the dedicated [runtime control](/manual/concepts/server#runtime_control) options: - `ha_status` - log HA cluster status in the Zabbix server log (and to stdout) - `ha_remove_node=target` - remove an HA node identified by its \<target\> - name or ID of the node (name/ID can be obtained from the output of running ha\_status), e.g.: ``` zabbix_server -R ha_remove_node=zabbix-node-02 ``` Note that active/standby nodes cannot be removed. - `ha_set_failover_delay=delay` - set HA failover delay (between 10 seconds and 15 minutes; time suffixes are supported, e.g. 10s, 1m) Node status can be monitored: - in *Reports* → *[System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix#high-availability-nodes)* - in the *System information* dashboard widget - using the `ha_status` runtime control option of the server (see above). The `zabbix[cluster,discovery,nodes]` internal item can be used for node discovery, as it returns a JSON with the high-availability node information. ### Getió del cluster d'alta disponibilitat (HA) L'estat actual del clúster HA es pot gestionar mitjançant les opcions dedicades [control en temps d'execució](/manual/concepts/server#runtime_control): - `ha_status`: desa l'estat del clúster HA al registre del servidor Zabbix (i a stdout) - `ha_remove_node=target` - elimina un node HA identificat pel seu \<target\> - nom o ID del node (nom/ID es poden obtindre a partir de la sortida de l'execució de ha\_status), per exemple: ``` zabbix_server -R ha_remove_node=zabbix-node-02 ``` Tingueu en compte que els nodes actius/en espera no es poden pas esborrar. - `ha_set_failover_delay=delay`: estableix l'endarreriment de la migració per error HA (entre 10 segons i 15 minuts; s'admeten sufixos de temps, per exemple, 10 s, 1 m) L'estat del node es pot controlar: - a *Informes* → *[Informació del sistema](/manual/web_interface/frontend_sections/reports/status_of_zabbix#high-availability-nodes)* - al giny del tauler *Informació del sistema* - emprant l'opció de control d'execució `ha_status` del servidor (veieu més amunt). L'element intern `zabbix[cluster,discovery,nodes]` es pot emprar per a la descoberta de nodes, ja que retorna un JSON amb informació de nodes d'alta disponibilitat. **Mandatory and optional parameters** Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional. **Usage with command-line utilities** Note that when testing or using item keys with zabbix_agentd or zabbix_get from the command line you should consider shell syntax too. For example, if a certain parameter of the key has to be enclosed in double quotes you have to explicitly escape double quotes, otherwise they will be trimmed by the shell as special characters and will not be passed to the Zabbix utility. Examples: zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]' zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0] **Paràmetres obligatoris i opcionals** Els paràmetres sense claudàtors són obligatoris. Els paràmetres entre claudàtors **<** **>** són opcionals. **S'empra amb utilitats de línia d'ordres** Tingueu en compte que quan proveu o empreu claus d'element amb zabbix_agentd o zabbix_get des de la línia d'ordres, també heu de tindre en compte la sintaxi de l'intèrpret d'ordres. Per exemple, si un determinat paràmetre clau s'ha d'incloure entre cometes dobles, heu d'escapar explícitament de les cometes dobles; en cas contrari, seran retallades per l'intèrpret d'ordres com a caràcters especials i no es passaran a la utilitat Zabbix. Exemples: zabbix_agentd -t 'vfs.dir.count[/var/log,,,"fichier,dir",,0]' zabbix_agentd -t vfs.dir.count[/var/log,,,\"fichier,dir\",,0] ##### Mandatory interface The only mandatory function is **zbx\_module\_api\_version()**: ``` {.c} int zbx_module_api_version(void); ``` This function should return the API version implemented by this module and in order for the module to be loaded this version must match module API version supported by Zabbix. Version of module API supported by Zabbix is ZBX\_MODULE\_API\_VERSION. So this function should return this constant. Old constant ZBX\_MODULE\_API\_VERSION\_ONE used for this purpose is now defined to equal ZBX\_MODULE\_API\_VERSION to preserve source compatibility, but it's usage is not recommended. ##### Interfície obligatòria L'única funció necessària és **zbx\_module\_api\_version()**: ``` {.c} int zbx_module_api_version(void); ``` Aquesta funció ha de retornar la versió del mòdul de l'API implementada per aquest mòdul i perquè el mòdul carregui aquesta versió ha de coincidir amb la versió del mòdul de l'API suportada per Zabbix. La versió del mòdul API admesa per Zabbix és ZBX\_MODULE\_API\_VERSION. Per tant, aquesta funció ha de retornar aquesta constant. L'antiga constant ZBX\_MODULES\_API\_VERSION\_ONE que s'empra per a aquest propòsit ara s'estableix igual a ZBX\_MODULE\_API\_VERSION per preservar la compatibilitat de les fonts, però aquest és un ús no recomanat. ##### Manifest preparation Each module is expected to have a manifest.json file with the following fields in JSON format: |Parameter|Required|Type|Default|Description| |---------|---|----|--|-------------------| |manifest\_version|Yes|Double|\-|Manifest version of the module. Currently supported version is **1**.| |id|Yes|String|\-|Module ID. Only one module with given ID can be enabled at the same time.| |name|Yes|String|\-|Module name as displayed in the Administration section.| |version|Yes|String|\-|Module version as displayed in the Administration section.| |namespace|Yes|String|\-|PHP namespace for Module.php and action classes.| |author|No|String|""|Module author as displayed in the Administration section.| |url|No|String|""|Module URL as displayed in the Administration section.| |description|No|String|""|Module description as displayed in the Administration section.| |actions|No|Object|{}|Actions to register with this module. See Actions.| |config|No|Object|{}|Module configuration.| For reference, please see an example of manifest.json in the [Reference](#reference) section. ##### Preparació del manifest Cada mòdul hauria de tindre un fitxer manifest.json amb els camps següents en format JSON: |Paràmetre|Obligatori|Tipus|Predeterminat|Descripció| |---------|---|----|--|-----| |manifest\_version|Sí|Doble|\-|Versió manifest del mòdul. La versió admesa actualment és **1**.| |id|Sí|String|\-|ID del mòdul. Només es pot activar un mòdul amb un identificador donat alhora.| |nom|Sí|Cadena|\-|Nom del mòdul tal com es veu a la secció Administració.| |versió|Sí|String|\-|Versió del mòdul tal com es veu a la secció Administració.| |espai de noms|Sí|Cadena|\-|Espai de noms PHP per a les classes d'acció i Module.php.| |autor|No|String|""|Autor del mòdul tal com es veu a la secció Administració.| |url|No|String|""|URL del mòdul tal com es veu a la secció Administració.| |descripció|No|String|""|Descripció del mòdul tal com es veu a la secció Administració.| |accions|No|Objecte|{}|Accions per registrar-se en aquest mòdul. Veieu Accions.| |configuració|No|Objecte|{}|Configuració del mòdul.| Per a referència, consulteu un exemple de manifest.json a la secció [Referència](#reference). ##### Manual mode When [configuring a host](/manual/config/hosts/host), in the *Inventory* tab you can enter such details as the type of device, serial number, location, responsible person, etc., - the data that will populate inventory information. If a URL is included in the host inventory information and it starts with 'http' or 'https', it will result in a clickable link in the *Inventory* section. ##### Mode manual Quan [configurem un equip](/manual/config/hosts/host), a la pestanya *Inventari*, podem entrar informació com el tipus de perifèric, el nombre de sèrie, ubicació, persona responsable, etc... - les dades que ompliran la informació de l'inventari. Si una URL s'inclou a la informació de l'inventari d'equip i comença per `http` o `https`, apareixerà un enllaç clicable a la secció *Inventari*. # map.create # map.create # map.delete # map.delete #### Map element Host group The map element Host group object defines one host group element. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|Host group ID| #### Element de mapa grup d'equips L'objecte element de mapa de grups d'equips defineix un o més elements de grups d'equips. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|string|ID del grup d'equips.| #### Map element Host The map element Host object defines one host element. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|Host ID| #### Element de mapa Equip L'objecte element de mapa d'equips defineix un o més elements d'equips. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|ID del grup d'equips.| #### Map element Map The map element Map object defines one map element. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|Map ID| #### Element de mapa Mapa L'objecte element de mapa Mapa defineix un o més elements de Mapes. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapid|string|ID del mapa.| #### Map element tag The map element tag object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Map element tag name.| |operator|integer|Map element tag condition operator.<br><br>Possible values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.| |value|string|Map element tag value.| #### Element del mapa Etiqueta L'objecte d'element de mapa Etiqueta té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|cadena|Nom d'etiqueta de l'element del mapa.| |operator|enter|Operador de condició d'etiqueta d'element de mapa.<br><br>Valors possibles :<br>0 - *(per defecte)* Conté;<br>1 - Iguals;<br>2 - No en conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.| |value|cadena|Valor d'etiqueta d'element de mapa.| ### Map element The map element object defines an object displayed on a map. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |selementid|string|*(readonly)* ID of the map element.| |**elements**<br>(required)|array|Element data object. Required for host, host group, trigger and map type elements.| |**elementtype**<br>(required)|integer|Type of map element.<br><br>Possible values:<br>0 - host;<br>1 - map;<br>2 - trigger;<br>3 - host group;<br>4 - image.| |**iconid\_off**<br>(required)|string|ID of the image used to display the element in default state.| |areatype|integer|How separate host group hosts should be displayed.<br><br>Possible values:<br>0 - *(default)* the host group element will take up the whole map;<br>1 - the host group element will have a fixed size.| |elementsubtype|integer|How a host group element should be displayed on a map.<br><br>Possible values:<br>0 - *(default)* display the host group as a single element;<br>1 - display each host in the group separately.| |evaltype|integer|Map element tag filtering condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>2 - OR.| |height|integer|Height of the fixed size host group element in pixels.<br><br>Default: 200.| |iconid\_disabled|string|ID of the image used to display disabled map elements. Unused for image elements.| |iconid\_maintenance|string|ID of the image used to display map elements in maintenance. Unused for image elements.| |iconid\_on|string|ID of the image used to display map elements with problems. Unused for image elements.| |label|string|Label of the element.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>-1 - *(default)* default location;<br>0 - bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|*(readonly)* ID of the map that the element belongs to.| |urls|array|Map element URLs.<br><br>The map element URL object is [described in detail below](object#map_element_url).| |use\_iconmap|integer|Whether icon mapping must be used for host elements.<br><br>Possible values:<br>0 - do not use icon mapping;<br>1 - *(default)* use icon mapping.| |viewtype|integer|Host group element placing algorithm.<br><br>Possible values:<br>0 - *(default)* grid.| |width|integer|Width of the fixed size host group element in pixels.<br><br>Default: 200.| |x|integer|X-coordinates of the element in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the element in pixels.<br><br>Default: 0.| ### Element de mapa L'objecte d'element del mapa defineix un objecte que es mostra en un mapa. Té les següents propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |selementid|string|*(només lectura)* ID de l'element del mapa.| |**elements**<br>(obligatori)|array|Objecte de dades de l'element. Necessari per a elements d'equip, grup d'equips, trigger i tipus de mapa.| |**elementtype**<br>(obligatori)|integer|Tipus d'element del mapa.<br><br>Valors possibles:<br>0 - equip;<br>1 - mapa;<br>2 - trigger;< br>3 - grup d'equips;<br>4 - imatge.| |**iconid\_off**<br>(obligatori)|string|ID de la imatge emprada per ensenyar l'element en estat predeterminat.| |areatype|integer|Com s'han d'ensenyar diferents equips del grup d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* l'element del grup d'equips ocuparà tot el mapa;<br>1 - l'element del grup d'equips tindrà una mida fixa.| |elementsubtype|integer|Com s'ha d'ensenyar un element del grup d'equips al mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* mostra el grup d'equips com a element únic;<br>1 - mostra cada equip al grup per separat.| |evaltype|integer|Mètode per avaluar les condicions del filtre d'etiquetes d'elements del mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.| |height|integer|Alçada de l'element del grup d'equips de mida fixa en píxels.<br><br>Per defecte: 200.| |iconid\_disabled|string|ID de la icona emprada per ensenyar els elements del mapa desactivats. No s'empra per a elements de tipus d'imatge.| |iconid\_maintenance|string|Identificador de la icona que s'empra per ensenyar els elements del mapa en manteniment. No s'empra per a elements de tipus d'imatge.| |iconid\_on|string|Identificador de la icona que s'empra per ensenyar els elements del mapa amb problemes. No s'empra per a elements de tipus d'imatge.| |label|string|Etiqueta de l'element.| |label\_location|integer|Posició de l'etiqueta de l'element del mapa.<br><br>Valors possibles:<br>-1 - *(per defecte)* posició per defecte;<br>0 - sota;<br>1 - esquerra;<br>2 - dreta;<br>3 - dalt.| |permission|integer|Tipus de nivell de permís.<br><br>Valors possibles:<br>-1 - cap;<br>2 - només lectura;<br>3 - lectura-escriptura.| |sysmapid|string|*(només lectura)* ID del mapa al qual pertany l'element.| |urls|array|elements del mapa d'URL.<br><br>L'objecte de l'element del mapa d'URL és [descrit en detall a continuació](object#map_element_url).| |use\_iconmap|integer|Indica si s'ha d'emprar l'assignació d'icones per als elements de l'equip.<br><br>Valors possibles:<br>0 - no empreu pas l'assignació d'icones;<br>1 - *(per defecte)* empreu la icona cartografia.| |viewtype|integer|Algorisme d'ubicació d'elements del grup d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* quadrícula.| |width|integer|Amplada de l'element del grup d'equips de mida fixa en píxels.<br><br>Per defecte: 200.| |x|integer|Coordenada X de l'element en píxels.<br><br>Per defecte: 0.| |y|integer|Coordenada Y de l'element en píxels.<br><br>Per defecte: 0.| #### Map element Trigger The map element Trigger object defines one or more trigger elements. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |triggerid|string|Trigger ID| #### Element de mapa Trigger L'objecte element de mapa Trigger defineix un o més triggers d'elements. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |triggerid|string|ID del trigger.| #### Map element URL The map element URL object defines a clickable link that will be available for a specific map element. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapelementurlid|string|*(readonly)* ID of the map element URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |selementid|string|ID of the map element that the URL belongs to.| #### Element de mapa URL L'objecte element de mapa URL defineix un enllaç clicable que serà disponible per a un element de mapa concret. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapelementurlid|string|*(només lectura)* ID de l'element de mapa URL.| |**name**<br>(obligatori)|string|Llegenda d'enllaç.| |**url**<br>(obligatori)|string|URL de l'enllaç.| |selementid|string|ID de l'element de mapa on pertany l'URL.| # map.get # map.get #### Map lines Create a map line. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map API lines", "width": 500, "height": 500, "lines": [ { "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "11" ] }, "id": 1 } ``` #### Línies de mapes Crear una línia de mapa. Petició: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map API lines", "width": 500, "height": 500, "lines": [ { "x1": 30, "y1": 10, "x2": 100, "y2": 50, "line_type": 1, "line_width": 10, "line_color": "009900" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "11" ] }, "id": 1 } ``` ### Map lines The map line object defines a line displayed on a map. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |x1|integer|X-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |y1|integer|Y-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |x2|integer|X-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |y2|integer|Y-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |line\_type|integer|Type of the lines.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |line\_width|integer|Width of the lines in pixels.<br><br>Default: 0.| |line\_color|string|Line color.<br><br>Default: '000000'.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.| ### Línies de mapes L'objecte defineix una línia que es mostra en un mapa. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmap\_shapeid|string|*(només lectura)* ID de la forma del mapa.| |x1|integer|Coordenada X del punt 1 de la línia en píxels.<br><br>Per defecte: 0.| |y1|integer|Coordenada Y del punt 1 de la línia en píxels.<br><br>Per defecte: 0.| |x2|integer|Coordenada X del punt 2 de la línia en píxels.<br><br>Per defecte: 200.| |y2|integer|Coordenada Y del punt 2 de la línia en píxels.<br><br>Per defecte: 200.| |line\_type|integer|Tipus de línia.<br><br>Valors possibles:<br>0 - cap;<br>1 - `—————`;<br>2 - `···· · `;<br>3 - `- - -`.<br><br>Per defecte: 0.| |line\_width|integer|Amplada de línia en píxels.<br><br>Per defecte: 0.| |line\_color|string|Color de línia.<br><br>Per defecte: '000000'.| |zindex|integer|Valor emprat per ordenar totes les formes i línies (índex z).<br><br>Per defecte: 0.| ### Map link The map link object defines a link between two map elements. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |linkid|string|*(readonly)* ID of the map link.| |**selementid1**<br>(required)|string|ID of the first map element linked on one end.| |**selementid2**<br>(required)|string|ID of the first map element linked on the other end.| |color|string|Line color as a hexadecimal color code.<br><br>Default: `000000`.| |drawtype|integer|Link line draw style.<br><br>Possible values:<br>0 - *(default)* line;<br>2 - bold line;<br>3 - dotted line;<br>4 - dashed line.| |label|string|Link label.| |linktriggers|array|Map link triggers to use as link status indicators.<br><br>The map link trigger object is [described in detail below](object#map_link_trigger).| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|ID of the map the link belongs to.| ### Enllaç de mapa L'objecte d'enllaç al mapa defineix un enllaç entre dos elements del mapa. Té les següents propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |linkid|string|*(només ectura)* ID de l'enllaç del mapa.| |**selementid1**<br>(obligatori)|string|ID del primer element del mapa enllaçat al final.| |**selementid2**<br>(obligatori)|string|ID del primer element del mapa enllaçat a l'altre extrem.| |color|string|Color de línia com a codi de color hexadecimal.<br><br>Per defecte: `000000`.| |drawtype|integer|Estil de línia d'enllaç.<br><br>Valors possibles:<br>0 - *(per defecte)* línia;<br>2 - línia en negreta;<br>3 - línia de punts; <br>4 - línia amb guions.| |label|string|Etiqueta d'enllaç.| |linktriggers|array|L'enllaç del mapa s'activa per emprar-lo com a indicadors d'estat de l'enllaç.<br><br>L'objecte trigger de l'enllaç del mapa és [descrit en detall a continuació](objecte#map_link_trigger). | |permission|integer|Tipus de nivell de permís.<br><br>Valors possibles:<br>-1 - cap;<br>2 - només lectura;<br>3 - lectura-escriptura.| |sysmapid|string|ID del mapa al qual pertany l'enllaç.| #### Map link trigger The map link trigger object defines a map link status indicator based on the state of a trigger. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |linktriggerid|string|*(readonly)* ID of the map link trigger.| |**triggerid**<br>(required)|string|ID of the trigger used as a link indicator.| |color|string|Indicator color as a hexadecimal color code.<br><br>Default: `DD0000`.| |drawtype|integer|Indicator draw style.<br><br>Possible values:<br>0 - *(default)* line;<br>2 - bold line;<br>3 - dotted line;<br>4 - dashed line.| |linkid|string|ID of the map link that the link trigger belongs to.| #### Trigger d'enllaç de mapa L'objecte estableix un indicador d'estat d'enllaç de mapa en funció de l'estat d'un trigger. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |linktriggerid|string|*(només lectura)* ID del trigger de l'enllaç del mapa.| |**triggerid**<br>(obligatori)|string|ID del trigger emprat com a indicador d'enllaç.| |color|string|Color de l'indicador com a codi de color hexadecimal.<br><br>Per defecte: `DD0000`.| |tipus de dibuix|integer|Estil de dibuix de l'indicador.<br><br>Valors possibles:<br>0 - *(per defecte)* línia;<br>2 - línia en negreta;<br>3 - línia puntejada;<br>4 - línia amb guions.| |linkid|string|ID de l'enllaç del mapa al qual pertany el trigger de l'enllaç.| #### Map listing {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the map. Click on the name to [view](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) the map.| |*Width*|Map width is displayed.| |*Height*|Map height is displayed.| |*Actions*|Two actions are available:<br>**Properties** - edit general map [properties](/manual/config/visualization/maps/map#creating_a_map)<br>**Constructor** - access the grid for adding [map elements](/manual/config/visualization/maps/map#adding_elements)| To [configure](/manual/config/visualization/maps/map#creating_a_map) a new map, click on the *Create map* button in the top right-hand corner. To import a map from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. The user who imports the map will be set as its owner. Two buttons below the list offer some mass-editing options: - *Export* - export the maps to a YAML, XML, or JSON file - *Delete* - delete the maps To use these options, mark the checkboxes before the respective maps, then click on the required button. #### Llistat de mapes {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom de la tarja. Feu clic al nom per [veure](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) el mapa.| |*Amplada*|Es mostra l'amplada del mapa.| |*Alçada*|Es mostra l'alçada del mapa.| |*Accions*|Hi ha dues accions disponibles:<br>**Propietats** - modificar les [propietats](/manual/config/visualization/maps/map#creating_a_map) generals del mapa<br>**Constructor** - quadrícula d'accés per afegir [elements del mapa](/manual/config/visualization/maps/map#adding_elements)| Per [configurar](/manual/config/visualization/maps/map#creating_a_map) un mapa nou, feu clic al botó *Crear un mapa* a la cantonada superior dreta. Per importar un mapa des d'un fitxer YAML, XML o JSON, feu clic al botó *Importar* a l'extrem superior dret. L'usuari que importa el mapa s'establirà com a propietari. Dos botons a sota de la llista ofereixen opcions d'edició massiva: - *Exportar* - exporta mapes a un fitxer YAML, XML o JSON - *Esborrar* - esborra targes Per emprar aquestes opcions, marqueu les caselles davant de les targes respectives i feu clic al botó requerit. # Map object The following objects are directly related to the `map` API. # Objecte mapa Els següents objectes són relacionats amb l'API `map`. ##### Mapping LLD macros Next you have to go to the LLD macros tab and make the following mappings: {#VOLUME}=$.labels['volume'] {#METRIC}=$['name'] {#HELP}=$['help'] ##### Mapatge de les macros LLD Llavors, hem d'anar a la pestanya de Macros LLD i fer aquests mapatges: {#VOLUME}=$.labels['volume'] {#METRIC}=$['name'] {#HELP}=$['help'] #### Maps Configure maps to create detailed dynamic representations of your IT infrastructure. [Map API](/manual/api/reference/map) #### Mapes Configurar mapes per crear representacions dinàmiques de la infraestructura informàtica. [API Mapes](/manual/api/reference/map) #### Map shapes Create a map with map name title. Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "shapes": [ { "type": 0, "x": 0, "y": 0, "width": 600, "height": 11, "text": "{MAP.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` #### Formes de mapa Crear un mapa amb un títol. Petició: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Host map", "width": 600, "height": 600, "shapes": [ { "type": 0, "x": 0, "y": 0, "width": 600, "height": 11, "text": "{MAP.NAME}" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "10" ] }, "id": 1 } ``` ### Map shapes The map shape object defines a geometric shape (with or without text) displayed on a map. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |**type** (required)|integer|Type of map shape element.<br><br>Possible values:<br>0 - rectangle;<br>1 - ellipse.<br><br>Property is required when new shapes are created.| |x|integer|X-coordinates of the shape in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the shape in pixels.<br><br>Default: 0.| |width|integer|Width of the shape in pixels.<br><br>Default: 200.| |height|integer|Height of the shape in pixels.<br><br>Default: 200.| |text|string|Text of the shape.| |font|integer|Font of the text within shape.<br><br>Possible values:<br>0 - Georgia, serif<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif<br>2 - "Times New Roman", Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - "Arial Black", Gadget, sans-serif<br>5 - "Comic Sans MS", cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - "Lucida Sans Unicode", "Lucida Grande", sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - "Trebuchet MS", Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - "Courier New", Courier, monospace<br>12 - "Lucida Console", Monaco, monospace<br><br>Default: 9.| |font\_size|integer|Font size in pixels.<br><br>Default: 11.| |font\_color|string|Font color.<br><br>Default: '000000'.| |text\_halign|integer|Horizontal alignment of text.<br><br>Possible values:<br>0 - center;<br>1 - left;<br>2 - right.<br><br>Default: 0.| |text\_valign|integer|Vertical alignment of text.<br><br>Possible values:<br>0 - middle;<br>1 - top;<br>2 - bottom.<br><br>Default: 0.| |border\_type|integer|Type of the border.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |border\_width|integer|Width of the border in pixels.<br><br>Default: 0.| |border\_color|string|Border color.<br><br>Default: '000000'.| |background\_color|string|Background color (fill color).<br><br>Default: `(empty)`.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.| ### Formes del mapa L'objecte defineix una forma geomètrica (amb text o sense) que s'ensenya a un mapa. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmap\_shapeid|string|*(només lectura)* ID de la forma del mapa.| |**tipus** (obligatori)|integer|Tipus de la forma del mapa.<br><br>Valors possibles:<br>0 - rectangle;<br>1 - el·lipse.<br><br>Aquesta propietat és necessària quan es creen noves formes.| |x|integer|Coordenada X de la forma en píxels.<br><br>Per defecte: 0.| |y|integer|Coordenada Y de la forma en píxels.<br><br>Per defecte: 0.| |width|integer|Amplada de la forma en píxels.<br><br>Per defecte: 200.| |height|integer|Alçada de la forma en píxels.<br><br>Per defecte: 200.| |text|string|Formulari de text.| |font|integer|Tipus de lletra del text en forma.<br><br>Valors possibles:<br>0 - Geòrgia, serif<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif<br> 2 - "Times New Roman", Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - "Arial Black", Gadget, sans-serif<br>5 - "Comic Sans MS", cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Ginebra, sans-serif<br> 9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Ginebra, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Mònaco, monospace <br><br>Per defecte: 9.| |font\_size|integer|Mida del tipus de lletra en píxels.<br><br>Per defecte: 11.| |font\_color|string|color de la font.<br><br>Per defecte: '000000'.| |text\_halign|integer|Alineació de text horitzontal.<br><br>Valors possibles:<br>0 - centre;<br>1 - esquerra;<br>2 - dreta.<br><br>Per defecte: 0 .| |text\_valign|integer|Alineació vertical del text<br><br>Valors possibles:<br>0 - mig;<br>1 - superior;<br>2 - inferior.<br><br>Per defecte: 0. | |border\_type|integer|Tipus de vora.<br><br>Valors possibles:<br>0 - cap;<br>1 - `—————`;<br>2 - `···· · ` ;<br>3 - `- - -`.<br><br>Per defecte: 0.| |border\_width|integer|Amplada de la vora en píxels.<br><br>Per defecte: 0.| |border\_color|string|Color de la vora.<br><br>Per defecte: '000000'.| |background\_color|cadena|Color de fons (color de farcit).<br><br>Per defecte: `(buida)`.| |zindex|integer|Valor emprat per ordenar totes les formes i línies (índex z).<br><br>Per defecte: 0.| #### Map sharing Create a map with two types of sharing (user and user group). Request: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map sharing", "width": 600, "height": 600, "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` #### compartir un mapa Crear un mapa amb dos tipus de compartició (usuari i grup d'usuaris). Petició: ```json { "jsonrpc": "2.0", "method": "map.create", "params": { "name": "Map sharing", "width": 600, "height": 600, "users": [ { "userid": "4", "permission": "3" } ], "userGroups": [ { "usrgrpid": "7", "permission": "2" } ] }, "auth": "038e1d7b1735c6a5436ee9eae095879e", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": { "sysmapids": [ "9" ] }, "id": 1 } ``` ### Map The map object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|*(readonly)* ID of the map.| |**height**<br>(required)|integer|Height of the map in pixels.| |**name**<br>(required)|string|Name of the map.| |**width**<br>(required)|integer|Width of the map in pixels.| |backgroundid|string|ID of the image used as the background for the map.| |expand\_macros|integer|Whether to expand macros in labels when configuring the map.<br><br>Possible values:<br>0 - *(default)* do not expand macros;<br>1 - expand macros.| |expandproblem|integer|Whether the problem trigger will be displayed for elements with a single problem.<br><br>Possible values:<br>0 - always display the number of problems;<br>1 - *(default)* display the problem trigger if there's only one problem.| |grid\_align|integer|Whether to enable grid aligning.<br><br>Possible values:<br>0 - disable grid aligning;<br>1 - *(default)* enable grid aligning.| |grid\_show|integer|Whether to show the grid on the map.<br><br>Possible values:<br>0 - do not show the grid;<br>1 - *(default)* show the grid.| |grid\_size|integer|Size of the map grid in pixels.<br><br>Supported values: 20, 40, 50, 75 and 100.<br><br>Default: 50.| |highlight|integer|Whether icon highlighting is enabled.<br><br>Possible values:<br>0 - highlighting disabled;<br>1 - *(default)* highlighting enabled.| |iconmapid|string|ID of the icon map used on the map.| |label\_format|integer|Whether to enable advanced labels.<br><br>Possible values:<br>0 - *(default)* disable advanced labels;<br>1 - enable advanced labels.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>0 - *(default)* bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |label\_string\_host|string|Custom label for host elements.<br><br>Required for maps with custom host label type.| |label\_string\_hostgroup|string|Custom label for host group elements.<br><br>Required for maps with custom host group label type.| |label\_string\_image|string|Custom label for image elements.<br><br>Required for maps with custom image label type.| |label\_string\_map|string|Custom label for map elements.<br><br>Required for maps with custom map label type.| |label\_string\_trigger|string|Custom label for trigger elements.<br><br>Required for maps with custom trigger label type.| |label\_type|integer|Map element label type.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing.| |label\_type\_host|integer|Label type for host elements.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_hostgroup|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_image|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>4 - nothing;<br>5 - custom.| |label\_type\_map|integer|Label type for map elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_trigger|integer|Label type for trigger elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |markelements|integer|Whether to highlight map elements that have recently changed their status.<br><br>Possible values:<br>0 - *(default)* do not highlight elements;<br>1 - highlight elements.| |severity\_min|integer|Minimum severity of the triggers that will be displayed on the map.<br><br>Refer to the [trigger "severity" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.| |show\_unack|integer|How problems should be displayed.<br><br>Possible values:<br>0 - *(default)* display the count of all problems;<br>1 - display only the count of unacknowledged problems;<br>2 - display the count of acknowledged and unacknowledged problems separately.| |userid|string|Map owner user ID.| |private|integer|Type of map sharing.<br><br>Possible values:<br>0 - public map;<br>1 - *(default)* private map.| |show\_suppressed|integer|Whether suppressed problems are shown.<br><br>Possible values:<br>0 - *(default)* hide suppressed problems;<br>1 - show suppressed problems.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Mapa L'objecte mapa té les següents propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapid|string|*(només lectura)* ID del mapa.| |**height**<br>(obligatori)|integer|Alçada del mapa en píxels.| |**name**<br>(obligatori)|string|Nom de la tarja.| |**width**<br>(obligatori)|integer|Amplada del mapa en píxels.| |backgroundid|string|ID de la imatge emprada com a fons del mapa.| |expand\_macros|integer|Indica si s'han d'ampliar les macros a les etiquetes quan es configura el mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* no s'amplien; <br>1 - ampliar macros.| |expandproblem|integer|Indica si el trigger del problema es mostrarà per als elements amb un sol problema.<br><br>Valors possibles:<br>0 - sempre mostra el nombre de problemes;<br>1 - *(per defecte) * mostra el trigger del problema si només hi ha un problema.| |grid\_align|integer|Indica si s'ha d'activar l'alineació de la quadrícula.<br><br>Valors possibles:<br>0 - desactiva l'alineació de la quadrícula;<br>1 - *(per defecte)* activa l'encaix a la quadrícula.| |grid\_show|integer|Indica si s'ha de veure la graella al mapa.<br><br>Valors possibles:<br>0 - no mostra la graella;<br>1 - *(per defecte)* mostra la graella .| |grid\_size|integer|Mida de la quadrícula del mapa en píxels.<br><br>Valors admesos: 20, 40, 50, 75 i 100.<br><br>Per defecte: 50.| |highlight|integer|Indica si el ressaltat de les icones és habilitat.<br><br>Valors possibles:<br>0 - ressaltat desactivat;<br>1 - *(per defecte)* ressaltat activat.| |iconmapid|string|ID del mapa d'icones emprat al mapa.| |label\_format|integer|Indica si s'han d'activar les etiquetes avançades.<br><br>Valors possibles:<br>0 - *(per defecte)* desactiva les etiquetes avançades;<br>1 - activa-les.| |label\_location|integer|Ubicació de l'etiqueta de l'element del mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* inferior;<br>1 - esquerra;<br >2 - dreta;< br>3 - a dalt.| |label\_string\_host|string|Etiqueta personalitzada per als elements d'equip.<br><br>Requerit per als mapes amb tipus d'etiqueta d'equip personalitzat.| |label\_string\_hostgroup|string|Etiqueta personalitzada per als elements del grup d'equips.<br><br>Requerit per als mapes amb tipus d'etiqueta de grup d'equips personalitzat.| |label\_string\_image|string|Etiqueta personalitzada per als elements d'imatge.<br><br>Requerit per als mapes amb tipus d'etiqueta d'imatge personalitzada.| |label\_string\_map|string|Etiqueta personalitzada per als elements del mapa.<br><br>Requerit per als mapes amb tipus d'etiqueta de mapa personalitzat.| |label\_string\_trigger|string|Etiqueta personalitzada per als elements trigger.<br><br>Obligatori per a targetes amb tipus d'etiqueta trigger personalitzat.| |label\_type|integer|Tipus d'etiqueta d'element del mapa.<br><br>Valors possibles:<br>0 - etiqueta;<br>1 - adreça IP;<br>2 - *(per defecte)* nom de l'element;< br>3 - només estat;<br>4 - res.| |label\_type\_host|integer|Tipus d'etiqueta per als elements de l'equip.<br><br>Valors possibles:<br>0 - etiqueta;<br>1 - adreça IP;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |label\_type\_hostgroup|integer|Tipus d'etiqueta per als elements del grup d'equips.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |label\_type\_image|integer|Tipus d'etiqueta per als elements de la imatge.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>4 - res;<br>5 - personalitzat.| |label\_type\_map|integer|Tipus d'etiqueta per als elements del mapa.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |label\_type\_trigger|integer|Tipus d'etiqueta per als triggers.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |markelements|integer|Indica si cal ressaltar els elements del mapa que han canviat d'estat recentment.<br><br>Valors possibles:<br>0 - *(per defecte)* no ressalten els elements;<br>1 - ressalten els elements.| |severity\_min|integer|Gravetat mínima dels triggers que es mostraran al mapa.<br><br>Consulteu la [propietat "gravetat" d'un trigger](/manual/api/reference/trigger/object# trigger ) per obtindre un llistat de les gravetats admeses.| |show\_unack|integer|Com s'han de veure els problemes.<br><br>Valors possibles:<br>0 - *(per defecte)* ensenya el recompte de tots els problemes;<br>1 - ensenya només el nombre de problemes no reconeguts;<br>2 - ensenya el nombre de problemes reconeguts i no reconeguts per separat.| |userid|string|identificador de l'usuari propietari del mapa.| |private|integer|Tipus de compartició del mapa.<br><br>Valors possibles:<br>0 - mapa públic;<br>1 - *(per defecte)* mapa privat.| |show\_suppressed|integer|Indica si es mostren els problemes suprimits.<br><br>Valors possibles:<br>0 - *(per defecte)* amaga els problemes suprimits;<br>1 - ensenya els problemes suprimits.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Map This class is designed to work with maps. Object references: - [Map](/manual/api/reference/map/object#map) - [Map element](/manual/api/reference/map/object#map_element) - [Map link](/manual/api/reference/map/object#map_link) - [Map URL](/manual/api/reference/map/object#map_url) - [Map user](/manual/api/reference/map/object#map_user) - [Map user group](/manual/api/reference/map/object#map_user_group) - [Map shape](/manual/api/reference/map/object#map_shapes) - [Map line](/manual/api/reference/map/object#map_lines) Available methods: - [map.create](/manual/api/reference/map/create) - create new maps - [map.delete](/manual/api/reference/map/delete) - delete maps - [map.get](/manual/api/reference/map/get) - retrieve maps - [map.update](/manual/api/reference/map/update) - update maps # Mapa Aquesta classe és dissenyada per treballar amb mapes. Referències d'objectes: - [Mapa](/manual/api/reference/map/object#map) - [Element de mapa](/manual/api/reference/map/object#map_element) - [Enllaç de mapa](/manual/api/reference/map/object#map_link) - [URL del mapa](/manual/api/reference/map/object#map_url) - [Usuari del mapa](/manual/api/reference/map/object#map_user) - [Grup d'usuaris del mapa](/manual/api/reference/map/object#map_user_group) - [Forma de mapa](/manual/api/reference/map/object#map_shapes) - [Línia de mapa](/manual/api/reference/map/object#map_lines) Mètodes disponibles: - [map.create](/manual/api/reference/map/create) - crear nous mapes - [map.delete](/manual/api/reference/map/delete) - esborrar mapes - [map.get](/manual/api/reference/map/get) - recuperar mapes - [map.update](/manual/api/reference/map/update) - actualitzar mapes # map.update # map.update ### Map URL The map URL object defines a clickable link that will be available for all elements of a specific type on the map. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapurlid|string|*(readonly)* ID of the map URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |elementtype|integer|Type of map element for which the URL will be available.<br><br>Refer to the [map element "type" property](object#map_element) for a list of supported types.<br><br>Default: 0.| |sysmapid|string|ID of the map that the URL belongs to.| ### URL de mapa L'objecte defineix un enllaç on es pot fer clic que serà disponible per a tots els elements d'un tipus específic del mapa. Té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapurlid|string|*(només lectura)* ID de l'URL del mapa.| |**name**<br>(obligatori)|string|Títol de l'enllaç.| |**url**<br>(obligatori)|string|URL de l'enllaç.| |elementtype|integer|Tipus d'element de mapa per al qual l'URL serà disponible.<br><br>Consulteu [la propietat "elementtype" de l'element de mapa](object#map_element) per obtindre un llistat dels tipus admesos.<br> <br>Per defecte: 0.| |sysmapid|string|ID del mapa al qual pertany l'URL.| ### Map user group List of map permissions based on user groups. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapusrgrpid|string|*(readonly)* ID of the map user group.| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Grup d'usuaris del mapa Llista dels permisos del mapa en funció del grup d'usuaris. L'objecte té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapusergrpid|string|*(només lectura)* ID del grup d'usuaris del mapa.| |**usergrpid**<br>(obligatori)|string|ID del grup d'usuaris.| |**permission**<br>(obligatori)|integer|Nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;| ### Map user List of map permissions based on users. It has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapuserid|string|*(readonly)* ID of the map user.| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;| ### Usuari de mapa Llista dels permisos del mapa en funció dels usuaris. L'objecte té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapuserid|string|*(només lectura)* ID del mapa d'usuari.| |**userid**<br>(obligatori)|string|ID d'usuari.| |**permission**<br>(obligatori)|integer|Nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;| ### MariaDB 10.10 support The maximum supported version for MariaDB is now 10.10.X. ### Suport de la versió 10.10 de MariaDB La versió més alta suportada de MariaDB és ara la 10.10.X. ### MariaDB 10.11 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 10.11.X. ### Suport de MariaDB 10.11 La [versió més nova suportada](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 10.11.X. ### MariaDB 10.7 support The maximum supported version for MariaDB is now 10.7.X. ### Suport de la versió 10.7 de MariaDB La versió més alta suportada de MariaDB és ara la 10.7.X. ### MariaDB 10.8 support The maximum supported version for MariaDB is now 10.8.X. ### Suport de la versió 10.8 de MariaDB La versió més alta suportada de MariaDB és ara la 10.8.X. #### MariaDB 11.0 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.0.X. #### Suport de MariaDB 11.10 La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 11.0.X. #### MariaDB 11.2 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.2.X. #### Suport de MariaDB 11.2 La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 11.2.X. #### MariaDB 11.3 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.3.X. #### Suport de MariaDB 11.3 La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 11.3.X. #### MariaDB 11.4 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.4.X. #### Suport de MariaDB 11.4 La [versió més nova admesa](/manual/installation/requirements#third-party-external-surrounding-software) per MariaDB és la 11.4.X. #### MariaDB 11.5 support The maximum [supported version](/manual/installation/requirements#database-management-system) for MariaDB is now 11.5.X. #### Suport de MariaDB 11.5 La [versió més nova admesa](/manual/installation/requirements#database-management-system) per MariaDB és la 11.5.X. #### MariaDB 12.0 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 12.0.X. #### Suport de MariaDB 12.0 La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 12.0.X. #### MariaDB 12.2 support The maximum [supported version](/manual/installation/requirements#required-software) for MariaDB is now 12.2.X. #### Suport de MariaDB 12.2 La [versió més nova admesa]](/manual/installation/requirements#required-software) per MariaDB és la 12.2.X. #### MariaDB 12.3 support The maximum [supported version](/manual/installation/requirements#required-software) for MariaDB is now 12.3.X. #### Suport de MariaDB 12.3 La [versió més nova admesa]](/manual/installation/requirements#required-software) per MariaDB és la 12.3.X. #### MariaDB/MySQL 8.0+ without mysqlsh This upgrade method takes more time and should be used only if an upgrade with *mysqlsh* is not possible. ##### Table upgrade * Log in to MySQL console as root (recommended) or any user with FILE privileges. * If performing migration with a running Zabbix server, start MySQL with the [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) variable enabled. * Rename old tables and create new tables by running `history_pk_prepare.sql`: ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` ##### Migration with stopped server *max_execution_time* must be disabled before migrating data to avoid timeout during migration. ``` {.sql} SET @@max_execution_time=0; INSERT IGNORE INTO history SELECT * FROM history_old; INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old; INSERT IGNORE INTO history_str SELECT * FROM history_str_old; INSERT IGNORE INTO history_log SELECT * FROM history_log_old; INSERT IGNORE INTO history_text SELECT * FROM history_text_old; ``` Follow [post-migration instructions](#post-migration) to drop the old tables. ##### Migration with running server Check for which paths import/export is enabled: ``` {.sql} mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ``` If *secure_file_priv* value is a path to a directory, export/import will be performed for files in that directory. In this case, edit paths to files in queries accordingly or set the *secure_file_priv* value to an empty string for the upgrade time. If *secure_file_priv* value is empty, export/import can be performed from any location. If *secure_file_priv* value is NULL, set it to the path that contains exported table data ('/var/lib/mysql-files/' in the example above). For more information, see [MySQL documentation](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_secure_file_priv). *max_execution_time* must be disabled before exporting data to avoid timeout during export. ``` {.sql} SET @@max_execution_time=0; SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old; LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old; LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old; LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old; LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old; LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; ``` Follow [post-migration instructions](#post-migration) to drop the old tables. #### MariaDB/MySQL 8.0+ sense mysqlsh Aquest mètode d'actualització pren més temps i s'ha d'emprar només si l'actualització amb *mysqlsh* no fos possible. ##### Actualització de la taula * Entreu a la consola de MySQL com a root (recomanat) o qualsevol altre usuari amb privilegis FILE. * Engegueu MySQL amb la variable [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) activa. * Reanomeneu les taules antigues i creeu les noves executant `history_pk_prepare.sql`: ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` ##### Migració amb el servidor aturat S'ha de deshabilitar el *max_execution_time* abans de migrar la informació, per evitar que s'esgoti el temps d'espera durant la migració. ``` {.sql} SET @@max_execution_time=0; INSERT IGNORE INTO history SELECT * FROM history_old; INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old; INSERT IGNORE INTO history_str SELECT * FROM history_str_old; INSERT IGNORE INTO history_log SELECT * FROM history_log_old; INSERT IGNORE INTO history_text SELECT * FROM history_text_old; ``` Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues. ##### Migració amb el servidor en marxa Reviseu per quines rutes import/export és activat: ``` {.sql} mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ``` Si el valor *secure_file_priv* és una ruta cap a un directori, export/import es farà per als arxius d'aquell directori. En aquest cas, editeu les rutes als arxius en consultes segons el valor *secure_file_priv* cap a una cadena buida per al temps d'actualització. Si el valor *secure_file_priv* és buit, export/import pot fer-se des de qualsevol ubicació. Si el valor *secure_file_priv* és NULL, establiu la ruta que conté la informació de la taula exportada ('/var/lib/mysql-files/' a l'exemple de més amunt). Per tindre més informació, veieu la [documentació de MySQL](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_secure_file_priv). S'ha de deshabilitar el *max_execution_time* abans d'exportar informació, per evitar que s'esgoti el temps d'espera durant la exportació. ``` {.sql} SET @@max_execution_time=0; SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old; LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old; LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old; LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old; LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old; LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; ``` Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues. ##### Mass editing options A button below the list offers one mass-editing option: - *Delete* - delete the maintenance periods To use this option, mark the checkboxes before the respective maintenance periods and click on *Delete*. ##### Opcions d'edició massiva Un botó a sota de la llista ofereix una opció d'edició massiva: - *Esborrar* - esborra els períodes de manteniment Per emprar aquesta opció, marqueu les caselles davant dels períodes de manteniment respectius i feu clic a *Esborrar*. ##### Mass editing options A button below the list offers one mass-editing option: - *Delete* - delete the scripts To use this option, mark the checkboxes before the respective scripts and click on *Delete*. ##### Opcions d'edició massiva Un botó a sota de la llista ofereix una opció d'edició massiva: - *Esborrar* - esborra scripts Per emprar aquesta opció, marqueu les caselles davant dels scripts respectius i feu clic a *Esborrar*. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Copy* - copy the graphs to other hosts or templates - *Delete* - delete the graphs To use these options, mark the checkboxes before the respective graphs, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Copiar* - copia els gràfics a altres equips o models - *Esborrar* - esborra gràfics Per emprar aquestes opcions, marqueu les caselles davant dels gràfics respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Copy* - copy the graphs to other hosts or templates - *Delete* - delete the graphs To use these options, mark the checkboxes before the respective graphs, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Copiar* - copia els gràfics a altres equips o models - *Esborrar* - esborra gràfics Per emprar aquestes opcions, marqueu les caselles davant dels gràfics respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these hosts as *Enabled* - *Create disabled* - create these hosts as *Disabled* - *Delete* - delete these host prototypes To use these options, mark the checkboxes before the respective host prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Crear activat* - crea aquests equips com a *Activat* - *Crear desactivat* - crea aquests equips com a *Desactivat* - *Esborrar* - esborra aquest prototip d'equips Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'equips respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these hosts as *Enabled* - *Create disabled* - create these hosts as *Disabled* - *Delete* - delete these host prototypes To use these options, mark the checkboxes before the respective host prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Crear activat* - crea aquests equips com a *Activat* - *Crear desactivat* - crea aquests equips com a *Desactivat* - *Esborrar* - esborra aquest prototip d'equips Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'equips respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these items as *Enabled* - *Create disabled* - create these items as *Disabled* - *Mass update* - mass update these item prototypes - *Delete* - delete these item prototypes To use these options, mark the checkboxes before the respective item prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Crear activat* - crea aquests elements com a *Activat* - *Crear desactivat* - crea aquests elements com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips d'elements - *Esborrar* - esborra aquest prototip d'elements Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'elements respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these items as *Enabled* - *Create disabled* - create these items as *Disabled* - *Mass update* - mass update these item prototypes - *Delete* - delete these item prototypes To use these options, mark the checkboxes before the respective item prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Crear activat* - crea aquests elements com a *Activat* - *Crear desactivat* - crea aquests elements com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips d'elements - *Esborrar* - esborra aquest prototip d'elements Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'elements respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these triggers as *Enabled* - *Create disabled* - create these triggers as *Disabled* - *Mass update* - mass update these trigger prototypes - *Delete* - delete these trigger prototypes To use these options, mark the checkboxes before the respective trigger prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Crear activat* - crea aquests triggers com a *Activat* - *Crear desactivat* - crea aquests triggers com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips de triggers - *Esborrar* - esborra aquest prototip de triggers Per emprar aquestes opcions, marqueu les caselles davant dels prototips de triggers respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Create enabled* - create these triggers as *Enabled* - *Create disabled* - create these triggers as *Disabled* - *Mass update* - mass update these trigger prototypes - *Delete* - delete these trigger prototypes To use these options, mark the checkboxes before the respective trigger prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Crear activat* - crea aquests triggers com a *Activat* - *Crear desactivat* - crea aquests triggers com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips de triggers - *Esborrar* - esborra aquest prototip de triggers Per emprar aquestes opcions, marqueu les caselles davant dels prototips de triggers respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Delete* - delete these graph prototypes To use these options, mark the checkboxes before the respective graph prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Esborrar*: esborra aquests prototips de gràfics Per emprar aquestes opcions, marqueu les caselles davant dels prototips de gràfics respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Delete* - delete these graph prototypes To use these options, mark the checkboxes before the respective graph prototypes, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Esborrar*: esborra aquests prototips de gràfics Per emprar aquestes opcions, marqueu les caselles davant dels prototips de gràfics respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change host status to *Monitored* - *Disable* - change host status to *Not monitored* - *Export* - export the hosts to a YAML, XML or JSON file - *Mass update* - [update several properties](/manual/config/hosts/hostupdate) for a number of hosts at once - *Delete* - delete the hosts To use these options, mark the checkboxes before the respective hosts, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat de l'equip a *Monitorat* - *Desactivar* - canvia l'estat de l'equip a *No monitorat* - *Exportar* - exporta els equips a un fitxer YAML, XML o JSON - *Actualització massiva* - [actualitza diverses propietats](/manual/config/hosts/hostupdate) per a diversos equips alhora - *Esborrar* - esborra els equips Per emprar aquestes opcions, marqueu les caselles davant dels equips respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change item status to *Enabled*. - *Disable* - change item status to *Disabled*. - *Copy* - copy the items to other hosts or templates. - *Mass update* - [update several properties](/manual/config/items/itemupdate) for a number of items at once. - *Delete* - delete the items. To use these options, mark the checkboxes before the respective items, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat de l'element a *Activat*. - *Desactivar* - canvia l'estat de l'element a *Desactivat*. - *Copiar* - copia els elements a altres equips o plantilles. - *Actualització massiva* - [actualitza diverses propietats](/manual/config/items/itemupdate) per a diversos elements alhora. - *Esborrar* - esborra els elements. Per emprar aquestes opcions, marqueu les caselles davant dels elements respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change item status to *Enabled* - *Disable* - change item status to *Disabled* - *Execute now* - execute a check for new item values immediately. Supported for **passive** checks only (see [more details](/manual/config/items/check_now)). Note that when checking for values immediately, configuration cache is not updated, thus the values will not reflect very recent changes to item configuration. - *Clear history and trends* - delete history and trend data for items. - *Copy* - copy the items to other hosts or templates. - *Mass update* - [update several properties](/manual/config/items/itemupdate) for a number of items at once. - *Delete* - delete the items. To use these options, mark the checkboxes before the respective items, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat de l'element a *Activat* - *Desactivar* - canvia l'estat de l'element a *Desactivat* - *Executar ara* - executa tot seguit una comprovació dels valors d'elements nous. Només s'admet per a comprovacions **passives** (veieu [més detalls](/manual/config/items/check_now)). Tingueu en compte que quan comproveu els valors immediatament, la memòria cau de configuració no s'actualitza, de manera que els valors no reflectiran canvis molt recents a la configuració de l'element. - *Esborrar historial i tendències* - esborra l'historial d'elements i les dades de tendències. - *Copiar* - copia elements a altres equips o plantilles. - *Actualització massiva* - [actualitza diverses propietats](/manual/config/items/itemupdate) per a diversos elements alhora. - *Esborrar* - esborra elements. Per emprar aquestes opcions, marqueu les caselles davant dels elements respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the action status to *Enabled* - *Disable* - change the action status to *Disabled* - *Delete* - delete the actions To use these options, mark the checkboxes before the respective actions, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat de l'acció a *Activat* - *Desactivar*: canvia l'estat de l'acció a *Desactivat* - *Esborrar*: esborra les accions Per emprar aquestes opcions, marqueu les caselles davant de les accions respectives i feu clic al botó necessari. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the correlation rule status to *Enabled* - *Disable* - change the correlation rule status to *Disabled* - *Delete* - delete the correlation rules To use these options, mark the checkboxes before the respective correlation rules, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat de la regla de correlació a *Activada* - *Desactivar*: canvia l'estat de la regla de correlació a *Desactivada* - *Esborrar*: esborra les regles de correlació Per emprar aquestes opcions, marqueu les caselles davant de les regles de correlació respectives i feu clic al botó necessari. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the discovery rule status to *Enabled* - *Disable* - change the discovery rule status to *Disabled* - *Delete* - delete the discovery rules To use these options, mark the checkboxes before the respective discovery rules, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat de la regla de descoberta a *Activada* - *Desactivar*: canvia l'estat de la regla de descoberta a *Desactivada* - *Esborrar*: esborra les regles de descoberta Per emprar aquestes opcions, marqueu les caselles davant de les regles de descoberta respectives i feu clic al botó necessari. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the low-level discovery rule status to *Enabled* - *Disable* - change the low-level discovery rule status to *Disabled* - *Delete* - delete the low-level discovery rules To use these options, mark the checkboxes before the respective discovery rules, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat de la regla de descoberta de baix nivell a *Activada* - *Desactivar*: canvia l'estat de la regla de descoberta de baix nivell a *Desactivada* - *Esborrar*: esborra les regles de descoberta de baix nivell Per emprar aquestes opcions, marqueu les caselles davant de les regles de descoberta respectives i feu clic al botó necessari. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the low-level discovery rule status to *Enabled*. - *Disable* - change the low-level discovery rule status to *Disabled*. - *Execute now* - perform discovery based on the discovery rules immediately. See [more details](/manual/config/items/check_now). Note that when performing discovery immediately, the configuration cache is not updated, thus the result will not reflect very recent changes to discovery rule configuration. - *Delete* - delete the low-level discovery rules. To use these options, mark the checkboxes before the respective discovery rules, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat de la regla de descoberta de baix nivell a *Activat*. - *Desactivar* - canvia l'estat de la regla de descoberta de baix nivell a *Desactivat*. - *Executar ara* - realitza immediatament la descoberta en funció de les regles de descoberta; veieu [més detalls](/manual/config/items/check_now). Tingueu en compte que quan s'executa la descoberta immediatament, la memòria cau de configuració no s'actualitza, de manera que el resultat no reflectirà els canvis molt recents a la configuració de la regla de descoberta. - *Esborrar* - esborra les regles de descoberta de baix nivell. Per emprar aquestes opcions, marqueu les caselles davant de les regles de descoberta respectives i, a continuació, feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the media type status to *Enabled* - *Disable* - change the media type status to *Disabled* - *Export* - export the media types to a YAML, XML or JSON file - *Delete* - delete the media types To use these options, mark the checkboxes before the respective media types, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat del tipus de suport a *Activat* - *Desactivar*: canvia l'estat del tipus de suport a *Desactivat* - *Exportar*: exporta els tipus de suport a un fitxer YAML, XML o JSON - *Esborrar*: esborra els tipus de suports Per emprar aquestes opcions, marqueu les caselles davant dels tipus de suports respectius i feu clic al botó necessari. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the scenario status to *Enabled* - *Disable* - change the scenario status to *Disabled* - *Clear history and trends* - clear history and trend data for the scenarios - *Delete* - delete the web scenarios To use these options, mark the checkboxes before the respective web scenarios, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat de l'escenari a *Activat* - *Desactivar* - canvia l'estat de l'escenari a *Desactivat* - *Esborrar historial i tendències* - esborra l'historial i les dades de tendències dels escenaris - *Esborrar* - esborra escenaris web Per emprar aquestes opcions, marqueu les caselles davant dels escenaris web respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the scenario status to *Enabled* - *Disable* - change the scenario status to *Disabled* - *Delete* - delete the web scenarios To use these options, mark the checkboxes before the respective web scenarios, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat de l'escenari a *Activat* - *Desactivar*: canvia l'estat de l'escenari a *Desactivat* - *Esborrar*: esborra els escenaris Per emprar aquestes opcions, marqueu les caselles davant dels escenaris web respectius i feu clic al botó necessari. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable* - change the user group status to *Enabled* - *Disable* - change the user group status to *Disabled* - *Enable debug mode* - enable debug mode for the user groups - *Disable debug mode* - disable debug mode for the user groups - *Delete* - delete the user groups To use these options, mark the checkboxes before the respective user groups, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilitar*: canvia l'estat del grup d'usuaris a *Activat* - *Desactivar*: canvia l'estat del grup d'usuaris a *Desactivat* - *Habilitar mode de depuració*: habilita el mode de depuració per als grups d'usuaris - *Deshabilitar mode de depuració*: deshabilita el mode de depuració per als grups d'usuaris - *Esborrar*: esborra els grups d'usuaris Per emprar aquestes opcions, marqueu les caselles davant dels grups d'usuaris respectius i feu clic al botó necessari. ##### 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. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat d'activació a *Activat* - *Desactivar* - canvia l'estat d'activació a *Desactivat* - *Copiar* - copia els triggers a altres equips o plantilles - *Actualització massiva* - actualitza diverses propietats per a diversos triggers alhora - *Esborrar* - esborra els triggers Per emprar aquestes opcions, marqueu les caselles davant dels triggers respectius i feu clic al botó requerit. ##### 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. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Activar* - canvia l'estat d'activació a *Activat*. - *Desactivar* - canvia l'estat d'activació a *Desactivat*. - *Copiar* - copia els triggers a altres equips o plantilles. - *Actualització massiva* - actualitza diverses propietats per a diversos triggers alhora. - *Esborrar* - esborra els triggers. Per emprar aquestes opcions, marqueu les caselles davant dels triggers respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable hosts* - change the status of all hosts in the group to "Monitored" - *Disable hosts* - change the status of all hosts in the group to "Not monitored" - *Delete* - delete the host groups To use these options, mark the checkboxes before the respective host groups, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista ofereixen opcions d'edició col·lectiva: - *Activa els equips*: canvia l'estat de tots els equips del grup a "Monitorat" - *Desactiva els equips*: canvia l'estat de tots els equips del grup a "Sense monitorar". - *Esborra* - esborra els grups d'equips Per emprar aquestes opcions, marqueu les caselles davant dels grups d'equips respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Enable hosts* - change the status of hosts monitored by the proxy to *Monitored* - *Disable hosts* - change the status of hosts monitored by the proxy to *Not monitored* - *Delete* - delete the proxies To use these options, mark the checkboxes before the respective proxies, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Habilita els equips*: canvieu l'estat dels equips monitorats pel proxy a *Monitorat* - *Desactiva els equips*: canvia l'estat dels equips monitorats pel proxy a *No monitorat* - *Esborrar* - esborra proxys Per emprar aquestes opcions, marqueu les caselles davant dels proxys respectius i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Export* - export the template to a YAML, XML or JSON file - *Mass update* - [update several properties](/manual/config/templates/mass) for a number of templates at once - *Delete* - delete the template while leaving its linked entities (items, triggers etc.) with the hosts - *Delete and clear* - delete the template and its linked entities from the hosts To use these options, mark the checkboxes before the respective templates, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Exportar* - exporta el model a un fitxer YAML, XML o JSON - *Actualització massiva* - [actualitza diverses propietats](/manual/config/templates/mass) per a diverses plantilles alhora - *Esborrar* - esborra el model deixant les seves entitats relacionades (elements, triggers, etc.) als equips - *Esborrar i netejar* - esborra el model i les entitats relacionades dels equips Per emprar aquestes opcions, marqueu les caselles davant de les plantilles respectives i feu clic al botó requerit. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Mass update* - update the selected problems by navigating to the [problem update](/manual/acknowledges#updating_problems) screen To use this option, mark the checkboxes before the respective problems, then click on the *Mass update* button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Actualització massiva* - actualitzeu els problemes triats anant a la pantalla [problemes d'actualització](/manual/acknowledges#updating_problems) Per emprar aquesta opció, marqueu les caselles davant dels problemes respectius i feu clic al botó *Actualització massiva*. ##### Mass editing options Buttons below the list offer some mass-editing options: - *Unblock* - re-enable system access to blocked users - *Delete* - delete the users To use these options, mark the check-boxes before the respective users, then click on the required button. ##### Opcions d'edició massiva Els botons de sota de la llista proporcionen opcions d'edició massiva: - *Desbloca*: torna a habilitar l'accés al sistema per als usuaris blocats - *Esborra* - esborra usuaris Per emprar aquestes opcions, marqueu les caselles davant dels respectius usuaris i feu clic al botó requerit. ##### Mass update Sometimes you may want to delete or change the status of a number of reports at once. Instead of opening each individual report for editing, you may use the mass update function for that. To mass-update some reports, do the following: - Mark the checkboxes of the reports to update in the list - Click the required button below the list to make the changes (*Enable*, *Disable*, or *Delete*) ##### Actualització massiva De vegades, és possible que vulgueu esborrar o canviar l'estat de diversos informes. En lloc d'obrir cada informe individual per editar-lo, podeu emprar la funció d'actualització massiva per a això. Per actualitzar de manera massiva determinats informes, seguiu aquestes passes: - Marqueu les caselles dels informes a actualitzar a la llista - Feu clic al botó necessari a sota de la llista per fer canvis (*Activar*, *Desactivar* o *Esborrar*). ##### Master item Create an IPMI item using the following key: ipmi.get  Set the type of information to "Text" for possibly big JSON data. ##### Element principal Creeu un element IPMI amb la clau següent: ipmi.get  Estableix el tipus d'informació a "Text" per a dades JSON possiblement grans. ##### Master item Create a Zabbix agent item using the following key: vfs.fs.get  Set the type of information to "Text" for possibly big JSON data. The data returned by this item will contain something like the following for a mounted filesystem: ``` {.java} { "fsname": "/", "fstype": "rootfs", "bytes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 }, "inodes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 } } ``` ##### Element mestre Creeu un element d'agent Zabbix amb la clau següent: vfs.fs.get  Estableix el tipus d'informació a "Text" per a dades JSON possiblement grans. Les dades que retorna aquest element contindran alguna cosa com el següent per a un sistema de fitxers muntat: ``` {.java} { "fsname": "/", "fstype": "rootfs", "bytes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 }, "inodes": { "total": 1000, "free": 500, "used": 500, "pfree": 50.00, "pused": 50.00 } } ``` #### Maximum JSON depth The maximum allowed JSON depth has been set to 64 to improve security and performance during JSON parsing. #### Profunditat màxima de JSON La profunditat JSON màxima permesa s'ha establert en 64 per millorar la seguretat i el rendiment durant l'anàlisi JSON. ### Media The media object has the following properties. |Property|Type|Description| |--|--|------| |mediaid|string|*(readonly)* ID of the user's media.| |userid|string|*(readonly)* ID of the user.| |**mediatypeid**<br>(required)|string|ID of the media type used by the user's media.| |**sendto**<br>(required)|string/array|Address, user name or other identifier of the recipient.<br><br>If type of [Media type](/manual/api/reference/mediatype/object#mediatype) is e-mail, values are represented as array. For other types of [Media types](/manual/api/reference/mediatype/object#mediatype), value is represented as a string.| |active|integer|Whether the media is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |severity|integer|Trigger severities to send notifications about.<br><br>Possible bitmap values:<br>1 - Not classified;<br>2 - Information;<br>4 - Warning;<br>8 - Average;<br>16 - High;<br>32 - Disaster.<br><br>This is a bitmask field; any sum of possible bitmap values is acceptable (for example, 48 for Average, High, and Disaster).<br><br>Default: 63.| |period|string|Time when the notifications can be sent as a [time period](/manual/appendix/time_period) or user macros separated by a semicolon.<br><br>Default: 1-7,00:00-24:00| ### Suport L'objecte suport té les propietats següents. |Propietat|Tipus|Descripció| |--|--|------| |**mediatypeid**<br>(obligatori)|string|ID del tipus de suport emprat per el suport.| |**sendto**<br>(obligatori)|string/array|L'adreça, el nom d'usuari o un altre identificador del destinatari.<br><br>Si el [tipus de suport](/en/manual/api/reference/mediatype /object#type_de_media) és un correu electrònic, els valors es representen com una matriu. Per a altres [tipus de suport](/en/manual/api/reference/mediatype/object#type_de_media), el valor es representa amb una cadena.| |**active**|integer|Indica si el suport és habilitat.<br><br>Valors possibles:<br>0 - *(per defecte)* activat;<br>1 - desactivat.| |**severity**|integer|Activa les gravetats per enviar notificacions.<br><br>Possibles valors de bitmap:<br>1 - No classificat;<br>2 - Informació;<br>4 - Avís;<br>8 - Mitjana;<br>16 - Alta;<br>32 - Desastre.<br><br>És un camp de màscara de bit; s'admet qualsevol suma de possibles valors de mapa de bits (per exemple, 48 per Mitjana, Alta i Desastre).<br><br>Per defecte: 63| |**period**|string|Hora en què les notificacions es poden enviar com a [període](/ca/manual/appendix/time_period) o macros d'usuari separades per punt i coma.<br><br> Per defecte: 1-7.00: 00-24:00| #### mediatype Changes:<br> [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `mediatype.get`: parameter `selectMessageTemplates` is now supported only for *Super admin* type users.<br> [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `mediatype.get`: *Admin* type users may now retrieve only the following [Media type object](/manual/api/reference/mediatype/object) properties: `mediatypeid`, `name`, `type`, `status`, `maxattempts`.<br> [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `mediatype.get`: when requesting user-related information of media types, *Admin* type users may now retrieve only data about their own user. #### tipus de suport Canvis:<br> [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `mediatype.get`: el paràmetre `selectMessageTemplates` ara només s'admet per als usuaris de tipus *Super admin*.\ [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `mediatype.get`: els usuaris de tipus *administrador* ara només poden recuperar les següents propietats de l'[objecte de tipus de suport](/manual/api/ reference/mediatype/object): `mediatypeid`, `ame`, `type`, `status`, `maxattempts`.\ [ZBX-25385](https://support.zabbix.com/browse/ZBX-25385) `mediatype.get`: quan demaneu informació relacionada amb l'usuari de tipus de suport, els usuaris de tipus *administrador* ara només poden recuperar dades sobre els seus propi usuari. #### mediatype Changes:<br> [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `mediatype.get`: parameter `selectUsers` now returns data based on the restrictions added to `user.get` method. #### mediatype Canvis:<br> [ZBX-26258](https://support.zabbix.com/browse/ZBX-26258) `mediatype.get`: el paràmetre `selectUsers` ara retorna dades basades en les restriccions afegides al mètode `user.get`. #### mediatype Changes:<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) message template object: added support of `conditiontype` value: 4 - *(event created on service status update)*. #### mediatype Canvis:<br> [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) objecte de plantilla de missatge: al valor `conditiontype` se li ha afegit el suport: 4 - *(esdeveniment creat en actualitzar l'estat del servei)*. #### mediatype Changes:<br> [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: added strict validation of the methods parameters. #### tipus de suport Canvis:<br> [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: afegida la validació estricta dels paràmetres dels mètodes. # mediatype.create # mediatype.create # mediatype.delete # mediatype.delete # mediatype.get # mediatype.get # Media type object The following objects are directly related to the `mediatype` API. # Objecte de tipus de suport Els següents objectes són relacionats amb l'API `mediatype`. #### Media type testing It is possible to test if a configured media type works. The testing request will be sent to Zabbix server. Zabbix server will attempt to send an alert using the specified media type and will return the result to frontend. The frontend will wait for the server to return the results. **Email** For example, to test an email media type: - Locate the relevant email in the [list](#overview) of media types - Click on *Test* in the last column of the list (a testing window will open) - Enter a *Send to* recipient address and with body and optional subject - Send a test message by clicking on *Test* Test success or failure message will be displayed in the same window: |<|{width="600"}| |-|-----------------------------------------------------------------------------------------| **Webhook** To test a webhook media type: - Locate the relevant webhook in the [list](#overview) of media types - Click on *Test* in the last column of the list (a testing window will open) - Edit the webhook parameter values, if needed - Click on *Test* By default, webhook tests are performed with parameters entered during configuration. However, it is possible to change attribute values for testing. Replacing or deleting values in the testing window affects the test procedure only, the actual webhook attribute values will remain unchanged. |<|{width="600"}| |-|-----------------------------------------------------------------------| To view media type test log entries without leaving the test window: - Click on *Open log* (a new popup window will open). |<|{width="600"}| |-|-------------------------------------------------------------------------| #### Test de tipus de suport Es pot provar si un tipus de suport configurat funciona. La petició de prova s'enviarà al servidor Zabbix. El servidor Zabbix intentarà enviar una alerta utilitzant el tipus de suport especificat i retornarà el resultat a la interfície. La interfície esperarà que el servidor retorni el resultat. **Correu electrònic** Per exemple, per provar un tipus de suport de correu electrònic: - Feu clic a *Provar* a la darrera columna de la llista (s'obrirà una finestra de prova) - Introduïu una adreça de destinatari *Enviar a* i el cos i l'assumpte opcionals - Envieu un missatge de prova fent clic a *Provar* El missatge d'aprovat o no de la prova es veurà a la mateixa finestra: |<|{width="600"}| |-|------------------------------------------------ --------------------------------------------| **Webhook** Per provar un tipus de suport de webhook: - Localitzeu el webhook rellevant a la [llista](#vista general) de tipus de suport - Feu clic a *Provar* a la darrera columna de la llista (s'obrirà una finestra de prova) - Modifiqueu els valors dels paràmetres del webhook, si cal - Feu clic a *Provar* Per defecte, les proves de webhook es fan amb els paràmetres introduïts durant la configuració. Tanmateix, és possible modificar els valors dels atributs de les proves. La substitució o la supressió de valors a la finestra de prova només afecta el procediment de prova, els valors reals dels atributs del webhook es mantindran sense canvis. |<|{width="600"}| |-|------------------------------------------------ -------------------------| Per veure les entrades del registre de prova de tipus de suport sense sortir de la finestra de prova: - Feu clic a *Obre el registre* (s'obrirà una nova finestra emergent). |<|{width="600"}| |-|------------------------------------------------ --------------------------| ### Media type The media type object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediatypeid|string|*(readonly)* ID of the media type.| |**name**<br>(required)|string|Name of the media type.| |**type**<br>(required)|integer|Transport used by the media type.<br><br>Possible values:<br>0 - email;<br>1 - script;<br>2 - SMS;<br>4 - Webhook.| |exec\_path|string|For script media types `exec_path` contains the name of the executed script.<br><br>Required for script media types.| |gsm\_modem|string|Serial device name of the GSM modem.<br><br>Required for SMS media types.| |passwd|string|Authentication password.<br><br>Used for email media types.| |smtp\_email|string|Email address from which notifications will be sent.<br><br>Required for email media types.| |smtp\_helo|string|SMTP HELO.<br><br>Required for email media types.| |smtp\_server|string|SMTP server.<br><br>Required for email media types.| |smtp\_port|integer|SMTP server port to connect to.| |smtp\_security|integer|SMTP connection security level to use.<br><br>Possible values:<br>0 - None;<br>1 - STARTTLS;<br>2 - SSL/TLS.| |smtp\_verify\_host|integer|SSL verify host for SMTP.<br><br>Possible values:<br>0 - No;<br>1 - Yes.| |smtp\_verify\_peer|integer|SSL verify peer for SMTP.<br><br>Possible values:<br>0 - No;<br>1 - Yes.| |smtp\_authentication|integer|SMTP authentication method to use.<br><br>Possible values:<br>0 - None;<br>1 - Normal password.| |status|integer|Whether the media type is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |username|string|User name.<br><br>Used for email media types.| |exec\_params|string|Script parameters.<br><br>Each parameter ends with a new line feed.| |maxsessions|integer|The maximum number of alerts that can be processed in parallel.<br><br>Possible values for SMS:<br>1 - *(default)*<br><br>Possible values for other media types:<br>0-100| |maxattempts|integer|The maximum number of attempts to send an alert.<br><br>Possible values:<br>1-100<br><br>Default value:<br>3| |attempt\_interval|string|The interval between retry attempts. Accepts seconds and time unit with suffix.<br><br>Possible values:<br>0-1h<br><br>Default value:<br>10s| |content\_type|integer|Message format.<br><br>Possible values:<br>0 - plain text;<br>1 - *(default)* html.| |script|text|Media type webhook script javascript body.| |timeout|string|Media type webhook script timeout. Accepts seconds and time unit with suffix.<br><br>Possible values:<br>1-60s<br><br>Default value:<br>30s| |process\_tags|integer|Defines should the webhook script response to be interpreted as tags and these tags should be added to associated event.<br><br>Possible values:<br>0 - *(default)* Ignore webhook script response.<br>1 - Process webhook script response as tags.| |show\_event\_menu|integer|Show media type entry in `problem.get` and `event.get` property `urls`.<br><br>Possible values:<br>0 - *(default)* Do not add `urls` entry.<br>1 - Add media type to `urls` property.| |event\_menu\_url|string|Define `url` property of media type entry in `urls` property of `problem.get` and `event.get`.| |event\_menu\_name|string|Define `name` property of media type entry in `urls` property of `problem.get` and `event.get`.| |parameters|array|Array of [webhook input parameters](/manual/api/reference/mediatype/object#webhook-parameters).| |description|text|Media type description.| Note that for some methods (update, delete) the required/optional parameter combination is different. ### Tipus de suport L'objecte de tipus de suport té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |--|--|------| |mediatypeid|string|*(només lectura)* ID del tipus de suport.| |**name**<br>(obligatori)|string|Nom del tipus de suport.| |**type**<br>(obligatori)|integer|Transport emprat pel tipus de suport.<br><br>Valors possibles:<br>0 - correu-e;<br>1 - script;<br>2 - SMS;<br>4 - Webhook.| |exec\_path|string|Per als tipus de suport d'script, `exec_path` conté el nom de l'script executat.<br><br>Requerit per als tipus de suport d'script.| |gsm\_modem|string|Nom del dispositiu sèrie del mòdem GSM.<br><br>Requerit per als tipus de suports SMS.| |passwd|string|Mot de pas d'autenticació.<br><br>S'empra per als tipus de mitjans de correu-e.| |smtp\_email|string|Adreça de correu-e des de la que s'enviaran les notificacions.<br><br>Requerit per als tipus de mitjans de correu-e.| |smtp\_helo|string|SMTP HELO.<br><br>Requerit per als tipus de suports de correu-e.| |smtp\_server|string|Servidor SMTP.<br><br>Requerit per als tipus de mitjans de correu-e.| |smtp\_port|integer|Port del servidor SMTP per connectar-se.| |smtp\_security|integer|Nivell de seguretat de la connexió SMTP que cal emprar.<br><br>Valors possibles:<br>0 - Cap;<br>1 - STARTTLS;<br>2 - SSL/TLS.| |smtp\_verify\_host|integer|SSL verifica l'equip per a SMTP.<br><br>Valors possibles:<br>0 - No;<br>1 - Sí.| |smtp\_verify\_peer|integer|SSL verifica el parell per a SMTP.<br><br>Valors possibles:<br>0 - No;<br>1 - Sí.| |smtp\_authentication|integer|Mètode d'autenticació SMTP que cal emprar.<br><br>Valors possibles:<br>0 - Cap;<br>1 - Mot de pas normal.| |status|integer|Si el tipus de suport és habilitat.<br><br>Valors possibles:<br>0 - *(per defecte)* activat;<br>1 - desactivat.| |username|integer|Nom d'usuari.<br><br>S'empra per als tipus de mitjans de correu-e.| |exec\_params|string|Paràmetres d'script.<br><br>Cada paràmetre acaba amb un salt de línia nova.| |maxsessions|integer|El nombre màxim d'alertes que es poden processar en paral·lel.<br><br>Valors possibles per a SMS:<br>1 - *(per defecte)*<br><br>Valors possibles ​​per a altres tipus de suports:<br>0-100| |maxattempts|integer|El nombre màxim d'intents per enviar una alerta.<br><br>Valors possibles:<br>1-100<br><br>Per defecte:<br>3| |attempt\_interval|string|L'interval de reintent. Accepta segons i unitat de temps amb sufix.<br><br>Valors possibles:<br>0-1h<br><br>Valor per defecte:<br>10s| |content\_type|integer|Format del missatge.<br><br>Valors possibles:<br>0 - text sense format;<br>1 - *(per defecte)* html.| |script|text|Cos de JavaScript de l'script del tipus de suport webhook.| |timeout|string|Temps d'espera de l'script del tipus de suport Webhook. Accepta segons i unitat de temps amb sufix.<br><br>Valors possibles:<br>1-60s<br><br>Valor per defecte:<br>30s| |process\_tags|integer|Defineix si la resposta de l'script webhook s'ha d'interpretar com a etiquetes i aquestes etiquetes s'han d'afegir a l'esdeveniment associat.<br><br>Valors possibles:<br>0 - *(per defecte) * Ignora la resposta de l'script webhook.<br>1 - Tracta la resposta de l'script webhook com a etiquetes.| |show\_event\_menu|integer|Mostra l'entrada del tipus de suport a `problem.get` i `event.get` a la propietat `urls`.<br><br>Valors possibles:<br>0 - *(per defecte)* No afegiu l'entrada `urls`.<br>1 - Afegeix un tipus de suport a la propietat `urls`.| |event\_menu\_url|string|Defineix la propietat `url` de l'entrada del tipus de suport a la propietat `urls` de `problem.get` i `event.get`.| |event\_menu\_name|string|Defineix la propietat `name` de l'entrada del tipus de suport a la propietat `urls` de `problem.get` i `event.get`.| |parameters|array|Matriu de [paràmetres d'entrada del webhook](/manual/api/reference/mediatype/object#webhook-parameters).| |description|text|Descripció del tipus de suport.| Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent. # Media type This class is designed to work with media types. Object references: - [Media type](/manual/api/reference/mediatype/object#media_type) Available methods: - [mediatype.create](/manual/api/reference/mediatype/create) - creating new media types - [mediatype.delete](/manual/api/reference/mediatype/delete) - deleting media types - [mediatype.get](/manual/api/reference/mediatype/get) - retrieving media types - [mediatype.update](/manual/api/reference/mediatype/update) - updating media types # Tipus de suport Aquesta classe és dissenyada per treballar amb tipus de suport. Referències d'objectes: - [Tipus de suport](/manual/api/reference/mediatype/object#media_type) Mètodes disponibles: - [mediatype.create](/manual/api/reference/mediatype/create) - crear nous tipus de suport - [mediatype.delete](/manual/api/reference/mediatype/delete) - esborrar tipus de suport - [mediatype.get](/manual/api/reference/mediatype/get) - recuperar tipus de suport - [mediatype.update](/manual/api/reference/mediatype/update) - actualitzar tipus de suport # mediatype.update # mediatype.update ### Media type URL The media type URL object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Media type defined URL name.| |url|string|Media type defined URL value.| Results will contain entries only for active media types with enabled event menu entry. Macro used in properties will be expanded, but if one of the properties contains an unexpanded macro, both properties will be excluded from results. For supported macros, see [*Supported macros*](/manual/appendix/macros/supported_by_location). ### URL dels tipus de suport L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|string|nom d'URL definit pel tipus de suport.| |url|string|valor d'URL definit pel tipus de suport.| Els resultats contindran entrades només per als tipus de suport actius amb una entrada de menú d'esdeveniments activada. La macro emprada a les propietats s'ampliarà, però si una de les propietats conté una macro no ampliada, ambdues propietats s'exclouran dels resultats. Les macros compatibles són descrites en aquesta [pàgina](/manual/appendix/macros/supported_by_location). ### Media type URL The media type URL object has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Media type defined URL name.| |url|string|Media type defined URL value.| Results will contain entries only for active media types with enabled event menu entry. Macro used in properties will be expanded, but if one of the properties contains an unexpanded macro, both properties will be excluded from results. For supported macros, see [*Supported macros*](/manual/appendix/macros/supported_by_location). ### URL dels tipus de suport L'objecte té les propietats següents. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|string|nom d'URL definit pel tipus de suport.| |url|string|valor d'URL definit pel tipus de suport.| Els resultats contindran entrades només per als tipus de suport actius amb una entrada de menú d'esdeveniments activada. La macro emprada a les propietats s'ampliarà, però si una de les propietats conté una macro no ampliada, ambdues propietats s'exclouran dels resultats. Les macros compatibles són descrites en aquesta [pàgina](/manual/appendix/macros/supported_by_location). ### Memcached |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |memcached.ping\[connString,<user>,<password>\]|<|<|<| |Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues)|**connString** - URI or session name.<br>**user, password** - Memcached login credentials.| | |memcached.stats\[connString,<user>,<password>,<type>\]|<|<|<| |Gets the output of the STATS command.|JSON - output is serialized as JSON|**connString** - URI or session name.<br>**user, password** - Memcached login credentials.<br>**type** - stat type to be returned: *items*, *sizes*, *slabs* or *settings* (empty by default, returns general statistics).| | ### Memcached |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |memcached.ping\[connString,\<usuari\>,\<mot de pas\>\]|<|<|<| |Prova si una connexió és activa o no.|1 - la connexió és activa<br><br>0 - la connexió s'ha avortat (en cas d'error, inclosos problemes d'AUTH i de configuració)|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - Credencials memcached.| | | |memcached.stats\[connString,\<usuari\>,\<mot de pas\>,\<tipus\>\]|<|<|<| |Obté la sortida de l'ordre STATS.|JSON - la sortida es serialitza com a JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió Memchached.<br>**tipus** - tipus d'estadístiques a retornar: *elements*, *mida*, *lloses* o *configuració* (buit per defecte, retorna estadístiques generals).| | #### Memory suffixes Memory size suffixes are supported in: - trigger [expression](/manual/config/triggers/expression) constants and function parameters - constants of [calculated item](/manual/config/items/itemtypes/calculated) formulas For memory size you can use: - **K** - kilobyte - **M** - megabyte - **G** - gigabyte - **T** - terabyte #### Sufixos de memòria Els sufixos de mida de memòria s'admeten a: - les [expressions](/manual/config/triggers/expression) de les constants i els paràmetres de funció de triggers. - les fòrmules de les constants dels [elements calculats](/manual/config/items/itemtypes/calculated) Per la mida de la memòria, podeu emprar: - **K** - kilooctet - **M** - megaoctet - **G** - gigaoctet - **T** - teraoctet **Memory** Zabbix requires both physical and disk memory. The amount of required disk memory obviously depends on the number of hosts and parameters that are being monitored. If you're planning to keep a long history of monitored parameters, you should be thinking of at least a couple of gigabytes to have enough space to store the history in the database. Each Zabbix daemon process requires several connections to a database server. The amount of memory allocated for the connection depends on the configuration of the database engine. ::: noteclassic The more physical memory you have, the faster the database (and therefore Zabbix) works. ::: **Memòria** Zabbix requereix memòria física i memòria de disc. 128 Mo de memòria física i 256 Mo d'espai lliure en disc poden ser un bon punt de partida. No obstant això, la quantitat de memòria de disc necessària, òbviament, depèn del nombre d'equips i paràmetres que es controlen. Si teniu previst mantindre un gran historial de paràmetres monitorats, hauríeu de considerar almenys uns quants gigaoctets per tindre prou espai per emmagatzemar l'historial a la base de dades. Cada procés de dimoni Zabbix requereix diverses connexions a un servidor de bases de dades. La quantitat de memòria assignada a la connexió depèn de la configuració del motor de base de dades. :::noteclassic Com més memòria física tingui, més ràpid s'executarà la base de dades (i, per tant, Zabbix). ::: ### Message template The message template object defines a template that will be used as a default message for action operations to send a notification. It has the following properties. |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**eventsource**<br>(required)|integer|Event source.<br><br>Possible values:<br>0 - triggers;<br>1 - discovery;<br>2 - autoregistration;<br>3 - internal;<br>4 - services.| |**recovery**<br>(required)|integer|Operation mode.<br><br>Possible values:<br>0 - operations;<br>1 - recovery operations;<br>2 - update operations.| |subject|string|Message subject.| |message|string|Message text.| ### Plantilla de missatge L'objecte defineix una plantilla que s'emprarà com a missatge predeterminat per a les operacions d'acció per enviar una notificació. Té les següents propietats. |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**eventsource**<br>(obligatori)|integer|Font de l'esdeveniment.<br><br>Valors possibles:<br>0 - triggers;<br>1 - descobriment;<br>2 - enregistrament automàtic;< br>3 - intern;<br>4 - serveis.| |**recovery**<br>(obligatori)|integer|Mode d'operació.<br><br>Valors possibles:<br>0 - operacions;<br>1 - operacions de recuperació;<br>2 - operacions d'actualització.| |subject|string|Assumpte del missatge.| |message|string|Text del missatge.| # Method reference This section provides an overview of the functions provided by the Zabbix API and will help you find your way around the available classes and methods. # Referència dels mètodes Aquesta secció proporciona una vista general de les funcions de l'API Zabbix i ens ajuda a trobar les classes i mètodes disponibles. #### Microsoft Entra ID configuration #### Configuració de Microsoft Entra ID #### Migration with running server * Export current history, import it to the temp table, then insert the data into new tables while ignoring duplicates: ``` {.sql} \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value DOUBLE PRECISION DEFAULT '0.0000' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value numeric(20) DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value varchar(255) DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, timestamp integer DEFAULT '0' NOT NULL, source varchar(64) DEFAULT '' NOT NULL, severity integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, logeventid integer DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### Migrció amb el servidor en marxa * Exporteu l'historial actual, importeu-lo a la taula temporal, i inseriu la informació a les noves taules ignorant duplicitats: ``` {.sql} \copy history_old TO '/tmp/history.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value DOUBLE PRECISION DEFAULT '0.0000' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history FROM '/tmp/history.csv' DELIMITER ',' CSV INSERT INTO history SELECT * FROM temp_history ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_uint_old TO '/tmp/history_uint.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_uint ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value numeric(20) DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_uint FROM '/tmp/history_uint.csv' DELIMITER ',' CSV INSERT INTO history_uint SELECT * FROM temp_history_uint ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_str_old TO '/tmp/history_str.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_str ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value varchar(255) DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_str FROM '/tmp/history_str.csv' DELIMITER ',' CSV INSERT INTO history_str (itemid,clock,value,ns) SELECT * FROM temp_history_str ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_log_old TO '/tmp/history_log.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_log ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, timestamp integer DEFAULT '0' NOT NULL, source varchar(64) DEFAULT '' NOT NULL, severity integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, logeventid integer DEFAULT '0' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_log FROM '/tmp/history_log.csv' DELIMITER ',' CSV INSERT INTO history_log SELECT * FROM temp_history_log ON CONFLICT (itemid,clock,ns) DO NOTHING; \copy history_text_old TO '/tmp/history_text.csv' DELIMITER ',' CSV CREATE TEMP TABLE temp_history_text ( itemid bigint NOT NULL, clock integer DEFAULT '0' NOT NULL, value text DEFAULT '' NOT NULL, ns integer DEFAULT '0' NOT NULL ); \copy temp_history_text FROM '/tmp/history_text.csv' DELIMITER ',' CSV INSERT INTO history_text SELECT * FROM temp_history_text ON CONFLICT (itemid,clock,ns) DO NOTHING; ``` * Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues. #### Mikrotik - *MikroTik \<device model> SNMP* - 53 new model-specific templates for monitoring various models of MikroTik ethernet routers and switches, see [full list](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/mikrotik); - *Mikrotik SNMP* - a generic template for monitoring MikroTik devices. ##### Mikrotik - *MikroTik \<model de dispositiu> SNMP* - 53 nous models específics de model per monitorar diversos models d'encaminadors i commutadors Ethernet MikroTik, veieu la [llista sencera](https://git.zabbix.com/projects/ZBX/rest/zabbix/browse/templates/net/mikrotik); - *Mikrotik SNMP* - una plantilla genèrica per controlar l'equip MikroTik. ##### Mikrotik routers Use SNMP agent provided by Mikrotik. See <http://www.mikrotik.com> for more information. ##### Routers Mikrotik Empreu un agent SNMP proveït per Mikrotik. Veieu <http://www.mikrotik.com> per tindre més informació. #### Minimum supported Go version The minimum supported Go version has been raised from 1.21 to 1.23. If you previously built Zabbix [agent 2](/manual/concepts/agent2), agent 2 [loadable plugins](/manual/extensions/plugins#loadable), or [web service](/manual/concepts/web_service) from source using a Go version older than 1.23, it is recommended to rebuild these components using a [supported Go version](/manual/installation/requirements#agent-2) to receive the latest security updates and bug fixes. Components built with an older Go version will continue to work, but [upgrading](/manual/installation/upgrade/sources#agent-upgrade-process) them will require a newer Go environment. #### Versió mínima de Go compatible La versió mínima de Go compatible ha pujat de la versió 1.21 a la 1.23. Si abans havíeu creat Zabbix [agent 2](/manual/concepts/agent2), agent 2 [plugins carregables](/manual/extensions/plugins#loadable) o [web service](/manual/concepts/web_service) des del codi font utilitzant una versió de Go anterior a la 1.23, es recomana reconstruir aquests components utilitzant una [versió de Go compatible](/manual/installation/requirements#agent-2) per rebre les darreres actualitzacions de seguretat i correccions d'errors. Els components creats amb una versió de Go anterior continuaran funcionant, però [actualitzar-los](/manual/installation/upgrade/sources#agent-upgrade-process) requerirà un entorn de Go més nou. ##### Minimum weekly disk space among clusters View the lowest disk space among clusters over a week. - add to the data set: hosts `cluster*`, key "Free disk space on /data" - select the aggregate function `min` and specify interval `1w` - a bar graph is displayed, where each bar represents the minimum disk space per week for each /data volume of the cluster ##### Espai de disc mínim setmanal entre clústers Mostra l'espai de disc més baix entre els clústers durant una setmana. - afegiu al conjunt de dades: equips `clúster*`, clau "Espai lliure en disc a /data". - trieu la funció d'agregació `min` i especifiqueu l'interval `1w` - Es mostra un gràfic de barres, on cada barra representa l'espai de disc mínim per setmana per a cada volum /data del clúster ## Miscellaneous ## Diversos ##### Miscellaneous aspects of escalation behavior Let's consider what happens in different circumstances if an action contains several escalation steps. |Situation|Behavior| |---------|--------| |*The host in question goes into maintenance after the initial problem notification is sent*|Depending on the *Pause operations for suppressed problems* setting in action [configuration](/manual/config/notifications/action/operation#configuring_an_operation), all remaining escalation steps are executed either with a delay caused by the maintenance period or without delay. A maintenance period does not cancel operations.| |*The time period defined in the **Time period** action condition ends after the initial notification is sent*|All remaining escalation steps are executed. The *Time period* condition cannot stop operations; it has effect with regard to when actions are started/not started, not operations.| |*A problem starts during maintenance and continues (is not resolved) after maintenance ends*|Depending on the *Pause operations for suppressed problems* setting in action [configuration](/manual/config/notifications/action/operation#configuring_an_operation), all escalation steps are executed either from the moment maintenance ends or immediately.| |*A problem starts during a no-data maintenance and continues (is not resolved) after maintenance ends*|It must wait for the trigger to fire, before all escalation steps are executed.| |*Different escalations follow in close succession and overlap*|The execution of each new escalation supersedes the previous escalation, but for at least one escalation step that is always executed on the previous escalation. This behavior is relevant in actions upon events that are created with EVERY problem evaluation of the trigger.| |*During an escalation in progress (like a message being sent), based on any type of event:<br>- the action is disabled<br>Based on trigger event:<br>- the trigger is disabled<br>- the host or item is disabled<br>Based on internal event about triggers:<br>- the trigger is disabled<br>Based on internal event about items/low-level discovery rules:<br>- the item is disabled<br>- the host is disabled*|The message in progress is sent and then one more message on the escalation is sent. The follow-up message will have the cancellation text at the beginning of the message body (*NOTE: Escalation canceled*) naming the reason (for example, *NOTE: Escalation canceled: action '<Action name>' disabled*). This way the recipient is informed that the escalation is canceled and no more steps will be executed. This message is sent to all who received the notifications before. The reason of cancellation is also logged to the server log file (starting from [Debug Level](/manual/appendix/config/zabbix_server) 3=Warning).<br><br>Note that the *Escalation canceled* message is also sent if operations are finished, but recovery operations are configured and are not executed yet.| |*During an escalation in progress (like a message being sent) the action is deleted*|No more messages are sent. The information is logged to the server log file (starting from [Debug Level](/manual/appendix/config/zabbix_server) 3=Warning), for example: `escalation canceled: action id:334 deleted`| ##### Aspectes diversos del comportament de l'escalada Considerem què passa en diferents circumstàncies si una acció conté diverses passes d'escalada. |Estat|Comportament| |----------|--------| |*L'equip en qüestió entra en manteniment després que s'enviï la notificació inicial del problema*|Segons la configuració *Aturar operacions per problemes esborrats* a [configuració](/manual/config/notifications/action/operation#configuring_an_operation) de l'acció, totes les passes d'escalada restants s'executen amb un endarreriment causat pel període de manteniment o sense demora. Un període de manteniment no cancel·la les operacions.| |*El període de temps definit a la condició d'acció **Període de temps** acaba després d'enviar la notificació inicial*|S'executen totes les passes d'escalada restants. La condició *Període* no pot aturar les operacions; té un efecte sobre quan s'inicien/no s'inicien les accions, no sobre les operacions.| |*Un problema comença durant el manteniment i continua (no es resol) després d'acabar el manteniment*|Segons la configuració *Pausa les operacions per a problemes esborrats* a [configuració](/manual/config/notifications/action/operation#configuring_an_operation) de l'acció, totes les passes d'escalada s'executen tan aviat com acaba el manteniment o immediatament.| |*Un problema s'inicia durant un manteniment sense dades i continua (no es resol) després d'acabar el manteniment*|Ha d'esperar que el trigger s'activi, abans d'executar qualsevol pas d'escalada.| |*Es segueixen i es superposen diferents escalades*|L'execució de cada escalada nova substitueix l'escalada anterior, però almenys per a una passa d'escalada que encara s'executa a l'escalada anterior. Aquest comportament és rellevant en accions sobre esdeveniments que es creen amb l'avaluació de CADA problema del trigger.| |*Durant una escalada en curs (com l'enviament d'un missatge), depenent de qualsevol tipus d'esdeveniment:<br>- l'acció és desactivada<br>Depenent de l'esdeveniment trigger:< br>- l'activador és desactivat<br>- equip o element és desactivat<br>Segons un esdeveniment intern relacionat amb els triggers:<br>- el trigger és desactivat<br>Segons un esdeveniment intern relacionat amb els elements/regles de descoberta de baix nivell:<br>- l'element és desactivat<br >- l'equip és desactivat*|S'envia el missatge actual i després s'envia un altre missatge sobre l'escalada. El missatge de seguiment contindrà el text de cancel·lació al principi del cos del missatge (*NOTA: Escalada cancel·lada*) indicant el motiu (p. ex. **NOTA: Escalada cancel·lada: acció '\<Nom de l'acció\>' desactivada*). D'aquesta manera, s'avisa al destinatari que l'escalada s'ha cancel·lat i no es faran més passes. Aquest missatge s'envia a tothom que hagi rebut les notificacions abans. El motiu de la recuperació també es registra al fitxer de registre del servidor (des del [nivell de depuració](/manual/appendix/config/zabbix_server) 3=Avís).<br><br>Tingueu en compte que el missatge *Escalada cancel·lada* també és enviat si les operacions s'han completat, però les operacions de recuperació són configurades i encara no s'executen.| |*Durant una escalada en curs (com ara enviar un missatge) l'acció s'esborra*|No s'envien més missatges. La informació es registra al fitxer de registre del servidor (des del [nivell de depuració](/manual/appendix/config/zabbix_server) 3=Avís), per exemple: `escalada cancel·lada: acció id:334 esborrada`| #### Miscellaneous - Maximum field size has been increased for the following fields: - [Item preprocessing](/manual/config/items/preprocessing#configuration) parameters - [Media type](/manual/config/notifications/media#common-parameters) message - The default language of Zabbix web interface has been changed from British to American English. Support of British English has been dropped. - The Share link in the main menu has been replaced by an Integrations link, leading to the [Integrations](https://www.zabbix.com/integrations) page on the Zabbix website. - If Zabbix web interface is opened in one of the languages available on the Zabbix website, clicking the Integrations link will open the Integrations page in the appropriate language. For all other languages, including English, the Integrations page will be opened in English. - A custom expression, used in [action configuration](/manual/config/notifications/action/#configuring-an-action) for calculating conditions, now can be up to 1024 characters long (previously 255). - *Monitoring->Hosts* section now shows link to host problems screen even if no problems are currently open. ##### Diversos - S'ha augmentat la mida màxima de camp per als camps següents: - Paràmetres [preprocessament d'elements](/manual/config/items/preprocessing#configuration) - Missatge del [tipus de suport](/manual/config/notifications/media#common-parameters) - L'idioma predeterminat de la interfície web de Zabbix ha canviat de l'anglès britànic a l'anglès dels EUA. S'ha esborrat el suport a l'anglès del Regne Unit. - L'enllaç Compartir al menú principal s'ha substituït per un enllaç Integracions, que porta a la pàgina d'[Integracions](https://www.zabbix.com/integrations) del lloc web de Zabbix. - Si la interfície web de Zabbix s'obre en un dels idiomes disponibles al lloc web de Zabbix, fent clic a l'enllaç Integracions s'obrirà la pàgina d'integracions en l'idioma adequat. Per a la resta d'idiomes, inclòs l'anglès, la pàgina Integracions s'obrirà en anglès. - Una expressió personalitzada, emprada a [configuració d'acció](/manual/config/notifications/action/#configuring-an-action) per calcular condicions, pot contindre fins a 1024 caràcters (era 255). - La secció *Monitoratge->Equips* ensenya un enllaç a la pantalla de problemes de l'equip encara que actualment no hi hagi cap problema obert. #### Miscellaneous The *Clear history* button located in *Configuration* → *Hosts* → [*Items*](/manual/web_interface/frontend_sections/configuration/hosts/items#mass-editing-options) has been renamed *Clear history and trends* to more accurately describe its function, which is the same as the *Clear history and trends* button in the item [configuration form](/manual/config/items/item). #### Diversos El botó *Esborrar historial* que hi ha a *Configuració* → *Equips* → [*Elements*](/manual/web_interface/frontend_sections/configuration/hosts/items#mass-editing-options) s'ha reanomenat a *Esborrar historial i tendències* per descriure amb més precisió la seva funció, que és la mateixa que el botó *Esborrar historial i tendències* de l'element [formulari de configuració](/manual/config/items/item). #### Mismatch counting Count the number of hosts whose names do not contain the substring "ubuntu" Request: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": "ubuntu" }, "excludeSearch": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": "44", "id": 1 } ``` #### Recompte d'incompatibilitat Compta el nombre d'equips amb noms que no tenen pas la subcadena "ubuntu" Petició: ```json { "jsonrpc": "2.0", "method": "host.get", "params": { "countOutput": true, "search": { "host": "ubuntu" }, "excludeSearch": true }, "auth": "766b71ee543230a1182ca5c44d353e36", "id": 1 } ``` Resposta: ```json { "jsonrpc": "2.0", "result": "44", "id": 1 } ``` #### Missing files in Windows agent archive The Windows Zabbix agent download ZIP file is missing zabbix_sender.h and zabbix_sender.lib files in versions 6.0.0-6.0.27, required for zabbix_sender.dll. #### Mancança de fitxers a l'arxiu de l'agent de Windows Al fitxer ZIP de descàrrega de l'agent de Windows Zabbix hi manquen els fitxers zabbix_sender.h i zabbix_sender.lib a les versions 6.0.0-6.0.27, necessaris per a zabbix_sender.dll. ### Mixing item key and session parameters in Zabbix agent 2 plugins Zabbix agent 2 now allows to override [named session](/manual/config/items/plugins) parameters by specifying new values in the item key parameters. Previously, users had to select if they prefer to provide connection string values in a named session or in an item key. If a named session has been used, related item key parameters had to be empty. Now, if using named sessions, only the first parameter (usually, a URI) has to be specified in the named session, whereas other parameters can be defined either in the named session or in the item key. ### Barrejant de claus d'element i paràmetres de sessió als connectors de l'agent 2 de Zabbix L'agent Zabbix 2 permet ara anul·lar els paràmetres de la [sessió anomenada](/manual/config/items/plugins) especificant nous valors als paràmetres clau de l'element. Abans, els usuaris havien de triar si preferien proporcionar valors de cadena de connexió en una sessió amb nom o en una clau d'element. Si s'havia emprat una sessió amb nom, els paràmetres de clau d'element relacionats havien d'estar buits. Ara, si s'empren sessions amb nom, només s'ha d'especificar el primer paràmetre (normalment, un URI) a la sessió amb nom, mentre que altres paràmetres es poden definir a la sessió amb nom o a la clau d'element. ##### Modbus data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**modbus.get**\[endpoint,<slave id>,<function>,<address>,<count>,<type>,<endianness>,<offset>\]|<|<|<| |Reads Modbus data.|JSON object|**endpoint** - endpoint defined as `protocol://connection_string`<br>**slave id** - slave ID<br>**function** - Modbus function<br>**address** - address of first registry, coil or input<br>**count** - number of records to read<br>**type** - type of data<br>**endianness** - endianness configuration<br>**offset** - number of registers, starting from 'address', the results of which will be discarded.<br><br>See a [detailed description](/manual/appendix/items/modbus) of parameters.|Supported since Zabbix 5.2.0.<br><br>On Windows, this item follows UNC paths in the **endpoint** parameter, which can be a [security risk](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).| ##### dades Modbus |Clau de l'elemen|<|<|<| |--|--|------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |**modbus.get**\[endpoint,<id esclave>,<fonction>,<adresse>,<count>,<type>,<endianness>,<offset>\]|<|<|<| |Llegeix dades Modbus.|Objecte JSON|**punt final** - punt final definit com a `protocol://connection_string`<br>**identificador esclau** - ID esclau<br>**funció** - funció Modbus<br >**adreça** - adreça del primer registre, bobina o entrada<br>**compte** - nombre de registres a llegir<br>**tipus** - tipus de dades<br>**endianness** - configuració endianness<br>**offset** - nombre de registres, començant per "adreça", els resultats dels quals s'ignoraran.<br><br>Veieu una [descripció detallada](/manual/appendix/items/modbus) de les configuracions.|Suportat des de Zabbix 5.2.0.<br><br>A Windows, aquest element segueix les reutes UNC al paràmetre **endpoint**, que podria esdevindre un [risc de seguretat](/manual/installation/requirements/best_practices#unc-path-access-on-windows-by-zabbix-agent).| ##### Modes (**forecast** only)<br> Every time a trigger function is evaluated, it gets data from the specified history period and fits a specified function to the data. So, if the data is slightly different, the fitted function will be slightly different. If we simply calculate the value of the fitted function at a specified time in the future, you will know nothing about how the analyzed item is expected to behave between now and that moment in the future. For some `fit` options (like *polynomial*) a simple value from the future may be misleading. |`mode`|**forecast** result| |------|-------------------| |*value*|f(now + `time`)| |*max*|max~now\ <=\ t\ <=\ now\ +\ `time`~ f(t)| |*min*|min~now\ <=\ t\ <=\ now\ +\ `time`~ f(t)| |*delta*|*max* - *min*| |*avg*|average of f(t) (now <= t <= now + `time`) according to [definition](https://en.wikipedia.org/wiki/Mean_of_a_function)| ##### Modes (**forecast** només)<br> Cada vegada que s'avalua una funció de trigger, s'obtenen dades del període d'historial especificat i ajusta una funció especificada a les dades. Així, si les dades són lleugerament diferents, la funció ajustada serà lleugerament diferent. Si només calculem el valor de la funció ajustada en un moment futur especificat, no sabreu pas res sobre el comportament esperat de l'element analitzat per llavors. Per a algunes opcions d'"ajustament" (com ara *polinomi*), un simple valor futur pot ésser enganyós. |`mode`|resultat **predit**| |------|----------------------------| |*valor*|f(ara + `hora`)| |*max*|max~ara\ <=\ t\ <=\ ara\ +\ `temps`~ f(t)| |*min*|min~ara\ <=\ t\ <=\ ara\ +\ `temps`~ f(t)| |*delta*|*max* - *min*| |*mitjana*|mitjana de f(t) (ara <= t <= ara + `temps`) segons [definició](https://en.wikipedia.org/wiki/Mean_of_a_function)| ### Modifying existing services :::noteclassic The buttons described below are visible only when *Services* section is in the Edit mode. ::: To edit an existing service, press the pencil icon next to the service. To clone an existing service, press the pencil icon to open its configuration and then press Clone button. When a service is cloned, its parent links are preserved, while the child links are not. To delete a service, press on the `x` icon next to it. When you delete a parent service, its child services will not be deleted and will move one level higher in the service tree (1st level children will get the same level as the deleted parent service). Two buttons below the list of services offer some mass-editing options: - *Mass update* - mass update service properties - *Delete* - delete the services To use these options, mark the checkboxes before the respective services, then click on the required button. ### Modificació dels serveis existents :::noteclassic Els botons que es descriuen a continuació només són visibles quan la secció *Serveis* és en mode d'edició. ::: Per editar un servei existent, toqueu la icona de llapis que hi ha al costat del servei. Per clonar un servei existent, toqueu la icona del llapis per obrir-ne la configuració i, a continuació, toqueu el botó Clonar. Quan es clona un servei, es conserven els seus enllaços primaris, mentre que els enllaços secundaris no. Per treure un servei, toqueu la icona "x" que hi ha al costat. Quan esborreu un servei principal, els seus serveis secundaris no s'esborraran pas i pujaran un nivell a l'arbre de serveis (els fills de primer nivell tindran el mateix nivell que el servei principal esborrat). Dos botons sota la llista de serveis ofereixen opcions d'edició massiva: - *Actualització massiva* - actualització massiva de les propietats del servei - *Suprimir* - esborra serveis Per emprar aquestes opcions, marqueu les caselles que hi ha davant dels serveis i, a continuació, feu clic al botó requerit. #### Module API In order for a shared library to be treated as a Zabbix module, it should implement and export several functions. There are currently six functions in the Zabbix module API, only one of which is mandatory and the other five are optional. #### Mòdul d'API Perquè una biblioteca compartida es tracti com un mòdul Zabbix, ha d'implementar i exportar diverses funcions. Actualment hi ha sis funcions a l'API Zabbix, on només una és obligatòria i les altres cinc són opcionals. #### Modules This section allows to administer custom [frontend modules](/manual/modules). {width="600"} Click on *Scan directory* to register/unregister any custom modules. Registered modules will appear in the list, along with their details. Unregistered modules will be removed from the list. You may filter modules by name or status (enabled/disabled). Click on the module status in the list to enable/disable a module. You may also mass enable/disable modules by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list. #### Mòduls Aquesta secció us permet administrar els [mòduls d'interfície web](/manual/modules) personalitzats. {width="600"} Feu clic a *Escanejar el directori* per registrar/anul·lar el registre de qualsevol mòdul personalitzat. Els mòduls desats apareixeran a la llista, juntament amb els seus detalls. Els mòduls no registrats s'esborraran de la llista. Podeu filtrar mòduls per nom o estat (activat/desactivat). Feu clic a l'estat del mòdul a la llista per activar/desactivar un mòdul. També podeu activar/desactivar mòduls en massa triant-los a la llista i després fent clic als botons *Activar/Desactivar* a sota de la llista. ##### Module structure Each module is a directory (placed within the `modules` directory) with sub-directories containing controllers, views and any other code: example_module_directory/ (required) manifest.json (required) Metadata and action definition. Module.php Module initialization and event handling. actions/ Action controller files. SomethingView.php SomethingCreate.php SomethingDelete.php data_export/ ExportAsXml.php ExportAsExcel.php views/ View files. example.something.view.php example.something.delete.php js/ JavaScript files used in views. example.something.view.js.php partials/ View partial files. example.something.reusable.php js/ JavaScript files used in partials. example.something.reusable.js.php As you can see, the only mandatory file within the custom module directory is `manifest.json`. The module will not register without this file. `Module.php` is responsible for registering menu items and processing events such as 'onBeforeAction' and 'onTerminate'. The *actions*, *views* and *partials* directories contain PHP and JavaScript code needed for module actions. ##### Estructura dels mòduls Cada mòdul és un directori (ubicat al directori "mòduls") amb subdirectoris que contenen controladors, vistes i altres codis: directori_mòdul_exemple/ (obligatori) manifest.json (obligatori) Definició de metadades i accions. Module.php Inicialització del mòdul i gestió d'esdeveniments. accions/fitxers del controlador d'accions. SomethingView.php SomethingCreate.php SomethingDelete.php exportació_dades/ ExportaAsXml.php Exporta com a Excel.php visualitzacions/ Veure fitxers. exemple.algunacosa.veure.php exemple.algunacosa.suprimir.php js/ Fitxers JavaScript emprats a views.example.something.view.js.php parcials/ Fitxers de visualització parcial. exemple.alguna cosa.reutilitzable.php js/ Fitxers JavaScript emprats a parcials. exemple.alguna cosa.reutilitzable.js.php Com podeu veure, l'únic fitxer necessari al directori del mòdul personalitzat és `manifest.json`. El mòdul no es registrarà sense aquest fitxer. `Module.php` és responsable de registrar els elements del menú i gestionar esdeveniments com ara 'onBeforeAction' i 'onTerminate'. Els directoris *accions*, *visualitzacions* i *parcials* contenen el codi PHP i JavaScript necessaris per a les accions del mòdul. ### Module The module object has the following properties: |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**moduleid**<br>(required)|string|ID of the module.| |status|integer|Whether access to the module is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| ### Mòdul L'objecte mòdul té les propietats següents: |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**moduleid**<br>(obligatori)|string|ID del mòdul.| |status|integer|Diu si l'accés al mòdul és habilitat.<br><br>Valors possibles:<br>0 - Inhabilitat;<br>1 - *(per defecte)* Habilitat.| ### MongoDB |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mongodb.collection.stats\[connString,<user>,<password>,<database>,collection\]|<|<|<| |Returns a variety of storage statistics for a given collection.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.<br>**database** - database name (default: admin).<br>**collection** — collection name.| | |mongodb.collections.discovery\[connString,<user>,<password>\]|<|<|<| |Returns a list of discovered collections. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.collections.usage\[connString,<user>,<password>\]|<|<|<| |Returns usage statistics for collections.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.connpool.stats\[connString,<user>,<password>\]|<|<|<| |Returns information regarding the open outgoing connections from the current database instance to other members of the sharded cluster or replica set.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.db.stats\[connString,<user>,<password>,<database>\]|<|<|<| |Returns statistics reflecting a given database system state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.<br>**database** - database name (default: admin).| | |mongodb.db.discovery\[connString,<user>,<password>\]|<|<|<| |Returns a list of discovered databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.jumbo\_chunks.count\[connString,<user>,<password>\]|<|<|<| |Returns count of jumbo chunks.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.oplog.stats\[connString,<user>,<password>\]|<|<|<| |Returns a status of the replica set, using data polled from the oplog.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.ping\[connString,<user>,<password>\]|<|<|<| |Tests if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.rs.config\[connString,<user>,<password>\]|<|<|<| |Returns a current configuration of the replica set.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.rs.status\[connString,<user>,<password>\]|<|<|<| |Returns a replica set status from the point of view of the member where the method is run.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.server.status\[connString,<user>,<password>\]|<|<|<| |Returns database state.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.sh.discovery\[connString,<user>,<password>\]|<|<|<| |Returns a list of discovered shards present in the cluster.|JSON object|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | |mongodb.version\[connString,<user>,<password>\]|<|<|<| |Returns the database server version.|String|**connString** - URI or session name.<br>**user, password** - MongoDB login credentials.| | ### MongoDB |Clau<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |mongodb.collection.stats\[connString,\<usuari\>,\<paraula de pas\>,\<base de dades\>,col·lecció\]|<|<|<| |Retorna diverses estadístiques d'emmagatzematge per a una col·lecció determinada.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.<br>**base de dades** - nom de la base de dades (per defecte: admin).<br>**col·lecció** — nom de la col·lecció.| | |mongodb.collections.discovery\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna una llista de col·leccions descobertes. S'empra per a la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - Credencials d'inici de sessió MongoDB.| | |mongodb.collections.usage\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna les estadístiques d'ús de la col·lecció.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.| | |mongodb.connpool.stats\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna informació sobre les connexions de sortida obertes de la instància de base de dades actual a altres membres del clúster fragmentat o del conjunt de rèpliques.|Objecte JSON|**connString** - URI o nom de sessió.<br >**usuari, paraula de pas** - Credencials d'inici de sessió de MongoDB.| | |mongodb.db.stats\[connString,\<usuari\>,\<paraula de pas\>,\<base de dades\>\]|<|<|<| |Retorna estadístiques que reflecteixen un estat del sistema de base de dades determinat.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.<br>* *base de dades** - nom de la base de dades (per defecte: admin).| | |mongodb.db.discovery\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna una llista de bases de dades descobertes. S'empra per a la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - Credencials Inici de sessió de MongoDB.| | |mongodb.jumbo\_chunks.count\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna el nombre de fragments jumbo.|objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.| | |mongodb.oplog.stats\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna un estat del conjunt de rèpliques, emprant les dades consultades des de l'oplog.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - Credencials connexió MongoDB.| | |mongodb.ping\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Prova si una connexió és activa o no.|1 - la connexió és activa<br><br>0 - la connexió s'avorta (en cas d'errors, inclosos problemes d'AUTH i de configuració).|**connString** - URI o nom de sessió. <br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.| | |mongodb.rs.config\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna una configuració actual del conjunt de rèpliques.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.| | |mongodb.rs.status\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna un estat de conjunt de rèpliques des de la perspectiva del membre on s'executa el mètode.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - Credencials d'inici de sessió MongoDB.| | |mongodb.server.status\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna l'estat de la base de dades.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.| | |mongodb.sh.discovery\[connString,\<usuari\>,\<paraula de pas\>\]|<|<|<| |Retorna una llista de fragments descoberts presents al clúster.|objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - credencials d'inici de sessió de MongoDB.| | |mongodb.version\[connString,<user>,<password>\]|<|<|<| |Retorna la versió de la base de dades del servidor.|Cadena|**connString** - URI o nom de sessió.<br>**usuari, paraula de pas** - Credencials d'accés de MongoDB.| | #### MongoDB plugin parameters The following MongoDB plugin parameters are no longer mandatory if Plugins.MongoDB.Sessions.<SessionName>.TLSConnect is set to `verify_ca` or `verify_full`: - Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile - Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile See also: [MongoDB plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters) #### Paràmetres del plugin MongoDB Els paràmetres del connector MongoDB següents ja no són obligatoris si Plugins.MongoDB.Sessions.<SessionName>.TLSConnect s'estableix a `verify_ca` o `verify_full`: - Plugins.MongoDB.Sessions.<SessionName>.TLSCertFile - Plugins.MongoDB.Sessions.<SessionName>.TLSKeyFile Veieu també: [paràmetre del plugin de MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters) #### Monitoring → Latest data updated Several improvements have been made to the Latest data section: - Time since last check (for example, 1m 20s) is now displayed instead of the last item execution time. - Hovering over an item's last value will show the raw value without units or value mapping applied. - If a host is in maintenance, an orange wrench icon will be visible next to the host name. ##### Monitoratge → Darreres dades actualitzades S'han fet diverses millores a la secció de Dades més recents: - Ara es veu el temps transcorregut des de la darrera comprovació (p. ex., 1 m 20 s) en lloc del temps d'execució del darrer element. - Si passeu el cursor per sobre del darrer valor d'un element, es veurà el valor brut sense unitats ni assignació de valors aplicades. - Si un equip és en manteniment, es veurà una icona de clau anglesa carbassa al costat del nom d'equip. #### Monitoring → Overview removed The Overview section in the Monitoring menu has been removed completely. The same functionality can be still accessed by using the *Data overview* and *Trigger overview* dashboard [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). #### Monitoratge → Vista general esborrada La secció de Vista general del menú Monitoratge s'ha eliminat completament. Encara es pot accedir a la mateixa funcionalitat mitjançant els [ginys](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) dels taulers de control *Vista general de dades* i *Vista general de triggers*. ##### Monitoring → Overview removed The Overview section in the Monitoring menu has been removed completely. The same functionality can be still accessed by using the *Data overview* and *Trigger overview* dashboard [widgets](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). ##### Monitoratge → Vista general esborrada La secció de Vista general del menú Monitoratge s'ha eliminat completament. Encara es pot accedir a la mateixa funcionalitat mitjançant els [ginys](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) dels taulers de control *Vista general de dades* i *Vista general de triggers*. #### Monitoring → Problems The following parameters are supported: - `show` - filter option "Show": 1 - recent problems, 2 - all, 3 - in problem state - `name` - filter option "Problem": freeform string - `severities` - filter option "Severity": array of selected severities in a format 'severities\[\*\]=\*' (replace \* with severity level): 0 - not classified, 1 - information, 2 - warning, 3 - average, 4 - high, 5 - disaster - `inventory` - filter option "Host inventory": array of inventory fields: \[field\], \[value\] - `evaltype` - filter option "Tags", tag filtering strategy: 0 - And/Or, 2 - Or - `tags` - filter option "Tags": array of defined tags: \[tag\], \[operator\], \[value\] - `show_tags` - filter option "Show tags": 0 - none, 1 - one, 2 - two, 3 - three - `tag_name_format` - filter option "Tag name": 0 - full name, 1 - shortened, 2 - none - `tag_priority` - filter option "Tag display priority": comma-separated string of tag display priority - `show_suppressed` - filter option "Show suppressed problems": should be 'show\_suppressed=1' to show - `unacknowledged` - filter option "Show unacknowledged only": should be 'unacknowledged=1' to show - `compact_view` - filter option "Compact view": should be 'compact\_view=1' to show - `highlight_row` - filter option "Highlight whole row" (use problem color as background color for every problem row): should be '1' to highlight; can be set only when 'compact\_view' is set - `filter_name` - filter properties option "Name": freeform string - `filter_show_counter` - filter properties option "Show number of records": 1 - show, 0 - do not show - `filter_custom_time` - filter properties option "Set custom time period": 1 - set, 0 - do not set - `sort` - sort column: clock, host, severity, name - `sortorder` - sort order or results: DESC - descending, ASC - ascending - `age_state` - filter option "Age less than": should be 'age\_state=1' to enable 'age'. Is used only when 'show' equals 3. - `age` - filter option "Age less than": days - `groupids` - filter option "Host groups": array of host groups IDs - `hostids` - filter option "Hosts": array of host IDs - `triggerids` - filter option "Triggers": array of trigger IDs - `show_timeline` - filter option "Show timeline": should be 'show\_timeline=1' to show - `details` - filter option "Show details": should be 'details=1' to show - `from` - date range start, can be 'relative' (e.g.: now-1m). Is used only when 'filter\_custom\_time' equals 1. - `to` - date range end, can be 'relative' (e.g.: now-1m). Is used only when 'filter\_custom\_time' equals 1. #### Monitoratge→ Problemes S'admeten els paràmetres següents: - `show` - opció de filtre "Veure": 1 - problemes recents, 2 - tots, 3 - en estat de problema - `name` - Opció de filtre "Problema": cadena de forma lliure - `severity' - Opció de filtre "Gravetat": taula de gravetats triades al format 'severitie\[\*\]=\*' (substituïu \* pel nivell de gravetat): 0 - sense classificar, 1 - informació, 2 - avís, 3 - mitjà, 4 - alt, 5 - desastre - `inventory` - opció de filtre "Inventari de l'equip": matriu de camps d'inventari: \[camp\], \[valor\] - `evaltype` - opció de filtre "Etiquetes", estratègia de filtrat d'etiquetes: 0 - I/o, 2 - O - `tags' - opció de filtre "Etiquetes": matriu d'etiquetes definides: \[etiqueta\], \[operador\], \[valor\] - `show_tags` - Opció de filtre "Mostra les etiquetes": 0 - cap, 1 - una, 2 - dues, 3 - tres - `tag_name_format` - Opció de filtre "Nom de l'etiqueta": 0 - nom complet, 1 - drecera, 2 - cap - `tag_priority` - Opció de filtre "Prioritat de visualització de l'etiqueta": cadena separada per comes de prioritat de visualització de l'etiqueta - `show_suppressed` - Opció de filtre "Mostra els problemes esborrats": ha de ser "show\_suppressed=1" per veure'ls - "unacknowledged" - opció de filtre "Mostra només els elements no reconeguts": ha de ser "unacknowledged=1" per veure - `compact_view` - Opció de filtre "Vista compacta": ha de ser "compact\_view=1" per mostrar - `highlight_row` - Opció de filtre "Resalta la fila sencera" (empra el color del problema com a color de fons per a cada filera del problema): ha de ser "1" per ressaltar; només es pot configurar quan s'ha configurat "compact\_view". - `filter_name` - Opció de propietats del filtre "Nom": cadena de forma lliure - `filter_show_counter` - Opció de propietats del filtre "Mostra el recompte de registres": 1 - mostrar, 0 - no mostrar - `filter_custom_time` - Opció de propietats del filtre "Estableix un període de temps personalitzat": 1 - estableix, 0 - no estableix - `sort` - columna d'ordenació: hora, equip, gravetat, nom - `sortorder` - ordre d'ordenació o resultats: DESC - descendent, ASC - ascendent - `age_state` - opció de filtre "Edat inferior a": ha de ser "edat\_estat=1" per activar "edat". Només s'empra quan "mostrar" és igual a 3. - `age` - Opció de filtre "Edat inferior a": dies - `groupids` - Opció de filtre "Grups d'equips": matriu d'ID de grups d'equips - `hostids` - Opció de filtre "Equips": matriu d'ID d'equips - `triggerids` - Opció de filtre "Triggers": matriu d'ID de trigger - `show_timeline` - Opció de filtre "Mostra la línia de temps": ha de ser 'show\_timeline=1' per mostrar-se - `details` - Opció de filtre "Mostra els detalls": ha de ser "detalls=1" per mostrar-se - `from` - inici de l'interval de dates, pot ser 'relatiu' (p. ex.: ara-1 m). Només s'utilitza quan "filter\_custom\_time" és igual a 1. - `to` - final de l'interval de dates, pot ser 'relatiu' (p. ex.: ara-1 m). Només s'utilitza quan "filter\_custom\_time" és igual a 1. ##### Monitoring server availability At least three methods (or combination of all methods) may be used in order to monitor availability of a server. - ICMP ping ("icmpping" key) - "zabbix\[host,agent,available\]" item - trigger function nodata() for monitoring the availability of hosts that use active checks only ##### Monitoratge de la disponibilitat del servidor Com a mínim es poden emprar tres mètodes (o una combinació de tots els mètodes) per monitorar la disponibilitat d'un servidor. * Ping ICMP (clau "icmpping") * Element "zabbix[host,agent,available]" * La funció de trigger nodata() permet monitorar la disponibilitat dels equips emprant només els controls actius. #### Monitoring specific applications #### Monitorant aplicacions concretes ### Monitoring The Zabbix API allows you to access history and other data gathered during monitoring. ### Monitoratge L'API Zabbix ens permet accedir a l'historial i altres dades recollides pel monitoratge. ### Monitoring Windows services This tutorial provides step-by-step instructions for setting up the monitoring of Windows services. It is assumed that Zabbix server and agent are configured and operational. ### Monitoratge dels serveis Windows Aquest tutorial ofereix instruccions passa per passa per configurar el monitoratge dels serveis de Windows. Se suposa que el servidor i l'agent Zabbix són configurats i operatius. #### Monotonic change It is now possible to check for monotonic increase or decrease in item values using the new **monoinc()** or **monodec()** [history functions](/manual/appendix/functions/history). ##### Canvi monòton Ara és possible comprovar l'augment o la disminució monòtons dels valors dels elements mitjançant les noves [funcions d'històric](/manual/appendix/functions/history) **monoinc()** o **monodec()**. ### Month abbreviated with capital letter A "month" is now abbreviated with the capital "M" in the frontend. Previously it was abbreviated with the small "m", overlapping with the abbreviation of a minute. ### S'abreuja el mes amb la lletra majúscula El "mes" ara s'abreuja amb la lletra majúscula "M" al tauler. Abans s'abreujava amb l'"m" minuscula, confonent-se amb l'abreujatura de minut. #### More info See [Virtual machine monitoring](/manual/vm_monitoring) for detailed information how to configure Zabbix to monitor VMware environments. #### Més informació Veieu [Monitoratge de màquines virtuals](/manual/vm_monitoring) per tindre més detall de la configuració de Zabbix per monitorar els entorns VMware. #### More secure JavaScript preprocessing The JavaScript function [atob](/manual/config/items/preprocessing/javascript/javascript_objects#global-javscript-functions) now returns an array of 8-bit unsigned integers instead of a decoded string. #### Preprocessament de JavaScript més segur La funció JavaScript [atob](/manual/config/items/preprocessing/javascript/javascript_objects#global-javscript-functions) ara retorna una matriu de nombres enters sense signe de 8 bits en lloc d'una cadena descodificada. Most trigger functions are evaluated based on item value [history](/manual/config/items/history_and_trends) data, while some trigger functions for long-term analytics, e.g. **trendavg()**, **trendcount()**, etc, use trend data. La majoria de les funcions de trigger s'avaluen en funció de les dades de valor de l'element [històric](/manual/config/items/history_and_trends), mentre que algunes funcions de trigger per a l'anàlisi a llarg termini, per exemple, **trendavg()**, **trendcount() **, etc., empren dades de tendències. #### Moving and copy-pasting elements Several selected elements can be **moved** to another place in the map by clicking on one of the selected elements, holding down the mouse button, and moving the cursor to the desired location. One or more elements can be **copied** by selecting the elements, then clicking on a selected element with the right mouse button and selecting *Copy* from the menu. {width="600"} To paste the elements, click on a map area with the right mouse button and select *Paste* from the menu. The *Paste without external links* option will paste the elements retaining only the links that are between the selected elements. Copy-pasting works within the same browser window. Keyboard shortcuts are not supported. #### Moure i copiar-enganxar elements Es poden **moure** diversos elements triats a una altra ubicació del mapa fent clic a un dels elements triats, mantinguent premut el botó del ratolí i arrossegant el cursor a la ubicació desitjada. Es poden **copiar** un o més elements triant els elements, després fent clic amb el botó dret sobre un element triat i escollint *Copiar* al menú. {width="600"} Per enganxar els elements, feu clic a una àrea del mapa amb el botó dret del ratolí i trieu *Enganxar* al menú. L'opció *Enganxar sense enllaços externs* enganxarà els elements conservant només els enllaços que hi ha entre els elements triats. Copia i enganxa funciona a la mateixa finestra del navegador. Les dreceres de teclat no són compatibles. ### MQTT |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mqtt.get\[<broker\_url>,topic,<username>,<password>\]|<|<|<| |Subscribes to a specific topic or topics (with wildcards) of the provided broker and waits for publications.|Depending on topic content.<br><br>If wildcards are used, returns topic content as JSON.|**broker\_url** - MQTT broker URL (if empty, *localhost* with port 1883 is used).<br>**topic** - MQTT topic (mandatory). Wildcards (+,\#) are supported.<br>**username,password** - authentication credentials (if required)|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks) ('Zabbix agent (active)' item type).<br><br>TLS encryption certificates can be used by saving them into a default location (e.g. `/etc/ssl/certs/` directory for Ubuntu). For TLS, use the `tls://` scheme.| ### MQTT |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor retornat**|**Paràmetres**|**Comentaris**| |mqtt.get\[<broker\_url>,tema,<nom d'usuari>,<mot de pas>\]|<|<|<| |Se subscriu a un o més temes específics (amb comodins) de l'agent proporcionat i espera les publicacions.|Basat en el contingut del tema.<br><br>Si s'empren comodins, retorna el contingut del tema en format JSON.|**broker\_url** - URL del corredor MQTT (si està buit, s'empra *localhost* amb el port 1883).<br>**tema** - tema MQTT (obligatori). S'admeten els comodins (+,\#).<br>**nom d'usuari, mot de pas** - credencials d'autenticació (si calen)|L'element s'ha de configurar com a [verificació activa](/manual /appendix/items/activepassive#active_checks) (tipus d'element 'Agent Zabbix (actiu)').<br><br>Els certificats de xifrat TLS es poden emprar desant-los en una ubicació predeterminada (per exemple, al directori `/etc/ssl/certs/` per a Ubuntu). Per a TLS, empreu l'esquema `tls://`.| #### MSSQL A new plugin for direct monitoring of MSSQL by Zabbix agent 2 has been added. For more information, see: - [MSSQL plugin readme](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Agent 2 items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [MSSQL plugin parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) - [Agent 2 installation](/manual/concepts/agent2#installation) #### MSSQL S'ha afegit un nou connector per al monitoratge directe de MSSQL per part de l'agent Zabbix 2. Per a més informació, consulteu: - [Llegeix-me del plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) - [Elements de l'agent 2](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) - [Paràmetres del plugin MSSQL](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) - [Instal·lació de l'agent 2](/manual/concepts/agent2#installation) #### MSSQL instance names supported in agent 2 plugin It is now possible to specify MSSQL instance names as part of the connection string in MSSQL agent 2 plugin items, for example: mssql.custom.query[sqlserver://localhost/InstanceName,...] Note that in this case **no port** must be specified. If port is specified, then the instance name will be ignored and the specified port will be used for connection. #### Noms d'instàncies MSSQL compatibles amb el plugin de l'agent 2 Ara és possible especificar noms d'instàncies MSSQL com a part de la cadena de connexió als elements del plugin de l'agent MSSQL 2, per exemple: mssql.custom.query[sqlserver://localhost/InstanceName,...] Tingueu en compte que en aquest cas s'ha d'especificar **cap port**. Si s'especifica el port, s'ignorarà el nom de la instància i s'emprarà el port especificat per a la connexió. ### MSSQL |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mssql.availability.group.get\[URI,<user>,<password>\]|<|<|<| |Returns availability groups.|JSON object|**URI** - MSSQL server URI (the only supported schema is `sqlserver://`). Embedded credentials will be ignored. Since Zabbix 6.0.36, it is possible to specify an instance name as part of the URI, i.e.: `sqlserver://localhost/InstanceName` (no port). If port is specified, the instance name is ignored;<br>**user, password** - username, password to send to protected MSSQL server.|Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.custom.query\[URI,<user>,<password>,queryName,<args...>\]|<|<|<| |Returns the result of a custom query.|JSON object|**URI** - MSSQL server URI (the only supported schema is `sqlserver://`). Embedded credentials will be ignored. Since Zabbix 6.0.36, it is possible to specify an instance name as part of the URI, i.e.: `sqlserver://localhost/InstanceName` (no port). If port is specified, the instance name is ignored;<br>**user, password** - username, password to send to protected MSSQL server;<br>**queryName** - name of a custom query configured in `Plugins.MSSQL.CustomQueriesDir` without the .sql extension;<br>**args** - one or several comma-separated arguments to pass to a query.|Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.db.get|<|<|<| |Returns all available MSSQL databases.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.job.status.get|<|<|<| |Returns the status of jobs.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.last.backup.get|<|<|<| |Returns the last backup time for all databases.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.local.db.get|<|<|<| |Returns databases that are participating in an Always On availability group and replica (primary or secondary) and are located on the server that the connection was established to.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.mirroring.get|<|<|<| |Returns mirroring info.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.nonlocal.db.get|<|<|<| |Returns databases that are participating in an Always On availability group and replica (primary or secondary) located on other servers (the database is not local to the SQL Server instance that the connection was established to).|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.perfcounter.get|<|<|<| |Returns the performance counters.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.ping|<|<|<| |Ping the database. Test if connection is correctly configured.|1 - alive,<br>0 - not alive| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.quorum.get|<|<|<| |Returns the quorum info.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.quorum.members.get|<|<|<| |Returns the quorum members.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.replica.get|<|<|<| |Returns the replicas.|JSON object| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mssql.version|<|<|<| |Returns the MSSQL version.|String| |Supported since Zabbix 6.0.27. For more information see the [MSSQL plugin](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| ### MSSQL |Clau|<|<|<| |--|--|-------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |mssql.availability.group.get\[URI,<usuari>,<mot de pas>\]|<|<|<| |Retorna grups de disponibilitat.|Objecte JSON|**URI** - URI del servidor MSSQL (l'únic esquema admès és `sqlserver://`). Les credencials incrustades seran ignorades. Des de Zabbix 6.0.36, és possible especificar un nom d'instància com a part de l'URI, com ara: `sqlserver://localhost/InstanceName` (no port). Si s'especifica el port, el nom de la instància no es tindrà pas en compte;<br>**usuari, mot de pas** - nom d'usuari, mot de pas per enviar al servidor MSSQL protegit.|S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.custom.query\[URI,<usuari>,<mot de pas>,queryName,<args...>\]|<|<|<| |Retorna el resultat d'una consulta personalitzada.|Objecte JSON|**URI** - URI del servidor MSSQL (l'únic esquema admès és `sqlserver://`). Les credencials incrustades seran ignorades. Des de Zabbix 6.0.36, és possible especificar un nom d'instància com a part de l'URI, com ara: `sqlserver://localhost/InstanceName` (no port). Si s'especifica el port, el nom de la instància no es tindrà pas en compte;<br>**usuari, mot de pas** - nom d'usuari, mot de pas per enviar al servidor MSSQL protegit;<br>**queryName** - nom d'una consulta personalitzada configurada a `Plugins.MSSQL.CustomQueriesDir` sense l'extensió .sql;<br>**args** - un o diversos arguments separats per comes per passar a una consulta.|S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.db.get|<|<|<| |Retorna totes les bases de dades MSSQL disponibles.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.job.status.get|<|<|<| |Retorna l'estat dels treballs.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.last.backup.get|<|<|<| |Retorna l'hora de la darrera còpia de seguretat de totes les bases de dades.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.local.db.get|<|<|<| |Retorna bases de dades que participen en un grup de disponibilitat Always On i una rèplica (principal o secundària) i que es troben al servidor al que s'ha establert la connexió.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.mirroring.get|<|<|<| |Retorna informació de duplicació.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.nonlocal.db.get|<|<|<| |Retorna bases de dades que participen en un grup de disponibilitat Always On i una rèplica (principal o secundària) ubicades en altres servidors (la base de dades no és local a la instància d'SQL Server a la que s'ha establert la connexió).|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.perfcounter.get|<|<|<| |Retorna els comptadors de rendiment.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.ping|<|<|<| |Ping a la base de dades. Comprova si la connexió és ben configurada.|1 - respon,<br>0 - no respon| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.quorum.get|<|<|<| |Retorna la informació de quòrum.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.quorum.members.get|<|<|<| |Retorna els membres del quòrum.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.replica.get|<|<|<| |Retorna les rèpliques.|Objecte JSON| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mssql.version|<|<|<| |Retorna la versió MSSQL.|String| |S'admet des de Zabbix 6.0.27. Per obtindre més informació, consulteu [plugin MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0).| #### MSSQL Zabbix agent 2 plugin update The template [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) has been updated with filters to include or exclude discovered quorum members by name as well as a service filter that allows filtering by cluster name to exclude empty clusters. To have the template work without errors, the [MSSQL Zabbix agent 2 plugin](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) must be updated to a version equal to or above 6.0.39. #### Actualització del plugin de l'agent 2 de MSSQL Zabbix La plantilla [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) s'ha actualitzat amb filtres per incloure o excloure el nom del servei trobat per als membres del clúster, ja que el nom del clúster permet que el filtre trobi el nom del clúster, per excloure els clústers buits. Perquè la plantilla funcioni sense errors, el [plugin MSSQL Zabbix agent 2](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin) s'ha d'actualitzar a una versió igual o superior a 6.0.39. ##### Multiple HTTP requests Collect the content of both *https://www.example.com* and *https://www.example.com/release\_notes*: - Create an item with type "Script". - In the *Script* field, enter: ```javascript var request = new HttpRequest(); return request.get("https://www.example.com") + request.get("https://www.example.com/release_notes"); ``` ##### Peticions HTTP múltiples Recollir el contingut de *https://www.example.com* i *https://www.example.com/release\_notes*: - Crear un element de tipus "Script".\ - Al camp *Script*, posar-hi el següent codi: ```javascript var request = new HttpRequest(); return request.get("https://www.example.com") + request.get("https://www.example.com/release_notes"); ``` #### Multiple LLD rules for the same item Since Zabbix agent version 3.2 it is possible to define several low-level discovery rules with the same discovery item. To do that you need to define the Alias agent [parameter](/manual/appendix/config/zabbix_agentd), allowing to use altered discovery item keys in different discovery rules, for example `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. #### Múltiples regles LLD per el mateix element Des de la versió 3.2 de l'agent Zabbix, és possible definir diverses regles de descoberta de baix nivell amb el mateix element de descoberta. Per fer-ho, heu d'establir el [paràmetre](/manual/appendix/config/zabbix_agentd) d'àlies de l'agent, que permet emprar claus d'element de descoberta modificades en diferents regles de descoberta, per exemple `vfs.fs.discovery[foo]`, `vfs.fs.discovery[bar]`, etc. #### MySQL 8.0 Group Replication in multi‐primary mode When using MySQL 8.0 Group Replication in multi‐primary mode, you may encounter an error during transaction commits similar to the following: 1531697:20250128:064734.697 query [txnlev:1] [update alerts set status=1,retries=0,error='' where alertid=154618; 1531697:20250128:064734.713 query [txnlev:1] [commit;] 1531697:20250128:064734.753 [Z3005] query failed: [3101] Plugin instructed the server to rollback the current transaction. [commit;] This error appears to be triggered by issues with rollback operations involving foreign key constraints. See also: - [ZBX-26060](https://support.zabbix.com/browse/ZBX-26060) for the related problem report. - [MySQL Bug #96758 "Rollbacks with Foreign Keys on single node"](https://bugs.mysql.com/bug.php?id=96758) for the upstream issue. #### Replicació de grups de MySQL 8.0 en mode multiprimari Quan s'utilitza la replicació de grups de MySQL 8.0 en mode multiprimari, és possible que es dongui un error durant les confirmacions de transacció similar al següent: 1531697:20250128:064734.697 query [txnlev:1] [update alerts set status=1,retries=0,error='' where alertid=154618; 1531697:20250128:064734.713 query [txnlev:1] [commit;] 1531697:20250128:064734.753 [Z3005] query failed: [3101] El plugin ha indicat al servidor que reverteixi la transacció actual. [commit;] Sembla que aquest error és degut a problemes amb les operacions de reversió que impliquen restriccions de clau externa. Veieu també: - [ZBX-26060](https://support.zabbix.com/browse/ZBX-26060) per a l'informe del problema relacionat. - [Error de MySQL núm. 96758 "Reversions amb claus externes en un sol node"](https://bugs.mysql.com/bug.php?id=96758) per al problema principal. #### MySQL 8.0+ with mysqlsh This method can be used with a running Zabbix server, but it is recommended to stop the server for the time of the upgrade. The MySQL Shell (*mysqlsh*) must be [installed](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install-linux-quick.html) and able to connect to the DB. * Log in to MySQL console as root (recommended) or as any user with FILE privileges. * Start MySQL with the [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) variable enabled. * Rename old tables and create new tables by running `history_pk_prepare.sql`. ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` * Export and import data. Connect via mysqlsh. If using a socket connection, specifying the path might be required. sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix Run (CSVPATH can be changed as needed): ``` {.javascript} CSVPATH="/var/lib/mysql-files"; util.exportTable("history_old", CSVPATH + "/history.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history.csv", {"dialect": "csv", "table": "history" }); util.exportTable("history_uint_old", CSVPATH + "/history_uint.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_uint.csv", {"dialect": "csv", "table": "history_uint" }); util.exportTable("history_str_old", CSVPATH + "/history_str.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_str.csv", {"dialect": "csv", "table": "history_str" }); util.exportTable("history_log_old", CSVPATH + "/history_log.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_log.csv", {"dialect": "csv", "table": "history_log" }); util.exportTable("history_text_old", CSVPATH + "/history_text.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_text.csv", {"dialect": "csv", "table": "history_text" }); ``` * Follow [post-migration instructions](#post-migration) to drop the old tables. #### MySQL 8.0+ amb mysqlsh Aques mètode es pot emprar amb un servidor Zabbix en marxa, però es recomana aturar el servidor mentre s'actualitza. La MySQL Shell (*mysqlsh*) ha d'ésser [instal·lada](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-install-linux-quick.html) i poder-se connectar amb la DB. * Entreu a la consola de MySQL com a root (recomanat) o qualsevol altre usuari amb privilegis FILE. * Inicieu MySQL amb la variable [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) activa. * Reanomeneu les taules antigues i creeu taules noves executant `history_pk_prepare.sql`. ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ``` * Exporteu i importeu la informació. Connecteu via mysqlsh. Si empreu una connexió socket, és necessari especificar la ruta. sudo mysqlsh -uroot -S /run/mysqld/mysqld.sock --no-password -Dzabbix Executeu (CSVPATH es pot canviar, si cal): ``` {.javascript} CSVPATH="/var/lib/mysql-files"; util.exportTable("history_old", CSVPATH + "/history.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history.csv", {"dialect": "csv", "table": "history" }); util.exportTable("history_uint_old", CSVPATH + "/history_uint.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_uint.csv", {"dialect": "csv", "table": "history_uint" }); util.exportTable("history_str_old", CSVPATH + "/history_str.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_str.csv", {"dialect": "csv", "table": "history_str" }); util.exportTable("history_log_old", CSVPATH + "/history_log.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_log.csv", {"dialect": "csv", "table": "history_log" }); util.exportTable("history_text_old", CSVPATH + "/history_text.csv", { dialect: "csv" }); util.importTable(CSVPATH + "/history_text.csv", {"dialect": "csv", "table": "history_text" }); ``` * Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues. #### MySQL 8.1 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.1.X. ### Suport de MySQL 8.1 La [versió més nova suportada](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MySQL és la 8.1.X. #### MySQL 8.2 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.2.X. ### Suport de MySQL 821 La [versió més nova suportada](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MySQL és la 8.2.X. #### MySQL 8.3 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.3.X. ### Suport de MySQL 8.3 La [versió més nova suportada](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MySQL és la 8.3.X. #### MySQL 8.4 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 8.4.X. ### Suport de MySQL 8.4 La [versió més nova suportada](/manual/installation/requirements#third-party-external-surrounding-software) per MySQL és la 8.4.X. #### MySQL 9.0 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 9.0.X. ### Suport de MySQL 9.0 La [versió més nova admesa](/manual/installation/requirements#third-party-external-surrounding-software) per MySQL és la 9.0.X. #### MySQL 9.5 support The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MySQL is now 9.5.X. ### Suport de MySQL 9.5 La [versió més nova admesa](/manual/installation/requirements#third-party-external-surrounding-software) per MySQL és la 9.5.X. #### MySQL 9.6 support The maximum [supported version](/manual/installation/requirements#thirdparty-external-surrounding-software) for MySQL is now 9.6.X. ### Suport de MySQL 9.6 La [versió més nova admesa](/manual/installation/requirements#third-party-external-surrounding-software) per MySQL és la 9.6.X. #### MySQL 9.7 support The maximum [supported version](/manual/installation/requirements#thirdparty-external-surrounding-software) for MySQL is now 9.7.X. ### Suport de MySQL 9.7 La [versió més nova admesa](/manual/installation/requirements#third-party-external-surrounding-software) per MySQL és la 9.7.X. #### MySQL configuration Modern versions of the database are ready out-of-the-box for `required` [encryption mode](/manual/appendix/install/db_encrypt#terminology). A server-side certificate will be created after initial setup and launch. Create users and roles for the main components: mysql> CREATE USER   'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>',   'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE SSL   PASSWORD HISTORY 5; mysql> CREATE ROLE 'zbx_srv_role', 'zbx_web_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT, CREATE, DROP, ALTER, INDEX, REFERENCES ON zabbix.* TO 'zbx_srv_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT ON zabbix.* TO 'zbx_web_role'; mysql> GRANT 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> GRANT 'zbx_web_role' TO 'zbx_web'@'%'; mysql> SET DEFAULT ROLE 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> SET DEFAULT ROLE 'zbx_web_role' TO 'zbx_web'@'%'; Note that the X.509 protocol is not used to check identity, but the user is configured to use only encrypted connections. See [MySQL documentation](https://dev.mysql.com/doc/refman/8.0/en/create-user.html#create-user-tls) for more details about configuring users. Run to check connection (socket connection cannot be used to test secure connections): mysql -u zbx_srv -p -h 10.211.55.9 --ssl-mode=REQUIRED Check current status and available cipher suites: mysql> status -------------- mysql Ver 8.0.21 for Linux on x86_64 (MySQL Community Server - GPL) Connection id: 62 Current database: Current user: zbx_srv@bfdb.local SSL: Cipher in use is TLS_AES_256_GCM_SHA384 mysql> SHOW SESSION STATUS LIKE 'Ssl_cipher_list'\G; *************************** 1. row *************************** Variable_name: Ssl_cipher_list Value: 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-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-DSS-AES128-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES256-SHA:CAMELLIA256-SHA:CAMELLIA128-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA 1 row in set (0.00 sec) ERROR: No query specified #### Configuració de MySQL Les versions modernes de la base de dades són llestes per [mode de xifrat](/manual/appendix/install/db_encrypt#terminology) "obligatoris". El certificat de la banda del servidor es crearà després de la configuració i el llançament inicials. Creeu usuaris i rols per als components principals: mysql> CREATE USER   'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>',   'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE SSL   PASSWORD HISTORY 5; mysql> CREATE ROLE 'zbx_srv_role', 'zbx_web_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT, CREATE, DROP, ALTER, INDEX, REFERENCES ON zabbix.* TO 'zbx_srv_role'; mysql> GRANT SELECT, UPDATE, DELETE, INSERT ON zabbix.* TO 'zbx_web_role'; mysql> GRANT 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> GRANT 'zbx_web_role' TO 'zbx_web'@'%'; mysql> SET DEFAULT ROLE 'zbx_srv_role' TO 'zbx_srv'@'%'; mysql> SET DEFAULT ROLE 'zbx_web_role' TO 'zbx_web'@'%'; Tingueu en compte que el protocol X.509 no s'empra per comprovar la identitat, sinó que l'usuari és configurat per emprar només connexions xifrades. Veieu la [documentació MySQL](https://dev.mysql.com/doc/refman/8.0/en/create-user.html#create-user-tls) per obtindre més detalls sobre la configuració dels usuaris. Executeu per comprovar la connexió (la connexió del sòcol no es pot emprar pas per provar les connexions segures): $ mysql -u zbx_srv -p -h 10.211.55.9 --ssl-mode=REQUIRED Testeu l'estat actual i les cadenes de xifrat disponibles: mysql> status -------------- mysql Ver 8.0.21 for Linux on x86_64 (MySQL Community Server - GPL) Connection id: 62 Current database: Current user: zbx_srv@bfdb.local SSL: Cipher in use is TLS_AES_256_GCM_SHA384 mysql> SHOW SESSION STATUS LIKE 'Ssl_cipher_list'\G; *************************** 1. row *************************** Variable_name: Ssl_cipher_list Value: 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-GCM-SHA384:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES256-SHA384:DHE-RSA-AES128-GCM-SHA256:DHE-DSS-AES128-GCM-SHA256:DHE-RSA-AES128-SHA256:DHE-DSS-AES128-SHA256:DHE-DSS-AES256-GCM-SHA384:DHE-RSA-AES256-SHA256:DHE-DSS-AES256-SHA256:DHE-RSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-ECDSA-AES256-SHA:DHE-DSS-AES128-SHA:DHE-RSA-AES128-SHA:DHE-DSS-AES256-SHA:DHE-RSA-AES256-SHA:AES256-SHA:CAMELLIA256-SHA:CAMELLIA128-SHA:AES128-GCM-SHA256:AES256-GCM-SHA384:AES128-SHA256:AES256-SHA256:AES128-SHA 1 row in set (0.00 sec) ERROR: No query specified #### MySQL configuration Set MySQL CE server configuration option (*/etc/my.cnf.d/server-tls.cnf*) to: [mysqld] ... # in this examples keys are located in the MySQL CE datadir directory ssl_ca=ca.pem ssl_cert=server-cert.pem ssl_key=server-key.pem require_secure_transport=ON tls_version=TLSv1.3 ... Keys for the MySQL CE server and client (Zabbix frontend) should be created manually according to the MySQL CE documentation: [Creating SSL and RSA certificates and keys using MySQL](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-rsa-files-using-mysql.html) or [Creating SSL certificates and keys using openssl](https://dev.mysql.com/doc/refman/5.7/en/creating-ssl-files-using-openssl.html) ::: noteimportant MySQL server certificate should contain the Common Name field set to the FQDN name as Zabbix frontend will use the DNS name to communicate with the database or IP address of the database host. ::: Create MySQL user: mysql> CREATE USER 'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>', 'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE X509 PASSWORD HISTORY 5; Check if it is possible to log in with that user: mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=VERIFY_IDENTITY --ssl-ca=/var/lib/mysql/ca.pem --ssl-cert=/var/lib/mysql/client-cert.pem --ssl-key=/var/lib/mysql/client-key.pem #### Configuració de MySQL Establiu l'opció de configuració del servidor MySQL CE (*/etc/my.cnf.d/server-tls.cnf*) a: [mysqld] ... # en aquest exemple, les claus són a la carpeta datadir de MySQL CE ssl_ca=ca.pem ssl_cert=server-cert.pem ssl_key=server-key.pem require_secure_transport=ON tls_version=TLSv1.3 ... Les claus per al servidor i el client MySQL CE (interfície Zabbix) s'han de crear manualment segons la documentació de MySQL CE: [Creació de certificats i claus SSL i RSA amb MySQL](https://dev.mysql.com/doc/refman/8.0/en/creating-ssl-rsa-files-using-mysql.html) o [Creació de certificats i claus SSL amb openssl](https://dev.mysql.com/doc/refman/5.7/en/creating-ssl-files-using-openssl.html) ::: nota important El certificat del servidor MySQL ha de contindre el camp de Nom Comú definit com a nom FQDN perquè la interfície Zabbix emprarà el nom DNS per comunicar-se amb la base de dades o l'adreça IP de l'equip de la base de dades. ::: Crear un usuari MySQL: mysql> CREATE USER 'zbx_srv'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>', 'zbx_web'@'%' IDENTIFIED WITH mysql_native_password BY '<strong_password>' REQUIRE X509 PASSWORD HISTORY 5; Verificar si és possible establir la connexió amb aquest usuari: $ mysql -u zbx_web -p -h 10.211.55.9 --ssl-mode=VERIFY_IDENTITY --ssl-ca=/var/lib/mysql/ca.pem --ssl-cert=/var/lib/mysql/client-cert.pem --ssl-key=/var/lib/mysql/client-key.pem #### MySQL - CR\_CONN\_HOST\_ERROR - CR\_SERVER\_GONE\_ERROR - CR\_CONNECTION\_ERROR - CR\_SERVER\_LOST - CR\_UNKNOWN\_HOST - ER\_SERVER\_SHUTDOWN - ER\_ACCESS\_DENIED\_ERROR - ER\_ILLEGAL\_GRANT\_FOR\_TABLE - ER\_TABLEACCESS\_DENIED\_ERROR - ER\_UNKNOWN\_ERROR #### MySQL - CR\_CONN\_HOST\_ERROR - CR\_SERVER\_GONE\_ERROR - CR\_CONNECTION\_ERROR - CR\_SERVER\_LOST - CR\_UNKNOWN\_HOST - ER\_SERVER\_SHUTDOWN - ER\_ACCESS\_DENIED\_ERROR - ER\_ILLEGAL\_GRANT\_FOR\_TABLE - ER\_TABLEACCESS\_DENIED\_ERROR - ER\_UNKNOWN\_ERROR #### MySQL custom error codes If Zabbix is used with MySQL installation on Azure, an unclear error message *\[9002\] Some errors occurred* may appear in Zabbix logs. This generic error text is sent to Zabbix server or proxy by the database. To get more information about the cause of the error, check Azure logs. #### Codis d'error personalitzats de MySQL Si Zabbix s'empra amb la instal·lació de MySQL a Azure, pot aparèixer un missatge d'error poc clar *\[9002\] Alguns errors* poden aparèixer als registres de Zabbix. Aquest text d'error genèric s'envia al servidor o proxy Zabbix per la base de dades. Per obtindre més informació sobre la causa de l'error, consulteu els registres d'Azure. ##### MySQL database certificate base encryption MySQL database side: apiVersion: v1 data: root-ca.pem: >- < root-ca.pem data> server-cert.pem: >- < server-cert.pem data> server-key.pem: >- < server-key.pem data> kind: Secret metadata: name: zabbix-db-server-tls-secret type: Opaque Zabbix components side: apiVersion: v1 data: client-cert.pem: >- < client-cert.pem data> client-key.pem: >- < client-key.pem data> root-ca.pem: >- < root-ca.pem data> kind: Secret metadata: name: zabbix-db-client-tls-secret type: Opaque Certificates must include `"-----BEGIN RSA PRIVATE KEY-----"` and `"-----END RSA PRIVATE KEY-----"`. For example: {width="600"} Then, during deployment, in the Zabbix component section and MySQL server (if using built-in server) choose the proper "TLS connection to database" option value and the "MySQL database certificates (client)" secret value. ##### Xifratge base del certificat de base de dades MySQL banda de la base de dades MySQL: apiVersion: v1 data: root-ca.pem: >- < root-ca.pem data> server-cert.pem: >- < server-cert.pem data> server-key.pem: >- < server-key.pem data> kind: Secret metadata: name: zabbix-db-server-tls-secret type: Opaque banda dels components de Zabbix: apiVersion: v1 data: client-cert.pem: >- < client-cert.pem data> client-key.pem: >- < client-key.pem data> root-ca.pem: >- < root-ca.pem data> kind: Secret metadata: name: zabbix-db-client-tls-secret type: Opaque Els certificats han d'incloure "-----BEGIN RSA PRIVATE KEY-----"" i `"-----END RSA PRIVATE KEY-----"`. Per exemple: {width="600"} Tot seguit, durant el desplegament, a la secció de components Zabbix i servidor MySQL (si utilitzeu un servidor integrat) trieu la "connexió TLS a la base de dades" i el valor secret "Certificats de base de dades MySQL (client)". #### MySQL database character set and collation If the Zabbix MySQL database was created with the utf8mb3 character set and utf8mb3_bin collation, it is strongly recommended to convert it to utf8mb4 character set and utf8mb4_bin collation before upgrading Zabbix, as described in [Repairing Zabbix database character set and collation](/manual/appendix/install/db_charset_coll). #### Conjunt de caràcters de base de dades MySQL i col·lecció Si la base de dades Zabbix MySQL es va crear amb el conjunt de caràcters utf8mb3 i la col·lació utf8mb3_bin, es recomana convertir-lo a conjunt de caràcters utf8mb4 i col·lació utf8mb4_bin abans d'actualitzar Zabbix, tal com es descriu a [Reparació del conjunt de caràcters de la base de dades Zabbix i la col·lació](/manual/appendix/install/db_charset). ##### MySQL database character set and collation Zabbix installations using a MySQL database created with the utf8mb3 character set and utf8mb3_bin collation may encounter issues. For example, a [known MySQL issue](https://bugs.mysql.com/bug.php?id=120323) can result in `Row size too large (> 8126)` errors during database schema upgrades or other DDL operations.<br> It is strongly recommended to convert databases using the utf8mb3 character set and utf8mb3_bin collation to utf8mb4 character set and utf8mb4_bin collation, as described in [Repairing Zabbix database character set and collation](/manual/appendix/install/db_charset_coll). ##### Conjunt de caràcters de base de dades MySQL i col·lecció Les instal·lacions de Zabbix que utilitzen una base de dades MySQL creada amb el conjunt de caràcters utf8mb3 i la col·lació utf8mb3_bin poden trobar problemes. Per exemple, un [conegut problema de MySQL](https://bugs.mysql.com/bug.php? id=120323) pot resultar en errors massa grans (> 8126)` durant les actualitzacions d'esquema de la base de dades o altres operacions de DDL. Es recomana convertir bases de dades utilitzant el conjunt de caràcters utf8mb3 i la col·lació utf8mb3_bin a utf8mb4 caràcter conjunt i utf8mb4_bin col·lació, com es descriu en [Reparació de Zabbix base de dades de caràcters conjunt i col·lació](/manual/apèndix/install/db_charset_coll). ### MySQL Export and import must be performed in tmux/screen to ensure that the session isn't dropped. See also: [Important notes](#important-notes) ### MySQL La exportació i importació s'hauran de fer a tmux/screen per assegurar que la sessió no es perd pas. Veieu també: [Notes importants](#important-notes) #### MySQL If a value contains a non-ASCII character in non UTF8 encoding - this character and the following will be discarded when the database stores this value. No warning messages will be written to the *zabbix\_server.log*.<br> Relevant for at least MySQL version 5.1.61. #### MySQL Si un valor conté un caràcter no-ASCII amb una codificació no-UTF8, aquest caràcter i els següents no es tindran pas en compte quan la base de dades l'emmagatzemi. No hi haurà pas cap missatge d'avís dins de *zabbix\_server.log*.<br> Pertinent com a mínim per MySQL versió 5.1.61. ### MySQL |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |mysql.custom.query\[connString,<username>,<password>,queryName,<args...>\]|<|<|<| |Returns the result of a custom query.|JSON object|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**queryName** - name of a custom query, must match SQL file name without an extension.<br>**args** - one or several comma-separated arguments to pass to a query.|Supported since Zabbix 6.0.21. For more information see the [MySQL plugin](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0) readme.| |mysql.db.discovery\[connString,<username>,<password>\]|<|<|<| |List of MySQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).|Result of the "show databases" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.db.size\[connString,<username>,<password>,dbName\]|<|<|<| |Database size in bytes.|Result of the "select coalesce(sum(data\_length + index\_length),0) as size from information\_schema.tables where table\_schema=?" SQL query for specific database in bytes.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**dbName** - Database name.| | |mysql.get\_status\_variables\[connString,<username>,<password>\]|<|<|<| |Values of global status variables.|Result of the "show global status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.ping\[connString,<username>,<password>\]|<|<|<| |Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues).|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.replication.discovery\[connString,<username>,<password>\]|<|<|<| |List of MySQL replications. Used for [low-level discovery](/manual/discovery/low_level_discovery).|Result of the "show slave status" SQL query in LLD JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | |mysql.replication.get\_slave\_status\[connString,<username>,<password>,<masterHost>\]|<|<|<| |Replication status.|Result of the "show slave status" SQL query in JSON format.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.<br>**masterHost** - Replication master host name. If none found, an error is returned. If this parameter is not specified, all hosts are returned.<br>Note that before Zabbix 6.0.23, the "masterHost" parameter is ignored and always the first master host is returned.| | |mysql.version\[connString,<username>,<password>\]|<|<|<| |MySQL version.|String with MySQL instance version.|**connString** - URI or session name.<br>**username, password** - MySQL login credentials.| | ### MySQL |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |mysql.custom.query\[connString,<nom d'usuari>,<mot de pas>,queryName,<args...>\]|<|<|<| |Retorna el resultat de la consulta personalitzada.|Objecte JSON |**connString** - URI o sessió anomenada.<br>**usuari, mot de pas** - credencials d'accés a MySQL.<br>**queryName** - nom de la consulta personalitzada; ha de coincidir amb el nom d'arxiu SQL sense extensió.<br>**args** - un o diferents arguments separats per comes, que es passen a la consulta.|S'admet des de Zabbix 6.0.21. Per tindre més informació, veieu les notes del [plugin MySQL](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/mysql/README.md?at=refs%2Fheads%2Frelease%2F6.0).| |mysql.db.discovery\[connString, \<nom d'usuari\>, \<mot de pas\>\]|<|<|<| |Llista de bases de dades MySQL. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Resultat de la consulta SQL "mostra bases de dades" en format LLD JSON.|**connString** - URI o nom de sessió. <br>**nom d'usuari, mot de pas** - credencials d'inici de sessió de MySQL.| | |mysql.db.size\[connString, \<nom d'usuari\>, \<mot de pas\>,dbName\]|<|<|<| |Mida de la base de dades en octets.|Resultat de la consulta SQL "trieu la fusió (sum(data\_length + index\_length),0) com a mida de la informació\_schema.tables on table\_schema=?" per a una base de dades específica en octets.|**connString** - URI o nom de sessió.<br>**nom d'usuari, mot de pas** - credencials d'inici de sessió MySQL.<br>**dbName** - Nom de la base de dades.| | |mysql.get\_status\_variables\[connString, \<nom d'usuari\>, \<mot de pas\>\]|<|<|<| |Valors de les variables d'estat global.|Resultat de la consulta SQL "mostrar l'estat global" en format JSON.|**connString** - URI o nom de sessió.<br>**nom d'usuari, mot de pas** - Credencials d'inici de sessió MySQL.| | |mysql.ping\[connString, \<nom d'usuari\>, \<mot de pas\>\]|<|<|<| |Prova si una connexió és activa o no.|1 - la connexió és activa<br><br>0 - la connexió s'avorta (si es produeix algun error, inclosos problemes d'AUTH i de configuració).|**connString** - URI o nom de sessió.<br>**nom d'usuari, mot de pas** - credencials d'inici de sessió de MySQL.| | |mysql.replication.discovery\[connString, \<nom d'usuari\>, \<mot de pas\>\]|<|<|<| |Llista de rèpliques de MySQL. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Resultat de la consulta SQL "mostra l'estat de l'esclau" en format LLD JSON.|**connString** - URI o nom de sessió.<br> **nom d'usuari, mot de pas** - credencials d'inici de sessió de MySQL.| | |mysql.replication.get\_slave\_status\[connString, \<nom d'usuari\>, \<mot de pas\>, \<masterHost\>\]|<|<|<| |Estat de la replicació.|Resultat de la consulta SQL "mostrar l'estat de l'esclau" en format JSON.|**connString** - URI o nom de sessió.<br>**nom d'usuari, mot de pas** - credencials d'inici de sessió de MySQL. <br>**masterHost** - Nom de l'equip mestre de replicació. Si no en troba cap, retorna un error. Si aquest paràmetre no s'especifica, retorna tots els equips.<br>Veieu que abans de Zabbix 6.0.23, el paràmetre "masterHost" s'ignora i retorna sempre el primer equip mestre.| | |mysql.version\[connString, \<nom d'usuari\>, \<mot de pas\>\]|<|<|<| |Versió de MySQL.|Cadena amb la versió de la instància de MySQL.|**connString** - URI o nom de sessió.<br>**nom d'usuari, mot de pas** - credencials d'inici de sessió de MySQL.| | #### MySQL/MariaDB Character sets utf8 (aka utf8mb3) and utf8mb4 are supported (with utf8_bin and utf8mb4_bin collation respectively) for Zabbix server/proxy to work properly with MySQL/MariaDB databases.<br> To avoid future problems, it is strongly recommended to use the utf8mb4 character set with the utf8mb4_bin collation for both new and existing installations. It is recommended to convert databases using the utf8mb3 character set and utf8mb3_bin collation to utf8mb4 character set and utf8mb4_bin collation, as described in [Repairing Zabbix database character set and collation](/manual/appendix/install/db_charset_coll). For Zabbix 6.0.11 and newer, deterministic triggers need to be created during the import of schema. On MySQL and MariaDB, this requires `GLOBAL log_bin_trust_function_creators = 1` to be set if binary logging is enabled and there is no superuser privileges and log_bin_trust_function_creators = 1 is not set in MySQL configuration file. If you are installing Zabbix from [packages](https://www.zabbix.com/download) or [containers](/manual/installation/containers), see the respective instructions. If you are installing Zabbix from sources: * Create and configure a database and a user. ```bash mysql -uroot -p<password> mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin; mysql> create user 'zabbix'@'localhost' identified by '<password>'; mysql> grant all privileges on zabbix.* to 'zabbix'@'localhost'; mysql> SET GLOBAL log_bin_trust_function_creators = 1; mysql> quit; ``` * Import the data into the database. For a Zabbix proxy database, only `schema.sql` should be imported (no images.sql nor data.sql). ```bash cd database/mysql mysql -uzabbix -p<password> zabbix < schema.sql # stop here if you are creating database for Zabbix proxy mysql -uzabbix -p<password> zabbix < images.sql mysql -uzabbix -p<password> zabbix < data.sql ``` `log_bin_trust_function_creators` can be disabled after the schema has been successfully imported: ```bash mysql -uroot -p<password> mysql> SET GLOBAL log_bin_trust_function_creators = 0; mysql> quit; ``` #### MySQL/MariaDB El conjunt de caracters utf8 (aka utf8mb3) i utf8mb4 es suporten (amb col·lació utf8_bin i utf8mb4_bin, respectivament) per tal que el servidor/proxy Zabbix treballi correctament amb la base de dades MySQL.<br> Per evitar problemes futurs, es recomana utilitzar el conjunt de caràcters utf8mb4 amb la col·lació utf8mb4_bin tant per a instal·lacions noves com existents. Es recomana convertir bases de dades utilitzant el conjunt de caràcters utf8mb3 i la col·lació utf8mb3_bin a conjunt de caràcters utf8mb4 i col·lació utf8mb4_bin, tal com es descriu a [Reparació del conjunt de caràcters de la base de dades Zabbix i la col·lació](/manual/apèndix/install/db_charset_coll). Per Zabbix 6.0.11 i posteriors, alguns triggers s'han de crear durant la importació de l'esquema. Amb MySQL i MariaDB, cal que s'estableixi `GLOBAL log_bin_trust_function_creators = 1` si s'ha activat el registre binari i si no hi ha privilegis de superusuari i no s'estableix pas el log_bin_trust_function_creators = 1 a l'arxiu de configuració de MySQL. Si instal·leu des dels [paquets](https://www.zabbix.com/download) de Zabbix o [contenidors](/manual/installation/containers), seguiu les instruccions corresponents. Si instal·leu Zabbix des de les fonts: * Creeu i configureu la base de dades i un usuari. ```bash mysql -uroot -p<password> mysql> create database zabbix character set utf8mb4 collate utf8mb4_bin; mysql> create user 'zabbix'@'localhost' identified by '<password>'; mysql> grant all privileges on zabbix.* to 'zabbix'@'localhost'; mysql> SET GLOBAL log_bin_trust_function_creators = 1; mysql> quit; ``` * Importeu la informació a la base de dades. Per la base de dades del proxy Zabbix, només s'ha d'importar `schema.sql` (sense images.sql ni data.sql). ```bash cd database/mysql mysql -uzabbix -p<password> zabbix < schema.sql # stop here if you are creating database for Zabbix proxy mysql -uzabbix -p<password> zabbix < images.sql mysql -uzabbix -p<password> zabbix < data.sql ``` `log_bin_trust_function_creators` es pot deshabilitar després que l'esquema s'hagi importat correctament: ```bash mysql -uroot -p<password> mysql> SET GLOBAL log_bin_trust_function_creators = 0; mysql> quit; ``` #### MySQL/MariaDB Historically, MySQL and derivatives used 'utf8' as an alias for utf8mb3 - MySQL's own 3-byte implementation of the standard UTF8, which is 4-byte. Starting from MySQL 8.0.28 and MariaDB 10.6.1, the 'utf8mb3' character set is deprecated and at some point its support will be dropped while 'utf8' will become a reference to 'utf8mb4'. Since Zabbix 6.0, 'utf8mb4' is supported. To avoid future problems, it is highly recommended to use 'utf8mb4'. Another advantage of switching to 'utf8mb4' is support of supplementary Unicode characters. ::: notewarning As versions before Zabbix 6.0 are not aware of utf8mb4, make sure to first upgrade Zabbix server and DB schema to 6.0.x before executing utf8mb4 conversion. ::: **1.** Check the database character set and collation. For example: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ Or: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ As we see, the character set here is not 'utf8mb4' and collation is not 'utf8mb4\_bin', so we need to fix them. **2.** Stop Zabbix. **3.** Create a backup copy of the database! **4.** Fix the character set and collation on database level: alter database <your DB name> character set utf8mb4 collate utf8mb4_bin; Fixed values: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8mb4 | utf8mb4_bin | +--------------------------+----------------------+ **5.** Load the [script](../../../../assets/en/manual/appendix/install/utf8mb4_convert.sql) to fix character set and collation on table and column level: mysql <your DB name> < utf8mb4_convert.sql **6.** Execute the script: SET @ZABBIX_DATABASE = '<your DB name>'; If MariaDB → set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); If MariaDB → set innodb_strict_mode = ON; drop procedure zbx_convert_utf8; Please note that 'utf8mb4' is expected to consume slightly more disk space. **7.** If no errors - you may want to create a database backup copy with the fixed database. **8.** Start Zabbix. #### MySQL/MariaDB Històricament, MySQL i els seus derivats 'utf8' com a àlias de utf8mb3 - la pròpia implementació de 3 octets de MySQL de l'UTF8 estàndard, que és de 4 octets. A partir de MySQL 8.0.28 i MariaDB 10.6.1, el joc de caràcters 'utf8mb3' és obsolet i en un moment donat, el seu suport es deixarà de banda mentre que 'utf8' esdevindrà la referència a 'utf8mb4'. Des de Zabbix 6.0, es suporta 'utf8mb4'. Per evitar problemes futurs, es recomana emprar 'utf8mb4'. Un altre avantatge de passar a 'utf8mb4' és el suport dels caràcters Unicode suplementaris. ::: notewarning Com les versions anteriors a Zabbix 6.0 no s'entenen amb utf8mb4, assegureu-vos d'actualitzar primer el servidor Zabbix i l'esquema de la base de dades a la versió 6.0.x abans d'executar la conversió a utf8mb4. ::: **1.** Verifiqueu el joc de caràcters i la classificació de la base de dades. Per exemple: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | latin2 | latin2 _general_ci | +--------------------------+----------------------+ O: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8 | utf8_bin | +--------------------------+----------------------+ Tal com ho veiem, el joc de caràcters aquí no és pas 'utf8mb4' i la classificació no és pas 'utf8mb4\_bin'; per tant ho hem de corregir. **2.** Aturem Zabbix. **3.** Creem una còpia de seguretat de la base de dades! **4.** Corregim el joc de caràcters i la classificació a nivell de la base de dades: alter database <your DB name> character set utf8mb4 collate utf8mb4_bin; Valors corregits: mysql> SELECT @@character_set_database, @@collation_database; +--------------------------+----------------------+ | @@character_set_database | @@collation_database | +--------------------------+----------------------+ | utf8mb4 | utf8mb4_bin | +--------------------------+----------------------+ **5.** Carreguem l'[script](../../../../assets/en/manual/appendix/install/utf8mb4_convert.sql) per tal de corregir el joc de caràcters i la classificació a nivell de la taula i de la columna: mysql <your DB name> < utf8mb4_convert.sql **6.** Executem l'script : SET @ZABBIX_DATABASE = '<nom de votre base de données>'; Si MariaDB → set innodb_strict_mode = OFF; CALL zbx_convert_utf8(); Si MariaDB → set innodb_strict_mode = ON; drop procedure zbx_convert_utf8; Fixeu-vos que 'utf8mb4' ha de consumir una mica més d'espai de disc. **7.** Si no hi ha pas errors, podem crear una còpia de seguretat de la base de dades amb la base de dades corregida. **8.** Engeguem Zabbix. **MySQL plugin parameters** The following MySQL plugin parameters are no longer mandatory if Plugins.Mysql.Sessions.<SessionName>.TLSConnect is set to *verify_ca* or *verify_full*: - Plugins.Mysql.Sessions.<SessionName>.TLSCertFile - Plugins.Mysql.Sessions.<SessionName>.TLSKeyFile **Paràmetres del plugin MySQL** Els paràmetres del connector MySQL següents ja no són obligatoris si Plugins.MySQL.Sessions.<SessionName>.TLSConnect s'estableix a *verify_ca* o *verify_full*: - Plugins.MySQL.Sessions.<SessionName>.TLSCertFile - Plugins.MySQL.Sessions.<SessionName>.TLSKeyFile ##### MySQL Several user parameters can be used for the monitoring of MySQL in the agent configuration file: /usr/local/etc/zabbix\_agentd.conf ### Set of parameters for monitoring MySQL server (v3.23.42 and later) ### Change -u and add -p if required #UserParameter=mysql.ping,mysqladmin -uroot ping|grep alive|wc -l #UserParameter=mysql.uptime,mysqladmin -uroot status|cut -f2 -d":"|cut -f2 -d" " #UserParameter=mysql.threads,mysqladmin -uroot status|cut -f3 -d":"|cut -f2 -d" " #UserParameter=mysql.questions,mysqladmin -uroot status|cut -f4 -d":"|cut -f2 -d" " #UserParameter=mysql.slowqueries,mysqladmin -uroot status|cut -f5 -d":"|cut -f2 -d" " #UserParameter=mysql.qps,mysqladmin -uroot status|cut -f9 -d":"|cut -f2 -d" " #UserParameter=mysql.version,mysql -V - *mysql.ping* Check whether MySQL is alive. Result: 0 - not started 1 - alive - *mysql.uptime* Number of seconds MySQL is running. - *mysql.threads* Number of MySQL threads. - *mysql.questions* Number of processed queries. - *mysql.slowqueries* Number of slow queries. - *mysql.qps* Queries per second. - *mysql.version* Version of MySQL. For example: mysql Ver 14.14 Distrib 5.1.53, for pc-linux-gnu (i686) For additional information see also the userparameter\_mysql.conf file in conf/zabbix\_agentd directory. ##### MySQL Molts paràmetres d'usuari es poden emprar per monitorar MySQL a l'arxiu de configuració de l'agent : /usr/local/etc/zabbix\_agentd.conf ### Conjunt de paràmetres per monitorar el servidor MySQL (v3.23.42 i posteriors) ### Canviar -u i afegir -p, si escau #UserParameter=mysql.ping,mysqladmin -uroot ping|grep alive|wc -l #UserParameter=mysql.uptime,mysqladmin -uroot status|cut -f2 -d":"|cut -f2 -d" " #UserParameter=mysql.threads,mysqladmin -uroot status|cut -f3 -d":"|cut -f2 -d" " #UserParameter=mysql.questions,mysqladmin -uroot status|cut -f4 -d":"|cut -f2 -d" " #UserParameter=mysql.slowqueries,mysqladmin -uroot status|cut -f5 -d":"|cut -f2 -d" " #UserParameter=mysql.qps,mysqladmin -uroot status|cut -f9 -d":"|cut -f2 -d" " #UserParameter=mysql.version,mysql -V - *mysql.ping* Verificar si MySQL s'ha engegat. Resultat : 0 - no engegat 1 - engegat - *mysql.uptime* Nombre de segons d'execució de MySQL. - *mysql.threads* Nombre de fils MySQL. - *mysql.questions* Nombre de peticions tractades. - *mysql.slowqueries* Nombre de peticions lentes. - *mysql.qps* Peticions per segon. - *mysql.version* Versió de MySQL. Per exemple: mysql Ver 14.14 Distrib 5.1.53, per pc-linux-gnu (i686) Per tindre més informació, consulteu l'arxiu userparameter\_mysql.conf de la carpeta conf/zabbix\_agentd. ##### Named sessions Named sessions represent an additional level of plugin parameters and can be used to specify separate sets of authentication parameters for each of the instances being monitored. Each named session parameter should have the following structure: *Plugins.<PluginName>.Sessions.<SessionName>.<Parameter>=<Value>* A session name can be used as a connString item key parameter instead of specifying a URI, username, and/or password separately. In item keys, the first parameter can be either a connString or a URI. If the first key parameter doesn't match any session name, it will be treated as a URI. Note that embedding credentials into a URI is not supported, use named session parameters instead. The list of available [named session parameters](/manual/appendix/config/zabbix_agent2_plugins) depends on the plugin. *In Zabbix versions before 6.0.17*, when providing a connString (session name) in key parameters, item key parameters for username and password must be empty. The values will be taken from the session parameters. If an authentication parameter is not specified for the named session, a hardcoded default value will be used. *Since Zabbix 6.0.17*, it is possible to override session parameters by specifying new values in the item key parameters (see [example](#example-2)). *Since Zabbix 6.0.18*, if a parameter is not defined for the named session, Zabbix agent 2 will use the value defined in the [default plugin parameter](#default-values). #### Sessions anomenades Les sessions amb nom representen un nivell addicional de configuració del connector i es poden emprar per definir conjunts separats de paràmetres d'autenticació per a cada instància monitorada. Cada paràmetre de sessió anomenada ha de tindre l'estructura següent: *Plugins.<PluginName>.Sessions.<SessionName>.<Parameter>=<Value>* Un nom de sessió es pot emprar com a paràmetre de clau d'element connString en lloc d'especificar un URI, un nom d'usuari i un mot de pas per separat. A les claus d'element, el primer paràmetre pot ésser un connString o un URI. Si el primer paràmetre clau coincideix amb un nom de sessió especificat al fitxer de configuració, la comprovació s'executarà mitjançant els paràmetres de sessió indicats. Si el primer paràmetre de clau no coincideix amb cap nom de sessió, es tractarà com a URI. La llista dels [paràmetres de sessions anomenades](/manual/appendix/config/zabbix_agent2_plugins) disponibles depenen del plugin. *A les versions de Zabbix anteriors a la 6.0.17*, quan es proporcioni una connString (nom de sessió) als paràmetres clau, els paràmetres clau d'element per al nom d'usuari i el mot de pas han de ser buits. Els valors es prendran dels paràmetres de sessió. Si no s'especifica un paràmetre d'autenticació per a la sessió anomenada, s'emprarà un valor predeterminat codificat en cru. *Des de Zabbix 6.0.17*, podeu substituir els paràmetres de sessió especificant nous valors als paràmetres clau de l'element. En aquest cas: *Des de Zabbix 6.0.18*, si no es defineix un paràmetre per la sessió anomenada, l'agent 2 de Zabbix emprarà el valor definit al [paràmetre per defecte del plugin](#default-values). ## NAME zabbix\_agent2 - Zabbix agent 2\ \ [ ]{#lbAC} ## NOM zabbix\_agent2 - Agent de Zabbix 2\ \ [ ]{#lbAC} ## NAME zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ## NOM zabbix\_agentd - Zabbix agent daemon [ ]{#lbAC} ## NAME zabbix\_get - Zabbix get utility [ ]{#lbAC} ## NOM zabbix\_get - utilitat de Zabbix get [ ]{#lbAC} ## NAME zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## NOM zabbix\_js - Zabbix JS utility [ ]{#lbAC} ## NAME zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## NOM zabbix\_proxy - Zabbix proxy daemon [ ]{#lbAC} ## NAME zabbix\_sender - Zabbix sender utility [ ]{#lbAC} ## NOM zabbix\_sender - Utilitat de Zabbix sender [ ]{#lbAC} ## NAME zabbix\_server - Zabbix server daemon [ ]{#lbAC} ## NOM zabbix\_server - dimoni servidor Zabbix [ ]{#lbAC} ## NAME zabbix\_web\_service - Zabbix web service [ ]{#lbAC} ## NOM zabbix\_web\_service - Servei web de Zabbix [ ]{#lbAC} ##### Naming and location of persistent files Zabbix agent distinguishes active checks by their keys. For example, logrt\[/home/zabbix/test.log\] and logrt\[/home/zabbix/test.log,\] are different items. Modifying the item logrt\[/home/zabbix/test.log,,,10\] in frontend to logrt\[/home/zabbix/test.log,,,20\] will result in deleting the item logrt[/home/zabbix/test.log,,,10] from the agent's list of active checks and creating logrt\[/home/zabbix/test.log,,,20\] item \(some attributes are carried across modification in frontend/server, not in agent\). The file name is composed of MD5 sum of item key with item key length appended to reduce possibility of collisions. For example, the state of logrt\[/home/zabbix50/test.log,,,,,,,,/home/zabbix50/agent_private\] item will be kept in persistent file c963ade4008054813bbc0a650bb8e09266. Multiple log items can use the same value of **persistent\_dir**. **persistent\_dir** is specified by taking into account specific file system layouts, mount points and mount options and storage mirroring configuration - the persistent file should be on the same mirrored filesystem as the monitored log file. If **persistent\_dir** directory cannot be created or does not exist, or access rights for Zabbix agent does not allow to create/write/read/delete files the log item becomes NOTSUPPORTED. ##### Nomenament i ubicació dels arxius persistents L'agent Zabbix distingeix les validacions actius per les seves claus. Per exemple, logrt\[/home/zabbix/test.log\] i logrt\[/home/zabbix/test.log,\] són elements diferents. Si canvieu l'element logrt\[/home/zabbix/test.log,,,10\] a la interfície a logrt\[/home/zabbix/test.log,,,20\] farà que l'element logrt[/home /zabbix/test.log,,,10] s'esborri de la llista de comprovacions actives de l'agent creant l'element logrt\[/home/zabbix/test.log,,,20\]\ (alguns atributs es passen quan s'editen a la interfície/servidor, no pas a l'agent\). El nom del fitxer es composa de la suma MD5 de la clau d'element amb la longitud de la clau d'element afegida per reduir el risc de col·lisions. Per exemple, l'estat de l'element logrt\[/home/zabbix50/test.log\,\,\,\,\,\,\,\,/home/zabbix50/agent_private\] es mantindrà al fitxer persistent c963ade4008054813bbc0a650bb8e09266. Diversos elements de registre poden emprar el mateix valor **persistent\_dir**. **persistent\_dir** s'especifica tinguent en compte els dissenys específics del sistema de fitxers, els punts de muntatge i les opcions de muntatge i la configuració de rèplica d'emmagatzematge: el fitxer persistent ha d'ésser al mateix sistema de fitxers duplicat que el fitxer de registre monitorat. Si no es pot crear el directori **persistent\_dir** o no existeix, o si els drets d'accés per a l'agent Zabbix no permeten crear/escriure/llegir/esborrar fitxers, el registre d'elements esdevindrà NO SUPORTAT. ##### Naming convention Before you create a module, it is important to agree on the naming convention for different module items such as directories and files so that we could keep things well organized. You can also find examples above, in the [Module structure](#module_structure) section. |Item|Naming rules|Example| |----|------------|-------| |*Module directory*|Lowercase \[a-z\], underscore and decimal digits|example\_v2| |*Action subdirectories*|Lowercase \[a-z\] and underscore character|data\_export| |*Action files*|CamelCase, ending with action type|SomethingView.php| |*View and partial files*|Lowercase \[a-z\]<br>Words separated with dot<br>Prefixed by `module.` followed by module name<br>Ending with action type and .php file extension|module.example.something.view.php| |*Javascript files*|The same rules apply as for view and partial files, except the .js.php file extension.|module.example.something.view.js.php| Note that the 'module' prefix and name inclusion is mandatory for view and partial file names, unless you need to override Zabbix core views or partials. This rule, however, does not apply to action file names. ##### Convenció de nomenclatura Abans de crear un mòdul, és important acordar la convenció de nomenclatura dels diferents elements del mòdul, com ara directoris i fitxers, per tal de poder mantindre les coses organitzades. També podeu trobar exemples més amunt, a la secció [Estructura del mòdul](#module_structure). |Element|Regles de nomenclatura|Exemple| |----|-------------|-------| |*Directori del mòdul*|Minúscules \[a-z\], guions baixos i dígits decimals|exemple\_v2| |*Subdirectoris d'acció*|Minúscules \[a-z\] i guions baixos|dades\_exportació| |*Fitxers d'acció*|Casos d'ús, que acaben amb el tipus d'acció|SomethingView.php| |*visualització i fitxers parcials*|Minúscules \[a-z\]<br>Paraules separades per un punt<br>Prefixat amb `mòdul.` seguit del nom del mòdul<br>Acabat amb el tipus d'acció i l'extensió del fitxer .php|mòdul.exemple.alguna cosa.vista.php| |*Fitxers Javascript*|S'apliquen les mateixes regles que per als fitxers de visualització i parcials, excepte per a l'extensió de fitxer .js.php.|module.example.something.view.js.php| Tingueu en compte que el prefix del "mòdul" i la inclusió del nom són obligatoris per als noms de fitxers de visualització i parcials, tret que hàgiu de substituir les vistes principals o parcials de Zabbix. Aquesta regla, però, no s'aplica als noms dels fitxers d'acció. Navigation tree elements are displayed in a list. You can: - drag an element (including its child elements) to a new place in the list; - expand or collapse an element to display or hide its child elements; - add a child element (with or without a linked map) to an element; - add multiple child elements (with linked maps) to an element; - edit an element; - remove an element (including its child elements). {width="600"} Els elements de l'arbre de navegació es mostren a una llista. Podeu: - arrossegar un element (inclosos els elements descendents) a un nou lloc de la llista; - expandir o encongir un element per veure o amagar els seus elements descendents; - afegir un element fill (amb o sense un mapa enllaçat) a un element; - afegir diversos elements fills (amb o sense un mapes enllaçats) a un element; - editar un element; - esborrar un element (incloent els seus elements descendents). {width="600"} #### Negative problem duration It is actually possible in some common situations to have negative problem duration i.e. when the problem resolution time is earlier than problem creation time, e. g.: - If some host is monitored by proxy and a network error happens, leading to no data received from the proxy for a while, the nodata(/host/key) trigger will be fired by the server. When the connection is restored, the server will receive item data from the proxy having a time from the past. Then, the nodata(/host/key) problem will be resolved and it will have a negative problem duration; - When item data that resolve the problem event are sent by Zabbix sender and contain a timestamp earlier than the problem creation time, a negative problem duration will also be displayed. ::: noteclassic Negative problem duration is not affecting [SLA calculation](/manual/it_services) or [Availability report](/manual/web_interface/frontend_sections/reports/availability) of a particular trigger in any way; it neither reduces nor expands problem time. ::: #### Durada negativa del problema És possible que en algunes situacions habituals el problema tingui una durada negativa, és a dir, quan el temps de resolució del problema és anterior al temps de creació del problema, per exemple: - Si un proxy és monitorat per un proxy i es produeix un error de xarxa que fa que no es rebin dades del proxy durant un període de temps, el servidor activarà el trigger nodata(/host/key). Quan es restableixi la connexió, el servidor rebrà dades d'elements del proxy en temps passat. Aleshores, el problema nodata(/host/key) es resoldrà i tindrà una durada negativa; - Quan el remitent de Zabbix envia les dades de l'element que resol l'esdeveniment del problema i contenen una marca de temps anterior a l'hora de creació del problema, també es mostrarà una durada negativa del problema. :::noteclassic La durada del problema negatiu no afecta de cap manera el [càlcul SLA](/manual/it_services) o l'[informe de disponibilitat](/manual/web_interface/frontend_sections/reports/availability) d'un trigger concret; no redueix ni allarga el temps del problema. ::: #### NetBSD 8.0 and newer Various Zabbix processes may randomly crash on startup on the NetBSD versions 8.X and 9.X. That is due to the too small default stack size (4MB), which must be increased by running: ulimit -s 10240 For more information, please see the related problem report: [ZBX-18275](https://support.zabbix.com/browse/ZBX-18275). #### NetBSD 8.0 i més recent Diversos processos Zabbix es poden bloquejar aleatòriament a l'inici a les versions 8.X i 9.X de NetBSD. Això es deu al fet que la mida de la pila per defecte és massa petita (4 Mo), i es pot d'augmentar executant: límit -s 10240 Per obtindre més informació, consulteu l'informe del problema relacionat: [ZBX-18275](https://support.zabbix.com/browse/ZBX-18275). #### Net service name Since Zabbix 5.4.0 it is possible to connect to Oracle by using net service name. <net\_service\_name> is a simple name for a service that resolves to a connect descriptor. In order to use the service name for creating a connection, this service name has to be defined in the tnsnames.ora file located on both the database server and the client systems. The easiest way to make sure that the connection will succeed is to define the location of tnsnames.ora file in the TNS\_ADMIN environment variable. The default location of the tnsnames.ora file is: $ORACLE_HOME/network/admin/ A simple tnsnames.ora file example: ORCL = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = ORCL) ) ) To set configuration parameters for the "Net Service Name" connection method, use one of the following options: - Set an empty parameter DBHost and set DBName as usual: ```{=html} <!-- --> ``` DBHost= DBName=ORCL - Set both parameters and leave both empty: ```{=html} <!-- --> ``` DBHost= DBName= In the second case, the TWO\_TASK environment variable has to be set. It specifies the default remote Oracle service (service name). When this variable is defined, the connector connects to the specified database by using an Oracle listener that accepts connection requests. This variable is for use on Linux and UNIX only. Use the LOCAL environment variable for Microsoft Windows. **Example:** Connect to a database using Net Service Name set as ORCL and the default port. Database parameters set in the server or proxy configuration file (zabbix\_server.conf and zabbix\_proxy.conf): DBHost= #DBPort= DBUser=myusername DBName=ORCL DBPassword=mypassword During Zabbix frontend installation, set the corresponding parameters in the *Configure DB connection* step of the setup wizard: - Database host: - Database port: 0 - 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"] = ''; $DB["PORT"] = '0'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; Connection string used by Zabbix to establish connection: DBUser/DBPassword@ORCL #### Nom del servei de xarxa Des de Zabbix 5.4.0, és possible connectar-se a Oracle emprant el nom del servei de xarxa. <net\_service\_name> és un nom simple per un servei que resol cap a un descriptor de connexió. Per emprar el nom del servei per crear una connexió, el nom s'ha de definir a l'arxiu tnsnames.ora que hi ha al servidor de base de dades i als sistemes clients. La manera més simple d'assegurar-vos que la connexió funcionarà és definir la ubicació de l'arxiu tnsnames.ora dins la variable d'entorn TNS\_ADMIN. La ubicació per defecte de l'arxiu tnsnames.ora és: $ORACLE_HOME/network/admin/ Un exemple simple d'arxiu tnsnames.ora : ORCL = (DESCRIPTION = (ADDRESS = (PROTOCOL = TCP)(HOST = localhost)(PORT = 1521)) (CONNECT_DATA = (SERVER = DEDICATED) (SERVICE_NAME = ORCL) ) ) Per definir els paràmetres de configuració del mètode de connexió "Nom del servei de xarxa", empreu una de les opcions següents: - Definiu un paràmetre DBHost buit i definiu DBName com de costum: ```{=html} <!-- --> ``` DBHost= DBName=ORCL - Definiu dos paràmetres i deixeu-los buits: ```{=html} <!-- --> ``` DBHost= DBName= En el segon cas, la variable d'entorn TWO\_TAKS s'ha de definir. Aquesta especifica el servei Oracle remot per defecte (nom del servei). Quan aquesta variable sigui definida, el connector es connectarà a la base de dades especificada emprarnt un escoltador Oracle que accepti les peticions de connexió. Aquesa variable s'empra només amb Linux i Unix. Empreu la variable d'entorn LOCAL per a Microsoft Windows. **Exemple:** Connecteu-vos a una base de dades emprant el nom de servei de xarxa definit a ORCL i el port per defecte. Paràmetres de la base de dades definits a l'arxiu de configuració del servidor o del proxy (zabbix\_server.conf et zabbix\_proxy.conf) : DBHost= #DBPort= DBUser=myusername DBName=ORCL DBPassword=mypassword Durant la instal·lació de la interfície Zabbix, definiu els paràmetres corresponents a la fase *Configurar la connexió a la base de dades* de l'assistent d'instal·lació: - Equip de la base de dades: - Port de la base de dades: 0 - Nom de la base de dades: ORCL - Usuari: myusername - Paraula de pas: mypassword {width="600"} Alternativament, aquests paràmetres es poden definir a ll'arxiu de configuració del frontal (zabbix.conf.php): $DB["TYPE"] = 'ORACLE'; $DB["SERVER"] = ''; $DB["PORT"] = '0'; $DB["DATABASE"] = 'ORCL'; $DB["USER"] = 'myusername'; $DB["PASSWORD"] = 'mypassword'; Cadena de connexió emprada per Zabbix per establir la connexió: DBUser/DBPassword@ORCL ##### Network data |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**net.dns**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Checks if DNS service is up.|0 - DNS is down (server did not respond or DNS resolution failed)<br><br>1 - DNS is up|**ip** - IP address of DNS server (leave empty for the default DNS server, on Windows supported for Zabbix agent 2, ignored for Zabbix agent)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol** (since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns*| |**net.dns.record**\[<ip>,name,<type>,<timeout>,<count>,<protocol>\]|<|<|<| |Performs a DNS query.|Character string with the required type of information|**ip** - IP address of DNS server (leave empty for the default DNS server, ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer)<br>**name** - DNS name to query<br>**type** - record type to be queried (default is *SOA*)<br>**timeout** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - timeout for the request in seconds (default is 1 second)<br>**count** (ignored on Windows, unless using Zabbix agent 2 version 6.0.1 or newer) - number of tries for the request (default is 2)<br>**protocol**(since version 3.0) - the protocol used to perform DNS queries: *udp* (default) or *tcp*|Example:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>The possible values for `type` are:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (not supported for Zabbix agent on Windows, Zabbix agent 2 on all OS), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>Internationalized domain names are not supported, please use IDNA encoded names instead.<br><br>SRV record type is supported since Zabbix 1.8.6 (Unix) and 2.0.0 (Windows).<br><br>Naming before Zabbix 2.0 (still supported): *net.tcp.dns.query*| |**net.if.collisions**\[if\]|<|<|<| |Number of out-of-window collisions.|Integer|**if** - network interface name| | |**net.if.discovery**|<|<|<| |List of network interfaces. Used for low-level discovery.|JSON object| |Supported since Zabbix 2.0.<br><br>On FreeBSD, OpenBSD and NetBSD supported since Zabbix 2.2.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |**net.if.in**\[if,<mode>\]|<|<|<| |Incoming traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*frame* - the number of packet framing errors<br>*compressed* - the number of compressed packets received by the device driver<br>*multicast* - the number of multicast frames received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix 1.8.6.<br><br>Examples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.out**\[if,<mode>\]|<|<|<| |Outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*collisions (colls)* - the number of collisions detected on the interface<br>*carrier* - the number of carrier losses detected by the device driver<br>*compressed* - the number of compressed packets transmitted by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Multi-byte interface names on Windows are supported since Zabbix agent 1.8.6 version.<br><br>Examples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.| |**net.if.total**\[if,<mode>\]|<|<|<| |Sum of incoming and outgoing traffic statistics on network interface.|Integer|**if** - network interface name (Unix); network interface full description or IPv4 address; or, if in braces, network interface GUID (Windows)<br>**mode** - possible values:<br>*bytes* - number of bytes (default)<br>*packets* - number of packets<br>*errors* - number of errors<br>*dropped* - number of dropped packets<br>*overruns (fifo)* - the number of FIFO buffer errors<br>*compressed* - the number of compressed packets transmitted or received by the device driver|On Windows, the item gets values from 64-bit counters if available. 64-bit interface statistic counters were introduced in Windows Vista and Windows Server 2008. If 64-bit counters are not available, the agent uses 32-bit counters.<br><br>Examples:<br>=> net.if.total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>You may obtain network interface descriptions on Windows with net.if.discovery or net.if.list items.<br><br>You may use this key with the *Change per second* preprocessing step in order to get bytes per second statistics.<br><br>Note that dropped packets are supported only if both net.if.in and net.if.out work for dropped packets on your platform.| |**net.tcp.listen**\[port\]|<|<|<| |Checks if this TCP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - TCP port number|Example:<br>=> net.tcp.listen\[80\]<br><br>On Linux supported since Zabbix 1.8.4<br><br>Since Zabbix 3.0.0, on Linux kernels 2.6.14 and above, information about listening TCP sockets is obtained from the kernel's NETLINK interface, if possible. Otherwise, the information is retrieved from /proc/net/tcp and /proc/net/tcp6 files.| |**net.tcp.port**\[<ip>,port\]|<|<|<| |Checks if it is possible to make TCP connection to specified port.|0 - cannot connect<br><br>1 - can connect|**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number|Example:<br>=> net.tcp.port\[,80\] → can be used to test availability of web server running on port 80.<br><br>For simple TCP performance testing use net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).| |**net.tcp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and accepting TCP connections.|0 - service is down<br><br>1 - service is running|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service\[ftp,,45\] → can be used to test the availability of FTP server on TCP port 45.<br><br>Note that these checks may result in additional messages in system daemon logfiles (SMTP and SSH sessions being logged usually).<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.port for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of TCP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent while connecting to the service|**service** - either of:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.tcp.service.perf\[ssh\] → can be used to test the speed of initial response from SSH server.<br><br>Checking of encrypted protocols (like IMAP on port 993 or POP on port 995) is currently not supported. As a workaround, please use net.tcp.service.perf\[tcp,<ip>,<port>\] for checks like these.<br><br>Checking of LDAP and HTTPS on Windows is only supported by Zabbix agent 2.<br><br>Note that the telnet check looks for a login prompt (':' at the end).<br><br>*https* and *telnet* services are supported since Zabbix 2.0.| |**net.tcp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of TCP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *syn\_sent*, *syn\_recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.tcp.socket.count\[,80,,,established\] → returns the number of connections to local TCP port 80 in the *established* state<br><br>This item is supported since Zabbix 6.0.| |**net.udp.listen**\[port\]|<|<|<| |Checks if this UDP port is in LISTEN state.|0 - it is not in LISTEN state<br><br>1 - it is in LISTEN state|**port** - UDP port number|Example:<br>=> net.udp.listen\[68\]<br><br>On Linux supported since Zabbix 1.8.4| |**net.udp.service**\[service,<ip>,<port>\]|<|<|<| |Checks if service is running and responding to UDP requests.|0 - service is down<br><br>1 - service is running|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service\[ntp,,45\] → can be used to test the availability of NTP service on UDP port 45.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.service.perf**\[service,<ip>,<port>\]|<|<|<| |Checks performance of UDP service.|Float<br><br>0 - service is down<br><br>seconds - the number of seconds spent waiting for response from the service|**service** - *ntp* (see [details](/manual/appendix/items/service_check_details))<br>**ip** - IP or DNS name (default is 127.0.0.1)<br>**port** - port number (by default standard service port number is used)|Example:<br>=> net.udp.service.perf\[ntp\] → can be used to test response time from NTP service.<br><br>This item is supported since Zabbix 3.0.0, but *ntp* service was available for net.tcp.service\[\] item in prior versions.| |**net.udp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<state>\]|<|<|<| |Return the number of UDP sockets that match parameters.|Integer|**laddr** - local IPv4/6 address or CIDR subnet<br>**lport** - local port number or service name<br>**raddr** - remote IPv4/6 address or CIDR subnet<br>**rport** - remote port number or service name<br>**state** - connection state (*established*, *unconn*)|This item is supported on Linux only on both Zabbix agent/agent 2. On Zabbix agent 2 it is also supported on 64-bit Windows.<br><br>Example:<br>=> net.udp.socket.count\[,,,,established\] → returns the number of UDP socket in the connected state<br><br>This item is supported since Zabbix 6.0.| ##### Dades de xarxa |Clau d'element|<|<|<| |--|--|------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |**net.dns**\[<ip>,nom,<tipus>,<temps d'espera>,<recompte>,<protocol>\]|<|<|<| |Comprova si el servei DNS és actiu.|0 - El DNS és inactiu (el servidor no ha respost o la resolució del DNS ha fallat)<br><br>1 - El DNS és actiu|**ip** - L'adreça IP del servidor DNS (deixeu-lo en blanc per al servidor DNS predeterminat, a Windows compatible amb l'agent Zabbix 2, ignorat per a l'agent Zabbix)<br>**nom** - nom DNS per consultar<br>**tipus** - tipus de registre que s'ha de consultar (el valor predeterminat és *SOA*)<br>**temps d'espera** (ignorat a Windows, tret que s'empri l'agent Zabbix 2 versió 6.0.1 o posterior) - temps d'espera per a la petició en segons (el valor predeterminat és 1 segon)<br>**compte** (ignorat a Windows, tret que empreu l'agent Zabbix 2 versió 6.0.1 o posterior) - nombre d'intents per a la petició (el valor predeterminat és 2)<br>**protocol** (des de la versió 3.0) - el protocol emprat per fer consultes DNS: *udp* (per defecte) o *tcp*|Exemple:<br>=> net.dns\[8.8.8.8,example.com,MX,2,1\]<br><br>Els valors possibles per a `type` són:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (no és compatible amb l'agent Zabbix a Windows, l'agent Zabbix 2 a tots els sistemes operatius), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br> <br>No s'admeten els noms de domini internacionalitzats, si us plau, empreu noms codificats IDNA.<br><br>El tipus de registre SRV és compatible des de Zabbix 1.8.6 (Unix) i 2.0.0 (Windows).<br><br>Anomenament abans de Zabbix 2.0 (encara compatible): *net.tcp.dns*| |**net.dns.record**\[<ip>,nom,<tipus>,<timeout>,<count>,<protocol>\]|<|<|<| |Realitza una consulta DNS.|Cadena de caràcters amb el tipus d'informació requerit|**ip** - Adreça IP del servidor DNS (deixeu buit per al servidor DNS predeterminat, ignorat a Windows, tret que empreu l'agent Zabbix 2 versió 6.0.1 o més recent)<br>**nom** - nom DNS per consultar<br>**tipus** - tipus de registre que s'ha de consultar (el valor predeterminat és *SOA*)<br>**temps d'espera** (ignorat a Windows, tret que utilitzant l'agent Zabbix 2 versió 6.0.1 o posterior) - temps d'espera per la petició en segons (el valor predeterminat és 1 segon)<br>**compte** (s'ignora a Windows, tret que s'utilitzi l'agent Zabbix 2 versió 6.0.1 o posterior) - nombre d'intents per a la petició (el valor per defecte és 2)<br>**protocol** (des de la versió 3.0) - el protocol emprat per realitzar consultes DNS: *udp* (predeterminat) o *tcp*|Exemple:<br>=> net.dns.record\[8.8.8.8,example.com,MX,2,1\]<br><br>Els valors possibles per a `type` són:<br>*ANY*, *A*, *NS*, *CNAME*, *MB*, *MG*, *MR*, *PTR*, *MD*, *MF*, *MX*, *SOA*, *NULL*, *WKS* (no compatible amb Agent Zabbix a Windows, agent Zabbix 2 a tots els sistemes operatius), *HINFO*, *MINFO*, *TXT*, *AAAA*, *SRV*<br><br>No s'admeten els noms de domini internacionalitzats, empreu noms codificats IDNA en lloc d'això.<br><br>El tipus de registre SRV s'admet des de Zabbix 1.8.6 (Unix) i 2.0.0 (Windows).<br><br>Anomenament abans de Zabbix 2.0 (encara compatible): *net.tcp.dns.consulta*| |**net.if.collisions**\[si\]|<|<|<| |Nombre de col·lisions fora de la finestra.|Enter|**sí** - nom de la interfície de xarxa| | |**net.if.discovery**|<|<|<| |Llistat d'interfícies de xarxa. S'empra per la descoberta de baix nivell.|Objecte JSON| |S'admet des de Zabbix 2.0.<br><br>A FreeBSD, OpenBSD i NetBSD s'admeten des de Zabbix 2.2.<br><br>Algunes versions de Windows (per exemple, Server 2008) poden requerir les darreres actualitzacions instal·lades per admetre caràcters no ASCII als noms d'interfície.| |**net.if.in**\[si,<mode>\]|<|<|<| |Estadístiques de trànsit entrant a la interfície de xarxa.|Enter|**sí** - nom de la interfície de xarxa (Unix); descripció completa de la interfície de xarxa o adreça IPv4; o, si és entre claus, GUID de la interfície de xarxa (Windows)<br>**mode** - valors possibles:<br>*octets* - nombre d'octets (per defecte)<br>*paquets* - nombre de paquets<br>*errors* - nombre d'errors<br>*caigut* - nombre de paquets caiguts<br>*desbordaments (fifo)* - nombre d'errors de memòria intermèdia FIFO<br>*frame* - nombre d'errors d'enquadrament de paquets<br>*comprimit* - el nombre de paquets comprimits rebuts pel controlador del dispositiu<br>*multicast* - el nombre de trames de multidifusió rebudes pel controlador del dispositiu|A Windows, l'element obté valors dels comptadors de 64 bits si és disponible. Els comptadors d'estadístiques de la interfície de 64 bits es van introduir a Windows Vista i Windows Server 2008. Si els comptadors de 64 bits no són disponibles, l'agent empra comptadors de 32 bits.<br><br>Els noms d'interfície de diversos octets a Windows són compatibles des de Zabbix 1.8.6.<br><br>Exemples:<br>=> net.if.in\[eth0,errors\]<br>=> net.if.in\[eth0\]<br><br> Podeu obtindre descripcions de la interfície de xarxa a Windows amb elements net.if.discovery o net.if.list.<br><br>Podeu emprar aquesta clau amb el pas de preprocessament *Canvi per segon* per obtindre estadístiques d'octets per segon.| |**net.if.out**\[si,<mode>\]|<|<|<| |Estadístiques de trànsit de sortida a la interfície de xarxa.|Enter|**sí** - nom de la interfície de xarxa (Unix); descripció completa de la interfície de xarxa o adreça IPv4; o, si és entre claus, GUID de la interfície de xarxa (Windows)<br>**mode** - valors possibles:<br>*octets* - nombre d'octets (per defecte)<br>*paquets* - nombre de paquets<br>*errors* - nombre d'errors<br>*caigut* - nombre de paquets caiguts<br>*desbordaments (fifo)* - el nombre d'errors de memòria intermèdia FIFO<br>*col·lisions (col·lisions)* - el nombre de col·lisions detectades a la interfície<br>*portador* - el nombre de pèrdues de portadora detectades pel controlador del dispositiu<br>*comprimit* - el nombre de paquets comprimits transmesos pel controlador del dispositiu|A Windows, l'element obté valors de 64 comptadors de bits si són disponibles. Els comptadors d'estadístiques de la interfície de 64 bits es van introduir a Windows Vista i Windows Server 2008. Si els comptadors de 64 bits no són pas disponibles, l'agent empra comptadors de 32 bits.<br><br>Els noms d'interfície de diversos octets a Windows són compatibles des de la versió de l'agent 1.8.6 de Zabbix.<br><br>Exemples:<br>=> net.if.out\[eth0,errors\]<br>=> net.if.out\[eth0\]<br><br>Podeu obtindre descripcions de la interfície de xarxa a Windows amb elements net.if.discovery o net.if.list.<br><br>Podeu emprar aquesta clau amb el pas de preprocessament *Canvi per segon* per obtindre octets per segona estadística.| |**net.if.total**\[si,<mode>\]|<|<|<| |Suma de les estadístiques de trànsit entrant i sortint a la interfície de xarxa.|Enter|**sí** - nom de la interfície de xarxa (Unix); descripció completa de la interfície de xarxa o adreça IPv4; o, si és entre claus, GUID de la interfície de xarxa (Windows)<br>**mode** - valors possibles:<br>*octets* - nombre d'octets (per defecte)<br>*paquets* - nombre de paquets<br>*errors* - nombre d'errors<br>*caigut* - nombre de paquets caiguts<br>*desbordaments (fifo)* - nombre d'errors de memòria intermèdia FIFO<br>*comprimit* - nombre de paquets comprimits transmesos o rebuts per el controlador del dispositiu|A Windows, l'element obté valors dels comptadors de 64 bits si és disponible. Els comptadors estadístics d'interfície de 64 bits es van introduir a Windows Vista i Windows Server 2008. Si no hi ha comptadors de 64 bits disponibles, l'agent empra comptadors de 32 bits.<br><br>Exemples:<br>=> net.if. total\[eth0,errors\]<br>=> net.if.total\[eth0\]<br><br>Podeu obtindre descripcions de la interfície de xarxa a Windows amb elements net.if.discovery o net.if.list.<br><br>Podeu emprar aquesta clau amb el pas de preprocessament *Canvi per segon* per obtindre estadístiques d'octets per segon.<br><br>Tingueu en compte que només s'admeten paquets abandonats si tant net.if.in com net.if.out funcionen per als paquets perduts a la vostra plataforma.| |**net.tcp.listen**\[port\]|<|<|<| |Comprova si aquest port TCP és en estat LISTEN.|0 - no és en estat LISTEN<br><br>1 - és en estat LISTEN|**port** - nombre de port TCP|Exemple:<br>=> net.tcp.listen\[80\]<br><br>A Linux suportat des de Zabbix 1.8.4<br><br>Des de Zabbix 3.0.0, als nuclis Linux 2.6.14 i posteriors, informació sobre com escoltar TCP sockets s'obté de la interfície NETLINK del nucli, si és possible. En cas contrari, la informació es recupera dels fitxers /proc/net/tcp i /proc/net/tcp6.| |**net.tcp.port**\[<ip>,port\]|<|<|<| |Comprova si és possible establir una connexió TCP al port especificat.|0 - no es pot connectar<br><br>1 - es pot connectar|**ip** - Nom IP o DNS (per defecte és 127.0.0.1)<br>**port** - nombre de port|Exemple:<br>=> net.tcp.port\[,80\] → es pot emprar per provar la disponibilitat del servidor web que s'executa al port 80.<br><br>Les proves de rendiment de TCP empren net.tcp.service.perf\[tcp,<ip>,<port>\]<br><br>Tingueu en compte que aquestes comprovacions poden donar lloc a missatges addicionals als fitxers de registre del dimoni del sistema (sessions SMTP i SSH registrades).| |**net.tcp.service**\[servei,<ip>,<port>\]|<|<|<| |Comprova si el servei s'és executant i admet connexions TCP.|0 - el servei és inactiu<br><br>1 - el servei s'és executant|**servei** - qualsevol de:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (veieu [detalls](/manual/appendix/items/service_check_details)) <br>**ip** - nom IP o DNS (per defecte és 127.0.0.1)<br>**port** - nombre de port (per defecte s'empra el nombre de port de servei ésndard)|Exemple:<br>=> net .tcp.service\[ftp,,45\] → es pot emprar per provar la disponibilitat del servidor FTP al port TCP 45.<br><br>Tingueu en compte que aquestes comprovacions poden donar lloc a missatges addicionals als fitxers de registre del dimoni del sistema (SMTP i sessions SSH s'enregistren normalment).<br><br>Actualment no s'admet la comprovació de protocols xifrats (com IMAP al port 993 o POP al port 995). Com a solució alternativa, empreu net.tcp.port per a comprovacions d'aquestes.<br><br>La comprovació de LDAP i HTTPS a Windows només és compatible amb l'agent Zabbix 2.<br><br>Tingueu en compte que la comprovació de telnet cerca una petició d'inici de sessió (':' al final).<br><br>Els serveis *https* i *telnet* són compatibles des de Zabbix 2.0.| |**net.tcp.service.perf**\[servei,<ip>,<port>\]|<|<|<| |Comprova el rendiment del servei TCP.|0: el servei és caigut<br><br>segons - nombre de segons que han passat en connectar-se al servei|**servei** - qualsevol de:<br>*ssh*, *ldap*, *smtp*, *ftp*, *http*, *pop*, *nntp*, *imap*, *tcp*, *https*, *telnet* (veieu [detalls](/manual/appendix/items/) service_check_details))<br>**ip** - nom IP o DNS (per defecte és 127.0.0.1)<br>**port** - nombre de port (per defecte s'empra el nombre de port de servei estandard)|Exemple:<br> => net.tcp.service.perf\[ssh\] → es pot emprar per provar la velocitat de resposta inicial del servidor SSH.<br><br>La comprovació de protocols xifrats (com IMAP al port 993 o POP al port 995) actualment no és compatible. Com a solució alternativa, empreu net.tcp.service.perf\[tcp,<ip>,<port>\] per a comprovacions d'aquestes.<br><br>La comprovació d'LDAP i HTTPS a Windows només és compatible amb l'agent Zabbix 2.<br><br>Tingueu en compte que la comprovació de telnet sembla per a una petició d'inici de sessió (':' al final).<br><br>Els serveis *https* i *telnet* són compatibles des de Zabbix 2.0.| |**net.tcp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<estat>\]|<|<|<| |Retorna el nombre de sòcols TCP que coincideixen amb els paràmetres.|Enter|**laddr** - adreça IPv4/6 local o subxarxa CIDR<br>**lport** - nombre de port local o nom de servei<br>**raddr** - adreça IPv4/6 remota o subxarxa CIDR<br>**rport** - nombre de port remot o nom de servei<br>**estat** - estat de connexió (*established*, *syn\_sent*, *syn\ _recv*, *fin\_wait1*, *fin\_wait2*, *time\_wait*, *close*, *close\_wait*, *last\_ack*, *listen*, *closing*)|Aquest element és compatible a Linux només a l'agent Zabbix/agent 2. A l'agent Zabbix 2 també és compatible amb Windows de 64 bits.<br><br>Exemple:<br>=> net.tcp.socket.count\[,80, ,,established\] → comproveu si el port TCP local 80 és en estat "establert"<br><br>Aquest element és compatible des de Zabbix 6.0.| |**net.udp.listen**\[port\]|<|<|<| |Comprova si aquest port UDP és en estat LISTEN.|0 - no és en estat LISTEN<br><br>1 - és en estat LISTEN|**port** - nombre de port UDP|Exemple:<br>=> net.udp.listen\[68\]<br><br>A Linux és compatible des de Zabbix 1.8.4| |**net.udp.service**\[servei,<ip>,<port>\]|<|<|<| |Comprova si el servei s'és executant i respon a les peticions UDP.|0 - el servei és caigut<br><br>1 - el servei s'és executant|**servei** - *ntp* (veieu [detalls](/manual/appendix/items/service_check_details))<br>**ip** - nom IP o DNS (per defecte és 127.0.0.1)<br>**port** - nombre de port (per defecte s'empra el nombre de port de servei estandard)|Exemple:<br>=> net.udp.service\[ntp,,45\] → es pot emprar per provar la disponibilitat del servei NTP al port UDP 45.<br><br>Aquest element és compatible des de Zabbix 3.0.0, però el servei *ntp* ja era disponible per a l'element net.tcp.service\[\] a versions anteriors.| |**net.udp.service.perf**\[servei,<ip>,<port>\]|<|<|<| |Comprova el rendiment del servei UDP.|0 - el servei és caigut<br><br>segons - el nombre de segons que s'han passat esperant la resposta del servei|**servei** - *ntp* (veieu [detalls](/manual/appendix/items/service_check_details))<br>**ip** - Nom IP o DNS (per defecte és 127.0.0.1)<br>**port** - nombre de port (per defecte s'empra el nombre de port de servei estandard)| Exemple:<br>=> net.udp.service.perf\[ntp\] → es pot emprar per provar el temps de resposta del servei NTP.<br><br>Aquest element és compatible des de Zabbix 3.0.0, però el servei *ntp* ja era disponible per a l'element net.tcp.service\[\] a versions anteriors.| |**net.udp.socket.count**\[<laddr>,<lport>,<raddr>,<rport>,<estat>\]|<|<|<| |Retorna el nombre de sòcols TCP que coincideixen amb els paràmetres.|Enter|**laddr** - adreça IPv4/6 local o subxarxa CIDR<br>**lport** - nombre de port local o nom de servei<br>**raddr** - adreça IPv4/6 remota o subxarxa CIDR<br>**rport** - nombre de port remot o nom de servei<br>**estat** - estat de connexió (*establert*, *unconn*)|Aquest element és compatible a Linux només a l'agent Zabbix/agent 2. A l'agent Zabbix 2 també és compatible amb Windows de 64 bits.<br><br>Exemple:<br>=> net.udp.socket.count\[,,,,stablished\] → retorna el nombre UDP del sòcol en l'estat de connexió<br><br>Aquest element és compatible des de Zabbix 6.0.| #### Network discovery In a [network discovery rule](/manual/discovery/network_discovery/rule), user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Update interval|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |^|SNMP OID|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |^|SNMP OID|yes| #### Descoberta de xarxa En una [regla de descoberta de xarxa](/manual/discovery/network_discovery/rule), les macros d'usuari es poden emprar als camps següents : |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interval d'actualització|<|no| |*SNMP v1, v2*|<|<| | |Comunitat SNMP|sí| |^|OID SNMP|sí| |*SNMP v3*|<|<| | |Nom del context|sí| |^|Nom de seguretat|sí| |^|Frase secreta d'autenticació|sí| |^|Frase secreta de confidencialitat|sí| |^|OID SNMP|sí| #### Network discovery Manage network-level discovery rules to automatically find and monitor new hosts. Gain full access to information about discovered services and hosts. [Discovery rule API](/manual/api/reference/drule) | [Discovery check API](/manual/api/reference/dcheck) | [Discovered host API](/manual/api/reference/dhost) | [Discovered service API](/manual/api/reference/dservice) #### Descoberta de xarxa Gestionar les regles de descoberta a nivell de xarxa per trobar automàticament els nous equips. Obtindre un accés complet a la informació dels serveis i equips descoberts. [API Regla de descoberta](/manual/api/reference/drule) | [API Verificació de descoberta](/manual/api/reference/dcheck) | [API Descoberta d'equips](/manual/api/reference/dhost) | [API Descoberta de serveis](/manual/api/reference/dservice) #### New action Delivering notifications is one of the things [actions](/manual/config/notifications/action) do in Zabbix. Therefore, to set up a notification, go to *Configuration → Actions* and click *Create action*.  All mandatory input fields are marked with a red asterisk. In this form, enter a name for the action. In the most simple case, if we do not add any more specific [conditions](/manual/config/notifications/action/conditions), the action will be taken upon any trigger change from 'Ok' to 'Problem'. We still should define what the action should do - and that is done in the *Operations* tab. Click on *Add* in the Operations block, which opens a new operation form.  All mandatory input fields are marked with a red asterisk. Here, click on *Add* in the *Send to Users* block and select the user ('user') we have defined. Select 'Email' as the value of *Send only to*. When done with this, click on *Add*, and the operation should be added: {width="600"} That is all for a simple action configuration, so click *Add* in the action form. #### Acció nova El lliurament de notificacions és una de les coses que fan les [accions](/manual/config/notifications/action) a Zabbix. Per tant, per configurar una notificació, aneu a *Configuració → Accions* i feu clic a *Crear una acció*.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. En aquest formulari, introduïu un nom per a l'acció. En el cas més senzill, si no afegim més [condicions](/manual/config/notifications/action/conditions), l'acció es durà a terme a qualsevol canvi de trigger de "Correcte" a "Problema". Encara hem de definir què ha de fer l'acció, i això es fa a la pestanya *Operacions*. Feu clic a *Nova* al bloc Operacions, que obre un nou formulari d'operacions.  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell. Aquí, feu clic a *Afegr* al bloc *Enviar als usuaris* i trieu l'usuari ('usuari') que heu definit. Trieu "Correu electrònic" com a valor per a *Enviar només a*. Quan hàgiu acabat, feu clic a *Afegir* i ara s'hauria d'afegir l'operació: {width="600"} Això és tot per a una configuració d'acció senzilla, així que feu clic a *Afegir* al formulari d'acció. #### New index on auditlog table A new index has been added to the `auditlog` table to improve database and frontend response times when filtering records by *Recordset ID* in the [Audit log](/manual/web_interface/frontend_sections/reports/audit). Note that users with large audit logs may experience extended upgrade times due to the database size. #### Nou índex a la taula d'auditoria S'ha afegit un nou índex a la taula `auditlog` per millorar els temps de resposta de la base de dades i de la interfície quan es filtren els registres per *Recordset ID* al [Registre d'auditoria](/manual/web_interface/frontend_sections/reports/audit). Tingueu en compte que els usuaris amb registres d'auditoria grans poden experimentar llargs temps d'actualització degut a la mida de la base de dades. #### New item for PostgreSQL Zabbix agent 2 plugin New [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql), **pgsql.version**, has been added to PostgreSQL Zabbix agent 2 plugin. This item is used for returning the PostgreSQL version. #### Nou element per al connector PostgreSQL Zabbix agent 2 El nou [element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#postgresql), **pgsql.version**, s'ha afegit al plugin de l'agent 2 de PostgreSQL Zabbix. Aquest element s'empra per retornar la versió de PostgreSQL. #### New item for Zabbix agent 2 A new item has been added to MySQL plugin for Zabbix agent 2. This new item, [mysql.custom.query](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql), can be used for executing custom MySQL queries. #### Nou element per a l'agent Zabbix 2 S'ha afegit un element nou al connector MySQL per a l'agent Zabbix 2. Aquest nou element, [mysql.custom.query](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mysql), es pot emprar per executar consultes MySQL personalitzades. #### New items in Zabbix agent 2 plugins The items for returning the database server version are now available in [MongoDB plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`mongodb.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)) and [Oracle Database plugin](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`oracle.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle)). #### Nous elements als plugins de l'agent 2 de Zabbix Ja són disponibles els elements de retorn del servidor de base de dades al [plugin MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`mongodb.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb)) i [plugin d'Oracle Database](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/src/go/plugins/oracle/README.md?at=refs%2Fheads%2Frelease%2F6.0) ([`oracle.version`](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#oracle)). #### New macros New macros are now supported for trigger expression debugging and internal actions. Expression debugging macros simplify the process of debugging trigger expressions: - {TRIGGER.EXPRESSION.EXPLAIN}, {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} - resolve to a partially evaluated trigger or recovery expression, where only item-based functions are applied; - {FUNCTION.VALUE<1-9>}, {FUNCTION.RECOVERY.VALUE<1-9>} - resolve to the results of the Nth item-based function at the time of the event. ##### Macros noves Ara s'admeten macros noves per depurar expressions triggers i accions internes. Les macros de depuració d'expressions simplifiquen el procés de depuració d'expressions triggers: - {TRIGGER.EXPRESSION.EXPLAIN}, {TRIGGER.EXPRESSION.RECOVERY.EXPLAIN} - resol parcialment l'expressió trigger o de recuperació avaluada, on només s'apliquen funcions basades en elements; - {FUNCTION.VALUE<1-9>}, {FUNCTION.RECOVERY.VALUE<1-9>} - resol els resultats de la funció basada en l'element enèssim al moment de l'esdeveniment. #### New templates A new template is available: - [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Jira Data Center health. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles Hi ha disponible una nova plantilla: - [Jira Data Center per JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar la salut de Jira Data Center. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates A new template is available: - [Oracle Cloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), a master template that discovers various Oracle Cloud Infrastructure (OCI) services and resources. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles Hi ha disponible una nova plantilla: - [Oracle Cloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/oracle_cloud?at=refs%2Fheads%2Frelease%2F6.0), una plantilla mestra que fa descoberta de diversos serveis i recursos d'Oracle Cloud Infrastructure ((OCI). Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates A new template is available: - [YugabyteDB by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), which includes the *YugabyteDB Cluster by HTTP* template for monitoring each YugabyteDB cluster. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles Hi ha disponible una nova plantilla: - [YugabyteDB per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/yugabytedb_http?at=refs%2Fheads%2Frelease%2F6.0), que inclou la plantilla *YugabyteDB Cluster per HTTP* per monitorar cada clúster YugabyteDB. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring AWS Lambda metrics. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles - [AWS Lambda by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_function_lambda_http/README.md?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar mètriques de Lambda AWS. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates - [GitHub repository by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring GitHub repositories. - [Microsoft 365 reports by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring Microsoft 365 services. You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles - [GitHub repository per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/github_http?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar l'estat de salut dels repositoris de GitHub. - [Microsoft 365 reports per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/ms365_http?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar els serveis de Microsoft 365. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates - [Huawei OceanStor V6 by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp?at=refs%2Fheads%2Frelease%2F6.0), a template for monitoring SAN Huawei OceanStor V6. #### Plantilles noves - [Huawei OceanStor V6 per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/san/huawei_oceanstor_v6_snmp?at=refs%2Fheads%2Frelease%2F6.0), una plantilla per monitorar SAN Huawei OceanStor V6. #### New templates New template is available: - [HPE iLO by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles Hi ha disponible una nova plantilla: - [HPE iLO per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/server/hpe_ilo_http?at=refs%2Fheads%2Frelease%2F6.0) Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates New templates are available: - [AWS ELB Application Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL by Zabbix agent 2](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Noves plantilles Hi ha dugues plantilles noves disponibles: - [AWS ELB Application Load Balancer per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0) - [Check Point Next Generation Firewall per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/checkpoint/quantum_ngfw_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [MSSQL per agent 2 de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_agent2?at=refs%2Fheads%2Frelease%2F6.0) Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates New templates are available: - [FortiGate by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate by SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) You can get these templates: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Plantilles noves Hi ha noves plantilles disponibles: - [FortiGate per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_http?at=refs%2Fheads%2Frelease%2F6.0) - [FortiGate per SNMP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/net/fortinet/fortigate_snmp?at=refs%2Fheads%2Frelease%2F6.0) - [Nextcloud per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nextcloud?at=refs%2Fheads%2Frelease%2F6.0) Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates - [Nutanix Prism Element by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http?at=refs%2Fheads%2Frelease%2F6.0), a template set that also includes the templates *Nutanix Cluster Prism Element by HTTP* and *Nutanix Host Prism Element by HTTP*. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles - [Nutanix Prism Element per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/nutanix_http/README.md?at=refs%2Fheads%2Frelease%2F6.0), una plantilla que també inclou les plantilles *Nutanix Cluster Prism Element per HTTP* i *Nutanix Host Prism Element per HTTP*. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). ##### New templates See the list of [new templates](/manual/introduction/whatsnew600#templates) in Zabbix 6.0.0. ##### Plantilles noves Veieu la llista de [plantilles noves](/manual/introduction/whatsnew600#templates) a Zabbix 6.0.0. #### New templates The AWS ELB template set has been supplemented with the template [AWS ELB Network Load Balancer by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0). You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Noves plantilles La plantilla ELB d'AWS s'ha complementat amb la plantilla [AWS ELB Network Load Balancer per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/AWS/aws_elb_http?at=refs%2Fheads%2Frelease%2F6.0). Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates - The [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) template set has been supplemented with the template *Azure SQL Managed Instance by HTTP*. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles El conjunt de plantilles d'[Azure per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure/_http?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb la plantilla *Azure SQL Managed Instance per HTTP*. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure Cost Management by HTTP template. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles El conjunt de plantilles d'[Azure per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure/_http?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb la plantilla Azure Cost Management per HTTP. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates The set of [Azure by HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.0) templates has been supplemented with the Azure VM Scale Set by HTTP template. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Nove plantilles El conjunt de plantilles d'[Azure per HTTP](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure/_http?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb la plantilla Azure VM Scale Set per HTTP. Podeu obtindre aquesta plantilla: - A *Configuració* → *Plantilles*, a les noves instal·lacions; - si sou actualitzant de versions anteriors, podeu descarregar les noves plantilles des del [repositori Git](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) de Zabbix i importar-les manualment a Zabbix a la secció *Configuració* → *Plantilles*. Si ja existeix alguna plantilla amb el mateix nom, marqueu *Esborrar les que no hi son* abans per fer una importació neta. D'aquesta manera, els elements que han estat exclosos de la plantilla actualizada s'esborraran (fixeu-vos que l'històric dels elements esborrats es perdrà). #### New templates - The template set [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0) has been supplemented with the templates *Zabbix server health by Zabbix agent*, *Zabbix server health by Zabbix agent active*, and [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) - with *Zabbix proxy health by Zabbix agent* and *Zabbix proxy health by Zabbix agent active*, enabling the monitoring of internal Zabbix metrics via Zabbix agent. You can get this template: - In *Configuration* → *Templates* in new installations; - When upgrading from previous versions, the latest templates can be downloaded from the [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates?at=refs%2Fheads%2Frelease%2F6.0) and manually imported into Zabbix in the *Configuration* → *Templates* section. If a template with the same name already exists, check the *Delete missing* option before importing to achieve a clean import. This way the items that have been excluded from the updated template will be removed (note that history of the deleted items will be lost). #### Plantilles noves - El conjunt de plantilles [Zabbix server health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_server?at=refs%2Fheads%2Frelease%2F6.0) s'ha complementat amb les plantilles *Zabbix server health per l'agent Zabbix* i *Zabbix server health per l'agent Zabbix actiu*, i [Zabbix proxy health](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/zabbix_proxy?at=refs%2Fheads%2Frelease%2F6.0) - amb *Zabbix proxy health per l'agent Zabbix* i *Zabbix proxy health per l'agent de Zabbix actiu*, activant el monitoratge de mètriques internes de de Zabbix mitjançant l'agent Zabbix. ##### Non-primitive data types Since Zabbix 4.0.0 it is possible to work with custom MBeans returning non-primitive data types, which override the **toString()** method. ##### Tipus de dades no-primitives Des de la versió de Zabbix 4.0.0, és possible treballar amb els MBeans personalitzables que retornen els tipus de dades no-primitives, que substituirà el métode **toString()**. ### Notation ### Notació ::: noteclassic If installing from [Zabbix Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), you need to run the following command prior to proceeding to the next steps: <br><br> `make dbschema` ::: ::: noteclassic Si s'instal·la des del [repositori Git de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse), heu d'executar la comanda següent abans de seguir amb la resta de passes: <br><br> `make dbschema` ::: ::: 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. ::: ::: noteclassic Tingueu en compte que després de l'actualització, algunes integracions de programari de tercers a Zabbix poden veure's afectades, si el programari extern no és compatible amb la versió actualitzada de Zabbix. ::: ::: noteimportant Deprecated widgets will be removed in the upcoming major release. ::: ::: noteimportant Els ginys obsolets s'eliminaran a la propera versió principal. ::: ::: noteimportant Deprecated widgets will be removed in the upcoming major release. ::: ::: noteimportant Els ginys obsolets s'eliminaran a la propera versió principal. ::: ::: noteimportant For SourceIP support in LDAP simple checks (e.g. `net.tcp.service[ldap]`), OpenLDAP version 2.6.1 or above is required. SourceIP is supported in LDAP simple checks since Zabbix 6.0.1. ::: ::: noteimportant Pour admetre SourceIP a les verificacions simples LDAP (per exemple, `net.tcp.service[ldap]`), cal OpenLDAP versió 2.6.1 o superior. SourceIP s'admet amb les verificacions simples LDAP des de Zabbix 6.0.1. ::: ::: noteimportant The instructions provided on this page are designed for advanced users and may need to be adjusted for your specific configuration. Upgrading to primary keys can be time-consuming and resource-intensive. Ensure that enough free disk space is available; depending on your database size and stored data, the process may require up to 2.5 times the space currently used by history tables. ::: ::: noteimportant Les instruccions proporcionades en aquesta pàgina estan dissenyades per a usuaris avançats i és possible que s'hagin d'ajustar a la vostra configuració específica. L'actualització a les claus primàries pot suposar un consum de temps i de recursos. Assegureu-vos que hi ha prou espai lliure disponible al disc; depenent de la mida de la base de dades i de les dades emmagatzemades, el procés pot requerir fins a 2,5 vegades l'espai que empren actualment les taules d'historial. ::: ::: noteimportant This widget is deprecated and will be removed in the upcoming major release. Consider using the [*Top hosts*](/manual/api/reference/dashboard/widget_fields/top_hosts) widget instead. ::: ::: noteimportant Aquest giny és obsolet i s'eliminarà a la propera versió principal. Penseu en emprar el giny [*Equips principals*](/manual/api/reference/dashboard/widget_fields/top_hosts). ::: ::: noteimportant This widget is deprecated and will be removed in the upcoming major release. Consider using the [*Top hosts*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts) widget instead. ::: ::: noteimportant Aquest giny és obsolet i s'eliminarà a la propera versió principal. Penseu en emprar el giny [*Equips principals*](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/top_hosts). ::: ::: noteimportant When creating a maintenance period, the [time zone](/manual/web_interface/time_zone) of the user who creates it is used. However, when recurring maintenance periods (*Daily*, *Weekly*, *Monthly*) are scheduled, the time zone of the Zabbix server is used. To ensure predictable behavior of recurring maintenance periods, it is required to use a common time zone for all parts of Zabbix. ::: ::: noteimportant Quan es crea un període de manteniment, s'empra la [zona horària](/manual/web_interface/time_zone) de l'usuari que el crea. Tanmateix, quan es programen períodes de manteniment recurrents (*diari*, *setmanal*, *mensual*), s'empra la zona horària del servidor Zabbix. Per garantir un comportament previsible dels períodes de manteniment recurrents, cal emprar un fus horari comú per a totes les parts de Zabbix. ::: Notes for AIX: 1. When choosing parameters for proc.mem[] item key on AIX, try to specify narrow process selection criteria. Otherwise there is a risk of getting unwanted processes counted into proc.mem[] result. Example: ``` $ zabbix_agentd -t proc.mem[,,,NonExistingProcess,rss] proc.mem[,,,NonExistingProcess,rss] [u|2879488] ``` This example shows how specifying only command line (regular expression to match) parameter results in Zabbix agent self-accounting - probably not what you want. Notes per AIX: 1. Quan trieu paràmetres per a la clau d'element proc.mem[] a l'AIX, proveu d'especificar criteris de selecció de processos restringits. En cas contrari, hi ha el risc de tindre processos no desitjats al resultat de proc.mem[]. Exemple: ``` $ zabbix_agentd -t proc.mem[,,,NonExistingProcess,rss] proc.mem[,,,NonExistingProcess,rss] [u|2879488] ``` Aquest exemple mostra com especificar només un paràmetre de línia de comandes (expressió regular que coincideixi) resulta en l'autocomptabilitat de l'agent Zabbix; que probablement sigui el que no volem. ##### Notes on connection termination If IPMI checks are not performed (by any reason: all host IPMI items disabled/notsupported, host disabled/deleted, host in maintenance etc.) the IPMI connection will be terminated from Zabbix server or proxy in 3 to 4 hours depending on the time when Zabbix server/proxy was started. ##### Notes de la fi de connexió Si les verificacions IPMI no es fan (per qualsevol raó: elements IPMI dels equips desactivats/no admesos, equip desactivat/esborrat, equip en manteniment, etc.) el servidor o el proxy tancaran la connexió IPMI en 3 o 4 hores, segons l'hora en que el servidor o proxy Zabbix s'hagi engegat. #### Notes on discovered performance counter items on NUMA systems Some [Windows performance counters](/manual/config/items/perfcounters) might be not available for some of the logical processors at NUMA systems. For example, items discovered with an item prototype with the key below might work only for the first NUMA node. Items for the other NUMA nodes might be in unsupported state. ``` perf_counter[\Processor({#CPU.NUMBER})\% Processor Time,60] ``` Also, a discovery rule with key "system.cpu.discovery" does not provide any low-level discovery macro values to substitute into such performance counters as: ``` perf_counter["\Processor Information(<NUMA node index>,<CPU index in NUMA node>)\% Processor Time",60] ``` While [system.cpu.util](/manual/appendix/items/system_cpu_util) items rely on different performance counters to monitor CPU utilization percentage depending on the processor group count and processor count. Also, there is a rare bug related to [processor groups on Windows](/manual/installation/known_issues#win-proc-groups). #### Notes sobre els elements del comptador de rendiment descoberts als sistemes NUMA És possible que alguns [comptadors de rendiment de Windows](/manual/config/items/perfcounters) no siguin pas disponibles per a alguns dels processadors lògics dels sistemes NUMA. Per exemple, els elements trobats amb un prototip d'element amb la clau següent poden funcionar només per al primer node NUMA. És possible que els elements dels altres nodes NUMA siguin en estat no compatible. ``` perf_counter[\Processor({#CPU.NUMBER})\% Processor Time,60] ``` A més, una regla de descoberta amb la clau "system.cpu.discovery" no dona pas cap valor de macro de descoberta de baix nivell per substituir a comptadors de rendiment com: ``` perf_counter["\Processor Information(<NUMA node index>,<CPU index in NUMA node>)\% Processor Time",60] ``` Mentre que [system.cpu.util](/manual/appendix/items/system_cpu_util) els elements depenen de diferents comptadors de rendiment per monitorar el percentatge d'utilització de la CPU en funció del nombre de grups de processadors i del nombre de processadors. A més, hi ha un error rar relacionat amb [grups de processadors a Windows](/manual/installation/known_issues#win-proc-groups). ##### Notes on discrete sensor names in OpenIPMI-2.0.16, 2.0.17, 2.0.18 and 2.0.19 Names of discrete sensors in OpenIPMI-2.0.16, 2.0.17 and 2.0.18 often have an additional "`0`" (or some other digit or letter) appended at the end. For example, while `ipmitool` and OpenIPMI-2.0.19 display sensor names as "`PhysicalSecurity`" or "`CATERR`", in OpenIPMI-2.0.16, 2.0.17 and 2.0.18 the names are "`PhysicalSecurity0`" or "`CATERR0`", respectively. When configuring an IPMI item with Zabbix server using OpenIPMI-2.0.16, 2.0.17 and 2.0.18, use these names ending with "0" in the *IPMI sensor* field of IPMI agent items. When your Zabbix server is upgraded to a new Linux distribution, which uses OpenIPMI-2.0.19 (or later), items with these IPMI discrete sensors will become "NOT SUPPORTED". You have to change their *IPMI sensor* names (remove the '0' in the end) and wait for some time before they turn "Enabled" again. ##### Notes sobre els sensors discrets a OpenIPMI-2.0.16, 2.0.17, 2.0.18 i 2.0.19 els noms dels sensors discrets amb OpenIPMI-2.0.16, 2.0.17 i 2.0.18 sovint tenen un "`0`" (o qualsevol altra xifra o lletra) afegida al final del nom. Per exemple, si `ipmitool` i OpenIPMI-2.0.19 mostren el nom com "`PhysicalSecurity`" o "`CATERR`", a OpenIPMI-2.0.16, 2.0.17 i 2.0.18, els noms són "`PhysicalSecurity0`" i "`CATERR0`", respectivament. Quan es configura un element IPMI amb Zabbix emprant OpenIPMI-2.0.16, 2.0.17 i 2.0.18, empreu els noms acabats en "0" al camp *Sensor IPMI* dels elements de l'agent IPMI. Quan el vostre servidor Zabbix s'actualitzi cap a una nova distribució de Linux, qui empri OpenIPMI-2.0.19 (o una versió posterior), els elements amb els sensors IPMI discrets esdevindran "NO SUPORTATS". Haureu de canviar el seu nom de *sensor IPMI* (traieu el '0' del final) i esperar un moment abans de reactivar-los. #### Notes on handling 'copytruncate' log file rotation `logrt` with the `copytruncate` option assumes that different log files have different records (at least their timestamps are different), therefore MD5 sums of initial blocks (up to the first 512 bytes) will be different. Two files with the same MD5 sums of initial blocks means that one of them is the original, another - a copy. `logrt` with the `copytruncate` option makes effort to correctly process log file copies without reporting duplicates. However, things like producing multiple log file copies with the same timestamp, log file rotation more often than logrt\[\] item update interval, frequent restarting of agent are not recommended. The agent tries to handle all these situations reasonably well, but good results cannot be guaranteed in all circumstances. #### Notes sobre la gestió de 'copytruncate' en la rotació del fitxer de registre `logrt` amb l'opció `copytruncate` assumeix que diferents fitxers de registre tenen registres diferents (almenys les seves marques de temps són diferents), de manera que les sumes MD5 dels blocs inicials (fins als primers 512 octets) seran diferents. Dos fitxers amb les mateixes sumes MD5 de blocs inicials signifiquen que un d'ells és l'original i l'altre n'és una còpia. `logrt` amb l'opció `copytruncate` intenta gestionar correctament les còpies dels fitxers de registre sense marcar els duplicats. Tanmateix, coses com la producció de diverses còpies dels fitxers de registre amb la mateixa marca de temps, la rotació del fitxer de registre més sovint que l'interval d'actualització de l'element logrt\[\], no es recomana el reinici freqüent de l'agent. L'agent intenta gestionar totes aquestes situacions de manera raonable, però no es poden garantir bons resultats en totes les circumstàncies. #### Notes on inclusion The `Include` statement in configuration files is processed immediately when encountered. For predictable behavior, it is recommended to place the `Include` parameter at the end of the configuration file. If the `Include` parameter is used for including a file, the file must be readable. If the `Include` parameter is used for including a directory: - All files in the directory must be readable. - No particular order of inclusion should be assumed (e.g. files are not included in alphabetical order). Therefore do not define one parameter in several ''Include'' files (e.g. to override a general setting with a specific one). - All files in the directory are included into configuration. - Beware of file backup copies automatically created by some text editors. For example, if editing the ''include/my_specific.conf'' file produces a backup copy ''include/my_specific_conf.BAK'' then both files will be included. Move ''include/my_specific.conf.BAK'' out of the "Include" directory. On Linux, contents of the ''Include'' directory can be checked with a ''ls -al'' command for unnecessary files. If the `Include` parameter is used for including files using a pattern: - All files matching the pattern must be readable. - No particular order of inclusion should be assumed (e.g. files are not included in alphabetical order). Therefore do not define one parameter in several ''Include'' files (e.g. to override a general setting with a specific one). #### Notes sobre la inclusió L'ordre `Include` als fitxers de configuració es processa immediatament quan es troba. Per a un comportament predictible, es recomana col·locar el paràmetre `Include` al final del fitxer de configuració. Si el paràmetre `Include` s'empra per incloure un fitxer, aquest ha d'ésser llegible. Si el paràmetre `Include` s'empra per incloure un directori: - Tots els arxius del directori han d'ésser llegibles. - No s'ha de suposar cap ordre particular d'inclusió (per exemple, els arxius que no s'inclouen en ordre alfabètic). Per tant, no definiu pas un paràmetre a diversos arxius ''Include'' (per exemple, per sobreescriure una configuració general per un paràmetre específic). - Tots els arxius del directori són inclosos a la configuració. - Compte amb les còpies de seguretat cels arxius creats automàticament per alguns editors de text. Per exemple, si l'edició del fitxer ''include/my_specific.conf'' fa una còpia de seguretat a ''include/my_specific_conf.BAK'', llavors ambdós fitxers s'inclouran. Desplaceu ''include/my_specific.conf.BAK'' fora del directori "Include". Sota Linux, el contingut del directori ''Include'' pot verificar-se amb la comanda ''ls -al'' per els arxius que no calen. Si el paràmetre `Include` s'empra per incloure els arxius emprant un patró: - Tots els arxius corresponent al patró hauran d'ésser llegibles. - No s'assumeix pas cap ordre d'inclusió en particular (per exemple, els arxius no són pas inclosos per ordre alfabètic). No definiu doncs un cap paràmetre a diferents arxius ''Include'' (per exemple, per sobreescriure un paràmetre general per un paràmetre concret). ### Notes on installation See [installation instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [Running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Notes sobre la instal·lació Consulteu les [instruccions d'instal·lació](https://www.zabbix.com/download?zabbix=6.0&os_distribution=red_hat_enterprise_linux&os_version=8&db=mysql) per plataforma a la pàgina de descàrrega per a: - Instal·lació de dipòsits - instal·lació de servidor/agent/interfície - creació de la base de dades inicial, importació de les dades inicials - Configuració de la base de dades per al servidor Zabbix - Configuració PHP per a la interfície Zabbix - inici dels processos servidor/agent - Configuració de la interfície Zabbix Si voleu executar l'agent Zabbix com a root, consulteu la pàgina [executar l'agent com a root](/manual/appendix/install/run_agent_as_root). El procés del servei web de Zabbix, que s'empra per a la [generació d'informes programats](/manual/web_interface/frontend_sections/reports/scheduled), requereix el navegador Google Chrome. El navegador no és pas inclòs als paquets i s'ha d'instal·lar a banda. ### Notes on installation See the [installation instructions](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=22.04) per platform in the download page for: - installing the repository - installing server/agent/frontend - creating initial database, importing initial data - configuring database for Zabbix server - configuring PHP for Zabbix frontend - starting server/agent processes - configuring Zabbix frontend If you want to run Zabbix agent as root, see [running agent as root](/manual/appendix/install/run_agent_as_root). Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually. ### Notes sobre la instal·lació Consulteu les [instruccions d'instal·lació](https://www.zabbix.com/download?zabbix=6.0&os_distribution=ubuntu&os_version=22.04) per plataforma a la pàgina de descàrrega per a: - Instal·lació de dipòsits - instal·lació de servidor/agent/interfície - creació de la base de dades inicial, importació de les dades inicials - Configuració de la base de dades per al servidor Zabbix - Configuració PHP per a la interfície Zabbix - inici dels processos servidor/agent - Configuració de la interfície Zabbix Si voleu executar l'agent Zabbix com a root, consulteu la pàgina [executar l'agent com a root](/manual/appendix/install/run_agent_as_root). El procés del servei web de Zabbix, que s'empra per a la [generació d'informes programats](/manual/web_interface/frontend_sections/reports/scheduled), requereix el navegador Google Chrome. El navegador no és pas inclòs als paquets i s'ha d'instal·lar a banda. #### Notes on IPMI discrete sensors To find sensors on a host start Zabbix server with **DebugLevel=4** enabled. Wait a few minutes and find sensor discovery records in Zabbix server logfile: $ grep 'Added sensor' zabbix_server.log 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:7 id:'CATERR' reading_type:0x3 ('discrete_state') type:0x7 ('processor') full_name:'(r0.32.3.0).CATERR' 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'CPU Therm Trip' reading_type:0x3 ('discrete_state') type:0x1 ('temperature') full_name:'(7.1).CPU Therm Trip' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'System Event Log' reading_type:0x6f ('sensor specific') type:0x10 ('event_logging_disabled') full_name:'(7.1).System Event Log' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'PhysicalSecurity' reading_type:0x6f ('sensor specific') type:0x5 ('physical_security') full_name:'(23.1).PhysicalSecurity' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'IPMI Watchdog' reading_type:0x6f ('sensor specific') type:0x23 ('watchdog_2') full_name:'(7.7).IPMI Watchdog' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'Power Unit Stat' reading_type:0x6f ('sensor specific') type:0x9 ('power_unit') full_name:'(21.1).Power Unit Stat' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Ctrl %' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.1).P1 Therm Ctrl %' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.2).P1 Therm Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 2' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 2' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 3' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 3' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'P1 Mem Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).P1 Mem Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'Front Panel Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Front Panel Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'Baseboard Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Baseboard Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +5.0V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +5.0V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +3.3V STBY' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V STBY' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +3.3V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.5V P1 DDR3' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.5V P1 DDR3' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.1V P1 Vccp' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.1V P1 Vccp' 8358:20130318:111122.174 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +1.05V PCH' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.05V PCH' To decode IPMI sensor types and states, a copy of [IPMI 2.0 specifications](https://www.intel.com/content/dam/www/public/us/en/documents/product-briefs/ipmi-second-gen-interface-spec-v2-rev1-1.pdf) is available (please note that [no further updates](http://www.intel.com/content/www/us/en/servers/ipmi/ipmi-specifications.html) to the IPMI specification are planned). The first parameter to start with is "reading\_type". Use "Table 42-1, Event/Reading Type Code Ranges" from the specifications to decode "reading\_type" code. Most of the sensors in our example have "reading\_type:0x1" which means "threshold" sensor. "Table 42-3, Sensor Type Codes" shows that "type:0x1" means temperature sensor, "type:0x2" - voltage sensor, "type:0x4" - Fan etc. Threshold sensors sometimes are called "analog" sensors as they measure continuous parameters like temperature, voltage, revolutions per minute. Another example - a sensor with "reading\_type:0x3". "Table 42-1, Event/Reading Type Code Ranges" says that reading type codes 02h-0Ch mean "Generic Discrete" sensor. Discrete sensors have up to 15 possible states (in other words - up to 15 meaningful bits). For example, for sensor 'CATERR' with "type:0x7" the "Table 42-3, Sensor Type Codes" shows that this type means "Processor" and the meaning of individual bits is: 00h (the least significant bit) - IERR, 01h - Thermal Trip etc. There are few sensors with "reading\_type:0x6f" in our example. For these sensors the "Table 42-1, Event/Reading Type Code Ranges" advises to use "Table 42-3, Sensor Type Codes" for decoding meanings of bits. For example, sensor 'Power Unit Stat' has type "type:0x9" which means "Power Unit". Offset 00h means "PowerOff/Power Down". In other words if the least significant bit is 1, then server is powered off. To test this bit, the **bitand** [function](/manual/appendix/functions) with mask '1' can be used. The trigger expression could be like bitand(last(/www.example.com/Power Unit Stat,#1),1)=1 to warn about a server power off. #### Notes sobre els sensors IPMI discrets Per trobar els sensors d'un equip en un servidor Zabbix amb **DebugLevel=4** actiu. Espereu uns minuts i trobeu els registres de descoberta del sensor al registre del servidor Zabbix: $ grep 'Added sensor' zabbix_server.log 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:7 id:'CATERR' reading_type:0x3 ('discrete_state') type:0x7 ('processor') full_name:'(r0.32.3.0).CATERR' 8358:20130318:111122.170 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'CPU Therm Trip' reading_type:0x3 ('discrete_state') type:0x1 ('temperature') full_name:'(7.1).CPU Therm Trip' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'System Event Log' reading_type:0x6f ('sensor specific') type:0x10 ('event_logging_disabled') full_name:'(7.1).System Event Log' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'PhysicalSecurity' reading_type:0x6f ('sensor specific') type:0x5 ('physical_security') full_name:'(23.1).PhysicalSecurity' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'IPMI Watchdog' reading_type:0x6f ('sensor specific') type:0x23 ('watchdog_2') full_name:'(7.7).IPMI Watchdog' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'Power Unit Stat' reading_type:0x6f ('sensor specific') type:0x9 ('power_unit') full_name:'(21.1).Power Unit Stat' 8358:20130318:111122.171 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Ctrl %' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.1).P1 Therm Ctrl %' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:16 id:'P1 Therm Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(3.2).P1 Therm Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 2' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 2' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:13 id:'System Fan 3' reading_type:0x1 ('threshold') type:0x4 ('fan') full_name:'(29.1).System Fan 3' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'P1 Mem Margin' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).P1 Mem Margin' 8358:20130318:111122.172 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'Front Panel Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Front Panel Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:15 id:'Baseboard Temp' reading_type:0x1 ('threshold') type:0x1 ('temperature') full_name:'(7.6).Baseboard Temp' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +5.0V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +5.0V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +3.3V STBY' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V STBY' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:9 id:'BB +3.3V' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +3.3V' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.5V P1 DDR3' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.5V P1 DDR3' 8358:20130318:111122.173 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:17 id:'BB +1.1V P1 Vccp' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.1V P1 Vccp' 8358:20130318:111122.174 Added sensor: host:'192.168.1.12:623' id_type:0 id_sz:14 id:'BB +1.05V PCH' reading_type:0x1 ('threshold') type:0x2 ('voltage') full_name:'(7.1).BB +1.05V PCH' Per decodificar els tipus i estats del sensor IPMI, hi ha disponible una còpia de les [especificacions IPMI 2.0](https:///www.intel.com/content/dam/www/public/us/en/documents/product-briefs/ipmi-second-gen-interface-spec-v2-rev1-1.pdf). Tingueu en compte que no hi ha previstes [futures actualitzacions](http://www.intel.com/content/www/us/en/servers/ipmi/ipmi-specifications.html) de les especificacions IPMI. El primera paràmetre per començar és "reading\_type". Veieu la "Taula 42-1, rang de codi de tipus d'esdeveniment/lectura" per veure les especificacions per decodificar "reading\_type". Molts dels sensors del nostre exemple tenen "reading\_type:0x1" que vol dir sensor "llindar". A la "Taula 42-3, Codis dels tipus de sensor" hi diu que "type:0x1" vol dir sensor de temperatura, "type:0x2" - sensor de voltatge, "type:0x4" - Ventilador, etc. Els sensors llindar sovint s'anomenen sensors "analògics", doncs mesuren de manera continuada els paràmetres com ara temperatura, voltatge i revolucions per minut. Un altre exemple - un sensor amb "reading\_type:0x3". "Taula 42-1, rang de codi de tipus d'esdeveniment/lectura" diu que el tipus de codi de lectura 02h-0Ch correspon a sensors "Genèrics discrets". Els sensors discrets tenen fins a 15 estats possibles(per tant, fins a 15 bits significatius(. Per exemple, el sensor 'CATERR' amb "type:0x7", la "Taula 42-3, codis de tipus de sensors" diu que aquest tipus és un "Processador" i el significat dels bits individuals és : 00h (el bit menys significatiu) - IERR, 01h - Thermal Trip etc. Hi ha alguns sensors amb "reading\_type:0x6f" al nostre exemple. La "Taula 42-1, rang de codi de tipus d'esdeveniment/lectura" ja diu que cal emprar la "Taula 42-3, codis de tipus de sensors" per decodificar els signifcats dels bits. Per exemple, el sensor 'Power Unit Stat' és del tipus "type:0x9", que vol dir "Power Unit". Offset 00h vol dir "PowerOff/Power Down". En altres paraules, si el menys significant dels bits és 1, el servidor és aturat. Per provar aquest bit, podeu emprar la [funció](/manual/appendix/functions) **bitand** amb màscara '1'. L'expressió trigger pot semblar-se a bitand(last(/www.example.com/Power Unit Stat,#1),1)=1 per avisar-nos si el servidor s'atura. #### Notes on persistent files for log\*\[\] items #### Notes sobre fitxers persistents dels elements log\*\[\] ##### Notes on threshold and discrete sensor simultaneous availability Some IPMI agents provide both a threshold sensor and a discrete sensor under the same name. In Zabbix versions prior to 2.2.8 and 2.4.3, the first provided sensor was chosen. Since versions 2.2.8 and 2.4.3, preference is always given to the threshold sensor. ##### Notes sobre la disponibilitat simultània dels sensors discrets i llindar Alguns agents IPMI proveeixen a la vegada un sensor llindar i discret amb el mateix nom. A les versions de Zabbix anteriors a la 2.2.8 i 2.4.3, es tria el primer sensor proporcionat. Després de les versions 2.2.8 i 2.4.3, la preferència sempre la té el sensor llindar. ::: notetip After enabling a trigger (changing its configuration status from *Disabled* to *Enabled*), the trigger expression is evaluated as soon as an item in it receives a value or the time to handle [date and time](/manual/appendix/functions/time) and/or nodata() functions comes. ::: ::: notetip Després d'activar un trigger (canviant el seu estat de configuració de *Disabled* a *Enabled*), l'expressió trigger s'avalua tan bon punt un element que conté rep un valor o quan arriba el moment de gestionar una funció de [data i hora](/manual/appendix/functions/time) and/or nodata() . ::: ::: notetip Mostly the `maintenance.inc.php` file is located in `/conf` of Zabbix HTML document directory on the web server. However, the location of the directory may differ depending on the operating system and a web server it uses. For example, the location for: - SUSE and RedHat is `/etc/zabbix/web/maintenance.inc.php`. - Debian-based systems is `/usr/share/zabbix/conf/`. See also [Copying PHP files](/manual/installation/install#copying-php-files). ::: |Parameter|Details| |--|--------| |**ZBX\_DENY\_GUI\_ACCESS**|Enable maintenance mode:<br>1 – maintenance mode is enabled, disabled otherwise| |**ZBX\_GUI\_ACCESS\_IP\_RANGE**|Array of IP addresses, which are allowed to connect to frontend (optional).<br>For example:<br>`array('192.168.1.1', '192.168.1.2')`| |**ZBX\_GUI\_ACCESS\_MESSAGE**|A message you can enter to inform users about the maintenance (optional).| ::: notetip La majoria de les vegades, el fitxer `maintenance.inc.php` es troba a `/conf` del directori de documents HTML de Zabbix al Servidor web. Tanmateix, la ubicació del directori pot variar segons el sistema operatiu i el servidor web emprat. Per exemple, la ubicació de: - SUSE i RedHat el fitxer és `/etc/zabbix/web/maintenance.inc.php`. - Sistemes basats en Debian el directori és `/usr/share/zabbix/conf/`. Veieu també [Copia de fitxers PHP](/manual/installation/install#copying-php-files). ::: |Paràmetre|Detalls| |--|---------| |**ZBX\_DENY\_GUI\_ACCESS**|Activa el mode de manteniment:<br>1: el mode de manteniment és habilitat, en cas contrari, desactivat| |**ZBX\_GUI\_ACCESS\_IP\_RANGE**|Matriu d'adreces IP permeses per connectar-se a la interfície (opcional).<br>Per exemple:<br>`array('192.168.1.1', '192.168.168.1.2')'| |**ZBX\_GUI\_ACCESS\_MESSAGE**|Un missatge que podeu escriure per notificar als usuaris el manteniment (opcional).| :::notetip You can find out more about setting up SSL for Zabbix frontend by referring to these [best practices](/manual/installation/requirements/best_practices). ::: :::notetip Podeu trobar més informació sblre com configurar SSL per la interfície de Zabbix seguint aquestes [bones pràctiques](/manual/installation/requirements/best_practices). ::: #### Notification about canceled escalations When configuring [action operations](/manual/config/notifications/action/operation#configuring-an-operation), it is now possible to cancel notifications about canceled escalations by unmarking the checkbox of the corresponding option. ##### Notificació d'escalades anul·lades Quan es configuren [operacions d'acció](/manual/config/notifications/action/operation#configuring-an-operation), és possible cancel·lar les notificacions sobre les escalades cancel·lades desmarcant la casella de l'opció corresponent. ## Notifications ## Notificacions ## Notifications ## Notificacions ## Notifications ## Notificacions #### Numeric (float) data type range with PostgreSQL 11 and earlier PostgreSQL 11 and earlier versions only support floating point value range of approximately -1.34E-154 to 1.34E+154. #### Interval de tipus de dades numèriques (flotant) amb PostgreSQL 11 i anteriors PostgreSQL 11 i versions anteriors només admeten l'interval de valors de coma flotant al rang de -1.34E-154 a 1.34E+154. #### Numeric representation Windows maintains numeric representations (indexes) for object and performance counter names. Zabbix supports these numeric representations as parameters to the `perf_counter`, `perf_counter_en` item keys and in `PerfCounter`, `PerfCounterEn` configuration parameters. However, it's not recommended to use them unless you can guarantee your numeric indexes map to correct strings on specific hosts. If you need to create portable items that work across different hosts with various localized Windows versions, you can use the `perf_counter_en` key or `PerfCounterEn` configuration parameter which allow to use English names regardless of system locale. To find out the numeric equivalents, run **regedit**, then find *HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009*. The registry entry contains information like this: 1 1847 2 System 4 Memory 6 % Processor Time 10 File Read Operations/sec 12 File Write Operations/sec 14 File Control Operations/sec 16 File Read Bytes/sec 18 File Write Bytes/sec .... Here you can find the corresponding numbers for each string part of the performance counter, like in '\\System\\% Processor Time': System → 2 % Processor Time → 6 Then you can use these numbers to represent the path in numbers: \2\6 #### Representació numèrica Windows manté representacions numèriques (índexs) per als noms d'objectes i els comptadors de rendiment. Zabbix suporta aquestes representacions numèriques com a paràmetres de les claus d'element `perf_counter`, `perf_counter_en` i en els paràmetres de configuració `PerfCounter`, `PerfCounterEn`. Tanmateix, no es recomana emprar-los tret que pugueu garantir que el vostre mapa d'índex numèric corregeix cadenes a equips específics. Si necessiteu crear elements portàtils que funcionin a diferents equips amb versions concretes de Windows, podeu emprar la clau `perf_counter_en` o el paràmetre de configuració `PerfCounterEn` que permet emprar noms en anglès independentment de la configuració regional del sistema. Per als equivalents numèrics, executeu **regedit** i, tot seguit, cerqueu *HKEY\_LOCAL\_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\Perflib\\009*. L'entrada del registre conté informació com aquesta: 1 1847 2 System 4 Memory 6 % Processor Time 10 File Read Operations/sec 12 File Write Operations/sec 14 File Control Operations/sec 16 File Read Bytes/sec 18 File Write Bytes/sec .... Aquí podeu trobar els nombres corresponents per a cada part de la cadena del comptador de rendiment, com a '\\System\% Processor Time': System → 2 % Processor Time → 6 A continuació, podeu emprar aquests nombres per representar el camí en nombres: \2\6 #### Obtaining sensor names Sensor labels, as printed by the *sensors* command, cannot always be used directly because the naming of labels may be different for each sensor chip vendor. For example, *sensors* output might contain the following lines: $ sensors in0: +2.24 V (min = +0.00 V, max = +3.32 V) Vcore: +1.15 V (min = +0.00 V, max = +2.99 V) +3.3V: +3.30 V (min = +2.97 V, max = +3.63 V) +12V: +13.00 V (min = +0.00 V, max = +15.94 V) M/B Temp: +30.0°C (low = -127.0°C, high = +127.0°C) Out of these, only one label may be used directly: $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in0] 2.240000 Attempting to use other labels (like *Vcore* or *+12V*) will not work. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,Vcore] ZBX_NOTSUPPORTED To find out the actual sensor name, which can be used by Zabbix to retrieve the sensor readings, run *sensors -u*. In the output, the following may be observed: $ sensors -u ... Vcore: in1_input: 1.15 in1_min: 0.00 in1_max: 2.99 in1_alarm: 0.00 ... +12V: in4_input: 13.00 in4_min: 0.00 in4_max: 15.94 in4_alarm: 0.00 ... So *Vcore* should be queried as *in1*, and *+12V* should be queried as *in4*. According to [specification](https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface), these are voltages on chip pins and generally speaking may need scaling. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in1] 1.301000 Not only voltage (in), but also current (curr), temperature (temp) and fan speed (fan) readings can be retrieved by Zabbix. #### Obtindre els noms dels sensors Les etiquetes del sensor, impreses per la comanda *sensors*, mai es poden emprar directament, doncs el seu nom pot ésser diferent per cada proveïdor del xip del sensor. Per exemple, la sortida de *sensors* pot contindre les següents línies: $ sensors in0: +2.24 V (min = +0.00 V, max = +3.32 V) Vcore: +1.15 V (min = +0.00 V, max = +2.99 V) +3.3V: +3.30 V (min = +2.97 V, max = +3.63 V) +12V: +13.00 V (min = +0.00 V, max = +15.94 V) M/B Temp: +30.0°C (low = -127.0°C, high = +127.0°C) A banda d'aquestes, una sola etiqueta es pot emprar directament: $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in0] 2.240000 Provant d'emprar altres etiquetes (com ara *Vcore* o *+12V*) no funcionarà pas. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,Vcore] ZBX_NOTSUPPORTED Per sapiguer el nom real del sensor, que es pot emprar per Zabbix per recuperar les lectures del sensor, executeu *sensors -u*. A la sortida, veureu: $ sensors -u ... Vcore: in1_input: 1.15 in1_min: 0.00 in1_max: 2.99 in1_alarm: 0.00 ... +12V: in4_input: 13.00 in4_min: 0.00 in4_max: 15.94 in4_alarm: 0.00 ... Donsc *Vcore* ha d'ésser consultat com a *in1*, i *+12V* haurà d'ésser consultat com a *in4*. [^1] Segons les [especificacions](https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface), aquests són els voltatges dels pins dels xips i, en general, pot caldre escalar. $ zabbix_get -s 127.0.0.1 -k sensor[lm85-i2c-0-2e,in1] 1.301000 No només el voltatge (in), també la corrent (curr), la temperatura (temp) i la velocitat del ventilador (fan) es poden recuperar per Zabbix. [^1]: Segons les [especificacions](https://www.kernel.org/doc/Documentation/hwmon/sysfs-interface) aquests són els voltatges dels pins dels xips i poden generalment necessitar un escalat. #### ODBC checks - MySQL unixODBC driver should not be used with Zabbix server or Zabbix proxy compiled against MariaDB connector library and vice versa, if possible it is also better to avoid using the same connector as the driver due to an [upstream bug](https://bugs.mysql.com/bug.php?id=73709). Suggested setup: PostgreSQL, SQLite or Oracle connector → MariaDB or MySQL unixODBC driver MariaDB connector → MariaDB unixODBC driver MySQL connector → MySQL unixODBC driver See [ZBX-7665](https://support.zabbix.com/browse/ZBX-7665) for more information and available workarounds. - XML data queried from Microsoft SQL Server may get truncated in various ways on Linux and UNIX systems. - It has been observed that using ODBC checks for monitoring Oracle databases using various versions of Oracle Instant Client for Linux causes Zabbix server to crash.<br> See also: [ZBX-18402](https://support.zabbix.com/browse/ZBX-18402), [ZBX-20803](https://support.zabbix.com/browse/ZBX-20803). - If using FreeTDS UnixODBC driver, you need to prepend a 'SET NOCOUNT ON' statement to an SQL query (for example, ````SET NOCOUNT ON DECLARE @strsql NVARCHAR(max) SET @strsql = ....````). Otherwise, database monitor item in Zabbix will fail to retrieve the information with an error "SQL query returned empty result".<br> See [ZBX-19917](https://support.zabbix.com/browse/ZBX-19917) for more information. #### Verificacions ODBC - El controlador MySQL unixODBC no s'ha d'emprar amb el servidor Zabbix o el proxy Zabbix compilat amb la biblioteca de connectors MariaDB i viceversa, si és possible. També és millor evitar emprar el mateix connector que el controlador a causa d'un [error](https://bugs.mysql.com/bug.php?id=73709). Configuració suggerida: Connector PostgreSQL, SQLite o Oracle → Controlador unixODBC MariaDB o MySQL Connector MariaDB → Controlador MariaDB unixODBC Connector MySQL → Controlador MySQL unixODBC Consulteu [ZBX-7665](https://support.zabbix.com/browse/ZBX-7665) per obtindre més informació i solucions alternatives disponibles. - Les dades XML consultades des de Microsoft SQL Server es poden truncar de diferents maneres en sistemes Linux i UNIX. - S'ha observat que l'ús de comprovacions ODBC per monitorar les bases de dades Oracle emprant diferents versions d'Oracle Instant Client per a Linux fa que el servidor Zabbix es bloquegi.<br> Veieu també [ZBX-18402](https://support.zabbix.com/browse/ZBX-18402), [ZBX-20803](https://support.zabbix.com/browse/ZBX-20803). - Si empreu el controlador FreeTDS UnixODBC, heu d'afegir una instrucció 'SET NOCOUNT ON' a una consulta SQL (per exemple, ````SET NOCOUNT ON DECLARE @strsql NVARCHAR(max) SET @strsql = .... ````). En cas contrari, l'element de monitoratge de la base de dades a Zabbix no podrà recuperar la informació amb un error "La consulta SQL ha retornat un resultat buit".<br> Consulteu [ZBX-19917](https://support.zabbix.com/browse/ZBX-19917) per obtindre més informació. #### OK events An OK event closes the related problem event(s) and may be created by 3 components: - triggers - based on 'OK event generation' and 'OK event closes' settings; - event correlation - task manager – when an event is [manually closed](/manual/config/events/manual_close) #### Esdeveniments d'acord (OK) Un esdeveniment OK tanca el/s esdeveniment/s o problemes relacionats i el pot crear per 3 components: - els triggers: basats en els paràmetres "Generació d'un esdeveniment OK" i "Es tanca un esdeveniment OK"; - Correlació d'esdeveniments - el gestor de tasques - quan un esdeveniment és [tancat manualment](/en/manual/config/events/manual_close) #### Okta configuration 1\. Go to <https://okta.com> and register or sign in to your account. 2\. In the Okta web interface navigate to *Applications → Applications* and press "Add Application" button (). 3\. Press "Create New App" button (). In a popup window select *Platform:* Web, *Sign on method:* SAML 2.0 and press "Create" button. {width="600"} 4\. Fill in the fields in the *General settings* tab (the first tab that appears) according to your preferences and press "Next". 5\. In the *Configure SAML* tab enter the values provided below, then press "Next". - In the **GENERAL** section: - *Single sign on URL*: https://<your-zabbix-url>/ui/index\_sso.php?acs<br> The checkbox *Use this for Recipient URL and Destination URL* should be marked) - *Audience URI (SP Entity ID)*: zabbix<br> Note that this value will be used within the SAML assertion as a unique service provider identifier (if not matching, the operation will be rejected). It is possible to specify a URL or any string of data in this field. - *Default RelayState*:<br> Leave this field blank; if a custom redirect is required, it can be added in Zabbix in the *Administration → Users* settings. - Fill in other fields according to your preferences.  ::: noteclassic If planning to use encrypted connection, generate private and public encryption certificates, then upload public certificate to Okta. Certificate upload form appears when *Assertion Encryption* is set to Encrypted (click *Show Advanced Settings* to find this parameter). ::: - In the **ATTRIBUTE STATEMENTS (OPTIONAL)** section add an attribute statement with: - *Name:* usrEmail - *Name format:* Unspecified - *Value:* user.email  6\. At the next tab, select "I'm a software vendor. I'd like to integrate my app with Okta" and press "Finish". 7\. Now, navigate to *Assignments* tab and press the "Assign" button, then select *Assign to People* from the drop-down.  8\. In a popup that appears, assign created app to people that will use SAML 2.0 to authenticate with Zabbix, then press "Save and go back". 9\. Navigate to the *Sign On* tab and press the "View Setup Instructions" button. Setup instructions will be displayed in a new tab; keep this tab open while configuring Zabbix.  #### Configuració d'Okta 1\. Aneu a <https://okta.com> i enregistreu-vos o connecteu-vos al vostre compte. 2\. A la interfície Web d'Okta, accediu a *Aplicacions → Aplicacions* i premeu el botó "Afegir una aplicació" (). 3\. Premeu el botó "Crear una nova aplicació" (). A la finestra contextual, trieu *Plataforma:* Web, *Mètode de connexió:* SAML 2.0, i premeu el botó "Crear". {width="600"} 4\. Ompliu els camps de la pestanya *Paràmetres generals* (la primera pestanya que apareix) segons les vostres preferències, i premeu "Següent". 5\. A la pestanya *Configurar SAML*, entreu els valors que hi ha aquí sota, i després premeu "Següent". - A la secció **GENERAL** : - *URL d'autenticació única* : https://\<votre-url-zabbix\>/ui/index\_sso.php?acs<br> Heu de marcar la casella *Emprar aquest per URL de destinatari i URL de destinació. - *Audiència URI (SP Entity ID)*: zabbix<br> Veieu que aquest valor s'emprarà a l'asserció SAML com a únic identificador de proveïdor del servei (si no es correspon pas, la operació serà rebutjada). És possible especificar una URL o tota una cadena de dades en aquest camp. - *Default RelayState*:<br> Deixeu aquest camp buix; si es demana una redirecció personal, es pot afegir a Zabbix als paràmetres *Administració → Usuaris*. - Ompliu els altres camps segons les vostres preferències.  ::: noteclassic Si voleu emprar una connexió xifrada, genereu els certificats de xifrat privats i públics, i pugeu el públic a Okta. El formulari de càrrega de certificat apareix quan *Xifrat d'asserció* s'estableix a Xifrat (cliqueu a *Afegir paràmetres avançats* per trobar aquest paràmetres). ::: - A la secció **ATRIBUTS DECLARATS (OPCIONAL)**, afegiu una declaració d'atribut amb: - *Nom :* usrEmail - *Format Nom :* No especificat - *Valor :* user.email  6\. A la pestanya següent, trieu "sóc un editor de programari. Vull integrar la meva aplicació amb Okta" i premeu "Acabar". 7\. Ara, accediu a la pestanya *Assignacions* i premeu el botó "Assignar", després trieu "Assignar a persones" al menú desplegable.  8\. A una finestra contextual que apareixerà, assigneu l'aplicació creada a les persones que emprearan SAML 2.0 per autenticar amb Zabbix, i després premeu "Registrar i anar enrere". 9\. Accediu a la pestanya "Connexió" i premeu el botó "Afegir les instruccions de configuració". Les instruccions de configuració s'afegiran a una nova pestanya: deseu aquesta pestanya oberta mentre configureu Zabbix.  #### Older XML protocol ::: noteclassic Zabbix will take up to 16 MB of XML Base64-encoded data, but a single decoded value should be no longer than 64 KB otherwise it will be truncated to 64 KB while decoding. ::: #### Antic protocol XML ::: noteclassic Zabbix prendrà fins a 16Mo de dades codificades en XML Base64, però un sol valor descodificat no haurà de passar els 64Ko, sinó es retallarà a 64Ko mentre es descodifiqui. ::: #### One side connects with certificate but other side accepts only PSK or vice versa In any log (with *GnuTLS*): failed to accept an incoming connection: from 127.0.0.1: zbx_tls_accept(): gnutls_handshake() failed:\ -21 Could not negotiate a supported cipher suite. In any log (with *OpenSSL* 1.0.2c): failed to accept an incoming connection: from 127.0.0.1: TLS handshake returned error code 1:\ file .\ssl\s3_srvr.c line 1411: error:1408A0C1:SSL routines:ssl3_get_client_hello:no shared cipher:\ TLS write fatal alert "handshake failure" #### Una banda es connecta amb el certificat, però l'altra banda només admet PSK o viceversa Al registre (amb *GnuTLS*): no s'ha pogut acceptar una connexió entrant: des de 127.0.0.1: zbx_tls_accept(): gnutls_handshake() ha fallat:\ -21 No s'ha pogut negociar un conjunt de xifrat compatible. Al registre (amb *OpenSSL* 1.0.2c): no s'ha pogut acceptar una connexió entrant: a partir de 127.0.0.1: l'enllaç TLS ha retornat el codi d'error 1:\ fitxer .\ssl\s3_srvr.c línia 1411: error:1408A0C1:Rutines SSL:ssl3_get_client_hello:no hi ha xifrat compartit:\ TLS escriu l'alerta fatal "error en l'establiment de comunicació (handshake)" #### One side connects with PSK but other side uses LibreSSL or has been compiled without encryption support LibreSSL does not support PSK. In connecting-side log: ...TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() I/O error: [0] Success In accepting-side log: ...failed to accept an incoming connection: from 192.168.1.2: support for PSK was not compiled in In Zabbix frontend: Get value from agent failed: TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() I/O error: [0] Success #### Una banda es connecta a PSK, però l'altra empra LibreSSL o s'ha compilat sense suport de xifrat LibreSSL no és compatible amb PSK. Al registre del costat de connexió: ...TCP correcte, no es pot establir TLS a [[192.168.1.2]:10050]: Error d'E/S SSL_connect(): [0] Correcte Al registre de l'altra banda: ... no s'ha pogut acceptar una connexió entrant: des de 192.168.1.2: el suport per a PSK no es va compilar A la interfície web de Zabbix: Ha fallat l'obtenció del valor de l'agent: TCP correcte, no es pot establir TLS a [[192.168.1.2]:10050]: SSL_connect() Error d'E/S: [0] Correcte #### One side connects with PSK but other side uses OpenSSL with PSK support disabled In connecting-side log: ...TCP successful, cannot establish TLS to [[192.168.1.2]:10050]: SSL_connect() set result code to SSL_ERROR_SSL: file ../ssl/record/rec_layer_s3.c line 1536: error:14094410:SSL routines:ssl3_read_bytes:sslv3 alert handshake failure: SSL alert number 40: TLS read fatal alert "handshake failure" In accepting-side log: ...failed to accept an incoming connection: from 192.168.1.2: TLS handshake set result code to 1: file ssl/statem/statem_srvr.c line 1422: error:1417A0C1:SSL routines:tls_post_process_client_hello:no shared cipher: TLS write fatal alert "handshake failure" #### Una banda es connecta a PSK, però l'altra empra OpenSSL amb el suport PSK desactivat Al registre del costat de connexió: ...TCP correcte, no es pot establir TLS a [[192.168.1.2]:10050]: SSL_connect() estableix el codi de resultat a SSL_ERROR_SSL: fitxer ../ssl/record/rec_layer_s3.c línia 1536: error:14094410:Rutines SSL: ssl3_read_bytes:falla de connexió d'alertes sslv3: nombre d'alerta SSL 40: TLS llegeix l'alerta fatal "error d'establiment de connexió" Al registre de l'altra banda: ... no s'ha pogut acceptar una connexió entrant: des de 192.168.1.2: el codi de resultat de l'establiment de la connexió TLS estableix el codi de resultat a 1: fitxer ssl/statem/statem_srvr.c línia 1422: error:1417A0C1:Rutines SSL:tls_post_process_client_hello: sense xifrat compartit: TLS escriu l'alerta fatal "fallida d'establiment de connexió" ##### On Linux 2.4: (Sensor readings are obtained from /proc/sys/dev/sensors directory) - **device** - device name (if <mode> is used, it is a regular expression); - **sensor** - sensor name (if <mode> is used, it is a regular expression); - **mode** - possible values: avg, max, min (if this parameter is omitted, device and sensor are treated verbatim). Example key: sensor\[w83781d-i2c-0-2d,temp1\] Prior to Zabbix 1.8.4, the sensor\[temp1\] format was used. ##### Sota Linux 2.4 : (Les lectures dels sensors s'obtenen del directori /proc/sys/dev/sensors) - **device** - nom del perifèric (si s'empra <mode> , és una expressió regular); - **sensor** - nom del sensor (si s'empra <mode> , és una expressió regular); - **mode** - valors possibles : avg, max, min (si s'omet aquest paràmetre, el perifèric i el sensor es tracten textualment). Exemple de clau : sensor\[w83781d-i2c-0-2d,temp1\] Abans de Zabbix 1.8.4, s'emprava el format sensor\[temp1\]. ##### On Linux 2.6+: (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 key: sensor\[k8temp-pci-00c3,temp,max\] or sensor\[0000:00:18.3,temp1\] sensor\[smsc47b397-isa-0880,in,avg\] or sensor\[smsc47b397.2176,in1\] ##### Sota Linux 2.6+ : (Les lectures dels sensors s'obtenen del directori /sys/class/hwmon) - **device** - nom del perifèric (expressió no regular). El nom del perifèric pot ésser el nom real (ex. 0000:00:18.3) o el nom adquirit emprant el programa de sensors (ex. k8temp-pci-00c3). L'usuari pot decidir el nom a emprar; - **sensor** - nom del sensor (expressió no regular); - **mode** - valors possibles : avg, max, min (si el paràmetre s'omet, el perifèric i el sensor es tracten textualment). Exemples de claus : sensor\[k8temp-pci-00c3,temp, max\] ou sensor\[0000:00:18.3,temp1\] sensor\[smsc47b397-isa-0880,in, avg\] ou sensor\[smsc47b397.2176,in1\] ### Open file descriptor limit increase for Zabbix agent 2 The systemd service file shipped in Zabbix agent 2 packages now declares the open file descriptor limit of 8196. Previously, the system default limit of 1024 has been used. The new limit is sufficient for the default Zabbix agent 2 configuration. If you have a non-standard agent 2 configuration, for example, use additional plugins or extended features, this limit may need to be manually increased further. In this case, adjust the `LimitNOFILE` parameter in the systemd unit file. ### Pujar el límit de descriptors de fitxers oberts per a l'agent Zabbix 2 El fitxer de servei Systemd proporcionat als paquets d'agent Zabbix 2 ara declara el límit del descriptor de fitxers oberts de 8196. Anteriorment, s'emprava el límit predeterminat del sistema de 1024. El nou límit és suficient per a la configuració predeterminada de l'agent Zabbix 2. Si teniu una configuració de l'Agent 2 no estàndard, per exemple, emprant connectors addicionals o funcionalitats esteses, és possible que s'hagi d'augmentar manualment aquest límit. En aquest cas, ajusteu el paràmetre `LimitNOFILE` al fitxer d'unitat systemd. ### Open file descriptor limit increase for Zabbix agent 2 The systemd service file shipped in Zabbix agent 2 packages now declares the open file descriptor limit of 8196. Previously, the system default limit of 1024 has been used. The new limit is sufficient for the default Zabbix agent 2 configuration. If you have a non-standard agent 2 configuration, for example, use additional plugins or extended features, this limit may need to be manually increased further. In this case, adjust the `LimitNOFILE` parameter in the systemd unit file. ### Pujar el límit de descriptors de fitxers oberts per a l'agent Zabbix 2 El fitxer de servei Systemd proporcionat als paquets d'agent Zabbix 2 ara declara el límit del descriptor de fitxers oberts de 8196. Anteriorment, s'emprava el límit predeterminat del sistema de 1024. El nou límit és suficient per a la configuració predeterminada de l'agent Zabbix 2. Si teniu una configuració de l'Agent 2 no estàndard, per exemple, emprant connectors addicionals o funcionalitats esteses, és possible que s'hagi d'augmentar manualment aquest límit. En aquest cas, ajusteu el paràmetre `LimitNOFILE` al fitxer d'unitat systemd. ### OpenSSL 3.0 support OpenSSL 3.0.x is now supported. Note that this change does not affect frontend encryption (which uses its own openssl-php package) and Java gateway JMX encrypted connections to monitoring targets (which uses its own Java encrypted libraries). ### Suport d'OpenSSL 3.0 Ara s'admet OpenSSL 3.0.x. Tingueu en compte que aquest canvi no afecta el xifrat de la interfície (que empra el seu propi paquet openssl-php) i les connexions xifrades de Java JMX Gateway per al monitoratge de destinació (que empren les seves pròpies biblioteques xifrades de Java). #### OpenSSL used with CRLs and for some CA in the certificate chain its CRL is not included in `TLSCRLFile` In TLS server log in case of *OpenSSL* peer: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file s3_srvr.c line 3251: error:14089086: SSL routines:ssl3_get_client_certificate:certificate verify failed: \ TLS write fatal alert "unknown CA" In TLS server log in case of *GnuTLS* peer: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file rsa_pk1.c line 103: error:0407006A: rsa routines:RSA_padding_check_PKCS1_type_1:\ block type is not 01 file rsa_eay.c line 705: error:04067072: rsa routines:RSA_EAY_PUBLIC_DECRYPT:paddin #### OpenSSL emprat amb CRLs i per algunes autoritats de certificació dins la cadena de certificats no té el CRL inclòs a `TLSCRLFile` Al registre del servidor TLS, en cas de peer *OpenSSL*: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file s3_srvr.c line 3251: error:14089086: SSL routines:ssl3_get_client_certificate:certificate verify failed: \ TLS write fatal alert "unknown CA" Al registre del servidor TLS, en cas de peer *GnuTLS*: failed to accept an incoming connection: from 127.0.0.1: TLS handshake with 127.0.0.1 returned error code 1: \ file rsa_pk1.c line 103: error:0407006A: rsa routines:RSA_padding_check_PKCS1_type_1:\ block type is not 01 file rsa_eay.c line 705: error:04067072: rsa routines:RSA_EAY_PUBLIC_DECRYPT:paddin #### Operating system - Use latest (stable!) version of OS - Exclude unnecessary functionality from kernel - Tune kernel parameters #### Sistema operatiu - Empreu la darrera versió (estable!) de Sistema Operatiu - Excloeu les funcionalitats inútils del kernel - Ajusteu els paràmetres del kernel #### Operational data of problems It is possible to display operational data for current problems, i.e. the latest item values as opposed to the item values at the time of the problem. Operational data display can be configured in the filter of *Monitoring* → *Problems* or in the configuration of the respective [dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems), by selecting one of the three options: - *None* - no operational data is displayed - *Separately* - operational data is displayed in a separate column {width="600"} - *With problem name* - operational data is appended to the problem name and in parentheses. Operational data are appended to the problem name only if the *Operational data* field is non-empty in the trigger configuration. {width="600"} The content of operational data can be configured with each [trigger](/manual/config/triggers/trigger), in the *Operational data* field. This field accepts an arbitrary string with macros, most importantly, the `{ITEM.LASTVALUE<1-9>}` macro. `{ITEM.LASTVALUE<1-9>}` in this field will always resolve to the latest values of items in the trigger expression. `{ITEM.VALUE<1-9>}` in this field will resolve to the item values at the moment of trigger status change (i.e. change into problem, change into OK, being closed manually by a user or being closed by correlation). Note that closing the problem manually does not produce a new value so the resolved value of `{ITEM.LASTVALUE<1-9>}` or `{ITEM.VALUE<1-9>}` will still show the value from the problem time. `{ITEM.LASTVALUE<1-9>}` or `{ITEM.VALUE<1-9>}` will resolve to \*UNKNOWN\* if the latest history value has been collected more than the *Max history display period* time ago (see *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)*). #### Dades operatives del problema És possible veure les dades operatives dels problemes actuals, és a dir, els darrers valors de l'element en lloc dels valors dels elements en el moment de l'emissió. La visualització de les dades operatives es pot configurar al filtre de *Monitoratge* → *Problemes* o a la configuració del respectiu [giny del tauler](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/problems), triant-ne un d'entre tres opcions: - *Cap* - no es veuen dades operatives - *Per separat* - les dades operatives es veuen en una columna separada {width="600"} - *Amb nom del problema* - les dades operatives s'afegeixen al nom del problema i entre parèntesis. Les dades operatives s'afegeixen al nom del problema només si el camp *Dades operacionals* no és buit a la configuració del trigger. {width="600"} El contingut de les dades operatives es pot configurar per a cada [trigger](/manual/config/triggers/trigger), al camp *Operational Data*. Aquest camp accepta una cadena arbitrària amb macros, la més important és la macro `{ITEM.LASTVALUE<1-9>}`. `{ITEM.LASTVALUE<1-9>}` en aquest camp sempre es resoldrà als darrers valors dels elements de l'expressió trigger.`{ITEM.VALUE<1-9>}` en aquest camp resoldrà els valors de l'element en el moment del canvi d'estat del trigger (és a dir, quan es converteix en un problema, s'arregla si es tanca manualment per un usuari o tancat per correlació). Tingueu en compte que tancar el problema manualment no produeix un valor nou, de manera que el valor resolt de `{ITEM.LASTVALUE<1-9>}` o `{ITEM.VALUE<1-9>}` encara mostrarà el valor de l'hora del problema. `{ITEM.LASTVALUE<1-9>}` o `{ITEM.VALUE<1-9>}` es resoldrà a \*DESCONEGUT\* si el darrer valor de l'historial s'ha recopilat abans del *Període màxim de visualització de l'historial* (veieu *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*). #### Operation details  |Parameter|<|Description| |-|----------|----------------------------------------| |*Operation*|<|Select the operation:<br>**Send message** - send message to user<br>**<remote command name>** - execute a remote command. Commands are available for execution if previously defined in [global scripts](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) with *Action operation* selected as its scope.<br>More operations are available for discovery and autoregistration based events (see above).| |*Steps*|<|Select the step(s) to assign the operation to in an [escalation](escalations) schedule:<br>**From** - execute starting with this step<br>**To** - execute until this step (0=infinity, execution will not be limited)| |*Step duration*|<|Custom duration for these steps (0=use default step duration).<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 60s, 1m, 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.<br>Several operations can be assigned to the same step. If these operations have different step duration defined, the shortest one is taken into account and applied to the step.| |Operation type: [send message](/manual/config/notifications/action/operation/message)|<|<| | |*Send to user groups*|Click on *Add* to select user groups to send the message to.<br>The user group must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |^|*Send to users*|Click on *Add* to select users to send the message to.<br>The user must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |^|*Send only to*|Send message to all defined media types or a selected one only.| |^|*Custom message*|If selected, the custom message can be configured.<br>For notifications about internal events via [webhooks](/manual/config/notifications/media/webhook), custom message is mandatory.| |^|*Subject*|Subject of the custom message. The subject may contain macros. It is limited to 255 characters.| |^|*Message*|The custom message. The message may contain macros. It is limited to certain amount of characters depending on the type of database (see [Sending message](/manual/config/notifications/action/operation/message) for more information).| |Operation type: [remote command](/manual/config/notifications/action/operation/remote_command)|<|<| | |*Target list*|Select targets to execute the command on:<br>**Current host** - command is executed on the host of the trigger that caused the problem event. This option will not work if there are multiple hosts in the trigger.<br>**Host** - select host(s) to execute the command on.<br>**Host group** - select host group(s) to execute the command on. Specifying a parent host group implicitly selects all nested host groups. Thus the remote command will also be executed on hosts from nested groups.<br>A command on a host is executed only once, even if the host matches more than once (e.g. from several host groups; individually and from a host group).<br>The target list is meaningless if a custom script is executed on Zabbix server. Selecting more targets in this case only results in the script being executed on the server more times.<br>Note that for global scripts, the target selection also depends on the *Host group* setting in global script [configuration](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script).<br>*Target list* option is not available for *Service actions* because in this case remote commands are always executed on Zabbix server.| |*Conditions*|<|Condition for performing the operation:<br>**Not ack** - only when the event is unacknowledged<br>**Ack** - only when the event is acknowledged.<br>*Conditions* option is not available for *Service actions*.| When done, click on *Add* to add the operation to the list of *Operations*. #### Detalls de l'operació  |Paràmetre|<|Descripció| |-|----------|----------------------------------------| |*Operació*|<|Trieu l'operació:<br>**Envia missatge** - envia un missatge a l'usuari<br>**\<nom de la comanda remota\>** - executeu una comanda a distància. Les comandes són disponibles per a l'execució si s'han definit prèviament a [scripts globals](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script) amb *Operació d'acció* triada com a àmbit.<br>Hi ha altres operacions disponibles per a esdeveniments basats en descoberta i registres automàtics (veieu més amunt).| |*Passes*|<|Trieu les passes a les quals assignar l'operació en una programació d'escalades (escalades):<br>**Des de** - executar des d'aquesta passa<br>**Fins a** - executar fins a aquesta fase (0 - indefinidament, l'execució no serà limitada)| |*Durada de la passa*|<|Durada personalitzada d'aquestes passes (0: empreu la durada de la passa predeterminada).<br>[Sufixos de temps](/manual/apèndix/sufixos) s'admeten per càrrega, per exemple, 60 s, 1 m, 2 h, 1 d, amb Zabbix 3.4.0.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros), amb Zabbix 3.4.0.<br>Es poden assignar diverses operacions a la mateixa passa. Si aquestes operacions tenen definides diferents durades de passa, es considera la més curta i s'aplica la passa.| |Tipus d'operació: [Envia missatge](/manual/config/notifications/action/operation/message)|<|<| | |*Enviar a grups d'usuaris*|Feu clic a *Afegir* per triar els grups d'usuaris als quals enviar el missatge.<br>El grup d'usuaris ha de tindre almenys [permisos](/manual/config/users_and_usergroups /permissions) de "lectura" a l'equip a per ser notificat.| |^|*Enviar als usuaris*|Feu clic a *Afegir* per triar els usuaris als quals enviar el missatge.<br>L'usuari ha de tindre almenys [permisos](/manual/config/users_and_usergroups/permissions) de "lectura" a l'equip per ser notificat.| |^|*Envia només a*|Envia un missatge a tots els tipus de suport definits o a un de triat.| |^|*Missatge personalitzat*|Si es tria, es pot configurar el missatge personalitzat.<br>Per a les notificacions d'esdeveniments interns mitjançant [webhooks](/manual/config/notifications/media/webhook), cal un missatge personalitzat.| |^|*Assumpte*|Assumpte del missatge personalitzat. El tema pot contindre macros. És limitat a 255 caràcters.| |^|*Missatge*|El missatge personalitzat. El missatge pot contindre macros. És limitat a un nombre determinat de caràcters en funció del tipus de base de dades (veieu [enviar missatge](/manual/config/notifications/action/operation/message) per a més informació).| |Tipus d'operació: [comanda remota](/manual/config/notifications/action/operation/remote_command)|<|<| | |*Llista d'objectius*|Trieu els objectius sobre els quals executar l'ordre:<br>**Equip actual** - L'ordre s'executa a l'equip del trigger que va provocar l'esdeveniment problemàtic. Aquesta opció no funcionarà si hi ha diversos equips al trigger.<br>**Equip** - trieu l'equip o equips on executar l'ordre.<br>**Grup d'equips** - trieu el o els grups d'equips per executar l'ordre. L'especificació d'un grup d'equip pare inclou implícitament tots els grups d'equips heretats. Per tant, l'ordre remota també s'executarà en equips en grups hereus.<br>Una ordre en un equip només s'executa una vegada, encara que l'equip coincideixi més d'una vegada (per exemple, des de diversos grups d'equip; individualment i des d'un grup equip). <br>La llista d'objectius no té sentit si s'és executant un script personalitzat al servidor Zabbix. En aquest cas, triar diversos objectius només fa que l'script s'executi al servidor diversos cops.<br>Tingueu en compte que, per als scripts globals, la selecció d'objectius també depèn de la configuració *Hostgroup* a la [configuració](/manual/interface_web/sections_frontend/administration/scripts#configuring_a_global_script) de l'script global.<br>L'opció *Llista d'objectius* no és disponible per a *accions de servei* perquè, en aquest cas, les comandes remotes encara s'executen al servidor Zabbix.| |*Condicions*|<|Condició d'execució de l'operació:<br>**L'esdeveniment no es reconeix** - només quan l'esdeveniment no és reconegut<br>**L'esdeveniment és reconegut** - només quan l'esdeveniment és reconegut.<br> L'opció *Condicions* no és disponible per a *accions de servei*.| Quan hagueu acabat, feu clic a *Afegir* per afegir la transacció a la llista de *Transaccions*. #### Operation type: notify all involved |Parameter|Description| |--|--------| |*Custom message*|If selected, a custom message can be defined.| |*Subject*|Subject of the custom message. The subject may contain macros.| |*Message*|The custom message. The message may contain macros.| #### Tipus d'operació: notificar totes les persones involucrades |Paràmetre|Descripció| |--|---------| |*Missatge personalitzat*|Si es tria, es pot definir un missatge personalitzat.| |*Assumpte*|Assumpte del missatge personalitzat. El tema pot contindre macros.| |*Missatge*|El missatge personalitzat. El missatge pot contindre macros.| #### Operation type: [remote command](/manual/config/notifications/action/operation/remote_command) |Parameter|Description| |--|--------| |*Target list*|Select targets to execute the command on:<br>**Current host** - command is executed on the host of the trigger that caused the problem event. This option will not work if there are multiple hosts in the trigger.<br>**Host** - select host(s) to execute the command on.<br>**Host group** - select host group(s) to execute the command on. Specifying a parent host group implicitly selects all nested host groups. Thus the remote command will also be executed on hosts from nested groups.<br>A command on a host is executed only once, even if the host matches more than once (e.g. from several host groups; individually and from a host group).<br>The target list is meaningless if the command is executed on Zabbix server. Selecting more targets in this case only results in the command being executed on the server more times.<br>Note that for global scripts, the target selection also depends on the *Host group* setting in global script [configuration](/manual/web_interface/frontend_sections/administration/scripts#configuring_a_global_script).| #### Tipus d'operació: [comanda remota](/manual/config/notifications/action/operation/remote_command) |Paràmetre|Descripció| |--|---------| |*Llistat d'objectius*|Trieu els objectius on executar la comanda:<br>**Equip actual** - La comanda s'executa a l'equip del trigger que va provocar l'esdeveniment problemàtic. Aquesta opció no funcionarà si hi ha diversos equips al trigger.<br>**Equip** - trieu l'equip o equips on executar la comanda.<br>**Grup d'equips** - trieu el o els grups d'equips on executar la comanda. L'especificació d'un grup d'equips pare inclou implícitament tots els grups d'equip descendents. Per tant, la comanda remota també s'executarà en equips en grups desdencents.<br>Una comanda en un equip només s'executa un cop, encara que l'equip coincideixi més d'una vegada (per exemple, des de diversos grups d'equips; individualment i des d'un grup d'equips).<br>El llistat d'objectius no té sentit si la comanda s'executa al servidor Zabbix. La tria de diversos objectius en aquest cas només fa que la comanda s'executi al servidor diversos cops.<br>Tingueu en compte que per als scripts globals, la tria d'objectius també depèn de la configuració *Hostgroup* a la [configuració](/manual/web_interface/frontend_sections /administration/scripts#configuring_a_global_script) d'script global.| #### Operation type: [send message](/manual/config/notifications/action/operation/message) |Parameter|Description| |--|--------| |*Send to user groups*|Click on *Add* to select user groups to send the recovery message to.<br>The user group must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |*Send to users*|Click on *Add* to select users to send the recovery message to.<br>The user must have at least "read" [permissions](/manual/config/users_and_usergroups/permissions) to the host in order to be notified.| |*Send only to*|Send default recovery message to all defined media types or a selected one only.| |*Custom message*|If selected, a custom message can be defined.| |*Subject*|Subject of the custom message. The subject may contain macros.| |*Message*|The custom message. The message may contain macros.| #### Tipus d'operació: [enviar un missatge](/manual/config/notifications/action/operation/message) |Paràmetre|Descripció| |--|---------| |*Enviar a grups d'usuaris*|Feu clic a *Afegir* per triar els grups d'usuaris als quals enviar el missatge de recuperació.<br>El grup d'usuaris ha de tindre almenys [permisos](/manual/config /users_and_usergroups/permissions) de "lectura" a l'equip per tal de ser notificat.| |*Enviar als usuaris*|Feu clic a *Afegir* per triar els usuaris als quals enviar el missatge de recuperació.<br>L'usuari ha de tindre almenys [permisos](/manual/config/users_and_usergroups/permissions) de "lectura" a l'equip per tal de ser notificat.| |*Envia només a*|Envia el missatge de recuperació predeterminat a tots els tipus de suport definits o a un seleccionat.| |*Missatge personalitzat*|Si es tria, es pot definir un missatge personalitzat.| |*Assumpte*|Assumpte del missatge personalitzat. El tema pot contenir macros.| |*Missatge*|El missatge personalitzat. El missatge pot contindre macros.| #### Operators The following operators are supported for triggers **(in descending priority of execution)**: |Priority|Operator|Definition|**Notes for [unknown values](/manual/config/triggers/expression#expressions_with_unknown-operands)**|Force cast operand to float ^**1**^| |-|-|----|----------------|--| |**1**|**-**|Unary minus|**-**Unknown → Unknown|Yes| |**2**|**not**|Logical NOT|**not** Unknown → Unknown|Yes| |**3**|**\***|Multiplication|0 **\*** Unknown → Unknown<br>(yes, Unknown, not 0 - to not lose<br>Unknown in arithmetic operations)<br>1.2 **\*** Unknown → Unknown|Yes| |<|**/**|Division|Unknown **/** 0 → error<br>Unknown **/** 1.2 → Unknown<br>0.0 **/** Unknown → Unknown|Yes| |**4**|**+**|Arithmetical plus|1.2 **+** Unknown → Unknown|Yes| |<|**-**|Arithmetical minus|1.2 **-** Unknown → Unknown|Yes| |**5**|**\<**|Less than. The operator is defined as:<br><br>A<B ⇔ (A<B-0.000001)|1.2 **<** Unknown → Unknown|Yes| |<|**<=**|Less than or equal to. The operator is defined as:<br><br>A<=B ⇔ (A≤B+0.000001)|Unknown **<=** Unknown → Unknown|Yes| |<|**>**|More than. The operator is defined as:<br><br>A>B ⇔ (A>B+0.000001)| |Yes| |<|**>=**|More than or equal to. The operator is defined as:<br><br>A>=B ⇔ (A≥B-0.000001)| |Yes| |**6**|**=**|Is equal. The operator is defined as:<br><br>A=B ⇔ (A≥B-0.000001) and (A≤B+0.000001)| |No ^**1**^| |<|**<>**|Not equal. The operator is defined as:<br><br>A<>B ⇔ (A<B-0.000001) or (A>B+0.000001)| |No ^**1**^| |**7**|**and**|Logical AND|0 **and** Unknown → 0<br>1 **and** Unknown → Unknown<br>Unknown **and** Unknown → Unknown|Yes| |**8**|**or**|Logical OR|1 **or** Unknown → 1<br>0 **or** Unknown → Unknown<br>Unknown **or** Unknown → Unknown|Yes| ^**1**^ String operand is still cast to numeric if: - another operand is numeric - operator other than **=** or **<>** is used on an operand (If the cast fails - numeric operand is cast to a string operand and both operands get compared as strings.) **not**, **and** and **or** operators are case-sensitive and must be in lowercase. They also must be surrounded by spaces or parentheses. All operators, except unary **-** and **not**, have left-to-right associativity. Unary **-** and **not** are non-associative (meaning **-(-1)** and **not (not 1)** should be used instead of **--1** and **not not 1**). Evaluation result: - **<**, **<=**, **>**, **>=**, **=**, **<>** operators shall yield '1' in the trigger expression if the specified relation is true and '0' if it is false. If at least one operand is Unknown the result is Unknown; - **and** for known operands shall yield '1' if both of its operands compare unequal to '0'; otherwise, it yields '0'; for unknown operands **and** yields '0' only if one operand compares equal to '0'; otherwise, it yields 'Unknown'; - **or** for known operands shall yield '1' if either of its operands compare unequal to '0'; otherwise, it yields '0'; for unknown operands **or** yields '1' only if one operand compares unequal to '0'; otherwise, it yields 'Unknown'; - The result of the logical negation operator **not** for a known operand is '0' if the value of its operand compares unequal to '0'; '1' if the value of its operand compares equal to '0'. For unknown operand **not** yields 'Unknown'. #### Operadors Els triggers admeten els operadors següents **(en prioritat d'execució descendent)**: |Prioritat|Operador|Definició|**Notes per a [valors desconeguts](/manual/config/triggers/expression#expressions_with_unsupported_items_and_unknown_values)**|Forçar l'operand a flotant^**1**^| |-|-|----|-----------------|--| |**1**|**-**|Menys unitari|**-**Desconegut → Desconegut|Sí| |**2**|**no**|NO lògic|**no** Desconegut → Desconegut|Sí| |**3**|**\***|Multiplicació|0 **\*** Desconegut → Desconegut<br>(sí, Desconegut, no 0 - per no perdre<br>Desconegut en operacions aritmètiques) <br >1,2 **\*** Desconegut → Desconegut|Sí| |<|**/**|Divisió|Desconegut **/** 0 → error<br>Desconegut **/** 1.2 → Desconegut<br>0.0 **/** Desconegut → Desconegut|Sí| |**4**|**+**|Signe més aritmètic|1,2 ***** Desconegut → Desconegut|Sí| |<|**-**|Signe menys aritmètic|1,2 **-** Desconegut → Desconegut|Sí| |**5**|**<**|L'operador es defineix com a menor de:<br><br>A<B ⇔ (A<B-0,000001)|1,2 **<** Desconegut → Desconegut|Sí| |<|**<=**|L'operador es defineix com inferior o igual a:<br><br>A<=B ⇔ (A≤B+0,000001)|Desconegut **<=** Desconegut → Desconegut|Sí| |<|**>**|L'operador es defineix com més gran que:<br><br>A>B ⇔ (A>B+0,000001)| |Sí| |<|**>=**|L'operador es defineix com més gran o igual a:<br><br>A>=B ⇔ (A≥B-0,000001)| |Sí| |**6***|**=**|L'operador es defineix com a igual:<br><br>A=B ⇔ (A≥B-0,000001) i (A≤B+0,000001)| |No ^**1**^| |<|**<>**|DL'operador es defineix com a diferent:<br><br>A<>B ⇔ (A<B-0,000001) o (A>B+0,000001)| |No ^**1**^| |**7**|**i**|I lògic|0 **i** Desconegut → 0<br>1 **i** Desconegut → Desconegut<br>Desconegut **i** Desconegut → Desconegut| Sí| |**8**|**o**|O lògic|1 **o** Desconegut → 1<br>0 **o** Desconegut → Desconegut<br>Desconegut **o** Desconegut → Desconegut| Sí| ^**1**^ L'operand de cadena sempre es converteix a numèric si: - un altre operand és numèric - S'empra un operador diferent de **=** o **<>** en un operand (Si la conversió falla, l'operand numèric es converteix en un operand de cadena i els dos operands es comparen com a cadenes.) Els operadors **no**, **i** i **o** distingeixen entre majúscules i minúscules i han d'ésser minúscules. També s'han d'envoltar per espais o parèntesis. Tots els operadors excepte els unaris **-** i **no** tenen associativitat d'esquerra a dreta. Els unitaris **-** i **no** no són associatius (és a dir, **-(-1)** i **no (no 1)** s'han d'emprar en comptes de **--1 ** i **no no 1**). Resultat de l'avaluació: - Els operadors **<**, **<=**, **>**, **>=**, **=**, **<>** han de donar '1' a l'expressió del trigger si la relació especificada és certa i '0' si és falsa. Si almenys un operand és desconegut, el resultat és Desconegut; - **i** per als operands coneguts ha de retornar '1' si els dos operands no són '0'; en cas contrari, retorna '0'; per a operands desconeguts **i** retorna '0' només si un operand és '0'; en cas contrari, dóna 'desconegut'; - **o** per a operands coneguts, retorna '1' si un dels seus operands no és '0'; en cas contrari, retorna '0'; per a operands desconeguts **o** només retorna '1' si un operand no és '0'; en cas contrari, dóna "desconegut"; - El resultat de l'operador de negació lògica **no** per a un operand conegut és '0' si el valor del seu operand no és igual a '0'; '1' si el valor del seu operand és '0'. Per a l'operand desconegut **no** dóna 'Desconegut'. ### Optimized API queries API database queries, used when searching through names in *hosts* and *items* tables, have been optimized and will now be processed more efficiently. ### Consultes API optimitzades Les consultes de bases de dades de l'API, que s'empren per buscar noms a les taules *equips* i *elements*, s'han optimitzat i ara es processaran de manera més eficient. ### Optimized API queries API database queries, used when searching through names in the *hosts* and *items* tables, have been optimized and will now be processed more efficiently. As a result of this change, deterministic triggers need to be created during an upgrade. On MySQL and MariaDB, this requires `GLOBAL log_bin_trust_function_creators = 1` to be set if binary logging is enabled and there is no superuser privileges and `log_bin_trust_function_creators = 1` is not set in MySQL configuration file. To set the variable using MySQL console, run: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Once the upgrade has been successfully completed, `log_bin_trust_function_creators` can be disabled: mysql> SET GLOBAL log_bin_trust_function_creators = 0; Triggers are also created for PostgreSQL and Oracle database. ### Consultes d'API optimitzades Les consultes de bases de dades de l'API, que s'empren quan es cerquen noms a les taules *equips* i *elements*, s'han optimitzat i ara es processaran de manera més eficient. Com a resultat d'aquest canvi, s'han de crear triggers deterministes durant una actualització. A MySQL i MariaDB, això requereix que s'estableixi `GLOBAL log_bin_trust_function_creators = 1` si el registre binari és habilitat i no hi ha privilegis de superusuari i `log_bin_trust_function_creators = 1` no és establert al fitxer de configuració de MySQL. Per configurar la variable mitjançant la consola MySQL, executeu: mysql> SET GLOBAL log_bin_trust_function_creators = 1; Un cop l'actualització s'hagi completat amb èxit, `log_bin_trust_function_creators` es pot desactivar: mysql> SET GLOBAL log_bin_trust_function_creators = 0; També es creen triggers per a bases de dades PostgreSQL i Oracle. ##### Optional interface The optional functions are **zbx\_module\_init()**, **zbx\_module\_item\_list()**, **zbx\_module\_item\_timeout()**, **zbx\_module\_history\_write\_cbs()** and **zbx\_module\_uninit()**: ``` {.c} int zbx_module_init(void); ``` This function should perform the necessary initialization for the module (if any). If successful, it should return ZBX\_MODULE\_OK. Otherwise, it should return ZBX\_MODULE\_FAIL. In the latter case Zabbix will not start. ``` {.c} ZBX_METRIC *zbx_module_item_list(void); ``` This function should return a list of items supported by the module. Each item is defined in a ZBX\_METRIC structure, see the section below for details. The list is terminated by a ZBX\_METRIC structure with "key" field of NULL. ``` {.c} void zbx_module_item_timeout(int timeout); ``` If module exports **zbx\_module\_item\_list()** then this function is used by Zabbix to specify the timeout settings in Zabbix configuration file that the item checks implemented by the module should obey. Here, the "timeout" parameter is in seconds. ``` {.c} ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void); ``` This function should return callback functions Zabbix server will use to export history of different data types. Callback functions are provided as fields of ZBX\_HISTORY\_WRITE\_CBS structure, fields can be NULL if module is not interested in the history of certain type. ``` {.c} int zbx_module_uninit(void); ``` This function should perform the necessary uninitialization (if any) like freeing allocated resources, closing file descriptors, etc. All functions are called once on Zabbix startup when the module is loaded, with the exception of zbx\_module\_uninit(), which is called once on Zabbix shutdown when the module is unloaded. ##### Interfície opcional Les funcions opcionals són **zbx\_module\_init()**, **zbx\_module\_item\_list()**, **zbx\_module\_item\_timeout()**, **zbx\_module\_history \_write\_cbs()** i **zbx\_module\_uninit()**: ``` {.c} int zbx_module_init(void); ``` Aquesta funció hauria de fer la inicialització necessària per al mòdul (si cal). Si té èxit, hauria de retornar ZBX\_MODULE\_OK. En cas contrari hauria de retornar ZBX\_MODULE\_FAIL. En aquest darrer cas, Zabbix no engegarà pas. ``` {.c} ZBX_METRIC *zbx_module_item_list(void); ``` Aquesta funció hauria de retornar una llista d'elements suportats pel mòdul. Cada element es defineix en una estructura ZBX\_METRIC, veieu la secció següent per obtenir-ne més detalls. La llista acaba amb una estructura ZBX\_METRIC amb el camp "clau" de NULL. ``` {.c} void zbx_module_item_timeout (temps d'espera int); ``` Si el mòdul exporta **zbx\_module\_item\_list()**, Zabbix empra aquesta funció per especificar la configuració del temps d'espera al fitxer de configuració de Zabbix que ha de complir l'element que comprova implementat pel mòdul. Aquí, el paràmetre "temps d'espera" és en segons. ``` {.c} ZBX_HISTORY_WRITE_CBS zbx_module_history_write_cbs(void); ``` Aquesta funció hauria de retornar les funcions de devolució de crida que el servidor Zabbix emprarà per exportar l'historial de diferents tipus de dades. Les funcions de devolució de trucada es proporcionen com a camps d'estructura ZBX\_HISTORY\_WRITE\_CBS, els camps poden ser NULL si el mòdul no té interès en cert tipus d'historial. ``` {.c} int zbx_module_uninit(void); ``` Aquesta funció hauria de realitzar la desinicialització necessària (si escau), com ara alliberar recursos assignats, tancar els descriptors de fitxers, etc. Totes les funcions es criden una vegada a l'inici de Zabbix quan es carrega el mòdul, excepte zbx\_module\_uninit(), que es crida a l'aturada de Zabbix quan es descarrega el mòdul. ## OPTIONS **-c**, **--config** *config-file* Use *config-file*. **Zabbix sender** reads server details from the agentd configuration file. By default **Zabbix sender** does not read any configuration file. Only parameters **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** and **TLSPSKFile** are supported. Hostname defined through **HostnameItem** parameter will not be picked up, in this case the hostname should be specified via command line (see -s option). All addresses defined in the agent **ServerActive** configuration parameter are used for sending data. If sending of batch data fails to one address, the following batches are not sent to this address. **-z**, **--zabbix-server** *server* Hostname or IP address of Zabbix server. If a host is monitored by a proxy, proxy hostname or IP address should be used instead. When used together with **--config**, overrides the entries of **ServerActive** parameter specified in agentd configuration file. **-p**, **--port** *port* Specify port number of Zabbix server trapper running on the server. Default is 10051. When used together with **--config**, overrides the port entries of **ServerActive** parameter specified in agentd configuration file. **-I**, **--source-address** *IP-address* Specify source IP address. When used together with **--config**, overrides **SourceIP** parameter specified in agentd configuration file. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-300 seconds (default: 60) **-s**, **--host** *host* Specify host name the item belongs to (as registered in Zabbix frontend). Host IP address and DNS name will not work. When used together with **--config**, overrides **Hostname** parameter specified in agentd configuration file. **-k**, **--key** *key* Specify item key to send value to. **-o**, **--value** *value* Specify item value. **-i**, **--input-file** *input-file* Load values from input file. Specify **-** as **<input-file>** to read values from standard input. Each line of file contains whitespace delimited: **<hostname> <key> <value>**. Each value must be specified on its own line. Each line must contain 3 whitespace delimited entries: **<hostname> <key> <value>**, where "hostname" is the name of monitored host as registered in Zabbix frontend, "key" is target item key and "value" - the value to send. Specify **-** as **<hostname>** to use hostname from agent configuration file or from **--host** argument. An example of a line of an input file: **"Linux DB3" db.connections 43** The value type must be correctly set in item configuration of Zabbix frontend. Zabbix sender will send up to 250 values in one connection. [Size limit](/manual/appendix/protocols/header_datalen) for sending values from an input file depends on the size described in Zabbix communication protocol. Contents of the input file must be in the UTF-8 encoding. All values from the input file are sent in a sequential order top-down. Entries must be formatted using the following rules: - Quoted and non-quoted entries are supported. - Double-quote is the quoting character. - Entries with whitespace must be quoted. - Double-quote and backslash characters inside quoted entry must be escaped with a backslash. - Escaping is not supported in non-quoted entries. - Linefeed escape sequences (\\n) are supported in quoted strings. - Linefeed escape sequences are trimmed from the end of an entry. **-T**, **--with-timestamps** This option can be only used with **--input-file** option. Each line of the input file must contain 4 whitespace delimited entries: **<hostname> <key> <timestamp> <value>**. Timestamp should be specified in Unix timestamp format. If target item has triggers referencing it, all timestamps must be in an increasing order, otherwise event calculation will not be correct. An example of a line of the input file: **"Linux DB3" db.connections 1429533600 43** For more details please see option **--input-file**. If a timestamped value is sent for a host that is in a “no data” maintenance type then this value will be dropped; however, it is possible to send a timestamped value in for an expired maintenance period and it will be accepted. **-N**, **--with-ns** This option can be only used with **--with-timestamps** option. Each line of the input file must contain 5 whitespace delimited entries: **<hostname> <key> <timestamp> <ns> <value>**. An example of a line of the input file: **"Linux DB3" db.connections 1429533600 7402561 43** For more details please see option **--input-file**. **-r**, **--real-time** Send values one by one as soon as they are received. This can be used when reading from standard input. **--tls-connect** *value* How to connect to server or proxy. Values: [ ]{#lbAF} ## OPCIONS **-c**, **--config** *config-file* Fer ús de *config-file*. **Zabbix sender** llegeix els paràmetres del servidor de l'arxiu de configuració de l'agent. Per defecte, **Zabbix sender** no llegeix pas cap arxiu de configuració. Tant sols són suportats els paràmetres **Hostname**, **ServerActive**, **SourceIP**, **TLSConnect**, **TLSCAFile**, **TLSCRLFile**, **TLSServerCertIssuer**, **TLSServerCertSubject**, **TLSCertFile**, **TLSKeyFile**, **TLSPSKIdentity** i **TLSPSKFile**. El nom d'equip definit mitjançant el paràmetre **HostnameItem** no es recollirà, en aquest cas el nom d'equip s'ha d'especificar mitjançant la línia d'ordres (veieu l'opció -s). Totes les adreces definides al paràmetre de configuració **ServerActive** de l'agent són emprats per enviar dades. Si l'enviament de dades en lots falla per a una adreça, els següents lots no s'enviaran pas cap a aquesta adreça. **-z**, **--zabbix-server** *server* Nom o adreça IP de l'equip del servidor Zabbix. Si un equip és monitorat per un proxy, s'han d'especificar el nom o adreça IP del proxy. Quan s'empra amb **--config**, sobreescriu els valors del paràmetre **ServerActive** especificat a l'arxiu de configuració de l'agent. **-p**, **--port** *port* Nombre de port del servidor Zabbix en execució al servidor. Per defecte és el 10051. Quan s'empra amb **--config**, sobreescriu les entrades de port del paràmetre **ServerActive** especificat a l'arxiu de configuració de l'agent. **-I**, **--source-address** *IP-address* Adreça IP d'origen. Quan s'empra amb **--config**, sobreescriu el paràmetre **SourceIP** especificat a l'arxiu de configuració de l'agent. **-t**, **--timeout** *seconds* Temps d'espera. Interval permès: 1-300 segons (per defecte: 60) **-s**, **--host** *host* Nom de l'equip al que pertany l'element (tal com s'ha registrat al tauler de Zabbix). L'adreça IP de l'equip i el nom DNS no funcionaran pas. Quan s'empra amb **--config**, sobreescriu el paràmetre **Hostname** definit a l'arxiu de configuració de l'agent. **-k**, **--key** *key* Clau de l'element per enviar el valor. **-o**, **--value** *value* Valor de l'element. **-i**, **--input-file** *input-file* Carrega els valors d'un arxiu d'entrada. Escriviu **-** como a **<input-file>** per tal de llegir els valors d'entrada per defecte. Cada línia de l'arxiu conté espais en blanc delimitats: **<hostname> <key> <value>**. Cada valor s'ha d'especificar a la seva línia. Cada línia ha de tindre 3 espais delimitadors: **<hostname> <key> <value>**, on "hostname" és el nom de l'equip monitorat tal com s'ha registrat al tauler de Zabbix, "key" és la clau de l'element destí i "value" - el valor a enviar. Definiu **-** com a **<hostname>** per emprar el nom d'equip de l'arxiu de configuració de l'agent o de l'argument **--host**. Un exemple d'una línia d'entrada d'un arxiu: **"Linux DB3" db.connections 43** El tipus de valor ha d'ésser definit correctament a la configuració de l'element del tauler de Zabbix. El Zabbix Sender enviarà fins a 250 valors en una connexió. [La mida límit](/manual/appendix/protocols/header_datalen) per enviar valors des d'un arxiu d'entrada dependrà de la mida descrita al protocol de comunicacions de Zabbix. El contingut de l'arxiu d'entrada ha d'ésser codificat amb UTF-8. Tots els valors de l'arxiu d'entrada s'envien en ordre seqüencial de dalt a baix. Les entrades s'han de formatar amb aquestes regles: - Suporta entrades amb i sense cometes. - Cometes dobles representen els caràcters de cometes. - Les entrades amb espais en blanc han d'ésser entre cometes. - Els caràcters de cometes dobles i barra invertida dins de cometes s'han d'especificar amb una barra invertida. - L'ESC no és pas suportat en entrades sense cometes. - Els salts de línia (\\n) es suporten en cadenes entre cometes. - Els salts de línia es tallen a partir del final d'una entrada. **-T**, **--with-timestamps** Aquesta opció només es pot emprar amb l'opció **--input-file**. Cada línia de l'arxiu d'entrada ha de contindre 4 entrades delimitades per espais en blanc: **<hostname> <key> <timestamp> <value>**. El temps d'espera s'ha d'especificar en format Unix. Si el destí té triggers que el referencien, tots els temps d'espera han d'ésser en ordre creixent; en cas contrari, el càlcul de l'event no serà pas correcte. Un exemple d'una línia de l'arxiu d'entrada: **"Linux DB3" db.connections 1429533600 43** Per més detalls, veieu l'opció **--input-file**. Si un valor amb temps d'espera s'envia a un equip que és en tipus de manteniment “no data”, es descartarà el valor; en canvi, és possible enviar un valor de temps d'espera per a un període de manteniment expirat i s'acceptarà. **-N**, **--with-ns** Aquesta opció només es pot emprar amb l'opció **--with-timestamps**. Cada línia de l'arxiu d'entrada ha de contindre 5 entrades delimitades per espais en blanc: **<hostname> <key> <timestamp> <ns> <value>**. un exemple d'una línia d'arxiu d'entrada: **"Linux DB3" db.connections 1429533600 7402561 43** Per tindre més detalls, veieu l'opció **--input-file**. **-r**, **--real-time** Envia els valors d'un en un tan aviat es reben. Això es pot emprar al llegir de l'entrada per defecte. **--tls-connect** *value* Com connectar al servidor o proxy. Valors: [ ]{#lbAF} ## 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} ## OPCIONS **-c**, **--config** *config-file* Feu ús de l'alternativa *config-file* enlloc del que hi ha per defecte. **-f**, **--foreground** Executar l'agent de Zabbix en primer pla. **-R**, **--runtime-control** *runtime-option* Executar accions administratives segons *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix proxy in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. [ ]{#lbAF} ## OPCIONS **-c**, **--config** *config-file* Usa un arxiu de configuració *config-file* alternatiu, enlloc del que hi ha per defecte. **-f**, **--foreground** Fa anar el servei de Zabbix proxy en primer pla. **-R**, **--runtime-control** *runtime-option* Executa funcions administratives segons les *runtime-option*. [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-f**, **--foreground** Run Zabbix server in foreground. **-R**, **--runtime-control** *runtime-option* Perform administrative functions according to *runtime-option*. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. Examples of running Zabbix server with command line parameters: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPCIONS **-c**, **--config** *config-file* Agafar el *config-file* alternatiu enlloc del que hi ha per defecte. **-f**, **--foreground** El servidor Zabbix corre en primer pla. **-R**, **--runtime-control** *runtime-option* Funcions administratives segons el *runtime-option*. **-h**, **--help** Mostra l'ajuda i surt. **-V**, **--version** Mostra informació de la versió i surt. Exemples d'execució del servidor Zabbix server des de la línia de comandes: ```yaml zabbix_server -c /usr/local/etc/zabbix_server.conf zabbix_server --help zabbix_server -V ``` [ ]{#lbAF} ## OPTIONS **-c**, **--config** *config-file* Use the alternate *config-file* instead of the default one. **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## OPCIONS **-c**, **--config** *config-file* *config-file* alternatiu, enlloc del que hi ha per defecte. **-h**, **--help** Veure l'ajuda i sortir. **-V**, **--version** Veure informació de la versió i sortir. [ ]{#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*. ## OPCIONS **-c**, **--config** *config-file* Feu ús del *config-file* alternatiu enlloc del que hi ha per defecte. **-R**, **--runtime-control** *runtime-option* Feu funcions administratives segons *runtime-option*. ### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| ### Opcions |Paràmetre|Descripció| |---------|-----------| |-V --version|Mostra la versió del plugin i informació de la llicència.| |-h --help|Mostra la informació d'ajuda (abreujatura).| #### Options |Parameter|Description| |---------|-----------| |-V --version|Print the plugin version and license information.| |-h --help|Print help information (shorthand).| #### Opcions |Paràmetre|Descripció| |---------|-----------| |-V --version|Mostra la versió del plugin i informació de la llicència.| |-h --help|Mostra la informació d'ajuda (abreujatura).| ## OPTIONS **-s**, **--host** *host-name-or-IP* Specify host name or IP address of a host. **-p**, **--port** *port-number* Specify port number of agent running on the host. Default is 10050. **-I**, **--source-address** *IP-address* Specify source IP address. **-t**, **--timeout** *seconds* Specify timeout. Valid range: 1-30 seconds (default: 30) **-k**, **--key** *item-key* Specify key of item to retrieve value for. **--tls-connect** *value* How to connect to agent. Values: [ ]{#lbAF} ## OPIONS **-s**, **--host** *nom d'equip o IP* Nom o adreça IP de l'equip. **-p**, **--port** *port* Nombre de port de l'agent que corre a l'equip. Per defecte és el 10050. **-I**, **--source-address** *adreça IP* Adreça IP d'origen. **-t**, **--timeout** *segons* Temps d'espera, en segons. El rang vàlid és d'entre 1 i 30 (el valor per defecte és 30) **-k**, **--key** *clau d'element* Clau de l'element del que hem de recuperar el valor. **--tls-connect** *valor* Com connectar amb l'agent. Valors: [ ]{#lbAF} ## OPTIONS **-s**, **--script** *script-file* Specify the file name of the script to execute. If '-' is specified as file name, the script will be read from stdin. **-p**, **--param** *input-param* Specify the input parameter. **-i**, **--input** *input-file* Specify the file name of the input parameter. If '-' is specified as file name, the input will be read from stdin. **-l**, **--loglevel** *log-level* Specify the log level. **-t**, **--timeout** *timeout* Specify the timeout in seconds. Valid range: 1\-60 seconds (default: 10) **-h**, **--help** Display this help and exit. **-V**, **--version** Output version information and exit. [ ]{#lbAF} ## OPCIONS **-s**, **--script** *script-file* Nom de l'arxiu d'script que es vol fer córrer. Si com a nom d'arxiu hi posem '-', l'script es llegirà d'stdin. **-p**, **--param** *input-param* Paràmetre d'entrada. **-i**, **--input** *input-file* Nom de l'arxiu del paràmetre d'entrada. Si com a nom hi posem '-', l'entrada serà llegida de l'stdin. **-l**, **--loglevel** *log-level* Nivell de registre. **-t**, **--timeout** *timeout* Temps d'espera, en segons. rang vàlid: 1\-60 segons (per defecte: 10) **-h**, **--help** Mostrar aquesta ajuda i sortir. **-V**, **--version** Mostrar informació de la versió i sortir. [ ]{#lbAF} #### Options The following command line parameters can be used with Zabbix agent 2: |Parameter|Description| |--|--------| |-c --config <config-file>|Path to the configuration file.<br>You may use this option to specify a configuration file that is not the default one.<br>On UNIX, default is /usr/local/etc/zabbix\_agent2.conf or as set by [compile-time](/manual/installation/install#installing_zabbix_daemons) variables *--sysconfdir* or *--prefix*| |-f --foreground|Run Zabbix agent in foreground (default: true).| |-p --print|Print known items and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-t --test <item key>|Test specified item and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-h --help|Print help information and exit.| |-v --verbose|Print debugging information. Use this option with -p and -t options.| |-V --version|Print agent version and license information.| |-R --runtime-control <option>|Perform administrative functions. See [runtime control](/manual/concepts/agent2#runtime_control).| Specific **examples** of using command line parameters: - print all built-in agent items with values - test a user parameter with "mysql.ping" key defined in the specified configuration file ```{=html} <!-- --> ``` zabbix_agent2 --print zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf #### Opcions Els paràmetres de línia de comandes següents es poden emprar amb l'agent Zabbix 2: |Paràmetre|Descripció| |--|---------| |-c --config <config-file>|Camí al fitxer de configuració.<br>Podeu emprar aquesta opció per especificar un fitxer de configuració no predeterminat.<br>A UNIX, per defecte és /usr/local/etc/zabbix \_agent2.conf o tal com defineixen les variables [temps de compilació](/manual/installation/install#installing_zabbix_daemons) *--sysconfdir* o *--prefix* | |-f --foreground|Executar l'agent Zabbix en primer pla (per defecte: cert).| |-p --print|Mostra els elements coneguts i surt.<br>*Nota*: Per retornar també els resultats dels [paràmetres d'usuari](/manual/config/items/userparameters), heu d'especificar el fitxer de configuració (si no es troba a la ubicació predeterminada). | |-t --test <clau d'element>|Prova l'element especificat i surt.<br>*Nota*: Per retornar també els resultats dels [paràmetres d'usuari](/manual/config/items/userparameters), heu d'especificar el fitxer de configuració (si no es troba a la ubicació predeterminada). | |-h --help|Mostra informació d'ajuda i surt.| |-v --verbose|Mostra la informació de depuració. Empreu aquesta opció amb els paràmetres -p i -t.| |-V --version|Mostra la versió de l'agent i la informació de la llicència.| |-R --runtime-control <opció>|Realitzar funcions administratives. Veieu [control d'execució](/manual/concepts/agent2#runtime_control).| Exemples **específics** d'ús de paràmetres de línia d'ordres: - Mostra tots els elements de l'agent integrat amb els seus valors - Prova un paràmetre d'usuari amb la clau "mysql.ping" definida al fitxer de configuració especificat ```{=html} <!-- --> ``` shell> zabbix_agent2 --print shell> zabbix_agent2 -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf ### Oracle Export and import must be performed in tmux/screen to ensure that the session isn't dropped. Zabbix server should be down during the upgrade. See also: [Important notes](#important-notes) #### Table upgrade * Install Oracle Data Pump (available in the [Instant Client Tools package](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html)). See Oracle Data Pump [documentation](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-performance-tips.html) for performance tips. * Rename tables using `history_pk_prepare.sql`. ```bash cd /path/to/zabbix-sources/database/oracle/option-patches sqlplus zabbix/password@oracle_host/service sqlplus> @history_pk_prepare.sql ``` ### Oracle La exportació i importació s'ha de fer amb tmux/screen per assegurar que la sessió no es tanca pas. El servidor de Zabbix ha d'ésser aturat durant l'actualització. Veieu també: [Notes importants](#important-notes) #### Actualització de la taula * Instal·leu Oracle Data Pump (disponible al [paquet Instant Client Tools](https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html)). Veieu els consells de rendiment de l'Oracle Data Pump a la [documentació](https://docs.oracle.com/en/database/oracle/oracle-database/19/sutil/oracle-data-pump-performance-tips.html). * Reanomeneu les taules emprant `history_pk_prepare.sql`. ``` bash cd /path/to/zabbix-sources/database/oracle/option-patches sqlplus zabbix/password@oracle_host/service sqlplus> @history_pk_prepare.sql ``` #### Oracle Instructions for creating and configuring Oracle database are provided in a separate [section](/manual/appendix/install/oracle). #### Oracle Les instruccions de creació i configuració d'Oracle són descrites a una [secció](/manual/appendix/install/timescaledb) diferent. ### Oracle |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |oracle.diskgroups.stats\[connString,<user>,<password>,<service>,<diskgroup>\]|<|<|<| |Automatic Storage Management (ASM) disk groups statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**diskgroup** - name of the ASM disk group to query.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.diskgroups.discovery\[connString,<user>,<password>,<service>\]|<|<|<| |List of ASM disk groups. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.archive.info\[connString,<user>,<password>,<service>,<destination>\]|<|<|<| |Archive logs statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**destination** - name of the destination to query.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.cdb.info\[connString,<user>,<password>,<service>,<database>\]|<|<|<| |Container Databases (CDBs) information.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**database** - name of the database to query.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.custom.query\[connString,<user>,<password>,<service>,queryName,<args...>\]|<|<|<| |Result of a custom query.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**queryName** — name of a custom query, must match SQL file name without an extension.<br>**args** - one or several comma-separated arguments to pass to a query.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.datafiles.stats\[connString,<user>,<password>,<service>\]|<|<|<| |Data files statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.db.discovery\[connString,<user>,<password>,<service>\]|<|<|<| |List of databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.fra.stats\[connString,<user>,<password>,<service>\]|<|<|<| |Fast Recovery Area (FRA) statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.instance.info\[connString,<user>,<password>,<service>\]|<|<|<| |Instance statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.pdb.info\[connString,<user>,<password>,<service>,<database>\]|<|<|<| |Pluggable Databases (PDBs) information.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**database** - name of the database to query.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.pdb.discovery\[connString,<user>,<password>,<service>\]|<|<|<| |List of PDBs. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.pga.stats\[connString,<user>,<password>,<service>\]|<|<|<| |Program Global Area (PGA) statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.ping\[connString,<user>,<password>,<service>\]|<|<|<| |Tests whether a connection to Oracle can be established.|0 - connection is broken (if there is any error presented including AUTH and configuration issues)<br>1 - connection is successful.|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.proc.stats\[connString,<user>,<password>,<service>\]|<|<|<| |Processes statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.redolog.info\[connString,<user>,<password>,<service>\]|<|<|<| |Log file information from the control file.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.sga.stats\[connString,<user>,<password>,<service>\]|<|<|<| |System Global Area (SGA) statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.sessions.stats\[connString,<user>,<password>,<service>,<lockMaxTime>\]|<|<|<| |Sessions statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**lockMaxTime** - maximum session lock duration in seconds to count the session as a prolongedly locked. Default: 600 seconds.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.sys.metrics\[connString,<user>,<password>,<service>,<duration>\]|<|<|<| |A set of system metric values.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**duration** - capturing interval (in seconds) of system metric values. Possible values: *60* — long duration (default), *15* — short duration.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.sys.params\[connString,<user>,<password>,<service>\]|<|<|<| |A set of system parameter values.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.ts.stats\[connString,<user>,<password>,<service>,<tablespace>,<type>\]|<|<|<| |Tablespaces statistics.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**tablespace** - name of the tablespace to query. Default (if left empty and `type` is set):<br>- "TEMP" (if `type` is set to "TEMPORARY");<br>- "USERS" (if `type` is set to "PERMANENT").<br>**type** - type of the tablespace to query. Default (if `tablespace` is set): "PERMANENT".|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.ts.discovery\[connString,<user>,<password>,<service>\]|<|<|<| |List of tablespaces. Used for [low-level discovery](/manual/discovery/low_level_discovery).|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.user.info\[connString,<user>,<password>,<service>,<username>\]|<|<|<| |Returns Oracle user information.|JSON object|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.<br>**username** - a username, for which the information is needed. Lowercase usernames are not supported. Default: current user.|**user** parameter allows to append one of the login options `as sysdba`, `as sysoper`, or `as sysasm` in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space). | |oracle.version\[connString,<user>,<password>,<service>\]|<|<|<| |Returns the database server version.|String|**connString** - URI or session name.<br>**user, password** - Oracle login credentials.<br>**service** - Oracle service name.| | ### Oracle |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |oracle.diskgroups.stats\[connString,<usuari>,<mot de pas>,<servei>,<grup de discs>\]|<|<|<| |Estadístiques de grups de discs de gestió automàtica d'emmagatzematge (ASM).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - Credencials d'inici de sessió d'Oracle.<br>**servei** - Nom del servei d'Oracle.<br>**diskgroup** - nom del grup de discs ASM a consultar.|**usuari** - permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.diskgroups.discovery\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Llista de grups de discs ASM. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle .<br>**servei** - Nom del servei d'Oracle.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com sysdba`, `com sysoper` o `com sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.archive.info\[connString,<usuari>,<mot de pas>,<servei>,<destinació>\]|<|<|<| |Arxiva les estadístiques dels registres.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle.<br >**destí** - nom del destí a consultar.|**El paràmetre usuari** permet afegir una de les opcions d'inici de sessió `com sysdba`, `com sysoper`, o `com sysasm` en el format `com sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.cdb.info\[connString,<usuari>,<mot de pas>,<servei>,<base de dades>\]|<|<|<| |Informació de bases de dades de contenidors (CDB).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle .<br>**base de dades** - nom de la base de dades a consultar.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.custom.query\[connString,<usuari>,<mot de pas>,<servei>,queryName,<args...>\]|<|<|<| |Resultat d'una consulta personalitzada.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle. <br>**queryName** - nom d'una consulta personalitzada (ha d'ésser igual al nom d'un fitxer sql sense extensió).<br>**args...** - un o diversos arguments separats per comes per passar a una consulta. | El paràmetre **user** permet afegir una de les opcions d'inici de sessió `com sysdba`, `com sysoper`, o `com sysasm` en el format `com sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules). No ha de contindre cap espai al final). | |oracle.datafiles.stats\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Estadístiques dels fitxers de dades.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle.|El paràmetre **user** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper' o `com a sysasm` en el format `user as sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). ). | |oracle.db.discovery\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Llista de bases de dades. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle .<br>**servei** - Nom del servei d'Oracle.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper` o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.fra.stats\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Estadístiques de l'àrea de recuperació ràpida (FRA).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - servei d'Oracle name.|**user** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no contenen un espai al final). | |oracle.instance.info\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Estadístiques de la instància.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle.|El paràmetre **user** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba' (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.pdb.info\[connString,<usuari>,<mot de pas>,<servei>,<base de dades>\]|<|<|<| |Informació de bases de dades connectables (PDB).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle .<br>**base de dades** - nom de la base de dades a consultar.|**El paràmetre usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.pdb.discovery\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Llista de PDB. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle .<br>**servei** - Nom del servei d'Oracle.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com sysdba`, `com sysoper` o `com sysasm` en el format `com sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.pga.stats\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Estadístiques de l'àrea global del programa (PGA).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - servei d'Oracle name.|**usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.ping\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Prova si es pot establir una connexió a Oracle.|0 - la connexió és trencada (si es presenta algun error, inclosos els problemes d'AUTH i de configuració)<br>1 - la connexió és correcta.|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - Credencials d'inici de sessió d'Oracle.<br>**servei** - Nom del servei d'Oracle.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, ` com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.proc.stats\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Estadístiques de procés.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle.|** El paràmetre usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba' (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.redolog.info\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Informació del fitxer de registre del fitxer de control.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - servei d'Oracle name.|**usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no continguin un espai al final). | |oracle.sga.stats\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Estadístiques de l'àrea global del sistema (SGA).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - servei d'Oracle name.|**usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no continguin un espai al final). | |oracle.sessions.stats\[connString,<usuari>,<mot de pas>,<servei>,<lockMaxTime>\]|<|<|<| |Estadístiques de sessions.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle.<br> **lockMaxTime** - la durada màxima del bloqueig de la sessió en segons per comptar la sessió com a bloquejada prolongadament. Per defecte: 600 segons.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com sysdba`, `com sysoper` o `com sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules); no ha de contindre cap espai al final). | |oracle.sys.metrics\[connString,<usuari>,<mot de pas>,<servei>,<durada>\]|<|<|<| |Un conjunt de valors de mètriques del sistema.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle .<br>**durada** - interval de captura (en segons) dels valors de mètriques del sistema. Valors possibles: *60* — llarga durada (per defecte), *15* — curta durada.|**usuari** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.sys.params\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Un conjunt de valors de paràmetres del sistema.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle |El paràmetre **user** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai final). | |oracle.ts.stats\[connString,<usuari>,<mot de pas>,<servei>,<espai de taula>,<tipus>\]|<|<|<| |Estadístiques d'espais de taula.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle.<br>**servei** - nom del servei d'Oracle.<br> **tablespace** - nom de l'espai de la taula a consultar. Per defecte (si es deixa buit i s'estableix `type`):<br>- "TEMP" (si `type` s'estableix en "TEMPORARY");<br>- "USUARI" (si `type` s'estableix en "PERMANENT" ").<br>**tipus** - tipus de l'espai de taula a consultar. Per defecte (si s'estableix `tablespace`): "PERMANENT".| El paràmetre **user** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper`, o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.ts.discovery\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Llista d'espais de taula. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/systemd).|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle .<br>**servei** - Nom del servei d'Oracle.|El paràmetre **usuari** permet afegir una de les opcions d'inici de sessió `com sysdba`, `com sysoper` o `com sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules; no ha de contindre cap espai al final). | |oracle.user.info\[connString,<usuari>,<mot de pas>,<servei>,<nom d'usuari>\]|<|<|<| |Retorna informació de l'usuari d'Oracle.|Objecte JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió d'Oracle .<br>**servei** - nom del servei d'Oracle.<br>**nom d'usuari** - nom d'usuari per al qual es necessita la informació. No s'admeten els noms d'usuari en minúscules. Per defecte: usuari actual.| El paràmetre **user** permet afegir una de les opcions d'inici de sessió `com a sysdba`, `com a sysoper` o `com a sysasm` en el format `com a sysdba` (l'opció d'inici de sessió no distingeix entre majúscules i minúscules); no ha de contindre cap espai al final). | |oracle.version\[connString,<usuari>,<mot de pas>,<servei>\]|<|<|<| |Retorna la versió del servidor de base de dades.|Cadena|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - Credencials d'inici d'Oracle.<br>**servei** - Nom del servei d'Oracle.| | #### Ordering shapes and lines To bring one shape in front of the other (or vice versa) click on the shape with the right mouse button bringing up the map shape menu.  #### Ordenar formes i línies Per posar una forma davant de l'altra (o viceversa), feu clic amb el botó dret a la forma per obrir el menú de forma del mapa.  #### Other agent options It is possible to run multiple instances of the agent on a host. A single instance can use the default configuration file or 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). The following command line parameters can be used with Zabbix agent: |Parameter|Description| |--|--------| |**UNIX and Windows agent**|<| |-c --config <config-file>|Path to the configuration file.<br>You may use this option to specify a configuration file that is not the default one.<br>On UNIX, default is /usr/local/etc/zabbix\_agentd.conf or as set by [compile-time](/manual/installation/install#installing_zabbix_daemons) variables *--sysconfdir* or *--prefix*<br>On Windows, default is c:\\zabbix\_agentd.conf| |-p --print|Print known items and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-t --test <item key>|Test specified item and exit.<br>*Note*: To return [user parameter](/manual/config/items/userparameters) results as well, you must specify the configuration file (if it is not in the default location).| |-h --help|Display help information| |-V --version|Display version number| |**UNIX agent only**|<| |-R --runtime-control <option>|Perform administrative functions. See [runtime control](/manual/concepts/agent#runtime_control).| |**Windows agent only**|<| |-m --multiple-agents|Use multiple agent instances (with -i,-d,-s,-x functions).<br>To distinguish service names of instances, each service name will include the Hostname value from the specified configuration file.| |**Windows agent only (functions)**|<| |-i --install|Install Zabbix Windows agent as service| |-d --uninstall|Uninstall Zabbix Windows agent service| |-s --start|Start Zabbix Windows agent service| |-x --stop|Stop Zabbix Windows agent service| Specific **examples** of using command line parameters: - printing all built-in agent items with values - testing a user parameter with "mysql.ping" key defined in the specified configuration file - installing a "Zabbix Agent" service for Windows using the default path to configuration file c:\\zabbix\_agentd.conf - installing a "Zabbix Agent \[Hostname\]" service for Windows using the configuration file zabbix\_agentd.conf located in the same folder as agent executable and make the service name unique by extending it by Hostname value from the config file ```{=html} <!-- --> ``` zabbix_agentd --print zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf zabbix_agentd.exe -i zabbix_agentd.exe -i -m -c zabbix_agentd.conf #### Altres opcions de l'agent Es poden executar múltiples instàncies de l'agent sota un equip. Una sola instància pot emprar l'arxiu de configuració per defecte especificat a la línia de comandes. En el cas d'instàncies múltiples, cada instància d'agent ha de tindre el seu propi fitxer de configuració (una de les instàncies pot emprar l'arxiu de configuració per defecte). Els paràmetres de línia de comanda següents poden emprar-se amb l'agent Zabbix : |**Paràmetre**|**Descripció**| |--|--------| |**Agent UNIX i Windows**|<| |-c --config <config-file>|Ruta del fitxer de configuració.<br>Haureu d'emprar aquesta opció per especificar l'arxiu de configuració que no sigui el que hi ha per defecte.<br>Sota UNIX, l'arxiu per defecte és /usr/local/etc/zabbix\_agentd.conf o com s'especifiqui a les variables [compile-time](/manual/installation/install#installing_zabbix_daemons) *--sysconfdir* o *--prefix*<br>Sota Windows, l'arxiu per defecte és c:\\zabbix\_agentd.conf| |-p --print|Imprimir els elements coneguts i tancar.<br>*Note*: Per retornar igualment els resultats dels [paràmetres d'usuari](/manual/config/items/userparameters), haureu d'especificar l'arxiu de configuració (si no és a la ruta per defecte).| |-t --test <item key>|Proveu l'element especificat i tanqueu.<br>*Note*: Per retornar igualment els resultats dels [paràmetres d'usuari](/manual/config/items/userparameters), haureu d'especificar l'arxiu de configuració (si no és pas a la ruta per defecte).| |-h --help|Mostra la informació d'ajuda| |-V --version|Mostra el nombre de versió| |**Només agent UNIX**|<| |-R --runtime-control <option>|Gestiona funcions administratives. Veieu [runtime control](/manual/concepts/agent#runtime_control).| |**Només agent Windows**|<| |-m --multiple-agents|Empra diverses instàncies de l'agent (amb les funcions -i,-d,-s,-x).<br>Per distingir els noms dels serveis dels de les instàncies, cada nom de servei inclourà el valor Hostname de l'arxiu de configuració especificat.| |**Només agent Windows (funcions)**|<| |-i --install|Instal·la l'agent Windows Zabbix com a servei| |-d --uninstall|Desinstal·la el servei de l'agent Windows Zabbix| |-s --start|Engega el servei de l'agent Windows Zabbix| |-x --stop|Atura el servei de l'agent Windows Zabbix| **Exemples** específics d'ús dels paràmetres de línia de comandes: - imprimint tots els elements d'agent integrats amb valors - provar un paràmetre d'usuari amb la clau "mysql.ping" definida a l'arxiu de configuració especificat - instal·lació d'un servei "Agent Zabbix" per Windows emprant el camí per defecte de l'arxiu de configuració c:\\zabbix\_agentd.conf - instal·lació d'un servei "Agent Zabbix \[Hostname\]" per Windows emprant l'arxiu de configuració zabbix\_agentd.conf ubicat a la mateixa carpeta que l'executable de l'agent i fer el nom de servei únic estenguent-lo per al valor ‘Hostname’ de l'arxiu config ```{=html} <!-- --> ``` zabbix_agentd --print zabbix_agentd -t "mysql.ping" -c /etc/zabbix/zabbix_agentd.conf zabbix_agentd.exe -i zabbix_agentd.exe -i -m -c zabbix_agentd.conf ### Other changes and bug fixes ### Altres canvis i correccions d'errades #### Other details - An Admin level user with *Read-write* access to a host will not be able to link/unlink templates, if he has no access to the *Templates* group. With *Read* access to *Templates* group he will be able to link/unlink templates to the host, however, will not see any templates in the template list and will not be able to operate with templates in other places. - An Admin level user with *Read* access to a host will not see the host in the configuration section host list; however, the host triggers will be accessible in IT service configuration. - Any non-Super Admin user (including 'guest') can see network maps as long as the map is empty or has only images. When hosts, host groups or triggers are added to the map, permissions are respected. - Zabbix server will not send notifications to users defined as action operation recipients if access to the concerned host is explicitly "denied". #### Altres detalls - Un usuari de nivell administrador amb accés *Lectura-Escriptura* a un equip no podrà enllaçar/desenllaçar models, si no té accés al grup *Models*. Amb l'accés *Llegir* al grup *Models*, podrà enllaçar/desenllaçar models a l'equip, però, no veurà cap model a la llista de models i no podrà operar amb models d'altres llocs. - Un usuari de nivell administrador amb accés *Lectura* a un equip no veurà l'equip a la llista d'equips a la secció de configuració; tanmateix, els triggers de l'equip seran accessibles a la configuració del departament de TI. - Qualsevol usuari que no sigui superadministrador (inclòs el "convidat") pot veure els mapes de la xarxa sempre que el mapa sigui buit o només tingui imatges. Quan s'afegeixen equips, grups d'equips o triggers al mapa, es compleixen els permisos. - El servidor Zabbix no enviarà notificacions als usuaris definits com a destinataris de l'operació d'acció si l'accés a l'equip corresponent és "denegat" explícitament. ##### Other expressions Function parameters may contain other expressions, as in the following syntax: min(min(/host/key,1h),min(/host2/key2,1h)*10) Note that other expressions may not be used, if the function references item history. For example, the following syntax is not allowed: ~~`min(/host/key,#5*10)`~~ ##### altres expressions Els paràmetres de funció poden contindre altres expressions, com a la sintaxi següent: min(min(/host/key,1h),min(/host2/key2,1h)*10) Veieu que altres expressions no es poden pas emprar si la funció fa referència a l'històric de l'element. Per exemple, la sintaxi següent no és pas permesa: ~~`min(/host/key,#5*10)`~~ **Other hardware** A serial communication port and a serial GSM modem are required for using SMS notification support in Zabbix. USB-to-serial converter will also work. **Altre maquinari** Calen un port sèrie i un mòdem GSM per les notificacions per SMS a Zabbix. També funcionarà un convertidor USB a sèrie. ##### Other issues A backslash character in an attribute name should be escaped: jmx[com.example:type=Hello,c:\\documents] For handling any other special characters in JMX item key, please see the item key format [section](/manual/config/items/item/key#parameter---quoted-string). This is actually all there is to it. Happy JMX monitoring! ##### Altres problemes S'ha d'escapar una barra invertida en un nom d'atribut: jmx[com.example:type=Hello,c:\\documents] Per gestionar altres caràcters especials a la clau d'element JMX, consulteu la secció [format de clau d'element](/manual/config/items/item/key##parameter---quoted-string). En realitat, això és tot el que hi ha. Bon monitoratge de JMX! #### Other locations In addition to the locations listed here, user macros can be used in the following fields: |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Global scripts (script, SSH, Telnet, IPMI), including confirmation text|<|yes| |Webhooks|<|<| | |JavaScript script|no| |^|JavaScript script parameter name|no| |^|JavaScript script parameter value|yes| |*Monitoring → Dashboards*|<|<| | |Column of data type *Text* in *Top hosts* dashboard widget|yes| |^|*Description* parameter in *Item value* dashboard widget|yes| |^|*URL*^[3](supported_by_location_user#footnotes)^ parameter in *URL* dashboard widget|yes| |*Administration → Users → Media*|<|<| | |When active|no| |*Administration → General → GUI*|<|<| | |Working time|no| |*Administration → Media types → Message templates*|<|<| | |Subject|yes| |^|Message|yes| |*Administration → Media types → Media type*|<|<| | |*Username* and *Password* fields for the *Email* media type (when *Authentication* is set to "Username and password"; [secret macros](/manual/config/macros/user_macros#configuration) recommended)|yes| For a complete list of all macros supported in Zabbix, see [supported macros](/manual/appendix/macros/supported_by_location). #### Altres ubicacions A banda de les llistades aquí, les macros d'usuari es poden emprar als camps següents: |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Scripts globals (script, SSH, Telnet, IPMI), incloent el text de confirmació|<|sí| |Webhooks|<|<| | |Script JavaScript|no| |^|Nom del paràmetre d'script JavaScript|no| |^|Valor del paràmetre d'script JavaScript|sí| |*Monitoratge→ Tauler principal*|<|<| | |Columna de tipus de dades *Text* al giny de tauler *Equips principals*|sí| |^|*Paràmetre *descripció* al giny de tauler *Valor de l'element*|sí| |^|Paràmetre *URL*^[3](supported_by_location_user#footnotes)^ al giny del tauler *URL*|sí| |*Administració → Usuaris → Suports*|<|<| | |Si actiu|no| |*Administració → General → IHM*|<|<| | |Temps de treball|no| |*Administració → Tipus de suport → Models de missatges*|<|<| | |Assumpte|sí| |^|Missatge|sí| | |Els camps *Usuari* i *Mot de pas* per el tipus de suport *Correu-e* (quan s'estableix l'*Authenticacío* a "Usuari i mot de pas"; [macros secretes](/manual/config/macros/user_macros#configuration) recommended)|sí| Per un llistat sencer de les macros admeses a Zabbix, veieu les [macros admeses](/manual/appendix/macros/supported_by_location). #### Other parameters This section allows configuring miscellaneous other frontend parameters.  |Parameter|Description| |--|--------| |*Frontend URL*|URL to Zabbix web interface. This parameter is used by Zabbix web service for communication with frontend and should be specified to enable scheduled reports.| |*Group for discovered hosts*|Hosts discovered by [network discovery](/manual/discovery/network_discovery) and [agent autoregistration](/manual/discovery/auto_registration) will be automatically placed in the host group, selected here.| |*Default host inventory mode*|Default [mode](/manual/config/hosts/inventory) for host inventory. It will be followed whenever a new host or host prototype is created by server or frontend unless overridden during host discovery/autoregistration by the *Set host inventory mode* operation.| |*User group for database down message*|User group for sending alarm message or 'None'.<br>Zabbix server depends on the availability of the backend database. It cannot work without a database. If the database is down, selected users can be notified by Zabbix. Notifications will be sent to the user group set here using all configured user media entries. Zabbix server will not stop; it will wait until the database is back again to continue processing.<br>Notification consists of the following content:<br>``[MySQL|PostgreSQL|Oracle] database <DB Name> [on <DB Host>:<DB Port>] is not available: <error message depending on the type of DBMS (database)>``<br><DB Host> is not added to the message if it is defined as an empty value and <DB Port> is not added if it is the default value ("0"). The alert manager (a special Zabbix server process) tries to establish a new connection to the database every 10 seconds. If the database is still down the alert manager repeats sending alerts, but not more often than every 15 minutes.| |*Log unmatched SNMP traps*|Log [SNMP trap](/manual/config/items/itemtypes/snmptrap) if no corresponding SNMP interfaces have been found.| #### Altres paràmetres Aquesta secció us permet configurar altres paràmetres de la interfície.  |Paràmetre|Descripció| |--|---------| |*URL del servidor*|URL de la interfície web de Zabbix. Aquest paràmetre l'empra el servei web de Zabbix per a la comunicació amb la interfície i s'ha d'especificar per habilitar els informes programats.| |*Grup d'equips descoberts*|Els equips descoberts per [descoberta de xarxa](/manual/discovery/network_discovery) i [registre automàtic de l'agent](/manual/discovery/auto_registration) es posaran automàticament als equips triats aquí.| |*Mode d'inventari d'equips predeterminat*|[Mode](/manual/config/hosts/inventory) per defecte per a l'inventari de l'equip. Se'n farà un seguiment cada vegada que el servidor o la interfície creï un nou equip o un prototip d'equip, tret que es substitueixi durant la descoberta/registre automàtic de l'equip per part de l'inventari d'operacions en mode de configuració de l'equip*.| |*Grup d'usuaris per rebre el missatge de tancament de la base de dades*|Grup d'usuaris per enviar missatges d'alarma o 'Cap'.<br>El servidor Zabbix depèn de la disponibilitat de la base de dades principal. No pot funcionar sense base de dades. Si la base de dades és caiguda, Zabbix pot notificar als usuaris triats. Les notificacions s'enviaran al grup d'usuaris definit aquí mitjançant totes les entrades multimèdia d'usuari configurades. El servidor Zabbix no s'aturarà; esperarà fins que la base de dades torni a ser disponible per continuar el processament.<br>La notificació consta del contingut següent:<br>`[MySQL\|PostgreSQL\|Oracle] base de dades <Nom de la base de dades> [a l'<equip de la base de dades>:<Port DB>] no és disponible: <missatge d'error segons el tipus de DBMS (base de dades)>`<br><Equip DB> no s'afegeix al missatge si es defineix com un valor buit i no s'afegeix <Port DB> si és el valor per defecte ("0"). El gestor d'alerta (un procés especial del servidor Zabbix) intenta establir una nova connexió de base de dades cada 10 segons. Si la base de dades encara no és disponible, Alert Manager repeteix l'enviament d'alertes, però no més sovint que cada 15 minuts.| |*Registreu trampes SNMP no coincidents*|Registreu [trampa SNMP](/manual/config/items/itemtypes/snmptrap) si no es troba cap interfície SNMP coincident.| ### Other types of discovery More detail and how-tos on other types of out-of-the-box discovery is available in the following sections: - discovery of [network interfaces](/manual/discovery/low_level_discovery/examples/network_interfaces); - discovery of [CPUs and CPU cores](/manual/discovery/low_level_discovery/examples/cpu); - discovery of [SNMP OIDs](/manual/discovery/low_level_discovery/examples/snmp_oids); - discovery of [JMX objects](/manual/discovery/low_level_discovery/examples/jmx); - discovery using [ODBC SQL queries](/manual/discovery/low_level_discovery/examples/sql_queries); - discovery of [Windows services](/manual/discovery/low_level_discovery/examples/windows_services); - discovery of [host interfaces](/manual/discovery/low_level_discovery/examples/host_interfaces) in Zabbix. For more detail on the JSON format for discovery items and an example of how to implement your own file system discoverer as a Perl script, see [creating custom LLD rules](/manual/discovery/low_level_discovery/custom_rules). ### Altres tipus de descoberta A les seccions següents trobareu més detalls i explicacions sobre altres tipus de descoberta predefinits: - descoberta d'[interfícies de xarxa](/manual/discovery/low_level_discovery/examples/network_interfaces); - descoberta de [CPU i nuclis de CPU](/manual/discovery/low_level_discovery/examples/cpu); - descoberta d'[SNMP OIDs](/manual/discovery/low_level_discovery/examples/snmp_oids); - descoberta d'[objectes JMX](/manual/discovery/low_level_discovery/examples/jmx); - descoberta mitjançant [consultes ODBC SQL](/manual/discovery/low_level_discovery/examples/sql_queries); - descoberta de [serveis de Windows](/manual/discovery/low_level_discovery/examples/windows_services); - descoberta d'[interfícies d'equip](/manual/discovery/low_level_discovery/examples/host_interfaces) a Zabbix. Per obtindre més detalls sobre el format JSON dels elements de descoberta i un exemple d'implementació de la vostra pròpia eina de descoberta del sistema de fitxers amb un script Perl, veieu [creació de regles LLD personalitzades](/manual/low_level_discovery/custom_rules). ##### Outgoing connections The simplest case is outgoing connections: - For outgoing connections with certificate - use TLSCipherCert13 or TLSCipherCert - For outgoing connections with PSK - use TLSCipherPSK13 or TLSCipherPSK - In case of zabbix\_get and zabbix\_sender utilities the command-line parameters `--tls-cipher13` or `--tls-cipher` can be used (encryption is unambiguously specified with a `--tls-connect` parameter) ##### Connexions sortints El cas més senzill és per a les connexions sortints: - Per a connexions sortints amb certificat: empreu TLSCipherCert13 o TLSCipherCert - Per a connexions de sortida amb PSK: empreu TLSCipherPSK13 o TLSCipherPSK - En el cas de les utilitats zabbix\_get i zabbix\_sender, es poden emprar els paràmetres de línia d'ordres `--tls-cipher13` i `--tls-cipher` (el xifrat s'especifica sense ambigüitats amb un `--tls-connect`) #### Output value JSONPaths can be divided in definite and indefinite paths. A definite path can return only null or a single match. An indefinite path can return multiple matches, basically JSONPaths with detached, multiple name/index list, array slice or expression segments. However, when a function is used the JSONPath becomes definite, as functions always output single value. A definite path returns the object/array/value it's referencing, while indefinite path returns an array of the matched objects/arrays/values. ::: noteimportant The property order in JSONPath query results may not align with the original JSON property order due to internal optimization methods. For example, the JSONPath `$.books[1]["author", "title"]` may return `["title", "author"]`. If preserving the original property order is essential, alternative post-query processing methods should be considered. ::: #### Valor de retorn Els camins JSON es poden dividir en camins definits i no definits. Un camí definit només pot retornar una coincidència nul·la o única. Un camí no definit pot retornar diverses coincidències, bàsicament JSONPaths amb diversos noms/llistes d'índex, fragments de matriu o segments d'expressió separats. Tanmateix, quan s'empra una funció, el JSONPath s'estableix, ja que les funcions sempre generen un valor únic. Un camí definit retorna l'objecte/matriu/valor al qual fa referència, mentre que el camí no definit retorna una matriu dels objectes/matrius/valors corresponents. ::: noteimportant És possible que l'ordre de la propietat dels resultats de la consulta JSONPath no s'alinei amb l'ordre de la propietat JSON original a causa dels mètodes d'optimització interns. Per exemple, el JSONPath `$.books[1]["author", "title"]` pot retornar `["title", "author"]`. Si conservar l'ordre de propietat original és essencial, s'han de considerar mètodes alternatius de processament posterior a la consulta. ::: #### Overrides The following parameters are supported for configuring *Overrides*. ::: noteclassic The first number in the property name (e.g. or.hosts.0.0, or.items.0.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| |-----|-|-----|-------------------| |***Host pattern***<br>(required)|1|or.hosts.0.0|[Host](/manual/api/reference/host/get) name or pattern (e.g. `Zabbix*`).| |***Item pattern***<br>(required)|1|or.items.0.0|[Item](/manual/api/reference/item/get) name or pattern (e.g. `*: Number of processed *values per second`).| |*Base color*|1|or.color.0|Hexadecimal color code (e.g. `FF0000`).| |*Width*|0|or.width.0|Valid values range from 1-10.| |*Draw*|0|or.type.0|0 - Line;<br>1 - Points;<br>2 - Staircase;<br>3 - Bar.| |*Transparency*|0|or.transparency.0|Valid values range from 1-10.| |*Fill*|0|or.fill.0|Valid values range from 1-10.| |*Point size*|0|or.pointsize.0|Valid values range from 1-10.| |*Missing data*|0|or.missingdatafunc.0|0 - None;<br>1 - Connected;<br>2 - Treat as 0.| |*Y-axis*|0|or.axisy.0|0 - Left;<br>1 - Right.| |*Time shift*|1|or.timeshift.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| #### Anul·lació Els paràmetres següents s'admeten per configurar *Anul·lacions*. ::: noteclassic El primer nombre del nom de la propietat (p. ex. or.hosts.0.0 o.items.0.0) representa el conjunt de dades concret, mentre que el segon nombre, si és present, representa l'equip o l'element configurat. ::: |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |***Patró d'equip***<br>(obligatori)|1|or.hosts.0.0|[Host](/manual/api/reference/host/get) nom o patró (p. ex., `Zabbix*`). | |***Patró d'element***<br>(obligatori)|1|or.items.0.0|[Item](/manual/api/reference/item/get) nom o patró (p. ex. `*: Nombre de processats *valors per segon`).| |*Color base*|1|o.color.0|Codi de color hexadecimal (per exemple, `FF0000`).| |*Amplada*|0|o.amplada.0|Els valors vàlids oscil·len entre 1 i 10.| |*Dibuix*|0|o.tipus.0|0 - Línia;<br>1 - Punts;<br>2 - Escala;<br>3 - Bar.| |*Transparència*|0|o.transparència.0|Els valors vàlids van d'1 a 10.| |*Emplenament*|0|or.fill.0|Els valors vàlids oscil·len entre 1 i 10.| |*Mida del punt*|0|o.mida del punt.0|Els valors vàlids oscil·len entre 1 i 10.| |*Falten dades*|0|o.missingdatafunc.0|0 - Cap;<br>1 - Connectat;<br>2 - Tractar com a 0.| |*Eix Y*|0|o.eix.0|0 - Esquerra;<br>1 - Dreta.| |*Desplaçament de temps*|1|o.timeshift.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes#time -sufixos). Es permeten valors negatius.| #### Override The **Overrides** tab allows setting rules to modify the list of item, trigger, graph, and host prototypes or their attributes for discovered objects that meet given criteria.  Overrides (if any) are displayed in a reorderable drag-and-drop list and executed in the order in which they are defined.  To configure details of a new override, click on  in the *Overrides* block. To edit an existing override, click on the override name. A popup window will open allowing to edit the override rule details.  All mandatory parameters are marked with red asterisks. |Parameter|Description| |--|--------| |*Name*|A unique (per LLD rule) override name.| |*If filter matches*|Defines whether next overrides should be processed when filter conditions are met:<br>**Continue overrides** - subsequent overrides will be processed.<br>**Stop processing** - operations from preceding (if any) and this override will be executed, subsequent overrides will be ignored for matched LLD rows.| |*Filters*|Determines to which discovered entities the override should be applied. Override filters are processed after discovery rule [filters](low_level_discovery#filter) and have the same functionality.| |*Operations*|Override operations are displayed with these details:<br>**Condition** - an object type and a condition to be met for the object name; for example: Trigger prototype does not equal *Disk space is low (used > 50%)*.<br>**Action** - links for editing and removing an operation are displayed.| **Configuring an operation** 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 popup window where you can edit the operation details will open.  |Parameter|<|<|Description| |-|-|----------|----------------------------------------| |*Object*|<|<|Four types of objects are available:<br>Item prototype<br>Trigger prototype<br>Graph prototype<br>Host prototype| |*Condition*|<|<|Allows filtering entities to which the operation should be applied.| | |Operator|<|Supported operators:<br>**equals** - apply to this prototype<br>**does not equal** - apply to all prototypes, except this<br>**contains** - apply, if prototype name contains this string<br>**does not contain** - apply, if prototype name does not contain this string<br>**matches** - apply, if prototype name matches regular expression<br>**does not match** - apply, if prototype name does not match regular expression<br>| |^|Pattern|<|A [regular expression](/manual/regular_expressions) or a string to search for.| |^|Object: *Item prototype*|<|<| |^| |*Create enabled*|When the checkbox is marked, the buttons will appear, allowing to override original item prototype settings:<br>*Yes* - the item will be added in an enabled state.<br>*No* - the item will be added to a discovered entity but in a disabled state.| |^|^|*Discover*|When the checkbox is marked, the buttons will appear, allowing to override original item prototype settings:<br>*Yes* - the item will be added.<br>*No* - the item will not be added.| |^|^|*Update interval*|When the checkbox is marked, two options will appear, allowing to set different interval for the item:<br>*Delay* - Item update interval. [User macros](/manual/config/macros/user_macros), [LLD macros](/manual/config/macros/lld_macros), and [time suffixes](/manual/appendix/suffixes) (e.g. 30s, 1m, 2h, 1d) are supported. Should be set to 0 if *Custom interval* is used.<br>*Custom interval* - click  to specify flexible/scheduling intervals. For detailed information see [Custom intervals](/manual/config/items/item/custom_intervals).| |^|^|*History storage period*|When the checkbox is marked, the buttons will appear, allowing to set different history storage period for the item:<br>*Do not keep history* - if selected, the history will not be stored.<br>*Storage period* - if selected, an input field for specifying storage period will appear to the right. [User macros](/manual/config/macros/user_macros) and [LLD macros](/manual/config/macros/lld_macros) are supported.| |^|^|*Trend storage period*|When the checkbox is marked, the buttons will appear, allowing to set different trend storage period for the item:<br>*Do not keep trends* - if selected, the trends will not be stored.<br>*Storage period* - if selected, an input field for specifying storage period will appear to the right. [User macros](/manual/config/macros/user_macros) and [LLD macros](/manual/config/macros/lld_macros) are supported.| |^|^|*Tags*|When the checkbox is marked, a new block will appear, allowing to specify tag-value pairs. [User macros](/manual/config/macros/user_macros) and [LLD macros](/manual/config/macros/lld_macros) are supported.<br>These tags will be appended to the tags specified in the item prototype, even if the tag names match.| |^|Object: *Trigger prototype*|<|<| |^| |*Create enabled*|When the checkbox is marked, the buttons will appear, allowing to override original trigger prototype settings:<br>*Yes* - the trigger will be added in an enabled state.<br>*No* - the trigger will be added to a discovered entity, but in a disabled state.| |^|^|*Discover*|When the checkbox is marked, the buttons will appear, allowing to override original trigger prototype settings:<br>*Yes* - the trigger will be added.<br>*No* - the trigger will not be added.| |^|^|*Severity*|When the checkbox is marked, trigger severity buttons will appear, allowing to modify trigger severity.| |^|^|*Tags*|When the checkbox is marked, a new block will appear, allowing to specify tag-value pairs. [User macros](/manual/config/macros/user_macros) and [LLD macros](/manual/config/macros/lld_macros) are supported.<br>These tags will be appended to the tags specified in the trigger prototype, even if the tag names match.| |^|Object: *Graph prototype*|<|<| |^| |*Discover*|When the checkbox is marked, the buttons will appear, allowing to override original graph prototype settings:<br>*Yes* - the graph will be added.<br>*No* - the graph will not be added.| |^|Object: *Host prototype*|<|<| |^| |*Create enabled*|When the checkbox is marked, the buttons will appear, allowing to override original host prototype settings:<br>*Yes* - the host will be created in an enabled state.<br>*No* - the host will be created in a disabled state.| |^|^|*Discover*|When the checkbox is marked, the buttons will appear, allowing to override original host prototype settings:<br>*Yes* - the host will be discovered.<br>*No* - the host will not be discovered.| |^|^|*Link templates*|When the checkbox is marked, an input field for specifying templates will appear. Start typing the template name or click on *Select* next to the field and select templates from the list in a popup window.<br>Templates from this override are added to all templates already linked to the host prototype.| |^|^|*Tags*|When the checkbox is marked, a new block will appear, allowing to specify tag-value pairs. [User macros](/manual/config/macros/user_macros) and [LLD macros](/manual/config/macros/lld_macros) are supported.<br>These tags will be appended to the tags specified in the host prototype, even if the tag names match.| |^|^|*Host inventory*|When the checkbox is marked, the buttons will appear, allowing to select different inventory [mode](/manual/config/hosts/inventory) for the host prototype:<br>*Disabled* - do not populate host inventory<br>*Manual* - provide details manually<br>*Automated* - auto-fill host inventory data based on collected metrics.| #### Anul·lar La pestanya **Sobrecàrrega** permet definir regles per modificar la llista d'elements prototip, triggers, gràfics i equips o els seus atributs per als objectes descoberts que compleixen uns criteris determinats.  Les sobrecàrregues (si n'hi ha) es mostren en una llista reordenable arrossegant i deixant anar i s'executen en l'ordre en què es defineixen. Per configurar els detalls d'una nova sobrecàrrega, feu clic a  al bloc *Sobrecàrregues*. Per modificar una sobrecàrrega existent, feu clic al nom de la sobrecàrrega. S'obrirà una finestra emergent que us permetrà editar els detalls de la regla de sobrecàrrega.  Tots els paràmetres necessaris són marcats amb asteriscs vermells. |Paràmetre|Descripció| |--|---------| |*Nom*|Un nom de sobrecàrrega únic (segons la regla LLD).| |*Si el filtre coincideix*|Defineix si s'han de processar les sobrecàrregues següents quan es compleixin les condicions del filtre:<br>**Continuar les sobrecàrregues** - es processaran les sobrecàrregues posteriors.<br>**Aturar el processament** - atura operacions anteriors (si n'hi ha) i s'executarà aquesta sobrecàrrega, s'ignoraran les sobrecàrregues posteriors per a les línies LLD corresponents.| |*Filtres*|Determina a quines entitats descobertes s'ha d'aplicar la substitució. Els filtres de sobrecàrrega es processen després dels [filtres](low_level_discovery#filter) de la regla de descoberta i tenen la mateixa funcionalitat.| |*Operacions*|Les operacions de sobrecàrrega es mostren amb aquests detalls:<br>**Condició** - un tipus d'objecte i una condició a complir per el nom d'objecte; per exemple: el prototip de Trigger no és igual a *Poc espai al disc (usat > 50%)*.<br>**Acció** - es mostren enllaços per modificar i esborrar una operació.| **Configura una operació** Per configurar els detalls d'una nova operació, feu clic a  al bloc *Operacions*. Per editar una operació existent, feu clic a  al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls de l'operació.  |Paràmetre|<|<|Descripció| |-|-|-----------|------------------------------------ ------| |*Objecte*|<|<|Hi ha quatre tipus d'objectes disponibles:<br>Prototip d'element<br>Prototip de trigger<br>Prototip de gràfic<br>Prototip d'equip| |*Condició*|<|<|Permet filtrar les entitats a les quals s'ha d'aplicar l'operació.| | |Operador|<|Operadors admesos:<br>**igual** - s'aplica a aquest prototip<br>**no és igual** - s'aplica a tots els prototips excepte aquest <br>**conté** - s'aplica, si el nom del prototip conté una cadena<br>**no conté** - s'aplica, si el nom del prototip no conté una cadena<br>* *coincideix** - s'aplica, si el nom del prototip coincideix amb l'expressió regular<br>**no coincideix** - s'aplica, si el nom del prototip no coincideix amb l'expressió regular<br >| |^|Patró|<|[Expressió regular](/manual/expressions_regulars) o cadena a cercar.| |^|Objecte: *Prototip d'element*|<|<| |^| |*Crear activat*|Quan és marcat, apareixeran botons que permetran anul·lar la configuració original del prototip d'element:<br>*Sí* - l'element s'afegirà en un estat activat.<br> *No* - l'element s'afegirà a una entitat descoberta però en estat discapacitat.| |^|^|*Descobrir*|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració del prototip d'element original:<br>*Sí* - l'element s'afegirà.<br>* No* - l'element no s'afegirà.| |^|^|*Interval d'actualització*|Quan és marcat, apareixeran dues opcions, que us permetran establir un interval diferent per a l'element:<br>*Endarreriment* - Interval d'actualització de l'element. S'admeten tant [macros d'usuari](/manual/config/macros/user_macros), [macros d'LLD](/manual/config/macros/lld_macros) i [sufixos de temps](/manual/appendix/sufixos) (p. ex., 30 s, 1 m, 2 h, 1 d). S'ha d'establir a 0 si s'empra un *Interval personalitzat*.<br>*Interval personalitzat* - feu clic a  per especificar un interval flexible/planificat. Per obtindre informació detallada, veieu els [intervals personalitzats](/manual/config/items/item/custom_intervals).| |^|^|*Període d'emmagatzematge de l'historial*|Quan és marcat, apareixen botons que us permeten establir un període d'emmagatzematge de l'historial diferent per a l'element:<br>*No conservar l'historial 'historial* - si s'escull, l'historial no s'emmagatzemarà.<br>*Període d'emmagatzematge* - si es tria, a la dreta apareixerà un camp d'entrada per especificar el període d'emmagatzematge. S'admeten tant [macros d'usuari](/manual/config/macros/user_macros) com [macros LLD](/manual/config/macros/lld_macros).| |^|^|*Període d'emmagatzematge de tendències*|Quan és marcat, apareixen botons que permeten establir un període d'emmagatzematge de tendències diferent per a l'element:<br>*No conservar les tendències* - si es tria, les tendències no s'emmagatzemaran.<br >*Període d'emmagatzematge* - si es tria, apareixerà un camp d'entrada per especificar el període d'emmagatzematge a la dreta. S'admeten tant [macros d'usuari](/manual/config/macros/user_macros) com [macros LLD](/manual/config/macros/lld_macros).| |^|^|*Etiquetes*|Quan la casella és marcada, apareixerà un bloc nou que permetrà especificar parelles d'etiqueta-valor. Admet [macros d'usuari](/manual/config/macros/user_macros) i [macros d'LLD](/manual/config/macros/lld_macros).<br>Aquestes etiquetes s'afegiran a les etiquetes especificades al prototip de l'element, encara que a l'etiqueta els noms coincideixen.| |^|Assumpte: *Prototip de trigger*|<|<| |^| |*Crear activat*|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració original del prototip de trigger:<br>*Sí* - el trigger s'afegirà en estat activat.<br>*No* - el trigger s'afegirà a una entitat descoberta, però en estat desactivat.| |^|^|*Descobrir*|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració original del prototip del trigger:<br>*Sí* - s'afegirà el trigger.<br>*No* - el trigger no s'afegirà pas.| |^|^|*Gravetat*|Quan és marcat, apareixeran botons de gravetat del trigger, que permetran canviar la gravetat del trigger.| |^|^|*Etiquetes*|Quan la casella és marcada, apareixerà un bloc nou, que permetrà especificar parelles d'etiqueta-valor. Admet [macros d'usuari](/manual/config/macros/user_macros) i [macros d'LLD](/manual/config/macros/lld_macros).<br>Aquestes etiquetes s'afegiran a les etiquetes especificades al prototip de trigger, encara que els noms d'etiquetes coincideixin.| |^|Assumpte: *Prototip de gràfic*|<|<| |^| |*Descobrir*|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració original del gràfic prototip:<br>*Sí* - el gràfic s'afegirà.<br>*No* - el gràfic no s'afegirà. | |^|Assumpte: *Prototip d'equip*|<|<| |^| |*Crear activat*|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració del prototip d'equip original:<br>*Sí* - l'equip es crearà en estat habilitat.<br> *No* - l'equip es crearà en estat desactivat.| |^|^|*Descoberta*|Quan és marcat, apareixeran botons que us permetran anul·lar la configuració del prototip d'equip original:<br>*Sí* - l'equip es descobrirà.<br>* No* - l'equip no serà descobert.| |^|^|*Enllaçar plantilles*|Quan és marcat, apareixerà un camp d'entrada per especificar models. Comenceu a escriure el nom del model o feu clic a *Triar* al costat del camp i trieu models de la llista en una finestra emergent.<br>Les plantilles d'aquesta sobrecàrrega s'afegeixen a totes les plantilles que ja siguin enllaçades al prototip d'equip.| |^|^|*Etiquetes*|Quan és marcat, apareixerà un bloc nou que permetrà especificar parelles d'etiquetes-valors. Admet [macros d'usuari](/manual/config/macros/user_macros) i [macros d'LLD](/manual/config/macros/lld_macros).<br>Aquestes etiquetes s'afegiran a les etiquetes especificades al prototip de l'equip, fins i tot si els noms d'etiquetes coincideixen.| |^|^|*Inventari de l'equip*|Quan és marcat, apareixeran botons que us permetran triar un [mode](/manual/config/hosts/inventory) diferent d'inventari per a l'equip prototip:<br>*Desactivat* - no emplena l'inventari de l'equip<br>*Manual* - proporcionar detalls manualment<br>*Automàtic* - emplena automàticament les dades de l'inventari de l'equip en funció de les mètriques recollides.| #### Overview Additional files or directories can be included into server/proxy/agent configuration using the `Include` parameter. #### Vista general Els arxius o directoris addicionals poden incloure's dins la configuració del servidor/proxy/agent emprant el paràmetre `Include`. #### Overview Aggregate calculations are a [calculated item](/manual/config/items/itemtypes/calculated) type allowing to collect information from several items by Zabbix server and then calculate an aggregate, depending on the aggregate function used. Only unsigned integer and float values (type of information) are supported for aggregate calculation items. Aggregate calculations do not require any agent running on the host being monitored. #### Vista general Els càlculs agregats són de tipus [element calculat](/manual/config/items/itemtypes/calculated) i permeten la recollida informació de diversos elements per el servidor Zabbix i calcular un agregat, segons la funció d'agregat emprada. Com a element de càlcul agregats, només s'admeten valors enters (sense signe) i flotants (tipus d'informació). Els càlculs agregats no necessiten cap agent executant-se a l'equip monitorat. #### Overview All users in Zabbix access the Zabbix application through the web-based frontend. Each user is assigned a unique login name and a password. All user passwords are encrypted and stored in the Zabbix database. Users cannot use their user id and password to log directly into the UNIX server unless they have also been set up accordingly to UNIX. Communication between the web server and the user browser can be protected using SSL. With a flexible [user permission schema](/manual/config/users_and_usergroups/permissions) you can restrict and differentiate rights to: - access administrative Zabbix frontend functions - perform certain actions in the frontend - access monitored hosts in hostgroups - use specific API methods #### Vista general Tots els usuaris de Zabbix accedeixen a l'aplicació Zabbix a través de la interfície web. A cada usuari se li assigna un nom d'inici de sessió i un mot de pas únics. Tots els mots de pas d'usuari són xifrats i emmagatzemats a la base de dades Zabbix. Els usuaris no poden emprar el seu ID d'usuari i mot de pas per connectar-se directament al servidor UNIX tret que també s'hagin configurat segons UNIX. La comunicació entre el servidor web i el navegador de l'usuari es pot protegir mitjançant SSL. Amb un [esquema de permisos d'usuari](/manual/config/users_and_usergroups/permissions) flexible, podeu restringir i diferenciar els drets per a: - accedir a les funcions d'administració de la interfície Zabbix - realitzar algunes accions a la interfície web - accedir als equips monitorats en grups d'equips - Emprar mètodes API específics #### Overview An external check is a check executed by Zabbix server by [running a shell script](/manual/appendix/command_execution) or a binary. However, when hosts are monitored by a Zabbix proxy, the external checks are executed by the proxy. External checks do not require any agent running on a host being monitored. The syntax of the item key is: script[<parameter1>,<parameter2>,...] Where: |ARGUMENT|DEFINITION| |--------|----------| |**script**|Name of a shell script or a binary.| |**parameter(s)**|Optional command line parameters.| If you don't want to pass any parameters to the script you may use: script[] or script Zabbix server or proxy will search the directory specified for external scripts and execute the command (see `ExternalScripts` parameter in Zabbix [server](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) configuration file). The command will be executed under the same user as Zabbix server/proxy, so any access permissions or environment variables should be handled in a wrapper script, if necessary. Permissions on the command should also allow that user to execute it. Only commands in the specified directory are available for execution. ::: notewarning Do not overuse external checks, as each script requires starting a fork process by Zabbix server/proxy, and running many scripts can significantly decrease Zabbix performance. ::: #### Vista general Una verificació externa és una verificació que executa el servidor Zabbix fent anar un [script shell](/manual/appendix/command_execution) o un binari. Tanmateix, quan els equips són monitorats pel proxy Zabbix, les verificacions externes s'executen per el proxy. Els controls externs no necessiten cap agent executant-se a l'equip monitorat. La sintaxi de la clau d'element és: script[<parameter1>,<parameter2>,...] On: |ARGUMENT|DEFINICIÓ| |--------|----------| |**script**|Nom d'un script shell o d'un binari.| |**paràmetre(s)**|Paràmetres opcionals de línia de comandes.| Si no voleu pas passar paràmetres a l'script, podeu emprar: script[] o script El servidor o el proxy Zabbix cercaran scripts externs al directori especificat i executaran l'ordre (veieu el paràmetre `ExternalScripts` al fitxer de configuració del [servidor](/manual/appendix/config/zabbix_server)/[proxy](/manual/appendix/config/zabbix_proxy) Zabbix). L'ordre s'executarà amb el mateix usuari que el servidor/proxy Zabbix, de manera que qualsevol permís d'accés o variable d'entorn s'hauria de gestionar en un script d'embolcall, si cal. Els permisos de l'ordre també haurien de permetre a l'usuari executar-lo. Només les comandes del directori especificat són disponibles per a l'execució. ::: notewarning No feu un ús excessiu de les comprovacions externes, ja que cada script requereix iniciar un procés de bifurcació per part del servidor/proxy Zabbix, i executar molts scripts pot minvar significativament el rendiment de Zabbix. ::: #### Overview An item is an individual metric. Items are used for collecting data. Once you have configured a host, you must add items to get actual data. One way of quickly adding many items is to attach one of the predefined templates to a host. However, for optimized system performance, you may need to fine-tune the templates to have as many items and as frequent monitoring as necessary. To specify what sort of data to collect from a host, use the [item key](/manual/config/items/item/key). For example, an item with the key name **system.cpu.load** will collect processor load data, while an item with the key name **net.if.in** will collect incoming traffic information. Additional parameters can be specified in square brackets after the key name. For example, system.cpu.load**\[avg5\]** will return the processor load average for the last 5 minutes, while net.if.in**\[eth0\]** will show incoming traffic in the interface "eth0". ::: noteclassic See individual sections of [item types](/manual/config/items/itemtypes) for all supported item types and item keys. ::: Proceed to [creating and configuring an item](/manual/config/items/item). #### Vista general Un element és una mètrica individual. Els elements són aquells que recullen dades d'un equip. Un cop hàgiu configurat un equip, heu d'afegir elements de monitoratge per començar a obtindre dades reals. Una manera d'afegir ràpidament molts elements és adjuntar una de les plantilles predefinides a un equip. Tanmateix, per optimitzar el rendiment del sistema, és possible que hàgiu d'ajustar les plantilles de manera que només tingueu els elements necessaris i una freqüència de monitoratge que s'adapti al vostre entorn. En un element individual, especifiqueu quin tipus de dades es recolliran de l'equip. Per fer-ho, empreu [clau d'element](/manual/config/items/item/key). Així, un element amb la clau **system.cpu.load** recopilarà dades de càrrega de la CPU, mentre que un element amb la clau **net.if.in** recopilarà informació de trànsit entrant. Per especificar altres paràmetres amb una clau, caldrà incloure'ls entre claudàtors després del nom de la clau. Per tant, system.cpu.load**\[avg5\]** retornarà la mitjana de càrrega de la CPU dels darrers 5 minuts, mentre que net.if.in**\[eth0\]** mostrarà el trànsit entrant a la interfície "eth0". :::noteclassic Per a tots els tipus d'elements admesos i claus d'elements, consulteu les seccions individuals [tipus d'elements](/manual/config/items/itemtypes). ::: Passeu a [creació i configuració d'un element](/ca/manual/config/items/item). #### Overview An optional context can be used in [user macros](/manual/config/macros/user_macros), allowing to override the default value with a context-specific one. The context is appended to the macro name; the syntax depends on whether the context is a static text value: {$MACRO:"static text"} or a regular expression: {$MACRO:regex:"regular expression"} Note that a macro with regular expression context can only be defined in user macro configuration. If the `regex:` prefix is used elsewhere as user macro context, like in a trigger expression, it will be treated as static context. Context quoting is optional (see also [important notes](#important_notes)). Macro context examples: |Example|Description| |-------|-----------| |`{$LOW_SPACE_LIMIT}`|User macro without context.| |`{$LOW_SPACE_LIMIT:/tmp}`|User macro with context (static string).| |`{$LOW_SPACE_LIMIT:regex:"^/tmp$"}`|User macro with context (regular expression). Same as `{$LOW_SPACE_LIMIT:/tmp}`.| |`{$LOW_SPACE_LIMIT:regex:"^/var/log/.*$"}`|User macro with context (regular expression). Matches all strings prefixed with /var/log/.| #### Vista general Es pot emprar un context opcional a [macros d'usuari](/manual/config/macros/user_macros), permetent que el valor predeterminat es substitueixi per un valor específic del context. El context s'afegeix al nom de la macro; la sintaxi varia en funció de si el context és un valor de text estàtic: {$MACRO:"text estàtic"} o una expressió regular: {$MACRO:regex:"expressió regular"} Tingueu en compte que una macro amb un context d'expressió regular només es pot definir a la configuració de la macro d'usuari. Si el prefix `regex:` s'empra en un altre lloc com a context de macro d'usuari, com ara en una expressió de trigger, es tractarà com un context estàtic. La citació contextual és opcional (veieu també les [notes importants](#notes_importants)). Exemples de macrocontext: |Exemple|Descripció| |-------|------------| |`{$LOW_SPACE_LIMIT}`|Macro d'usuari sense context.| |`{$LOW_SPACE_LIMIT:/tmp}`|Macro d'usuari amb context (cadena estàtica).| |`{$LOW_SPACE_LIMIT:regex:"^/tmp$"}`|Macro d'usuari amb context (regex). Igual que `{$LOW_SPACE_LIMIT:/tmp}`.| |`{$LOW_SPACE_LIMIT:regex:"^/var/log/.*$"}`|Macro d'usuari amb context (regex). Coincideix amb totes les cadenes amb el prefix /var/log/.| #### Overview As an alternative to setting up manually or reusing an existing server for Zabbix, users may [download](http://www.zabbix.com/download_appliance) a Zabbix appliance or a Zabbix appliance installation CD image. Zabbix appliance and installation CD versions are based on AlmaLinux 8 (x86\_64). Zabbix appliance installation CD can be used for instant deployment of Zabbix server (MySQL). ::: noteimportant You can use this Appliance to evaluate Zabbix. The Appliance is not intended for serious production use. ::: #### Vista general En lloc de configurar manualment o reutilitzar un servidor existent per Zabbix, els usuaris poden [descarregar](http://www.zabbix.com/download_appliance) una aplicació Zabbix o una imatge de CD d'instal·lació de l'aplicació Zabbix. Les versions de l'aplicació Zabbix i el CD d'instal·lació es basen en AlmaLinux 8 (x86\_64). El CD d'instal·lació de l'aplicació Zabbix es pot emprar per fer un desplegament instantani del servidor Zabbix (MySQL). ::: noteimportant Podeu emprar aquesta aplicació per avaluar Zabbix. L'aplicació no és pas destinada a producció. ::: #### Overview Assuming that we have configured some items and triggers and now are getting some events happening as a result of triggers changing state, it is time to consider some actions. To begin with, we would not want to stare at the triggers or events list all the time. It would be much better to receive notification if something significant (such as a problem) has happened. Also, when problems occur, we would like to see that all the people concerned are informed. That is why sending notifications is one of the primary actions offered by Zabbix. Who and when should be notified upon a certain event can be defined. To be able to send and receive notifications from Zabbix you have to: - [define some media](/manual/config/notifications/media) - [configure an action](/manual/config/notifications/action) that sends a message to one of the defined media Actions consist of *conditions* and *operations*. Basically, when conditions are met, operations are carried out. The two principal operations are sending a message (notification) and executing a remote command. For discovery and autoregistration created events, some additional operations are available. Those include adding or removing a host, linking a template etc. #### Vista general Suposant que hem configurat alguns elements i triggers i que ara es produeixen alguns esdeveniments com a resultat del canvi d'estat dels triggers, és hora de considerar algunes accions. Per començar, no voldríem estar sempre pendents dels triggers o la llista d'esdeveniments. Seria millor rebre una notificació si passa alguna cosa important (com ara un problema). A més, quan sorgeixen problemes, voldríem que tots els implicats fossin informats. És per això que l'enviament de notificacions és una de les principals accions que ofereix Zabbix. Es pot definir qui i quan s'ha de notificar a cada esdeveniment. Per poder enviar i rebre notificacions de Zabbix, heu de: - [establir alguns suports](/manual/config/notifications/media) - [configurar una acció](/manual/config/notifications/action) que envia un missatge a un dels suports definits Les accions consisteixen en *condicions* i *operacions*. Bàsicament, quan es compleixen les condicions, es realitzen les operacions. Les dues operacions principals són enviar un missatge (notificació) i executar una comanda remota. Per als esdeveniments creats per la detecció i el registre automàtics, hi ha algunes operacions addicionals disponibles. Aquests inclouen afegir o eliminar un equip, vincular un model, etc. #### Overview A template is a set of entities that can be conveniently applied to multiple hosts. The entities may be: - items - triggers - graphs - dashboards - low-level discovery rules - web scenarios As many hosts in real life are identical or fairly similar so it naturally follows that the set of entities (items, triggers, graphs,...) you have created for one host, may be useful for many. Of course, you could copy them to each new host, but that would be a lot of manual work. Instead, with templates you can copy them to one template and then apply the template to as many hosts as needed. When a template is linked to a host, all entities (items, triggers, graphs,...) of the template are added to the host. Templates are assigned to each individual host directly (and not to a host group). Templates are often used to group entities for particular services or applications (like Apache, MySQL, PostgreSQL, Postfix...) and then applied to hosts running those services. Another benefit of using templates is when something has to be changed for all the hosts. Changing something on the template level once will propagate the change to all the linked hosts. Thus, the use of templates is an excellent way of reducing one's workload and streamlining the Zabbix configuration. Proceed to [creating and configuring a template](/manual/config/templates/template). #### Vista general Una plantilla és un conjunt d'entitats que es poden aplicar fàcilment a diversos equips. Les entitats poden ser: - elements - triggers - gràfics - Taulers de comandament - regles de descoberta de baix nivell - escenaris web Com que molts equips a la vida real són iguals o força semblants, es dedueix naturalment que el conjunt d'entitats (elements, triggers, gràfics, ...) que heu creat per a un equip pot ser útil per a molts. Per descomptat, podríeu copiar-los a cada nou equip, però això seria molt de treball manual. En comptes d'això, amb les plantilles, podeu copiar-les en una plantilla i aplicar-la a tants equips com sigui necessari. Quan una plantilla és enllaçada a un equip, totes les entitats (elements, triggers, gràfics,...) de la plantilla s'afegeixen a l'equip. Les plantilles s'assignen directament a cada equip individual (no a un grup d'equips). Els patrons s'empren sovint per agrupar entitats per a serveis o aplicacions particulars (com Apache, MySQL, PostgreSQL, Postfix...) i després s'apliquen als equips que executen aquests serveis. Un altre avantatge d'emprar plantilles és quan cal canviar alguna cosa per a tots els equips. Si canvieu alguna cosa a nivell de plantilla un cop, es propagarà el canvi a tots els equips enllaçats. Per tant, emprar plantilles és una bona manera de reduir la seva càrrega de treball i racionalitzar la configuració de Zabbix. Veieu la [creació i configuració d'una plantilla](/manual/config/templates/template). #### Overview A vertical menu in a sidebar provides access to various Zabbix frontend sections. The menu is dark blue in the default theme. {width="600"} #### Vista general Un menú vertical en una barra lateral proporciona accés a diverses seccions de la interfície Zabbix. El menú és blau fosc al tema predeterminat. {width="600"} #### Overview A Zabbix database must be created during the installation of Zabbix server or proxy. This section provides instructions for creating a Zabbix database. A separate set of instructions is available for each supported database. UTF-8 is the only encoding supported by Zabbix. It is known to work without any security flaws. Users should be aware that there are known security issues if using some of the other encodings. See also [Limits of filtering with utf8mb4 collations](/manual/installation/known_issues#limits-of-filtering-with-utf8mb4-collations). #### Vista general Una base de dades Zabbix s'ha de crear durant la instal·lació el servidor o el proxy Zabbix. Aquesta secció conté les instruccions per crear una base de dades Zabbix. Hi ha disponible un recull d'instruccions diferents per cadascuna de les bases de dades suportades. UTF-8 és la única codificació admesa per Zabbix. És reconeguda per funcionar sense cap error de seguretat. Els usuaris han d'ésser conscients que h iha problemes de seguretat comuns si s'empren alguns dels altres tipus de codificació. Veieu també [límits de filtrat amb col·lació utf8mb4](/manual/installation/known_issues#limits-of-filtering-with-utf8mb4-collations). ### Overview A Zabbix proxy can collect performance and availability data on behalf of the Zabbix server. This way, a proxy can take on itself some of the load of collecting data and offload the Zabbix server. Also, using a proxy is the easiest way of implementing centralized and distributed monitoring, when all agents and proxies report to one Zabbix server and all data is collected centrally. A Zabbix proxy can be used to: - Monitor remote locations - Monitor locations having unreliable communications - Offload the Zabbix server when monitoring thousands of devices - Simplify the maintenance of distributed monitoring {width="500"} The proxy requires only one TCP connection to the Zabbix server. This way it is easier to get around a firewall as you only need to configure one firewall rule. ::: noteimportant Zabbix proxy must use a separate database. Pointing it to the Zabbix server database will break the configuration. ::: All data collected by the proxy is stored locally before transmitting it over to the server. This way no data is lost due to any temporary communication problems with the server. The *ProxyLocalBuffer* and *ProxyOfflineBuffer* parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) control for how long the data are kept locally. ::: noteimportant It may happen that a proxy, which receives the latest configuration changes directly from Zabbix server database, has a more up-to-date configuration than Zabbix server whose configuration may not be updated as fast due to the value of [CacheUpdateFrequency](/manual/appendix/config/zabbix_server). As a result, proxy may start gathering data and send them to Zabbix server that ignores these data. ::: Zabbix proxy is a data collector. It does not calculate triggers, process events or send alerts. For an overview of what proxy functionality is, review the following table: |Function|<|Supported by proxy| |-|--------------|--| |Items|<|<| |<|*Zabbix agent checks*|**Yes**| |^|*Zabbix agent checks (active)*|**Yes** ^1^| |^|*Simple checks*|**Yes**| |^|*Trapper items*|**Yes**| |^|*SNMP checks*|**Yes**| |^|*SNMP traps*|**Yes**| |^|*IPMI checks*|**Yes**| |^|*JMX checks*|**Yes**| |^|*Log file monitoring*|**Yes**| |^|*Internal checks*|**Yes**| |^|*SSH checks*|**Yes**| |^|*Telnet checks*|**Yes**| |^|*External checks*|**Yes**| |^|*Dependent items*|**Yes**| |^|*Script items*|**Yes**| |Built-in web monitoring|<|**Yes**| |Item value preprocessing|<|**Yes**| |Network discovery|<|**Yes**| |Active agent autoregistration|<|**Yes**| |Low-level discovery|<|**Yes** ^2^| |Remote commands|<|**Yes**| |Calculating triggers|<|*No*| |Processing events|<|*No*| |Event correlation|<|*No*| |Sending alerts|<|*No*| ::: noteclassic \[1\] To make sure that an agent asks the proxy (and not the server) for active checks, the proxy must be listed in the **ServerActive** parameter in the agent configuration file.<br> \[2\] For LLD, Zabbix proxy only collects and preprocesses the data and then sends it to Zabbix server for further processing. ::: ### Vista general Un proxy de Zabbix pot recopilar dades de rendiment i disponibilitat en nom del servidor de Zabbix. D'aquesta manera, un proxy pot assumir part de la càrrega de recollida de dades i descarregar el servidor Zabbix. A més, l'ús d'un proxy és la manera més senzilla d'implementar el monitoratge centralitzat i distribuït, quan tots els agents i proxys informen a un servidor Zabbix i totes les dades es recullen de manera centralitzada. Es pot emprar un proxy Zabbix per a: - Monitorar ubicacions remotes - Monitorar ubicacions amb comunicacions poc fiables - Descarregar el servidor Zabbix quan controleu milers de dispositius - Simplificar el manteniment del monitoratge distribuït {width="500"} El proxy només ha de menester una connexió TCP al servidor Zabbix. D'aquesta manera, és més fàcil evitar un tallafoc perquè només cal configurar una regla de tallafoc. ::: noteimportant El proxy Zabbix ha d'emprar una base de dades independent. Apuntar-lo a la base de dades del servidor Zabbix trencarà la configuració. ::: Totes les dades recollides pel proxy s'emmagatzemen localment abans d'ésser transmeses al servidor. D'aquesta manera, no es perden dades a causa de problemes temporals de comunicació amb el servidor. Els paràmetres *ProxyLocalBuffer* i *ProxyOfflineBuffer* al [fitxer de configuració del proxy](/manual/appendix/config/zabbix_proxy) controlen quant de temps es conserven les dades localment. ::: noteimportant Pot passar que un proxy, que rep els darrers canvis de configuració directament de la base de dades del servidor Zabbix, tingui una configuració més actualitzada que el servidor Zabbix, la configuració del qual potser no s'actualitza tan ràpidament a causa del valor de [CacheUpdateFrequency](/manual/annex/config/zabbix_server). Com a resultat, el proxy pot començar a recollir dades i enviar-les al servidor Zabbix que ignora aquestes dades. ::: El proxy Zabbix és un recopilador de dades. No calcula triggers, ni processa esdeveniments ni envia alertes. Per obtindre una visió general de quina és la funcionalitat del proxy, consulteu la taula següent: |Funció|<|Efectuada amb proxy| |-|--------------|--| |Elements|<|<| |<|*Comprova els agents de Zabbix*|**Sí**| |^|*Comprovacions de l'agent Zabbix (actiu)*|**Sí** ^1^| |^|*Comprovacions senzilles*|**Sí**| |^|*Zabbix Trapper*|**Sí**| |^|*Comprovacions SNMP*|**Sí**| |^|*Trampes SNMP*|**Sí**| |^|*Comprovacions IPMI*|**Sí**| |^|*Comprovacions JMX*|**Sí**| |^|*Monitoratgge del fitxer de registre*|**Sí**| |^|*Comprovacions internes*|**Sí**| |^|*Comprovacions SSH*|**Sí**| |^|*Comprovacions Telnet*|**Sí**| |^|*Comprovacions externes*|**Sí**| |^|*Elements dependents*|**Sí**| |^|*Elements d'script*|**Sí**| |Monitoratgge web integrat|<|**Sí**| |Valor de l'element de preprocessament|<|**Sí**| |Descoberta de la xarxa|<|**Sí**| |Registre automàtic d'agents actius|<|**Sí**| |Descoberta de baix nivell|<|**Sí**| |Comandes remotes|<|**Sí**| |Càlcul dels triggers|<|*No*| |Processat d'esdeveniments|<|*No*| |Correlació d'esdeveniments|<|*No*| |Enviament d'alertes|<|*No*| :::noteclassic \[1\] Per assegurar-vos que un agent demana al proxy (i no al servidor) comprovacions actives, el proxy ha d'ésser llistat al paràmetre **ServerActive** del fitxer de configuració de l'agent. \[2\] Per a LLD, el proxy de Zabbix només recopila i preprocessa les dades i després les envia al servidor Zabbix per a processar. ::: #### Overview By default, Zabbix provides a number of predefined themes. You may follow the step-by-step procedure provided here in order to create your own. Feel free to share the result of your work with Zabbix community if you created something nice. #### Vista general Per defecte, Zabbix ofereix una sèrie de temes predefinits. Podeu seguir el procediment passa per passa indicada aquí per crear el vostre. No dubteu a compartir el resultat del vostre treball amb la comunitat Zabbix si heu creat alguna cosa genial. ##### Overview by item type In this screen it is easy to locate if the problem is related to one or several item types. {width="600"} Each line contains an item type. Each column shows the number of waiting items - waiting for 5-10 seconds/10-30 seconds/30-60 seconds/1-5 minutes/5-10 minutes or over 10 minutes respectively. ##### Vista general per tipus d'element En aquesta pantalla, és fàcil localitzar si el problema té a veure amb un o més tipus d'elements. {width="600"} Cada línia conté un tipus d'element. Cada columna mostra el nombre d'elements en espera: 5-10 segons/10-30 segons/30-60 segons/1-5 minuts/5-10 minuts o més de 10 minuts respectivament. ##### Overview by proxy In this screen it is easy to locate if the problem is related to one of the proxies or the server. {width="600"} Each line contains a proxy, with the server last in the list. Each column shows the number of waiting items - waiting for 5-10 seconds/10-30 seconds/30-60 seconds/1-5 minutes/5-10 minutes or over 10 minutes respectively. ##### Vista general per proxy En aquesta pantalla, és fàcil veure si el problema té relació amb un dels proxys o amb el servidor. {width="600"} Cada línia conté un proxy, amb el servidor el darrer a la llista. Cada columna mostra el nombre d'elements en espera: 5-10 segons/10-30 segons/30-60 segons/1-5 minuts/5-10 minuts o més de 10 minuts respectivament. #### Overview Change of trigger status is the most frequent and most important source of events. Each time the trigger changes its state, an event is generated. The event contains details of the trigger state's change - when it happened and what the new state is. Two types of events are created by triggers - Problem and OK. #### Vista general El canvi d'estat d'un trigger és la font d'esdeveniments més freqüent i important. Cada vegada que el trigger canvia d'estat, es genera un esdeveniment. L'esdeveniment conté els detalls del canvi d'estat del trigger: quan va passar i quin és el nou estat. Els triggers creen dos tipus d'esdeveniments: Problema i D'acord. #### Overview Checking for a new item value in Zabbix is a cyclic process that is based on configured update intervals. While for many items the update intervals are quite short, there are others (including low-level discovery rules) for which the update intervals are quite long, so in real-life situations there may be a need to check for a new value quicker - to pick up changes in discoverable resources, for example. To accommodate such a necessity, it is possible to reschedule a passive check and retrieve a new value immediately. This functionality is supported for **passive** checks only. The following item types are supported: - Zabbix agent (passive) - SNMPv1/v2/v3 agent - IPMI agent - Simple check - Zabbix internal - External check - Database monitor - JMX agent - SSH agent - Telnet - Calculated - HTTP agent - Script ::: noteimportant The check must be present in the configuration cache in order to get executed; for more information see [CacheUpdateFrequency](/manual/appendix/config/zabbix_server). Before executing the check, the configuration cache is **not** updated, thus very recent changes to item/discovery rule configuration will not be picked up. Therefore, it is also not possible to check for a new value for an item/rule that is being created or has been created just now; use the *Test* option while configuring an item for that. ::: #### Vista general La recerca d'un nou valor d'elements dins de Zabbix és un procés cíclic basat en intervals d'actualització configurats. Mentre que per molts elements, els intervals d'actualització són curts, n'hi ha d'altres (incloent les regles de descoberta de baix nivell) per les quals els intervals d'actualització són llargs, doncs a la realitat potser cal cercar un nou valor més ràpidament -per detectar els canvis als recursos detectables, per exemple. Per respondre a una necessitat, és possible reprogramar una verificació passiva i recuperar al moment un nou valor.. Aquesta funcionalitat només s'admet per verificacions **passives**. Els tipus d'elements suportats són els següents: - Agent Zabbix (passiu) - Agent SNMPv1/v2/v3 - Agent IPMI - Verificació simple - Intern Zabbix - Verificació externa - Monitor de base de dades - Agent JMX - Agent SSH - Telnet - Calculé - Agent HTTP - Script ::: noteimportant Per poder executar-la, la verificació ha d'ésser present a la cau de configuració; per més informació, veieu [CacheUpdateFrequency](/manual/appendix/config/zabbix_server). Abans d'executar la verificació, la cau de configuració **no** és pas actualitzada, pel que les modificacions més recents fetes a la configuració no es recuperaran pas. Per tant, no és possible de cercar un valor nou d'un element/regla que s'estigui creant o que s'acabi de crear; empreu l'opció *Test* mentre configureu un element per això. ::: #### Overview Configuring a map in Zabbix requires that you first create a map by defining its general parameters and then you start filling the actual map with elements and their links. You can populate the map with elements that are a host, a host group, a trigger, an image, or another map. Icons are used to represent map elements. You can define the information that will be displayed with the icons and set that recent problems are displayed in a special way. You can link the icons and define information to be displayed on the links. You can add custom URLs to be accessible by clicking on the icons. Thus you may link a host icon to host properties or a map icon to another map. Maps are managed in *Monitoring* → *[Maps](/manual/web_interface/frontend_sections/monitoring/maps)*, where they can be configured, managed and viewed. In the monitoring view, you can click on the icons and take advantage of the links to some scripts and URLs. Network maps are based on vector graphics (SVG) since Zabbix 3.4. #### Vista general La configuració d'un mapa a Zabbix requereix que primer creeu un mapa establint la configuració general i després comenceu a omplir el mapa real amb elements i els seus enllaços. Podeu omplir el mapa amb elements que siguin equips, grups d'equips, triggers, imatges o altres mapes. Les icones s'empren per representar els elements del mapa. Podeu definir quina informació es mostrarà amb les icones i definir que els problemes recents es mostrin d'una manera determinada. Podeu enllaçar les icones i configurar la informació que es mostri als enllaços. Podeu afegir URL personalitzades accessibles fent clic a les icones. Així, podeu vincular una icona d'equip a propietats de l'equip o una icona de mapa a un altre mapa. Els mapes es gestionen a *Monitoratge* → *[Mapes](/manual/web_interface/frontend_sections/monitoring/maps)*, on es poden configurar, gestionar i visualitzar. A la vista de seguiment, podeu fer clic a les icones i gaudir d'enllaços a determinats scripts i URL. Els mapes de xarxa es basen en gràfics vectorials (SVG) des de Zabbix 3.4. #### Overview Configuring a template requires that you first create a template by defining its general parameters and then you add entities (items, triggers, graphs, etc.) to it. #### Vista general La configuració d'una plantilla requereix primer crear una plantilla definint la seva configuració general i després afegir entitats (elements, triggers, gràfics, etc.). #### Overview Custom graphs, as the name suggests, offer customization capabilities. While simple graphs are good for viewing data of a single item, they do not offer configuration capabilities. Thus, if you want to change graph style or the way lines are displayed or compare several items, for example, incoming and outgoing traffic in a single graph, you need a custom graph. Custom graphs are configured manually. They can be created for a host or several hosts or for a single template. #### Vista general Els gràfics personalitzats, com el seu nom indica, ofereixen capacitat de personalització. Tot i que els gràfics senzills són útils per visualitzar dades d'un sol element, no ofereixen opcions de configuració. Per tant, si voleu canviar l'estil del gràfic o la manera com es mostren les línies o comparar diverses coses, per exemple, el trànsit entrant i sortint en un sol gràfic, necessiteu un gràfic personalitzat. Els gràfics personalitzats es configuren manualment. Es poden crear per a un o més equips o per a un sol model. #### Overview Data provided in Prometheus line format can be used for low-level discovery. See [Prometheus checks](/manual/config/items/itemtypes/http/prometheus) for details how Prometheus data querying is implemented in Zabbix. #### Vista general Les dades proporcionades en format de filera de Prometheus es poden emprar per la descoberta de baix nivell. Consulteu [comprovacions de Prometheus](/manual/config/items/itemtypes/http/prometheus) per obtindre més detalls sobre com s'implementa la consulta de dades de Prometheus a Zabbix. #### Overview Debug mode may be used to diagnose performance problems with frontend pages. #### Vista general El mode de depuració es pot emprar per diagnosticar problemes de rendiment de la interfície web. #### Overview Depending on user role permissions, the *User settings* section may contain the following pages: - *User profile* - for customizing certain Zabbix frontend features; - *API tokens* - for managing API tokens assigned to the current user. The list of available pages appears upon pressing on the  user icon near the bottom of the Zabbix menu (not available for a guest user). It is also possible to switch between pages by using a title dropdown in the top left corner. | | | |---|---| |{width="300"}|{width="300"}| |Third-level menu.|Title dropdown.| #### Vista general En funció dels permisos de rol d'usuari, la secció *Configuració de l'usuari* pot contindre les pàgines següents: - *Perfil d'usuari* - per personalitzar algunes característiques de la interfície Zabbix; - *Fitxes API* - per gestionar fitxes API assignades a l'usuari actual. La llista de pàgines disponibles apareix prement la icona d'usuari  a la part inferior del menú Zabbix (no disponible per a un usuari convidat). També és possible canviar entre pàgines mitjançant una llista desplegable de títols a la cantonada superior esquerra. | | | |---|---| |{width="300"}|{width="300"}| |Menú de tercer nivell.|Llista desplegable de títols.| #### Overview Each pre-shared key (PSK) in Zabbix actually is a pair of: - non-secret PSK identity string, - secret PSK string value. PSK identity string is a non-empty UTF-8 string. For example, "PSK ID 001 Zabbix agentd". It is a unique name by which this specific PSK is referred to by Zabbix components. Do not put sensitive information in PSK identity string - it is transmitted over the network unencrypted. PSK value is a hard to guess string of hexadecimal digits, for example, "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9". #### Vista general Cada clau precompartida (PSK) a Zabbix és en realitat un parell de: - cadena d'identitat PSK no secreta, - valor secret de la cadena PSK. La cadena d'identitat PSK és una cadena UTF-8 no buida. Per exemple, "PSK ID 001 Zabbix agentd". És un nom únic amb el qual els components Zabbix fan referència a aquest component PSK específic. No introduïu informació sensible a la cadena d'identitat PSK: es transmet sense xifrar per la xarxa. El valor PSK és una cadena hexadecimal difícil d'endevinar, com ara "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9". #### Overview Event correlation allows to correlate problem events to their resolution in a manner that is very precise and flexible. Event correlation can be defined: - [on trigger level](/manual/config/event_correlation/trigger) - one trigger may be used to relate separate problems to their solution - [globally](/manual/config/event_correlation/global) - problems can be correlated to their solution from a different trigger/polling method using global correlation rules #### Vista general La correlació d'esdeveniments permet correlacionar els esdeveniments problemàtics amb al seva resolució de manera més precisa i flexible. La correlació d'esdeveniments es pot definir: - [A nivell de trigger](/manual/config/event_correlation/trigger) - un trigger es pot emprar per relacionar els problemes diferents amb la seva solució - [Globalment](/manual/config/event_correlation/global) - els problemes poden relacionar-se amb la seva solució a partir d'un altre mètode trigger o de consulta emprant les regles de correlació globals #### Overview Expression macros are useful for formula calculations. They are calculated by expanding all macros inside and evaluating the resulting expression. Expression macros have a special syntax: {?EXPRESSION} The syntax in EXPRESSION is the same as in [trigger expressions](/manual/config/triggers/expression) (see usage limitations below). {HOST.HOST<1-9>} and {ITEM.KEY<1-9>} macros are supported inside expression macros. {ITEM.KEY<1-9>} macros are supported in expression macros since Zabbix 6.0.9. #### Vista general Les macros d'expressió són útils per als càlculs de fórmules. Es calculen ampliant totes les macros que hi ha dins i avaluant l'expressió resultant. Les macros d'expressió tenen una sintaxi especial: {?EXPRESSION} La sintaxi a EXPRESSION és la mateixa que a [expressions de trigger](/manual/config/triggers/expression) (veieu les limitacions d'ús tot seguit). Les macros {HOST.HOST<1-9>} i {ITEM.KEY<1-9>} són compatibles amb les macros d'expressió. Les macros {ITEM.KEY<1-9>} són compatibles amb les macros d'expressió des de Zabbix 6.0.9. #### Overview For an easy access to Zabbix from anywhere and from any platform, the web-based interface is provided. ::: noteclassic If using more than one frontend instance make sure that the locales and libraries (LDAP, SAML etc.) are installed and configured identically for all frontends. ::: #### Vista genereal Per accedir fàcilment a Zabbix des de qualsevol lloc i des de qualsevol plataforma, es proporciona una interfície web. :::noteclassic Si empreu més d'una instància d'interfície, assegureu-vos que les localitzacions i les biblioteques (LDAP, SAML, etc.) siguin instal·lades i configurades de manera idèntica per a totes les interfícies. ::: #### Overview Foreach functions are used in [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) to return one aggregate value for each item that is selected by the used **item filter**. An array of values is returned. For example, the *avg_foreach* function will return an array of values, where each value is the *average* history value of the selected item, during the time interval that is specified. The [item filter](#item-filter-syntax) is part of the syntax used by foreach functions. The use of wildcards is supported in the item filter, thus the required items can be selected quite flexibly. #### Vista general Les funcions de Foreach s'empren als [càlculs agregats](/manual/config/items/itemtypes/calculated/aggregate) i retornen un valor agregat per cada element triat al **filtre d'element*. Es retorna una taula de valors. per exemple, la funció *avg_foreach* retorna una taula de valors, on cada valor és la *mitjana* de valors històrics de l'element triat, durant l'interval de temps donat. El [filtre d'element](#iten-filter-syntax) és part de la sintaxi emprada per les funcions foreach. L'ús de comodins s'admet al filtre, per poder triar els elements desitjats de manera flexible. #### Overview Geomap widget displays hosts as markers on a geographical map using open-source JavaScript interactive maps library Leaflet. ::: noteclassic Zabbix offers multiple predefined map tile service providers and an option to add a custom tile service provider or even host tiles themselves (configurable in the *Administration → General → Geographical maps* [menu section](/manual/web_interface/frontend_sections/administration/general#geographical_maps)). ::: #### Vista general El giny Geomap mostra els equips com a marcadors en un mapa geogràfic mitjançant la biblioteca de mapes interactius JavaScript Leaflet de codi obert. :::noteclassic Zabbix ofereix diversos proveïdors de serveis de rajoles de mapes predefinits i una opció per afegir un proveïdor de serveis de rajoles personalitzats o fins i tot allotjar els mateixos mosaics (configurable a la [secció de menú](/manual/web_interface/frontend_sections/administration/general#mapes_geogràfics)) *Administració → General → Mapes*. ::: #### Overview Global event correlation allows to reach out over all metrics monitored by Zabbix and create correlations. It is possible to correlate events created by completely different triggers and apply the same operations to them all. By creating intelligent correlation rules it is actually possible to save yourself from thousands of repetitive notifications and focus on root causes of a problem! Global event correlation is a powerful mechanism, which allows you to untie yourself from one-trigger based problem and resolution logic. So far, a single problem event was created by one trigger and we were dependent on that same trigger for the problem resolution. We could not resolve a problem created by one trigger with another trigger. But with event correlation based on event tagging, we can. For example, a log trigger may report application problems, while a polling trigger may report the application to be up and running. Taking advantage of event tags you can tag the log trigger as *Status: Down* while tag the polling trigger as *Status: Up*. Then, in a global correlation rule you can relate these triggers and assign an appropriate operation to this correlation such as closing the old events. In another use, global correlation can identify similar triggers and apply the same operation to them. What if we could get only one problem report per network port problem? No need to report them all. That is also possible with global event correlation. Global event correlation is configured in **correlation rules**. A correlation rule defines how the new problem events are paired with existing problem events and what to do in case of a match (close the new event, close matched old events by generating corresponding OK events). If a problem is closed by global correlation, it is reported in the *Info* column of *Monitoring* → *Problems*. Configuring global correlation rules is available to Super Admin level users only. ::: noteimportant Event correlation must be configured very carefully, as it can negatively affect event processing performance or, if misconfigured, close more events than was intended (in the worst case even all problem events could be closed). ::: To configure global correlation **safely**, observe the following important tips: - Reduce the correlation scope. Always set a unique tag for the new event that is paired with old events and use the *New event tag* correlation condition; - Add a condition based on the old event when using the *Close old event* operation (or else all existing problems could be closed); - Avoid using common tag names that may end up being used by different correlation configurations; - Keep the number of correlation rules limited to the ones you really need. See also: [known issues](/manual/installation/known_issues#global_event_correlation). #### Vista general La correlació d'esdeveniments global permet arribar a totes les mètriques monitorades per Zabbix i crear correlacions. És possible correlacionar esdeveniments creats per triggers completament diferents i aplicar les mateixes operacions a tots ells. En crear regles de correlació intel·ligents, és possible estalviar-vos milers de notificacions repetitives i centrar-vos en les causes d'un problema! La correlació global d'esdeveniments és un mecanisme potent que us permet separar-vos de la lògica de resolució i problemes basats en triggers. Fins ara, només un esdeveniment problema es creava per un trigger i depeníem d'aquest mateix trigger per resoldre el problema. No hem pogut resoldre un problema creat per un trigger amb un altre trigger. Però amb la correlació d'esdeveniments basada en el marcatge d'esdeveniments, és possible. Per exemple, un trigger de registre pot indicar problemes de l'aplicació, mentre que un trigger de sondeig pot indicar si l'aplicació és operativa. Aprofitant les etiquetes d'esdeveniment, podeu etiquetar el trigger del registre com a *Estat: Caigut* mentre marqueu el trigger de l'enquesta com a *Estat:Aixecat*. Aleshores, en una regla de correlació global, podeu enllaçar aquests triggers i assignar una operació adequada a aquesta correlació, com ara tancar esdeveniments antics. En un altre ús, la correlació global pot identificar desencadenants similars i aplicar-hi la mateixa operació. Què passaria si només poguéssim obtindre un informe de problema per problema de port de xarxa? No cal declarar-los tots. Això també és possible amb la correlació d'esdeveniments globals. La correlació global d'esdeveniments es configura a **regles de correlació**. Una regla de correlació defineix com es combinen els nous esdeveniments problemàtics amb els esdeveniments problemàtics existents i què fer en cas de coincidència (tancar el nou esdeveniment, tancar els antics esdeveniments de concordança generant esdeveniments d'acord coincidents). Si un problema es tanca per correlació global, s'informa a la columna *Informació* de *Supervisió* → *Problemes*. La configuració de regles de correlació global només és disponible per a usuaris de nivell superadministrador. ::: noteimportant La correlació d'esdeveniments s'ha de configurar amb molta cura, ja que pot afectar negativament el rendiment del processament d'esdeveniments o, si es configura incorrectament, tancar més esdeveniments dels esperats (en el pitjor dels casos, fins i tot es podrien tancar tots els esdeveniments problemàtics). ::: Per configurar la correlació global **de manera segura**, seguiu aquests consells importants: - Reduir l'abast de la correlació. Definiu sempre una etiqueta única per al nou esdeveniment associat amb els antics esdeveniments i empreu la condició de correlació *Etiqueta d'esdeveniment nova*; - Afegiu una condició basada en l'esdeveniment antic quan empreu l'operació *Tancar esdeveniment antic* (en cas contrari es podrien tancar tots els problemes existents); - Eviteu emprar noms d'etiquetes comuns que poden ser emprats per diferents configuracions de correlació; - Limiteu el nombre de regles de correlació a les que realment necessiteu. Veieu també: [problemes coneguts](/manual/installation/known_issues#global_event_correlation). #### Overview Global notifications are a way of displaying issues that are currently happening right on the screen you're at in Zabbix frontend. Without global notifications, working in some other location than *Problems* or the *Dashboard* would not show any information regarding issues that are currently happening. Global notifications will display this information regardless of where you are. Global notifications involve both showing a message and [playing a sound](sound). ::: noteimportant The auto play of sounds may be disabled in recent browser versions by default. In this case, you need to change this setting manually. ::: #### Vista general Les notificacions globals són una manera de veure els problemes que es són produint actualment directament a la pantalla on sou a la interfície de Zabbix. Sense notificacions globals, treballar en llocs diferents de *Problemes* o els *Taulers de control* no mostraria informació sobre problemes actuals. Les notificacions globals mostraran aquesta informació independentment d'on siguis. Les notificacions globals impliquen tant mostrar un missatge com [reproduir un so]. #### Overview Having to use some large numbers, for example '86400' to represent the number of seconds in one day, is both difficult and error-prone. This is why you can use some appropriate unit symbols (or suffixes) to simplify Zabbix trigger expressions and item keys. Instead of '86400' for the number of seconds you can simply enter '1d'. Suffixes function as multipliers. #### Vista general Havent d'emprar nombres grans (com ara '86400' per representar el nombre de segons d'un dia), és difícil i una font d'errors. Això passa perquè podem emprar alguns símbols d'unitats apropiats (o sufixes) per simplificar les expressions de trigger Zabbix i claus d'element. En lloc de '86400' com a nombre de segons, podem escriure '1d'. Els sufixos funcionen com a multiplicadors. ### Overview High availability (HA) is typically required in critical infrastructures that can afford virtually no downtime. So for any service that may fail there must be a failover option in place to take over should the current service fail. Zabbix offers a **native** high-availability solution that is easy to set up and does not require any previous HA expertise. Native Zabbix HA may be useful for an extra layer of protection against software/hardware failures of Zabbix server or to have less downtime due to maintenance. In the Zabbix high availability mode multiple Zabbix servers are run as nodes in a cluster. While one Zabbix server in the cluster is active, others are on standby, ready to take over if necessary.  Switching to Zabbix HA is non-committal. You may switch back to standalone operation at any point. See also: [Implementation details](#implementation-details) ### Vista general L'alta disponibilitat (HA) es demana generalment a les infraestructures crítiques que no poden permetre's cap temps d'aturada. Per qualsevol servei susceptible de fallar, una opció de balanceig cap a un altre lloc és útil per evitar una aturada. Zabbix propoa una solució d'alta disponibilitat **nadiua** fàcil de configurar i sense necessitat de cap experiència prèvia en HA. Zabbix HA nadiu és útil per una capa de protecció contra errades de programari/maquinari del servidor Zabbix o per tindre menys temps d'aturada per manteniments. En mode alta disponibilitat de Zabbix, múltiples servidors executen com a nodes dins un clúster. Mentre un servidor Zabbix és actiu, els altres romanen a l'espera a punt de prendre el relleu si escau.  Encara que passem a Zabbix HA, sempre es pot fer marxa enrere en tot moment. Veieu també: [Detalls de la implementació](#implementation-details) #### Overview History and trends are the two ways of storing collected data in Zabbix. Whereas history keeps each collected value, trends keep averaged information on hourly basis and therefore are less resource-hungry. #### vista general L'històric i les tendències són dues maneres d'emmagatzemar les dades recollides dins de Zabbix. Mentre l'històric conserva cada valor recollit, les tendències conserven les mitjanes sota una base horària i, per tant, consumeixen menys recursos. #### Overview Host dashboards look similar to [global dashboards](/manual/web_interface/frontend_sections/monitoring/dashboard), however, host dashboards display data about the host only. Host dashboards have no owner. Host dashboards are configured on the [template](/manual/config/templates/template#adding_dashboards) level and then are generated for a host, once the template is linked to the host. Widgets of host dashboards can only be copied to host dashboards of the same template. Widgets from global dashboards cannot be copied onto host dashboards. Host dashboards *cannot* be configured or directly accessed in the *Monitoring* → *[Dashboard](/manual/web_interface/frontend_sections/monitoring/dashboard)* section, which is reserved for global dashboards. The ways to access host dashboards are listed below in this section. {width="600"} When viewing host dashboards you may switch between the configured dashboards using the dropdown in the upper right corner. To switch to *Monitoring→Hosts* section, click *All hosts* navigation link below the dashboard name in the upper left corner. Widgets of the host dashboards cannot be edited. Note that host dashboards used to be host screens before Zabbix 5.2. When importing an older template containing screens, the screen import will be ignored. #### Vista general Els taulers de control de l'equip semblen [taulers de control globals](/manual/web_interface/frontend_sections/monitoring/dashboard), però, els taulers de control de l'equip només mostren dades sobre l'equip. Els taulers d'equip no tenen propietari. Els taulers de control de l'equip es configuren al nivell de [plantilla](/manual/config/templates/template#adding_dashboards) i es generen per a un equip després que la plantilla sigui enllaçada a l'equip. Els ginys dels taulers de control de l'equip només es poden copiar als taulers de comandament de l'equip de la mateixa plantilla. Els ginys dels taulers globals no es poden copiar als taulers d'equip. Els taulers de control de l'equip *no es poden* configurar ni accedir directament a la secció *Monitoratge* → *[Taulers de control](/manual/web_interface/frontend_sections/monitoring/dashboard)*, que és reservat per als taulers de control globals. Les maneres d'accedir als taulers d'equip s'enumeren a continuació en aquesta secció. {width="600"} Quan visualitzeu els taulers de control de l'equip, podeu canviar entre els taulers de control configurats mitjançant la llista desplegable de l'extrem superior dret. Per anar a la secció *Monitoratge→Equips*, feu clic a l'enllaç de navegació *Tots els equips* sota el nom del tauler de control a la cantonada superior esquerra. Els ginys del tauler de control de l'equip no es poden pas editar. Tingueu en compte que els taulers d'equip eren pantalles d'equip abans de Zabbix 5.2. Quan s'importa un model antic que conté pantalles, s'ometrà la importació de la pantalla. #### Overview Host graphs can be accessed from *Monitoring → Hosts* by clicking on Graphs for the respective host. Any [custom graph](/manual/config/visualization/graphs/custom) that has been configured for the host can be displayed, as well as any [simple graph](/manual/config/visualization/graphs/simple). {width="600"} Graphs are sorted by: - graph name (custom graphs) - item name (simple graphs) Graphs for disabled hosts are also accessible. #### Vista general Es pot accedir als gràfics d'equips des de *Monitoratge → Equips* fent clic a Gràfics per a l'equip respectiu. Es pot mostrar qualsevol [gràfic personalitzat](/manual/config/visualization/graphs/custom) que s'hagi configurat per a l'equip, així com qualsevol [gràfic](/manual/config/visualization/graphs/simple) senzill. {width="600"} Els gràfics són ordenats per: - nom del gràfic (gràfics personalitzats) - nom de l'element (gràfics simples) Els gràfics per a equips desactivats també són accessibles. #### Overview Host groups are used for the logical grouping of hosts and assigning user permissions to them. Each host must have at least one host group assigned. A host may belong to multiple host groups, and each host group may contain multiple hosts. Note that in Zabbix, all permissions are based on [user groups](/manual/config/users_and_usergroups) and host/[template](/manual/config/templates/template) groups. So, even if a single user needs access to a single host, it is granted by adding the user to a user group that has permission to access the host group containing that host. #### Vista general Els grups d'euips s'empren per agrupar lògicament els equips i assignar-hi permisos d'usuari. Cada equip ha de tindre com a mínim un grup d'equips assignat. Un equip pot pertànyer a diversos grups d'equips i cada grup d'equips pot contindre diversos equips. Tingueu en compte que a Zabbix, tots els permisos es basen en [grups d'usuaris](/manual/config/users_and_usergroups) i [grups de plantilles](/manual/config/templates/template). Així, fins i tot si un sol usuari necessita accedir a un únic equip, es concedeix afegint l'usuari a un grup d'usuaris que té permís per accedir al grup d'equips que conté aquest equip. #### Overview Hosts are [exported](/manual/xml_export_import) with many related objects and object relations. Host export contains: - linked host groups - host data - template linkage - host group linkage - host interfaces - directly linked items - directly linked triggers - directly linked graphs - directly linked discovery rules with all prototypes - directly linked web scenarios - host macros - host inventory data - value maps #### Vista general Els equips s'exporten (/manual/xml_export_import) amb molts objectes i relacions d'objectes. L'exportació d'equips conté: - grups d'equips enllaçats - Dades de l'equip - enllaços a plantilles - connexió amb altres grups d'equips - interfícies d'equips - elements enllaçats directament - triggers connectats directament - gràfics directament enllaçats - regles de descoberta directament relacionades amb tots els prototips - escenaris web enllaçats directament - macros d'equips - informació de l'inventari d'equips - mapes de valors #### Overview Host [web scenario](/manual/web_monitoring) information can be accessed from *Monitoring → Hosts* by clicking on Web for the respective host. {width="600"} Data of disabled hosts is also accessible. The name of a disabled host is listed in red. The maximum number of scenarios displayed per page depends on the *Rows per page* user profile [setting](/manual/web_interface/user_profile#user-profile). By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of latest data. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration→General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section. The scenario name is link to more detailed statistics about it: {width="600"} #### Vista general Es pot accedir a la informació sobre l'[escenari web](/manual/web_monitoring) d'un equip des de *Monitoratge → Equips* fent clic al web de l'equip corresponent. {width="600"} Les dades dels equips desactivats també són accessibles. El nom d'un equip desactivat apareix en vermell. El nombre màxim d'escenaris que es mostren per pàgina depèn del [paràmetre](/manual/web_interface/user_profile#user-profile) *Línies per pàgina* del perfil d'usuari. Per defecte, només es mostren els valors que es produeixen les darreres 24 hores. Aquest límit es va afegir per intentar millorar els temps de càrrega inicials de les pàgines de dades grans més recents. Podeu ampliar aquest període modificant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*. El nom de l'escenari és un enllaç a estadístiques més detallades sobre ell: {width="600"} #### Overview If [installed](/manual/installation/install_from_packages/debian_ubuntu#java_gateway_installation) from Debian/Ubuntu packages, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### Vista general Si s'ha [instal·lat](/manual/installation/install_from_packages/debian_ubuntu#java_gateway_installation) des dels paquets Debian/Ubuntu, la informació següent us ajudarà a configurar la [Passarel·la Java](/manual/concepts/java) de Zabbix. #### Overview If [installed](/manual/installation/install_from_packages/rhel#java_gateway_installation) from RHEL packages, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### Vista general Si s'ha [instal·lat](/manual/installation/install_from_packages/rhel#java_gateway_installation) des dels paquets de RHEL, la informació següent us ajudarà a configurar la [Passarel·la Java](/manual/concepts/java) de Zabbix. #### Overview If [installed](/manual/installation/install_from_packages/rhel#java_gateway_installation) from RHEL packages, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### Vista general Si s'ha [instal·lat](/manual/installation/install_from_packages/rhel#java_gateway_installation) des dels paquets de RHEL, la informació següent us ajudarà a configurar la [Passarel·la Java](/manual/concepts/java) de Zabbix. #### Overview If [installed](/manual/installation/install#installing_java_gateway) from sources, the following information will help you in setting up Zabbix [Java gateway](/manual/concepts/java). #### Vista general Si s'ha [instal·lat](/manual/installation/install#installing_java_gateway) des de les fonts, la informació següent us ajudarà a configurar la [Passarel·la Java](/manual/concepts/java) de Zabbix. #### Overview If you are not satisfied with the existing media types for sending alerts, there is an alternative way to do that. You can create a script that will handle the notification your way. Alert scripts are executed on Zabbix server. These scripts must be located in the directory specified in the server [configuration file](/manual/appendix/config/zabbix_server) `AlertScriptsPath` parameter. Here is an example of a custom alert script: ``` {.bash} #!/bin/bash to=$1 subject=$2 body=$3 cat <<EOF | mail -s "$subject" "$to" $body EOF ``` ::: noteimportant Starting from version 3.4 Zabbix checks for the exit code of the executed commands and scripts. Any exit code which is different from **0** is considered as a [command execution](/manual/appendix/command_execution) error. In such case Zabbix will try to repeat failed execution. ::: Environment variables are not preserved or created for the script, so they should be handled explicitly. #### Vista general Si no sou satisfets amb els tipus de suport existents per enviar alertes, hi ha una altra manera de fer-ho. Podeu crear un script que gestionarà la notificació a la vostra manera. Els scripts d'alerta s'executen al servidor Zabbix. Aquests scripts s'han de posar al directori especificat al paràmetre `AlertScriptsPath` del servidor [fitxer de configuració](/manual/appendix/config/zabbix_server). Aquí teniu un exemple d'script d'alerta: ``` {.bash} #!/bin/bash to=$1 subject=$2 body=$3 cat <<EOF | mail -s "$subject" "$to" $body EOF ``` ::: noteimportant A partir de la versió 3.4, Zabbix comprova el codi de sortida de les comandes i scripts executats. Qualsevol codi de sortida que no sigui **0** es considera un error d'[execució de comandes](/manual/appendix/command_execution). En aquest cas, Zabbix intentarà repetir l'execució fallida. ::: Les variables d'entorn no es conserven ni es creen per a l'script, de manera que s'han de gestionar de manera explícita. #### Overview If you have a network to look after, you may want to have an overview of your infrastructure somewhere. For that purpose, you can create maps in Zabbix - of networks and of anything you like. All users can create network maps. The maps can be public (available to all users) or private (available to selected users). Proceed to [configuring a network map](/manual/config/visualization/maps/map). #### Vista general Si teniu una xarxa per gestionar, potser voldreu tindre una visió general de la vostra infraestructura en algun lloc. Amb aquest propòsit podeu crear mapes a Zabbix - xarxes i el que vulgueu. Tots els usuaris poden crear mapes de xarxa. Els mapes poden ésser públics (disponibles per a tots els usuaris) o privats (disponibles per a alguns usuaris). Aneu a [configurar un mapa de xarxa](/manual/config/visualization/maps/map). #### Overview If you want some operations taking place as a result of events (for example, notifications sent), you need to configure actions. Actions can be defined in response to events of all supported types: - Trigger actions - for events when trigger status changes from *OK* to *PROBLEM* and back - Service actions - for events when service status changes from *OK* to *PROBLEM* and back - Discovery actions - for events when network discovery takes place - Autoregistration actions - for events when new active agents auto-register (or host metadata changes for registered ones) - Internal actions - for events when items become unsupported or triggers go into an unknown state #### Vista general Si voleu que es produeixin determinades operacions com a resultat d'esdeveniments (per exemple, notificacions enviades), heu de configurar accions. Les accions es poden establir en resposta a esdeveniments de tots els tipus compatibles: - Accions de triggers: per a esdeveniments quan l'estat del trigger canvia d'*OK* a *PROBLEMA* i viceversa - Accions de servei: per a esdeveniments quan l'estat del servei canvia d'*OK* a *PROBLEMA* i viceversa - Accions de descoberta: per a esdeveniments durant la descoberta de la xarxa - Accions de registre automàtic: per a esdeveniments quan es registren automàticament nous agents actius (o canvien les metadades de l'equip per als registrats) - Accions internes: per a esdeveniments quan els elements ja no s'admeten o els triggers passen a un estat desconegut #### Overview In a similar way as [file systems](/manual/discovery/low_level_discovery#configuring_low-level_discovery) are discovered, it is possible to also discover Windows services. #### Vista general Així com els [sistemes de fitxers](/manual/discovery/low_level_discovery#configuring_low-level_discovery) són descoberts, també es poden descobrir els serveis de Windows. #### Overview In message subjects and message text you can use macros for more efficient problem reporting. In addition to a number of built-in macros, [user macros](/manual/config/macros/user_macros) and [expression macros](/manual/config/macros/expression_macros) are also supported. A [full list of macros](/manual/appendix/macros/supported_by_location) supported by Zabbix is available. #### Vista general A l'assumpte dels missatges i al text, podeu emprar macros per informar de problemes més eficientment. A més d'una sèrie de macros integrades, també s'admeten [macros d'usuari](/manual/config/macros/user_macros) i [macros d'expressió](/manual/config/macros/expression_macros). Hi ha disponible una [llista sencera de macros](/manual/appendix/macros/supported_by_location) compatibles amb Zabbix. #### Overview In *Monitoring → Problems* you can see what problems you currently have. Problems are those triggers that are in the "Problem" state. {width="600"} |Column|Description| |--|-----------| |*Time*|Problem start time is displayed.| |*Severity*|Problem severity is displayed.<br>Problem severity is originally based on the severity of the underlying problem trigger, however, after the event has happened it can be updated using the *Update problem* [screen](/manual/acknowledges#updating_problems). Color of the problem severity is used as cell background during problem time.| |*Recovery time*|Problem resolution time is displayed.| |*Status*|Problem status is displayed:<br>**Problem** - unresolved problem<br>**Resolved** - recently resolved problem. You can hide recently resolved problems using the filter.<br>New and recently resolved problems blink for 2 minutes. Resolved problems are displayed for 5 minutes in total. Both of these values are configurable in *Administration* → *General* → *[Trigger displaying options](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*.| |*Info*|A green information icon is displayed if a problem is closed by global correlation or manually when updating the problem. Rolling a mouse over the icon will display more details:<br><br>The following icon is displayed if a suppressed problem is being shown (see *Show suppressed problems* option in the filter). Rolling a mouse over the icon will display more details:<br>| |*Host*|Problem host is displayed.| |*Problem*|Problem name is displayed.<br>Problem name is based on the name of the underlying problem trigger.<br>Macros in the trigger name are resolved at the time of the problem happening and the resolved values do not update any more.<br>*Note* that it is possible to append the problem name with [operational data](#operational_data_of_problems) showing some latest item values.<br>Clicking on the problem name brings up the [event menu](#event_menu).<br>Hovering on the  icon after the problem name will bring up the trigger description (for those problems that have it).| |*Operational data*|[Operational data](#operational_data_of_problems) are displayed containing latest item values.<br>Operational data can be a combination of text and item value macros if configured on a trigger level. If no operational data is configured on a trigger level, the latest values of all items from the expression are displayed.<br>This column is only displayed if *Separately* is selected for *Show operational data* in the filter.| |*Duration*|Problem duration is displayed.<br>See also: [Negative problem duration](#negative_problem_duration)| |*Ack*|The acknowledgment status of the problem is displayed:<br>**Yes** - green text indicating that the problem is acknowledged. A problem is considered to be acknowledged if all events for it are acknowledged.<br>**No** - a red link indicating unacknowledged events.<br>If you click on the link you will be taken to the [problem update](/manual/acknowledges#updating_problems) screen where various actions can be taken on the problem, including commenting and acknowledging the problem.| |*Actions*|History of activities about the problem is displayed using symbolic icons:<br> - comments have been made. The number of comments is also displayed.<br> - problem severity has been increased (e.g. Information → Warning)<br> - problem severity has been decreased (e.g. Warning → Information)<br> - problem severity has been changed, but returned to the original level (e.g. Warning → Information → Warning)<br> - actions have been taken. The number of actions is also displayed.<br> - actions have been taken, at least one is in progress. The number of actions is also displayed.<br> - actions have been taken, at least one has failed. The number of actions is also displayed.<br>When rolling the mouse over the icons, popups with details about the activity are displayed. See [viewing details](#Viewing_details) to learn more about icons used in the popup for actions taken.| |*Tags*|[Tags](/manual/config/tagging) are displayed (if any).<br>In addition, tags from an external ticketing system may also be displayed (see the *Process tags* option when configuring [webhooks](/manual/config/notifications/media/webhook)).| #### Vista general A *Monitoratge → Problemes* podeu veure els problemes que teniu actualment. Els problemes són desencadenants que es troben en l'estat "Problema". {width="600"} |Columna|Descripció| |--|------------| |*Hora*|Hora d'inici del problema.| |*Gravetat*|Gravetat del problema.<br>La gravetat del problema es basa inicialment en la gravetat del trigger del problema subjacent, però, un cop s'ha produït l'esdeveniment, es pot configurar per actualitzar-lo mitjançant [pantalla](/manual/acknowledges#updating_problems) *Problema d'actualització*. El color de la gravetat del problema s'empra com a fons de la cel·la durant el període del problema.| |*Temps de recuperació*|Temps de resolució del problema.| |*Estat*|Es mostra l'estat del problema:<br>**Problema** - problema no resolt<br>**Resolt** - problema acabat de resoldre. Podeu amagar els problemes resolts recentment mitjançant el filtre.<br>Els problemes nous i els que s'han resolt recentment parpellegen durant 2 minuts. Els problemes resolts es veuen durant un total de 5 minuts. Aquests dos valors es poden configurar a *Administració* → *General* → *[Opció de visualització del trigger](/manual/web_interface/frontend_sections/administration/general#trigger_displaying_options)*.| |*Informació*|Icona d'informació verda si un problema es tanca mitjançant una correlació global o manualment quan s'actualitza. Passeu el cursor per damunt de la icona per veure més detalls:<br> <br>El es mostra la icona següent si es mostra un problema esborrat (vegeu l'opció *Veure problemes suprimits* al filtre). Passeu el cursor per damunt de la icona per veure més detalls:<br>| |*Equip*|L'equip problemàtic.| |*Problema*|Nom del problema.<br>El nom del problema es basa en el nom del trigger del problema subjacent.<br>Les macros del nom del trigger es resolen en el moment en què es produeix el problema i els valors resolts ja no s'actualitzen.<br>*Tingueu en compte* que és possible afegir #operational_data_of_problems al nom del problema que mostra els valors de l'element més recents.<br> Si feu clic al nom del problema, apareixerà el [menú d'esdeveniments](#event_menu).<br>Passant el cursor per sobre de la icona  després del nom del problema apareixerà el trigger de la descripció (per a problemes que la tenen).| |*Dades operacionals*|[Dades operacionals](#operational_data_of_problems) es mostren amb els darrers valors d'element.<br>Les dades operacionals poden ser una combinació de macros de text i valor d'element si es configuren a nivell de trigger. Si no es configuren dades operatives al trigger, es mostren els darrers valors de tots els elements de l'expressió.<br>Aquesta columna només es mostra si es tria *Per separat* per a *Mostrar les dades operatives* al filtre.| |*Durada*|Durada del problema.<br>Veieu també: [Durada negativa del problema](#negative_problem_duration)| |*Reconegut*|Es mostra l'estat de reconeixement del problema:<br>**Sí** - text verd que indica que s'ha reconegut el problema. Es considera que s'ha reconegut un problema si es reconeixen tots els esdeveniments corresponents.<br>**No** - un enllaç vermell que indica esdeveniments no reconeguts.<br>Si feu clic a l'enllaç, se us redirigirà a [actualitzar el problema](/manual/acknowledges#updating_problems) on es poden realitzar diverses accions sobre el problema, com ara comentar i reconèixer el problema.| |*Accions*|L'historial d'activitats relacionades amb el problema es mostra mitjançant icones simbòliques:<br> - S'han fet comentaris. També es mostra el nombre de comentaris.<br> - la gravetat del problema ha augmentat (p. ex., Informació → Avís)<br>: la gravetat del problema s'ha reduït (p. ex., Avís → Informació)<br>: la gravetat del problema ha canviat, però torna al nivell original (p. ex., Avís → Informació → Avís)<br> - s'han fet accions. També es mostra el nombre d'accions.<br> - s'han dut a terme accions, almenys una és en curs. També es mostra el nombre d'accions.<br>: s'han dut a terme accions, almenys una ha fallat. També es mostra el nombre d'accions.<br>Quan passeu el cursor per sobre de les icones, apareixeran finestres emergents amb detalls de l'activitat. Veieu [detalls](#Viewing_details) per obtindre més informació sobre les icones emprades a la finestra emergent per a les accions realitzades.| |*Etiquetes*|Es mostren [etiquetes](/manual/config/tagging) (si escau).<br>A més, també es poden veure etiquetes d'un sistema de tiquets extern (vegeu l'opció *Processar* etiquetes en configurar [webhooks](/manual/config/notifications/media/webhook)).| #### Overview In order to provide monitoring for network devices such as switches and routers, we have created two so-called models: for the network device itself (its chassis basically) and for network interface. Since Zabbix 3.4 templates for many families of network devices are provided. All templates cover (where possible to get these items from the device): - Chassis fault monitoring (power supplies, fans and temperature, overall status) - Chassis performance monitoring (CPU and memory items) - Chassis inventory collection (serial numbers, model name, firmware version) - Network interface monitoring with IF-MIB and EtherLike-MIB (interface status, interface traffic load, duplex status for Ethernet) If the template is not available in your Zabbix installation, you may need to import the template's .yaml file first. See [Templates out of the box](/manual/config/templates_out_of_the_box) for details. If you are importing the new out-of-the-box templates, you may want to also update the `@Network interfaces for discovery` global regular expression to: Result is FALSE: ^Software Loopback Interface Result is FALSE: ^(In)?[lL]oop[bB]ack[0-9._]*$ Result is FALSE: ^NULL[0-9.]*$ Result is FALSE: ^[lL]o[0-9.]*$ Result is FALSE: ^[sS]ystem$ Result is FALSE: ^Nu[0-9.]*$ to filter out loopbacks and null interfaces on most systems. #### Vista general Per tal de proporcionar monitoratge de dispositius de xarxa com commutadors i encaminadors, hem creat dos models, anomenats: per al propi dispositiu de xarxa (el seu xassís bàsicament) i per a la interfície de xarxa. Des de Zabbix 3.4 es proporcionen plantilles per a moltes famílies de dispositius de xarxa. Totes les plantilles cobreixen (si és possible obtenir aquests elements del dispositiu): - Monitoratge d'errors del xassís (fontes d'alimentació, ventiladors i temperatura, estat general) - Monitoratge del rendiment del xassís (elements de CPU i memòria) - Col·lecció d'inventari del xassís (nombre de sèrie, nom del model, versió del firmware) - Monitoratge de la interfície de xarxa amb IF-MIB i EtherLike-MIB (estat de la interfície, càrrega de trànsit de la interfície, estat dúplex per Ethernet) Si la plantilla no és pas disponible a la instal·lació de Zabbix, potser cal que abans hagueu d'importar el fitxer .yaml de la plantilla. Veieu les [Plantilles predefinides](/manual/config/templates_out_of_the_box) per obtindre més informació. Si sou important les noves plantilles descobertes, és possible que també vulgueu actualitzar l'expressió regular global "@Network interfaces for discovery" a: El resultat és FALS: ^Interfície de bucle de programari El resultat és FALS: ^(En)?[lL]oop[bB]ack[0-9._]*$ El resultat és FALS: ^NULL[0-9.]*$ El resultat és FALS: ^[lL]o[0-9.]*$ El resultat és FALS: ^[sS]ystem$ El resultat és FALS: ^Nu[0-9.]*$ per filtrar els bucles i les interfícies nul·les a la majoria de sistemes. #### Overview In order to use any other language than English in Zabbix web interface, its locale should be installed on the web server. Additionally, the PHP gettext extension is required for the translations to work. #### Vista general Per emprar una altra llengua enlloc de l'anglès a la interfície Web de Zabbix, els paràmetres regionals s'han d'instal·lar al servidor Web. A més, l'extensió PHP gettext és necessària per al funcionament de les traduccions. #### Overview In *Reports → Availability report* you can see what proportion of time each trigger has been in problem/ok state. The percentage of time for each state is displayed. Thus it is easy to determine the availability situation of various elements on your system. {width="600"} From the drop-down in the upper right corner, you can choose the selection mode - whether to display triggers by hosts or by triggers belonging to a template. {width="600"} The name of the trigger is a link to the latest events of that trigger. #### Vista general A *Informes → Informe de temps d'activitat* podeu veure la proporció de temps que cada trigger ha estat en estat de problema/d'acord. Es mostra el percentatge de temps per a cada estat. Així, és fàcil determinar la situació de disponibilitat dels diferents elements del vostre sistema. {width="600"} A la llista desplegable de l'extrem superior dret, podeu triar el mode de selecció: si voleu mostrar triggers per equips o per triggers pertanyents a un model. {width="600"} El nom del trigger és un enllaç als darrers esdeveniments d'aquest trigger. #### Overview In *Reports → Scheduled reports*, users with sufficient permissions can configure scheduled generation of PDF versions of the dashboards, which will be sent by email to specified recipients. {width="600"} The opening screen displays information about scheduled reports, which can be filtered out for easy navigation - see [Using filter](#using_filter) section below. Displayed data: |Column|Description| |--|--------| |*Name*|Name of the report. Clicking it opens the report [configuration form](/manual/config/reports#configuration).| |*Owner*|User who created the report.| |*Repeats*|Report generation frequency (daily/weekly/monthly/yearly).| |*Period*|Period for which the report is prepared.| |*Last sent*|The date and time when the latest report has been sent.| |*Status*|Current status of the report (enabled/disabled/expired). Users with sufficient permissions can change the status by clicking it - from "Enabled" to "Disabled" (and back); from "Expired" to "Disabled" (and back). For users with insufficient rights, the status is not clickable.| |*Info*|Displays informative icons:<br>A red icon indicates that report generation has failed; hovering over it will display a tooltip with the error information.<br>A yellow icon indicates that a report was generated, but sending to some (or all) recipients has failed or that a report is expired; hovering over it will display a tooltip with additional information.| #### Vista general A *Informes → Informes programats*, els usuaris amb permisos suficients poden configurar la generació programada de versions PDF dels taulers de control, que s'enviaran per correu electrònic als destinataris triats. {width="600"} La pantalla inicial mostra informació sobre els informes programats, que es poden filtrar per facilitar la navegació; consulteu la secció [emprar el filtre](#using_filter) tot seguit. Dades ensenyades: |Columna|Descripció| |--|---------| |*Nom*|Nom de l'informe.| |*Propietari*|Usuari qui ha creat l'inform.e| |*Repetició*|Freqüència de generació d'informes (diària/setmanal/mensual/anual).| |*Període*|Període pel qual s'elabora l'informe.| |*Darrer enviament*|Data i hora del darrer informe enviat.| *|Estat*|Estat actual de l'informe (activat/desactivat/caducat). Els usuaris amb permisos suficients poden canviar l'estat fent-hi clic: d'"Activat" a "Inhabilitat" (i viceversa); de "Caducat" a "Inhabilitat" (i viceversa). Es mostra com a text per als usuaris amb drets insuficients.| |*Informació*|Mostra icones informatives:<br>Una icona vermella indica que la generació d'informes ha fallat; si passeu el cursor per sobre, es veurà una informació sobre eines amb la informació de l'error.<br>Una icona groga indica que s'ha generat un informe, però que el lliurament a alguns (o a tots) els destinataris ha fallat o un informe ha caducat; passant el cursor es veurà informació addicional sobre eines.| #### Overview In *Reports → System information*, a summary of key Zabbix server and system data is displayed. System data is collected using [internal items](/manual/config/items/itemtypes/internal). Note that in a high availability setup, it is possible to redirect the system information source (server instance). To do this, edit the *zabbix.conf.php* file - uncomment and set `$ZBX_SERVER` or both `$ZBX_SERVER` and `$ZBX_SERVER_PORT` to a server other than the one shown active. Note that when setting `$ZBX_SERVER` only, a default value (10051) for `$ZBX_SERVER_PORT` will be used. With the high availability setup enabled, a separate block is displayed below the system stats with details of high availability nodes. This block is visible to Zabbix *Super Admin* users only. *System information* is also available as a dashboard [widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets). #### Vista general A *Informes → Informació del sistema* es mostra un resum de les dades clau del sistema i del servidor Zabbix. La informació del sistema es recull emprant [elements interns](/manual/config/items/itemtypes/internal). Tingueu en compte que en una configuració d'alta disponibilitat és possible redirigir la font d'informació del sistema (instància del servidor). Per fer-ho, editeu el fitxer *zabbix.conf.php* - descomenteu i configureu `$ZBX_SERVER` o tots dos `$ZBX_SERVER` i `$ZBX_SERVER_PORT` a un servidor diferent del que es mostra actiu. Tingueu en compte que quan configureu només `$ZBX_SERVER`, s'emprarà un valor predeterminat (10051) per a `$ZBX_SERVER_PORT`. Amb la configuració d'alta disponibilitat habilitada, es mostra un bloc separat a sota de les estadístiques del sistema amb detalls dels nodes d'alta disponibilitat. Aquest bloc només és visible per als usuaris de Zabbix *Super Admin*. *La informació del sistema* també és disponible com a [giny](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets) del tauler de control. #### Overview In *Reports → Triggers top 100* you can see the triggers that have changed their state most often within the period of evaluation, sorted by the number of status changes. {width="600"} Both host and trigger column entries are links that offer some useful options: - for host - links to user-defined scripts, latest data, inventory, graphs, and dashboards for the host - for trigger - links to latest events, the trigger configuration form, and a simple graph **Using filter** You may use the filter to display triggers by host group, host, or trigger severity. Specifying a parent host group implicitly selects all nested host groups. For better search performance, data is searched with macros unresolved. The filter is located below the *100 busiest triggers* bar. It can be opened and collapsed by clicking on the *Filter* tab on the right. **Time period selector** The [time period selector](/manual/config/visualization/graphs/simple#time_period_selector) allows to select often required periods with one mouse click. The time period selector can be opened by clicking on the time period tab next to the filter. #### Vista general A *Informes → Els 100 triggers principals*, podeu veure els triggers que han canviat d'estat amb més freqüència durant el període d'avaluació, ordenats pel nombre de canvis d'estat. {width="600"} Les entrades de la columna d'equip i trigger són enllaços que proporcionen opcions útils: - per a l'equip: enllaços a scripts definits per l'usuari, dades més recents, inventari, gràfics i taulers de comandament per a l'equip - per al trigger: enllaços als darrers esdeveniments, el formulari de configuració del trigger i un gràfic senzill **Ús del filtre** Podeu emprar el filtre per veure triggers per grup d'equips, equip o gravetat del trigger. L'especificació d'un grup d'equips pare selecciona implícitament tots els grups d'equips heretats. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes. El filtre es troba sota la barra *100 triggers més actius*. Es pot obrir i replegar fent clic a la pestanya *Filtre* de la dreta. **Selector de període** El [selector de període de temps](/manual/config/visualization/graphs/simple#time_period_selector) permet triar períodes de temps sovint necessaris amb un clic del ratolí. El selector de període de temps es pot obrir fent clic a la pestanya de període de temps al costat del filtre. #### Overview Internal checks allow to monitor the internal processes of Zabbix. In other words, you can monitor what goes on with Zabbix server or Zabbix proxy. Internal checks are calculated: - on Zabbix server - if the host is monitored by server - on Zabbix proxy - if the host is monitored by proxy Internal checks are processed by server or proxy regardless of host maintenance status. To use this item, choose the **Zabbix internal** item type. ::: notetip Internal checks are processed by Zabbix pollers. ::: #### Vista general Els controls interns permeten monitorar els processos interns de Zabbix. En altres paraules, podeu monitorar allò que passa amb el servidor o proxy Zabbix. Els controls interns es calculen: - al servidor Zabbix - si l'equip es monitora amb ell - al proxy Zabbix - si l'equip es monitora amb ell els controls interns es tracten per el servidor o el proxy, independentment de l'estat de manteniment de l'equip. Per emprar aquest element, escolliu el tipus d'element **Zabbix Intern**. ::: notetip Les verificacions internes es tracten per els pollers Zabbix. ::: #### Overview In the action log widget, you can display details of action operations (notifications, remote commands). It replicates information from *Reports → Action log*. #### Vista general Al giny del registre d'accions, podeu veure els detalls de les operacions d'acció (notificacions, comandes remotes). Replica la informació d'*Informes → Auditoria*. #### Overview In the *Administration → Media types* section users can configure and maintain media type information. Media type information contains general instructions for using a medium as delivery channel for notifications. Specific details, such as the individual e-mail addresses to send a notification to are kept with individual users. A listing of existing media types with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the media type. Clicking on the name opens the media type [configuration form](/manual/config/notifications/media/email#configuration).| |*Type*|Type of the media (e-mail, SMS, etc) is displayed.| |*Status*|Media type status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| |*Used in actions*|All actions where the media type is used directly (selected in the *Send only to* dropdown) are displayed. Clicking on the action name opens the action configuration form.| |*Details*|Detailed information of the media type is displayed.| |*Actions*|The following action is available:<br>**Test** - click to open a testing form where you can enter media type parameters (e.g. a recipient address with test subject and body) and send a test message to verify that the configured media type works. See also: [Media type testing](/manual/config/notifications/media#media_type_testing).| To configure a new media type, click on the *Create media type* button in the top right-hand corner. To import a media type, click on the *Import* button in the top right-hand corner. #### Vista general A la secció *Administració → Tipus de suport*, els usuaris poden configurar i gestionar la informació dels tipus de suport. La informació del tipus de suport conté directrius generals per emprar els suports com a canal de lliurament de notificacions. Els detalls específics, com ara les adreces de correu electrònic individuals a les quals enviar notificacions, es conserven amb els usuaris individuals. Es mostra una llista dels tipus de suports existents amb els seus detalls. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom del tipus de suport. En fer clic al nom s'obre el [formulari de configuració](/manual/config/notifications/media/email#configuration) del tipus de suport.| |*Tipus*|Es mostra el tipus de suport (correu electrònic, SMS, etc.).| |*Estat*|Es mostra l'estat del tipus de suport: *Activat* o *Desactivat*.<br>Feu clic a l'estat per canviar-lo.| |*Emprar en accions*|Es mostren totes les accions on s'empra directament el tipus de suport (triades al menú desplegable *Enviar només a*). Si feu clic al nom de l'acció, s'obre el formulari de configuració de l'acció.| |*Detalls*|Es mostra informació detallada sobre el tipus de suport.| |*Acció*|L'acció següent és disponible:<br>**Prova** - feu clic per obrir un formulari de prova on podeu introduir paràmetres de tipus de suport (per exemple, una adreça de destinatari amb l'assumpte i el cos de la prova) i enviar un missatge de prova per verificar que el tipus de suport configurat funciona. Veieu també: [Prova de tipus de suport](/manual/config/notifications/media#media_type_testing).| Per configurar un nou tipus de suport, feu clic al botó *Crear un tipus de suport* a l'extrem superior dret. Per importar un tipus de suport, feu clic al botó *Importar* a l'extrem superior dret. #### Overview In the *Administration → Proxies* section proxies for [distributed monitoring](/manual/distributed_monitoring) can be configured in the Zabbix frontend. #### Vista general A la secció *Administració → Proxys*, els proxys per a [monitoratge distribuït](/manual/distributed_monitoring) es poden configurar a la interfície Zabbix. #### Overview In the *Administration → Queue* section items that are waiting to be updated are displayed. Ideally, when you open this section it should all be "green" meaning no items in the queue. If all items are updated without delay, there are none waiting. However, due to lacking server performance, some items may get delayed and the information is displayed in this section. For more details, see the [Queue](/manual/config/items/queue) section. ::: noteclassic The queue is available only if Zabbix server is running. Items are not counted in the queue if the item interface becomes unavailable due to connection problems or agent not working properly. ::: The *Administration → Queue* section contains the following pages: - Queue overview — displays queue by item type; - Queue overview by proxy — displays queue by proxy; - Queue details — displays a list of delayed items. The list of available pages appears upon pressing on *Queue* in the *Administration* menu section. It is also possible to switch between pages by using a title dropdown in the top left corner. | | | |---|---| |{width="300"}|{width="300"}| |Third-level menu.|Title dropdown.| #### Vista general A la secció *Administració → Cua*, es mostren els elements pendents d'actualitzar. Idealment, quan obriu aquesta secció, tot hauria d'ésser "verd", el que significa que no hi ha elements a la cua. Si tots els elements s'actualitzen sense demora, no n'hi ha cap de pendent. Tanmateix, a causa del rendiment insuficient del servidor, alguns elements poden endarrerir-se i es mostra informació en aquesta secció. Per obtindre més detalls, consulteu la secció [Cua](/manual/config/items/queue). :::noteclassic La cua només és disponible si el servidor Zabbix és en execució. Els elements no es compten a la cua si la interfície d'elements no és disponible degut a problemes de connexió o l'agent no funciona correctament. ::: La secció *Administració → Cua* conté les pàgines següents: - Visió general de la cua: mostra la cua per tipus d'element; - Vista prèvia de la cua per proxy: mostra la cua per proxy; - Detalls de la cua: mostra una llista d'elements endarrerits. La llista de pàgines disponibles apareix prement *Cua* a la secció del menú *Administració*. També és possible canviar entre pàgines mitjançant una llista desplegable de títols a la cantonada superior esquerra. | | | |---|---| |{width="300"}|{width="300"}| |Menú de tercer nivell.|Llista desplegable de títols.| #### Overview In the *Administration → Scripts* section user-defined global scripts can be configured and maintained. Global scripts, depending on the configured scope and also user permissions, are available for execution: - from the [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) in various frontend locations (*Dashboard*, *Problems*, *Latest data*, *Maps*, etc.) - from the [event menu](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) - can be run as an action operation The scripts are executed on Zabbix agent, Zabbix server (proxy) or Zabbix server only. See also [Command execution](/manual/appendix/command_execution). Both on Zabbix agent and Zabbix proxy, remote scripts are disabled by default. They can be enabled as follows: - For remote commands executed on Zabbix agent - by adding an AllowKey=system.run[<command>,\*] parameter for each allowed command in agent configuration, \* stands for wait and nowait mode. - For remote commands executed on Zabbix proxy - **Warning: It is not required to enable remote commands on Zabbix proxy if remote commands are executed on Zabbix agent that is monitored by Zabbix proxy.** If, however, it is required to execute remote commands on Zabbix proxy, set *EnableRemoteCommands* parameter to '1' in the proxy configuration. A listing of existing scripts with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the script. Clicking on the script name opens the script [configuration form](scripts#configuring_a_global_script).| |*Scope*|Scope of the script - action operation, manual host action or manual event action. This setting determines where the script is available.| |*Used in actions*|Actions where the script is used are displayed.| |*Type*|Script type is displayed - *Webhook*, *Script*, *SSH*, *Telnet* or *IPMI* command.| |*Execute on*|It is displayed whether the script will be executed on Zabbix agent, Zabbix server (proxy) or Zabbix server only.| |*Commands*|All commands to be executed within the script are displayed.<br>Nothing is displayed here for webhooks.| |*User group*|The user group that the script is available to is displayed (or *All* for all user groups).| |*Host group*|The host group that the script is available for is displayed (or *All* for all host groups).| |*Host access*|The permission level for the host group is displayed - *Read* or *Write*. Only users with the required permission level will have access to executing the script.| To configure a new script, click on the *Create script* button in the top right-hand corner. #### Vista general A la secció *Administració → Scripts*, es poden configurar i gestionar scripts globals definits per l'usuari. Els scripts globals, segons l'abast configurat i els permisos de l'usuari, són disponibles per a l'execució: - des del [menú de l'equip](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) a diverses ubicacions d'interfície (*Taulers de control*, *Problemes*, *Dades més recents*, *Mapes*, etc.) - des del [menú d'esdeveniments](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) - es pot executar com una operació d'acció Els scripts s'executen només a l'agent Zabbix, al servidor Zabbix (proxy) o al servidor Zabbix. Veieu també [Execució de comandes](/manual/appendix/command_execution). Els scripts remots de l'agent Zabbix i del proxy Zabbix són desactivats de manera predeterminada. Es poden activar mitjançant: - Comandes remotes executades a l'agent Zabbix - afegint un paràmetre AllowKey=system.run[<command>,\*] per a cada ordre autoritzada a la configuració de l'agent, \* representa el mode wait i nowait; - Comandes remotes executades al proxy Zabbix - **Avís: no cal habilitar comandes remotes al proxy Zabbix si s'executen comandes remotes a l'agent Zabbix monitorat pel proxy Zabbix.** Si, tanmateix, és necessari executar comandes remotes al proxy Zabbix, establiu el paràmetre *EnableRemoteCommands* a '1' a la configuració del proxy. Es mostra una llista dels scripts existents amb els seus detalls. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom de l'script. En fer clic al nom de l'script s'obre el [formulari de configuració] de l'script (scripts#configuring_a_global_script).| |*Àmbit*|Àmbit de l'script: operació d'acció, acció manual de l'equip o acció manual d'esdeveniments. Aquesta configuració determina on és disponible l'script.| |*S'empra en accions*|Es mostren les accions on s'empra l'script.| |*Tipus*|Es mostra el tipus d'script: comanda *Webhook*, *Script*, *SSH*, *Telnet* o *IPMI*.| |*Executar a*|Es mostra si l'script s'executarà només a l'agent Zabbix, al proxy Zabbix o al servidor Zabbix.| |*Comandes*|Es mostren totes les ordres que s'han d'executar a l'script.<br>No s'hi veurà res aquí per webhooks.| |*Grup d'usuaris*|Es mostra el grup d'usuaris per al qual està disponible l'script (o *Tot* per a tots els grups d'usuaris).| |*Grup d'equips*|Es mostra el grup d'equip per al qual està disponible l'script (o *Tot* per a tots els grups d'equip).| |*Accés a l'equip*|Es mostra el nivell de permís per al grup d'equip: *Llegir* o *Escriure*. Només els usuaris amb el nivell de permís necessari tindran accés per executar l'script.| Per configurar un script nou, feu clic al botó *Crea script* a l'extrem superior dret. #### Overview In the *Administration → User groups* section user groups of the system are maintained. #### Vista general A la secció *Administració → Grups d'usuaris* hiha el manteniment dels grups d'usuaris del sistema. #### Overview In the *Administration → User roles* section roles that can be assigned to system users and specific permissions for each role are maintained. #### Vista general A la secció *Administració → Rols d'usuari*, es mantenen els rols que es poden assignar als usuaris del sistema i els permisos específics per a cada funció. #### Overview In the *Administration → Users* section users of the system are maintained. #### Vista general A la secció *Administració → Usuaris* hi ha el manteniment dels usuaris del sistema. #### Overview In the classic graph widget, you can display a single custom graph or simple graph. #### Vista general Al giny de gràfic clàssic, podeu mostrar un gràfic personalitzat o un gràfic senzill. #### Overview In the clock widget, you may display local, server, or specified host time. #### Vista general Al giny del rellotge, podeu veure l'hora local, del servidor o d'un equip concret. #### Overview In the *Configuration → Actions* section users can configure and maintain actions. The actions displayed are actions assigned to the selected event source (trigger, discovery, autoregistration, internal actions). To switch to a different event source, click on *Actions* in the *Configuration* menu section. It is also possible to switch between sources by using the title dropdown in the top left corner. :::noteclassic Actions for services are maintained in a similar way in *Services → Service actions*. ::: For users without Super admin rights actions are displayed according to permission settings. That means in some cases a user without Super admin rights isn't able to view the complete action list because of certain permission restrictions. An action is displayed to the user without Super admin rights if the following conditions are fulfilled: - The user has read-write access to host groups, hosts, templates, and triggers in action conditions - The user has read-write access to host groups, hosts, and templates in action operations, recovery operations, and update operations - The user has read access to user groups and users in action operations, recovery operations, and update operations {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the action. Clicking on the action name opens the action [configuration form](/manual/config/notifications/action#configuring_an_action).| |*Conditions*|Action conditions are displayed.| |*[Operations](/manual/config/notifications/action/operation#configuring_an_operation)*|Action operations are displayed.<br>Since Zabbix 2.2, the operation list also displays the media type (e-mail, SMS or script) used for notification as well as the name and surname (in parentheses after the username) of a notification recipient.<br>Action operation can both be a [notification](/manual/config/notifications/action/operation/message) or a [remote command](/manual/config/notifications/action/operation/remote_command) depending on the selected type of operation.| |*Status*|Action status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.<br>See the [Escalations](/manual/config/notifications/action/escalations) section for more details as to what happens if an action is disabled during an escalation in progress.| To configure a new action, click on the *Create action* button in the top right-hand corner. #### Vista general A la secció *Configuració → Accions*, els usuaris poden configurar i gestionar accions. Les accions que es mostren són accions assignades a la font d'esdeveniment triada (trigger, descoberta, registre automàtic, accions internes). Per canviar a una font d'esdeveniments diferent, feu clic a *Accions* a la secció *Configuració* del menú. També es pot canviar entre fonts des del desplegable del títol a la cantonada superior esquerra. :::noteclassic Les accions dels serveis es mantenen de manera similar a *Serveis -> Accions de servei*. ::: | | | |---|---| |{width="300"}|{width="300"}| |Menú de tercer nivell.|Llista desplegable de títols.| Després de triar una subsecció, veureu una pàgina amb una llista d'accions existents amb els seus detalls. Per als usuaris sense drets de superadministrador, les accions es mostren en funció de la configuració dels permisos. Això vol dir que, en alguns casos, un usuari sense drets de superadministrador no pot veure la llista sencera d'accions a causa de determinades restriccions de permissos. Es mostra una acció a l'usuari sense drets de superadministrador si es compleixen les condicions següents: - L'usuari té accés de lectura i escriptura a grups d'equips, equips, plantilles i triggers en condicions d'acció - L'usuari té accés de lectura i escriptura a grups d'equips, equips i plantilles en operacions d'acció, operacions d'obtenció i operacions d'actualització - L'usuari té accés de lectura a grups d'usuaris i usuaris en operacions d'acció, operacions d'obtenció i operacions d'actualització :::noteclassic Les accions dels serveis es gestionen de manera similar a la secció de menú *Serveis->Accions de servei*. L'accés de l'usuari a accions de servei específiques depèn dels permisos de rol d'usuari establerts a la secció de menú *Accés al servei*. ::: {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom de l'acció. En fer clic al nom de l'acció s'obre el [formulari de configuració](/manual/config/notifications/action#configuring_an_action) de l'acció.| |*Condicions*|Condicions de l'acció.| |*[Operacions](/manual/config/notifications/action/operation#configuring_an_operation)*|Operacions d'acció.<br>Des de Zabbix 2.2, la llista d'operacions també mostra el tipus de suport (correu electrònic, SMS o script) s'empra per a la notificació i el nom i cognom (entre parèntesis després del nom d'usuari) d'un destinatari de notificació.<br>L'operació d'acció pot ser tant una [notificació](/manual/config/notifications/action/operation/message) com una [comanda remota](/manual/config/notifications/action/operation/remote_command) en funció del tipus d'operació triada.| |*Estat*|Es mostra l'estat de l'acció: *Activat* o *Desactivat*.<br>Feu clic a l'estat, podeu canviar-lo.<br>Consulteu les [Escalades](/manual/config/notifications /action/escalations ) per obtindre detalls sobre què passa si una acció es desactiva durant una escalada en curs.| Per configurar una acció nova, feu clic al botó *Crear una acció* a l'extrem superior dret. #### Overview In the *Configuration → Discovery* section users can configure and maintain discovery rules. A listing of existing discovery rules with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the discovery rule. Clicking on the discovery rule name opens the discovery rule [configuration form](/manual/discovery/network_discovery/rule).| |*IP range*|The range of IP addresses to use for network scanning is displayed.| |*Proxy*|The proxy name is displayed, if discovery is performed by the proxy.| |*Interval*|The frequency of performing discovery displayed.| |*Checks*|The types of checks used for discovery are displayed.| |*Status*|Action status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| To configure a new discovery rule, click on the *Create discovery rule* button in the top right-hand corner. #### Vista general A la secció *Configuració → Descoberta*, els usuaris poden configurar i gestionar les regles de descoberta. Es mostra un llistat de regles de descoberta existents amb els seus detalls. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom de la regla de descoberta. Si feu clic al nom de la regla, s'obre el [formulari de configuració](/manual/discovery/network_discovery/rule) de la regla de descoberta.| |*Interval IP*|Es mostra l'interval d'adreces IP que s'empraran per a l'exploració de la xarxa.| |*Proxy*|Es mostra el nom del proxy, si la descoberta la realitza.| |*Interval*|La freqüència d'execució de la descoberta mostrada.| |*Comprovacions*|Es mostren els tipus de comprovacions emprades per a la descoberta.| |*Estat*|Es mostra l'estat de l'acció - *Activada* o *Desactivada*.<br>Fent clic a l'estat el podeu canviar.| Per configurar una regla de descoberta nova, feu clic al botó *Crea una regla de descoberta* a l'extrem superior dret. #### Overview In the *Configuration → Event correlation* section users can configure and maintain global correlation rules for Zabbix events. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the correlation rule. Clicking on the correlation rule name opens the rule [configuration form](/manual/config/event_correlation/global#configuration).| |*Conditions*|Correlation rule conditions are displayed.| |*Operations*|Correlation rule operations are displayed.| |*Status*|Correlation rule status is displayed - *Enabled* or *Disabled*.<br>By clicking on the status you can change it.| To configure a new correlation rule, click on the *Create correlation* button in the top right-hand corner. #### Vista general A la secció *Configuració → Correlació d'esdeveniments*, els usuaris poden configurar i mantindre regles de correlació globals per als esdeveniments de Zabbix. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom de la regla de correlació. En fer clic al nom de la regla de correlació s'obre el [formulari de configuració](/manual/config/event_correlation/global#configuration) de la regla.| |*Condicions*|Es mostren les condicions de la regla de correlació.| |*Operacions*|Es mostren les operacions de la regla de correlació.| |*Estat*|Es mostra l'estat de la regla de correlació: *Activada* o *Desactivada*.<br>Fent clic a l'estat el podeu canviar.| Per configurar una nova regla de correlació, feu clic al botó *Crear una correlació* a l'extrem superior dret. #### Overview In the *Configuration → Host groups* section users can configure and maintain host groups. A host group can contain both templates and hosts. A listing of existing host groups with their details is displayed. You can search and filter host groups by name. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the host group. Clicking on the group name opens the host group [configuration form](/manual/config/hosts/host_groups#configuration).| |*Hosts*|Number of hosts in the group (displayed in gray). Clicking on "Hosts" will, in the whole listing of hosts, filter out those that belong to the group.| |*Templates*|Number of templates in the group (displayed in gray). Clicking on "Templates" will, in the whole listing of templates, filter out those that belong to the group.| |*Members*|Names of group members. Template names are displayed in gray, monitored host names in blue and non-monitored host names in red. Clicking on a name will open the template/host configuration form.| |*Info*|Error information (if any) regarding the host group is displayed.| #### Vista general A la secció *Configuració → Grups d'equips*, els usuaris poden configurar i gestionar grups d'equips. Un grup d'equips pot contindre plantilles i equips. Es mostra una llista dels grups d'equips existents amb els seus detalls. Podeu cercar i filtrar grups d'equips pel nom. {width="600"} Dades mostrades: |Columna|Descripció| |-------|------------| |*Nom*|Nom del grup d'equips. Si feu clic al nom del grup, s'obre el [formulari de configuració](/ca/manual/config/hosts/host_groups#configuration) per al grup d'equips.| |*Equips*|Nombre d'equips del grup (es mostra en gris). Fent clic a "Equips", a la llista completa d'equips, es filtraran els que pertanyen al grup.| |*Plantilles*|Nombre de plantilles del grup (visualitzat en gris). Fent clic a "Plantilles", a la llista completa de plantilles, aquestes es filtraran.| |*Membres*|Noms dels membres del grup. Els noms de les plantilles es mostren en gris, els noms d'equips monitorats en blau i els noms d'equips no monitorats en vermell. Si feu clic a un nom, s'obrirà el formulari de configuració del model/equip.| |*Info*|Errors (si n'hi ha) pel que fa al grup d'equips.| #### Overview In the *Configuration → Hosts* section users can configure and maintain hosts. A listing of existing hosts with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the host. Clicking on the host name opens the host [configuration form](/manual/config/hosts/host#configuration).| |*Entities (Items, Triggers, Graphs, Discovery, Web)*|Clicking on the entity name will display items, triggers etc. of the host. The number of the respective entities is displayed in gray.| |*Interface*|The main interface of the host is displayed.| |*Proxy*|Proxy name is displayed, if the host is monitored by a proxy.<br>This column is only displayed if the *Monitored by* filter option is set to 'Any' or 'Proxy'.| |*Templates*|The templates linked to the host are displayed. If other templates are contained in the linked template, those are displayed in parentheses, separated by a comma. Clicking on a template name will open its configuration form.| |*Status*|Host status is displayed - *Enabled* or *Disabled*. By clicking on the status you can change it.<br>An orange wrench icon  before the host status indicates that this host is in maintenance. Maintenance details are displayed when the mouse pointer is positioned over the icon.| |*Availability*|Host [availability](/manual/web_interface/frontend_sections/configuration/hosts#reading_host_availability) per configured interface is displayed.<br>Icons represent only those interface types (Zabbix agent, SNMP, IPMI, JMX) that are configured. If you position the mouse on the icon, a popup list of all interfaces of this type appears with each interface details, status and errors.<br>The column is empty for hosts with no interfaces.<br>The current status of all interfaces of one type is displayed by the respective icon color:<br>**Green** - all interfaces available<br>**Yellow** - at least one interface available and at least one unavailable; others can have any value including 'unknown'<br>**Red** - no interfaces available<br>**Gray** - at least one interface unknown (none unavailable)<br>Note that active Zabbix agent items do not affect host availability.| |*Agent encryption*|Encryption status for connections to the host is displayed:<br>**None** - no encryption<br>**PSK** - using pre-shared key<br>**Cert** - using certificate<br>| |*Info*|Error information (if any) regarding the host is displayed.| |*Tags*|[Tags](/manual/config/tagging) of the host, with macros unresolved.| To configure a new host, click on the *Create host* button in the top right-hand corner. To import a host from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. #### Vista general A la secció *Configuració → Equips*, els usuaris poden configurar i gestionar els equips. Es mostra un llistat dels equips existents amb els seus detalls. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom de l'equip. Si feu clic al nom d'equip, s'obre el [formulari de configuració](/manual/config/hosts/host#configuration) de l'equip.| |*Entitats (Elements, Triggers, Gràfics, Descoberta, Web)*|Fent clic al nom de l'entitat es mostraran els elements, triggers, etc. de l'equip. El nombre de les entitats respectives es mostra en gris.| |*Interfície*|Es mostra la interfície principal de l'equip.| |*Proxy*|El nom del proxy es mostra si l'equip és monitorat per un proxy.<br>Aquesta columna només es veu si l'opció de filtre *Monitorat per* és establerta a "Qualsevol" o "Proxy".| |*Plantilles*|Es mostren les plantilles enllaçades a l'equip. Si hi ha altres models al model enllaçat, aquests es mostren entre parèntesis, separats per una coma. Si feu clic al nom d'un model, s'obrirà el seu formulari de configuració.| |*Estat*|Es mostra l'estat de l'equip - *Activat* o *Desactivat*. Si feu clic a l'estat, podeu canviar-lo.<br>Una icona de clau anglesa carbassa abans que l'estat de l'equip vol dir que l'equip és en manteniment. Els detalls de manteniment es mostren quan el punter del ratolí es posa sobre la icona.| |*Disponibilitat*|[Disponibilitat](/manual/web_interface/frontend_sections/configuration/hosts#reading_host_availability) de l'equip per interfície configurada.<br>Les icones només representen els tipus d'interfície (agent Zabbix, SNMP, IPMI, JMX) que és configurada. Si passeu el ratolí per sobre de la icona, apareixerà una llista emergent de totes les interfícies d'aquest tipus amb els detalls, l'estat i els errors de cada interfície.<br>La columna és en blanc per als equips sense interfície.<br>L'estat actual de totes les interfícies d'un tipus es mostra amb el color de la icona corresponent:<br>**Verd** - totes les interfícies disponibles<br>**Groc** - almenys una interfície disponible i almenys una no disponible; altres poden tenir qualsevol valor, inclòs "desconegut"<br>**Vermell** - no hi ha interfície disponible<br>**Gris** - almenys una interfície desconeguda (cap no disponible)<br>Tingueu en compte que els elements actius de l'agent Zabbix no afecten la disponibilitat de l'equip.| |*Encriptació de l'agent*|Es mostra l'estat de xifrat de les connexions a l'equip:<br>**Cap** - sense xifrat<br>**PSK** - emprant la clau prèvia compartida<br>**Cert** - emprant certificat<br>| |*Informació*|Es mostra informació d'error (si n'hi ha) sobre l'equip.| |*Etiquetes*|[Etiquetes](/manual/config/tagging) de l'equip, amb macros no resoltes.| Per configurar un equip nou, feu clic al botó *Crear equip* a l'extrem superior dret. Per importar un equip des d'un fitxer YAML, XML o JSON, feu clic al botó *Importar* a l'extrem superior dret. #### Overview In the *Configuration → Maintenance* section users can configure and maintain maintenance periods for hosts. A listing of existing maintenance periods with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|--------| |*Name*|Name of the maintenance period. Clicking on the maintenance period name opens the maintenance period [configuration form](/manual/maintenance#configuration).| |*Type*|The type of maintenance is displayed: *With data collection* or *No data collection*| |*Active since*|The date and time when executing maintenance periods becomes active.<br>Note: This time does not activate a maintenance period; maintenance periods need to be set separately.| |*Active till*|The date and time when executing maintenance periods stops being active.| |*State*|The state of the maintenance period:<br>**Approaching** - will become active soon<br>**Active** - is active<br>**Expired** - is not active any more| |*Description*|Description of the maintenance period is displayed.| To configure a new maintenance period, click on the *Create maintenance period* button in the top right-hand corner. #### vista general A la secció *Configuració → Manteniment*, els usuaris poden configurar i gestionar els períodes de manteniment de l'equip. Es mostra un llistat dels períodes de manteniment existents amb els seus detalls. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Nom*|Nom del període de manteniment. En fer clic al nom del període de manteniment s'obre el [formulari de configuració](/manual/maintenance#configuration) del període de manteniment.| |*Tipus*|Es mostra el tipus de manteniment: *Amb recollida de dades* o *Sense recollida de dades*| |*Actiu des de*|La data i l'hora en què s'activa l'execució de la finestra de manteniment.<br>Nota: aquesta vegada no activa cap finestra de manteniment; els períodes de manteniment s'han de definir per separat.| |*Actiu fins a*|La data i l'hora en què l'execució dels períodes de manteniment deixa d'estar activa.| |*Estat*|L'estat del període de manteniment:<br>**S'apropa** - s'activarà aviat<br>**Actiu** - és actiu<br>**Caducat** - ja no és actiu| |*Descripció*|Es mostra la descripció del període de manteniment.| Per configurar una nova finestra de manteniment, feu clic al botó *Crear una finestra de manteniment* a l'extrem superior dret. #### Overview In the *Configuration → Templates* section users can configure and maintain templates. A listing of existing templates with their details is displayed. {width="600"} Displayed data: |Column|Description| |--|-----------| |*Name*|Name of the template. Clicking on the template name opens the template [configuration form](/manual/config/templates/template#creating_a_template).| |*Hosts*|Number of editable hosts to which the template is linked; read-only hosts are not included.<br>Clicking on *Hosts* will open the host list with only those hosts filtered that are linked to the template.| |*Entities (Items, Triggers, Graphs, Dashboards, Discovery, Web)*|Number of the respective entities in the template (displayed in gray). Clicking on the entity name will, in the whole listing of that entity, filter out those that belong to the template.| |*Linked templates*|Templates that are linked to the template, in a nested setup where the template will inherit all entities of the linked templates.| |*Linked to templates*|The templates that the template is linked to ("children" templates that inherit all entities from this template).<br>Since Zabbix 5.0.3, this column no longer includes hosts.| |*Tags*|[Tags](/manual/config/tagging) of the template, with macros unresolved.| To configure a new template, click on the *Create template* button in the top right-hand corner. To import a template from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. #### Vista general A la secció *Configuració → Plantilles*, els usuaris poden configurar i gestionar plantilles. Es mostra una llista de plantilles existents amb els seus detalls. {width="600"} Dades mostrades: |Columna|Descripció| |--|------------| |*Nom*|Nom del model. Si feu clic al nom de la plantilla, s'obre el [formulari de configuració](/manual/config/templates/template#creating_a_template) de la plantilla.| |*Hosts*|Nombre d'equips editables als quals és vinculada la plantilla; no s'inclouen els equips de només lectura.<br>Si feu clic a *Equips*, s'obrirà la llista d'equips amb només els equips filtrats que estan vinculats a la plantilla.| |*Entitats (elements, triggers, gràfics, taulers de control, descoberta, web)*|Nombre d'entitats respectives del model (mostrades en gris). Clicant sobre el nom de l'entitat es filtraran, a tota la llista d'aquesta entitat, les que pertanyen al model.| |*Models enllaçats*|Models enllaçats al model, en una configuració heretada on el model heretarà totes les entitats dels models enllaçats.| |*Enllaçat a models*|Els models als quals està enllaçat el model (models ("fills") que hereten totes les entitats d'aquest model).<br>A partir de Zabbix 5.0.3, aquesta columna ja no inclou els equips.| |*Etiquetes*|[Etiquetes](/manual/config/tagging) del model, amb macros no resoltes.| Per configurar una plantilla nova, feu clic al botó *Crear una plantilla* a l'extrem superior dret. Per importar una plantilla d'un fitxer YAML, XML o JSON, feu clic al botó *Importar* a l'extrem superior dret. #### Overview In the data overview widget, you can display the latest data for a group of hosts. The color of problem items is based on the problem severity color, which can be adjusted in the [problem update](/manual/acknowledges#updating_problems) screen. By default, only values that fall within the last 24 hours are displayed. This limit has been introduced with the aim of improving initial loading times for large pages of latest data. This limit is configurable in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, using the *Max history display period* option. Clicking on a piece of data offers links to some predefined graphs or latest values. Note that 50 records are displayed by default (configurable in *Administration* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, using the *Max number of columns and rows in overview tables* option). If more records exist than are configured to display, a message is displayed at the bottom of the table, asking to provide more specific filtering criteria. There is no pagination. Note that this limit is applied first, before any further filtering of data, for example, by tags. #### Vista general Al giny Visió general de dades, podeu veure les dades més recents d'un grup d'equips. El color dels elements del problema es basa en el color de la gravetat del problema, que es pot ajustar a la pantalla [actualitzar problemes](/manual/acknowledges#updating_problems). De manera predeterminada, només es mostren els valors de les darreres 24 hores. Aquest límit es va introduir per millorar els temps de càrrega inicials de les pàgines de dades grans més recents. Aquest límit es pot configurar a *Administració* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, emprant l'opció *Període màxim de visualització de l'historial*. Si feu clic a una dada, s'ofereix enllaços a gràfics predefinits o als valors més recents. Tingueu en compte que es mostren 50 registres per defecte (configurables a *Administració* → *General* → *[GUI](/manual/web_interface/frontend_sections/administration/general#gui)*, emprant el *Nombre màxim de columnes i fileres a la vista prèvia de les taules d'opcions*). Si hi ha més registres dels que s'han configurat per mostrar, apareix un missatge a la part inferior de la taula que demana que proporcioneu criteris de filtre més específics. No hi ha paginació. Tingueu en compte que aquest límit s'aplica primer, abans de qualsevol altre filtrat de les dades, per exemple, per etiquetes. #### Overview In the graph prototype widget, you can display a grid of graphs created from either a graph prototype or an item prototype by low-level discovery. #### Vista general Al giny de prototip de gràfic, podeu mostrar una graella de gràfics creats a partir d'un prototip de gràfic o d'un prototip d'element mitjançant una descoberta de baix nivell. #### Overview In the host availability widget, high-level statistics about host availability are displayed in four colored columns/lines. | | | |---|---| ||Horizontal display (columns).| ||Vertical display (lines).| Host availability in each column/line is counted as follows: - *Available* - hosts with all interfaces available - *Not available* - hosts with at least one interface unavailable - *Unknown* - hosts with at least one interface unknown (none unavailable) - *Total* - total of all hosts #### Vista general Al giny de disponibilitat de l'equip, les estadístiques d'alt nivell sobre la disponibilitat de l'equip es mostren en quatre columnes/fileres de colors. | | | |---|---| ||Visualització horitzontal (columnes) .| ||Visualització vertical (línies) .| La disponibilitat de l'equip a cada columna/filera es compta de la següent manera: - *Disponible* - equips amb totes les interfícies disponibles - *No disponible* - equips amb almenys una interfície no disponible - *Desconegut* - equips amb almenys una interfície desconeguda (cap no disponible) - *Total* - total de tots els equips #### Overview In the *Inventory → Hosts* section [inventory data](/manual/config/hosts/inventory) of hosts are displayed. You can filter the hosts by host group(s) and by any inventory field to display only the hosts you are interested in. {width="600"} To display all host inventories, press the "Reset" button. While only some key inventory fields are displayed in the table, you can also view all available inventory information for that host. To do that, click on the host name in the first column. #### Vista general A la secció *Inventari → Equips*, es mostren les [dades d'inventari](/manual/config/hosts/inventory) dels equips. Podeu filtrar els equips per grups d'equips i qualsevol camp d'inventari per veure només els equips que us interessen. {width="600"} Per veure tots els inventaris d'equips, premeu el botó "Reset". Tot i que a la taula només es mostren determinats camps d'inventari clau, també podeu veure tota la informació d'inventari disponible per a aquest equip. Per fer-ho, feu clic al nom d'equip a la primera columna. #### Overview In the map widget you can display either: - a single configured network map; - one of the configured network maps in the [map navigation tree](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree) (when clicking on the map name in the tree). #### Vista general Al giny del mapa, podeu veure: - Només s'ha configurat una targeta de xarxa - una de les targetes de xarxa configurades a l'[arbre de navegació del mapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/map_tree) quan feu clic al nom de la tarja a l'arbre. #### Overview In the *Monitoring → Discovery* section results of [network discovery](/manual/discovery/network_discovery) are shown. Discovered devices are sorted by the discovery rule. {width="600"} If a device is already monitored, the host name will be listed in the *Monitored host* column, and the duration of the device being discovered or lost after previous discovery is shown in the *Uptime/Downtime* column. After that follow the columns showing the state of individual services for each discovered device (red cells show services that are down). Service uptime or downtime is included within the cell. ::: noteimportant Only those services that have been found on at least one device will have a column showing their state. ::: #### Vista general A la secció *Monitoratge → Descoberta*, es veuen els resultats de [descoberta de xarxa](/manual/discovery/network_discovery). Els dispositius descoberts s'ordenen segons la regla de descoberta. {width="600"} Si ja s'ha monitorat un dispositiu, el nom de l'equip apareixerà a la columna *Equip monitorat* i la durada de la descoberta o pèrdua del dispositiu després de la descoberta anterior apareixerà a *Temps de funcionament/aturada*. Després d'això, seguiu les columnes que mostren l'estat del servei individual per a cada dispositiu descobert (els globus vermells indiquen que els serveis són inactius). La disponibilitat o indisponibilitat del servei s'inclou a la cel·la. ::: noteimportant Només els serveis que s'hagin trobat en almenys un dispositiu tindran una columna que mostra el seu estat. ::: #### Overview In the *Monitoring → Maps* section you can configure, manage and view [network maps](/manual/config/visualization/maps). When you open this section, you will either see the last map you accessed or a listing of all maps you have access to. All maps can be either public or private. Public maps are available to all users, while private maps are accessible only to their owner and the users the map is shared with. #### Vista general A la secció *Monitoratge → Mapes*, podeu configurar, gestionar i visualitzar [mapes de xarxa](/manual/config/visualization/maps). Quan obriu aquesta secció, veureu el darrer mapa al qual heu accedit o una llista de tots els mapes als quals teniu accés. Totes les targes poden ser públiques o privades. Els mapes públics són disponibles per a tots els usuaris, mentre que els mapes privats només són disponibles per al seu propietari i per als usuaris amb qui es comparteix el mapa. #### Overview In the plain text widget, you can display the latest item data in plain text. #### Vista general Al giny de text pla, podeu veure la darrera informació de l'element en text pla. #### Overview In the problem host widget, you can display high-level information about host availability. #### Vista general Al giny d'equips amb problemes, podeu veure informació d'alt nivell sobre la disponibilitat dels equips. #### Overview In the Reports → Action log section users can view details of operations (notifications, remote commands) executed within an action. {width="600"} Displayed data: |Column|Description| |--|--------| |*Time*|Timestamp of the operation.| |*Action*|Name of the action causing operations is displayed.| |*Type*|Operation type is displayed.| |*Recipient(s)*|Username, name, surname (in parentheses) and e-mail address of the notification recipient is displayed.| |*Message*|The content of the message, remote command or global script name is displayed.<br>A remote command is separated from the target host with a colon symbol: `<host>:<command>`. If the remote command is executed on Zabbix server, then the information has the following format: `Zabbix server:<command>`| |*Status*|Operation status is displayed:<br>*In progress* - action is in progress<br>For actions in progress the number of retries left is displayed - the remaining number of times the server will try to send the notification.<br>*Sent* - notification has been sent<br>*Executed* - command has been executed<br>*Not sent* - action has not been completed.| |*Info*|Error information (if any) regarding the action execution is displayed.| **Using filter** You may use the filter to narrow down the records by the message recipient(s). For better search performance, data is searched with macros unresolved. The filter is located below the *Action log* bar. It can be opened and collapsed by clicking on the *Filter* tab on the right. **Time period selector** The [time period selector](/manual/config/visualization/graphs/simple#time_period_selector) allows to select often required periods with one mouse click. The time period selector can be opened by clicking on the time period tab next to the filter. #### Vista general A la secció Informes → Registre d'accions, els usuaris poden veure els detalls de les operacions (notificacions, comandes remotes) fetes dins d'una acció. {width="600"} Dades mostrades: |Columna|Descripció| |--|---------| |*Hora*|Marca de temps de l'operació.| |*Acció*|Es mostra el nom de l'acció que ha provocat les operacions.| |*Tipus*|Es mostra el tipus d'operació - *Correu electrònic* o *Comanda*.| |*Destinatari(s)*|Es mostren el nom d'usuari, el cognom, el nom (entre parèntesis) i l'adreça de correu electrònic del destinatari de la notificació.| |*Missatge*|Es mostra el contingut del missatge, de la comanda remota o de l'script global.<br>Una comanda remota és separada de l'equip de destinació per dos punts: `<host>:<command>`. Si la comanda remota s'executa al servidor Zabbix, la informació té el format següent: `Servidor Zabbix:<command>`| |*Estat*|Es mostra l'estat de l'operació:<br>*En curs* - l'acció és en curs<br>Per a les accions en curs, es mostra el nombre d'intents restants - el nombre d'intents restants del servidor per enviar la notificació.<br>*Enviat* - la notificació s'ha enviat<br>*Executat* - la comanda s'ha executat<br>*No enviat* - l'acció no s'ha completat.| |*Info*|Es mostra informació d'error (si n'hi ha) pel que fa a l'execució de l'acció.| **Ús del filtre** Podeu emprar el filtre per restringir els registres per destinataris del missatge. Per obtindre un millor rendiment de la cerca, les dades es cerquen amb macros no resoltes. El filtre es troba sota la barra *Registre d'accions*. Es pot obrir i replegar fent clic a la pestanya *Filtre* de la dreta. **Selector de període** El [selector de període de temps](/manual/config/visualization/graphs/simple#time_period_selector) permet seleccionar períodes de temps sovint necessaris amb un clic del ratolí. El selector de període de temps es pot obrir fent clic a la pestanya de període de temps al costat del filtre.