en-us	# 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 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 JMX interface set up.\ If the template is not available in your Zabbix installation, you may need to import the template's .xml 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 sharing data with Zabbix.  A detailed description of a template, including the full list of macros, items and triggers is available in the template's Readme.md file (accessible by clicking on a template name).   The following templates are available:  -   [Apache ActiveMQ by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0)
ca	# 5 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 .xml 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 by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/activemq_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Apache Cassandra by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/cassandra_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Apache Kafka by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/kafka_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Apache Tomcat by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/tomcat_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [GridGain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/gridgain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Ignite by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/ignite_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Jira Data Center by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/jira_datacenter_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [WildFly Domain by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_domain_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [WildFly Server by JMX](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/app/wildfly_server_jmx/README.md?at=refs%2Fheads%2Frelease%2F7.0)

en-us	# 5 Large file support  Large file support, often abbreviated to LFS, is the term applied to the ability to work with files larger than 2 GB on 32-bit operating systems. Support for large files affects at least [log file monitoring](/manual/config/items/itemtypes/log_items) and all [vfs.file.\* items](/manual/config/items/itemtypes/zabbix_agent#vfs.file.cksumfilemode). 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.
ca	# 5 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. El suport de fitxers grans afecta, com a mínim, el [monitoratge de l'arxiu de registre](/manual/config/items/itemtypes/log_items) i tots els [elements vfs.file.\*](/manual/config/items/itemtypes/zabbix_agent#vfs.file.cksumfilemode). 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.

en-us	# 5 Low-level discovery macros
ca	# 5 Macros de descoberta de baix nivell

en-us	# 5 Mac OS agent installation from PKG
ca	# 5 Instal·lació de l'agent Mac OS des de PKG

en-us	# 5 Maintenance
ca	# 5 Manteniment

en-us	##### 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. :::
ca	##### 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. :::

en-us	# 5 Modbus plugin
ca	# 5 Plugin Modbus

en-us	# 5 Monitor VMware with Zabbix
ca	# 5 Monitorar VMware amb Zabbix

en-us	 5\. Navigate to the Zabbix agent home directory (if it does not exist on your system, you need to create it; default: */var/lib/zabbix*).      cd /var/lib/zabbix  6\. Create a *.my.cnf* file in the Zabbix agent home directory.      vi .my.cnf  7\. Copy the following contents to the *.my.cnf* file (replace *<password>* with the password of the "zbx_monitor" user).      [client]     user='zbx_monitor'     password='<password>'
ca	 5\. Navegueu al directori inicial de l'agent Zabbix (si no existeix al vostre sistema, heu de crear-lo; per defecte: */var/lib/zabbix*).       cd /var/lib/zabbix  6\. Creeu un fitxer *.my.cnf* al directori inicial de l'agent Zabbix.       vi .my.cnf  7\. Copieu el contingut següent al fitxer *.my.cnf* (substituïu *<password>* per el mot de pas de l'usuari "zbx_monitor").      [client]     user='zbx_monitor'     password='<password>'

en-us	# 5 Network maps
ca	# 5 Mapes de xarxa

en-us	# 5 Notes on low-level discovery
ca	# 5 Notes sobre la descoberta de baix nivell

en-us	# 5 Proxy groups
ca	# 5 Grups de proxys

en-us	# 5 Quickstart  Please use the sidebar to access content in the Quickstart section.
ca	# 5. Inici ràpid  Empreu la barra lateral per accedir al contingut de la secció d'Inici ràpid.

en-us	# 5 Receiving problem notification
ca	# 5 Rebre una notificació de problema

en-us	# 5 Reports
ca	# 5 Informes

en-us	##### 5 Review server configuration parameters  Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are required.  For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page.
ca	##### 5 Reviseu els paràmetres de configuració del servidor  Assegureu-vos de revisar les [Notes d'actualització](/manual/installation/upgrade_notes_700) 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/whatsnew700).

en-us	# 5 Secure connection to the database
ca	# 5 Assegurar la connexió a la base de dades

en-us	# 5 Simple checks
ca	# 5 Verificacions simples

en-us	##### 5 Start new Zabbix agent  Start the new Zabbix agent. Check log files to see if the agent has started successfully.
ca	##### 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.

en-us	##### 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).
ca	##### 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).

en-us	# 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 time-based) 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)  The functions are listed without additional information. Click on the function to see the full details.  |Function|Description| |--|--------| |[baselinedev](#baselinedev)|Returns the number of deviations (by stddevpop algorithm) between the last data period and the same data periods in preceding seasons.| |[baselinewma](#baselinewma)|Calculates the baseline by averaging data from the same timeframe in multiple equal time periods ('seasons') using the weighted moving average algorithm.| |[trendavg](#trendavg)|The average of trend values within the defined time period.| |[trendcount](#trendcount)|The number of successfully retrieved trend values within the defined time period.| |[trendmax](#trendmax)|The maximum in trend values within the defined time period.| |[trendmin](#trendmin)|The minimum in trend values within the defined time period.| |[trendstl](#trendstl)|Returns the rate of anomalies during the detection period - a decimal value between 0 and 1 that is `((the number of anomaly values)/(total number of values))`.| |[trendsum](#trendsum)|The sum of trend values within the defined time period.|
ca	# 5 Funcions de tendència  Les funcions de tendència, a diferència de les [funcions d'històric](/manual/appendix/functions/history), empren dades de [tendències](/manual/config/items/history_and_trends#keeping-trends) per als càlculs.  Les tendències emmagatzemen valors afegits per hora. Les funcions de tendència empren aquestes mitjanes horàries i, per tant, són útils per anàlisi a llarg termini.  Els resultats de la funció de tendència s'emmagatzemen a la memòria cau, de manera que diverses crides a la mateixa funció amb els mateixos paràmetres obtindran informació de la base de dades només un cop. La memòria cau de la funció de tendència és controlada per el paràmetre del servidor [TrendFunctionCacheSize](/manual/appendix/config/zabbix_server).  Els triggers que fan referència a les funcions de tendència **només** s'avaluen una vegada per període de temps més petit a l'expressió. Per exemple, un trigger com ara       trendavg(/host/key,1d:now/d) > 1 o trendavg(/host/key2,1w:now/w) > 2  s'avaluarà un cop al dia. Si el trigger conté funcions de tendència i d'historial (o basades en el temps), es calcula segons els [principis habituals](/manual/config/triggers#calculation-time).  Totes les funcions listades aquí són compatibles amb:  - [Expressions trigger](/manual/config/triggers/expression) - [Elements calculats](/manual/config/items/itemtypes/calculated)  Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.  |Funció|Descripció| |--|---------| |[baselinedev](#baselinedev)|Retorna el nombre de desviacions (per algorisme stddevpop) entre el darrer període de dades i els mateixos períodes de dades de les temporades anteriors.| |[baselinewma](#baselinewma)|Calcula la línia de base fent la mitjana de les dades del mateix període de temps en diversos períodes de temps iguals ('temporades') mitjançant l'algorisme de mitjana mòbil ponderada.| |[trendavg](#trendavg)|Mitjana dels valors de tendència dins del període de temps definit.| |[trendcount](#trendcount)|Nombre de valors de tendència recuperats correctament durant el període de temps definit.| |[trendmax](#trendmax)|Màxim dels valors de tendència dins del període de temps definit.| |[trendmin](#trendmin)|Mínim en valors de tendència dins del període de temps definit.| |[trendstl](#trendstl)|Retorna la taxa d'anomalies durant el període de detecció: un valor decimal entre 0 i 1 que és `((el nombre de valors d'anomalia)/(nombre total de valors))`.| |[trendsum](#trendsum)|Suma dels valors de tendència dins del període de temps definit.|

en-us	##### 5 Upgrade Zabbix components  To upgrade Zabbix components you may run something like:      apt-get 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` 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). :::  Then, to upgrade the web frontend with Apache correctly, also run:      apt-get install zabbix-apache-conf
ca	##### 5 Actualització dels components de Zabbix  Per actualitzar els components de Zabbix, podeu executar:       apt-get 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 de Zabbix, substituïu `zabbix-agent` per `zabbix-agent2` a l'ordre.  ::: noteimportant Actualitzar l'agent 2 de Zabbix 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). :::  Tot seguit, actualitzeu la interfície web amb Apache, executant:       # apt-get install zabbix-apache-conf

en-us	##### 5 Upgrade Zabbix components  To upgrade Zabbix components you may run something like:      dnf 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.  ::: 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). :::  To upgrade the web frontend with Apache **on RHEL 8** correctly, also run:      dnf install zabbix-apache-conf 
ca	##### 5 Actualitzar els components de Zabbix  Per actualitzar els components de Zabbix, podeu fer-ho executant:       dnf upgrade 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` 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). :::  Per actualitzar correctament la interfície web amb Apache **a RHEL 8**, executeu també:      dnf install zabbix-apache-conf

en-us	# 5 User parameters
ca	# 5 Paràmetres d'usuari

en-us	# 5 Web scenarios
ca	# 5 Escenaris web

en-us	# 5 Web scenarios
ca	# 5 Escenaris web

en-us	# 5 What's new in Zabbix 7.0.0  See [breaking changes](/manual/installation/upgrade_notes_700#breaking_changes) for this version.
ca	# 5 Què hi ha de nou al Zabbix 7.0.0  Veieu els [canvis més importants](/manual/installation/upgrade_notes_700#breaking_changes) per a aquesta versió.

en-us	# 5 Zabbix agent (Windows)
ca	# 5 Zabbix agent (Windows)

en-us	# 5 Zabbix sender protocol
ca	# 5 Protocol del sender de Zabbix

en-us	##### 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.  :::
ca	##### 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. :::

en-us	# 6 Action log
ca	# 6 Registre d'accions

en-us	# 6 CSV to JSON preprocessing
ca	# 6 Preprocessament CSV cap a JSON

en-us	# 6 Data collection
ca	# 6 Recollida de dades

en-us	# 6 Discovery of JMX objects
ca	# 6 Descoberta d'objectes JMX

en-us	 # 6 Discovery rules  Please use the sidebar to see discovery rule configuration examples for various cases.
ca	# 6 Regles de descoberta  Utilitzeu la barra lateral per veure exemples de configuració de regles de descoberta per a diferents casos.

en-us	# 6 Event correlation
ca	# 6 Correlació d'esdeveniments

en-us	# 6 Expression macros
ca	# 6 Macros d'expressió

en-us	# 6 Favorite maps
ca	# 6 Mapes preferits

en-us	# 6 Favorite maps
ca	# 6 Mapes preferits

en-us	# 6 Header
ca	# 6 Capçalera

en-us	# 6 Installation from containers
ca	# 6 Instal·lació des de contenidors

en-us	# 6 Log file monitoring
ca	# 6 monitoratge de l'arxiu de registre

en-us	# 6 Macros
ca	# 6 Macros

en-us	# 6 Mass update
ca	# 6 Actualització massiva

en-us	# 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.  The functions are listed without additional information. Click on the function to see the full details.  |Function|Description| |--|--------| |[abs](#abs)|The absolute value of a value.| |[acos](#acos)|The arccosine of a value as an angle, expressed in radians.| |[asin](#asin)|The arcsine of a value as an angle, expressed in radians.| |[atan](#atan)|The arctangent of a value as an angle, expressed in radians.| |[atan2](#atan2)|The arctangent of the ordinate (value) and abscissa coordinates specified as an angle, expressed in radians.| |[avg](#avg)|The average value of the referenced item values.| |[cbrt](#cbrt)|The cube root of a value.| |[ceil](#ceil)|Round the value up to the nearest greater or equal integer.| |[cos](#cos)|The cosine of a value, where the value is an angle expressed in radians.| |[cosh](#cosh)|The hyperbolic cosine of a value.| |[cot](#cot)|The cotangent of a value, where the value is an angle expressed in radians.| |[degrees](#degrees)|Converts a value from radians to degrees.| |[e](#e)|The Euler's number (2.718281828459045).| |[exp](#exp)|The Euler's number at a power of a value.| |[expm1](#expm1)|The Euler's number at a power of a value minus 1.| |[floor](#floor)|Round the value down to the nearest smaller or equal integer.| |[log](#log)|The natural logarithm.| |[log10](#log10)|The decimal logarithm.| |[max](#max)|The highest value of the referenced item values.| |[min](#min)|The lowest value of the referenced item values.| |[mod](#mod)|The division remainder.| |[pi](#pi)|The Pi constant (3.14159265358979).| |[power](#power)|The power of a value.| |[radians](#radians)|Converts a value from degrees to radians.| |[rand](#rand)|Return a random integer value.| |[round](#round)|Round the value to decimal places.| |[signum](#signum)|Returns '-1' if a value is negative, '0' if a value is zero, '1' if a value is positive.| |[sin](#sin)|The sine of a value, where the value is an angle expressed in radians.| |[sinh](#sinh)|The hyperbolical sine of a value, where the value is an angle expressed in radians.| |[sqrt](#sqrt)|The square root of a value.| |[sum](#sum)|The sum of the referenced item values.|  |[tan](#tan)|The tangent of a value.| |[truncate](#truncate)|Truncate the value to decimal places.|
ca	# 6 Funcions matemàtiques  Totes les funcions enumerades aquí són compatibles amb:  - [Expressions triggers](/manual/config/triggers/expression) - [Elements calculats](/manual/config/items/itemtypes/calculated)  Les funcions matemàtiques s'admeten amb tipus de valor flotant i enter, llevat que s'indiqui el contrari.  Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.  |Funció|Descripció| |--|---------| |[abs](#abs)|Valor absolut d'un valor.| |[acos](#acos)|Arcosinus d'un valor com a angle, expressat en radians.| |[asin](#asin)|Arcseu d'un valor com a angle, expressat en radians.| |[atan](#atan)|Arctangent d'un valor com a angle, expressat en radians.| |[atan2](#atan2)|Arctangent de l'ordenada (valor) i les coordenades d'abscissa especificades com a angle, expressada en radians.| |[mitjana](#avg)|Valor mitjà dels valors dels elements de referència.| |[cbrt](#cbrt)|Arrel cúbica d'un valor.| |[ceil](#ceil)|Arrodoneix el valor a l'enter més proper o igual.| |[cos](#cos)|Cosinus d'un valor, on el valor és un angle expressat en radians.| |[cosh](#cosh)|Cosinus hiperbòlic d'un valor.| |[cot](#cot)|Cotangent d'un valor, on el valor és un angle expressat en radians.| |[graus](#graus)|Converteix un valor de radians a graus.| |[e](#e)|Nombre d'Euler (2.718281828459045).| |[exp](#exp)|Nombre d'Euler a una potència d'un valor.| |[expm1](#expm1)|Nombre d'Euler a una potència d'un valor menys 1.| |[floor](#floor)|Arrodoneix el valor al nombre enter més petit o igual més proper.| |[log](#log)|Logaritme natural.| |[log10](#log10)|Logaritme decimal.| |[max](#max)|Valor més alt dels valors de l'element referenciat.| |[min](#min)|Valor més baix dels valors dels elements de referència.| |[mod](#mod)|Resta de la divisió.| |[pi](#pi)|Constant Pi (3,14159265358979).| |[power](#power)|Poder d'un valor.| |[radians](#radians)|Converteix un valor de graus a radians.| |[rand](#rand)|Retorna un valor enter aleatori.| |[round](#round)|Arrodoneix el valor a decimals.| |[signum](#signum)|Retorna '-1' si un valor és negatiu, '0' si un valor és zero, '1' si un valor és positiu.| |[sin](#sin)|Sinus d'un valor, on el valor és un angle expressat en radians.| |[sinh](#sinh)|Sinus hiperbòlic d'un valor, on el valor és un angle expressat en radians.| |[sqrt](#sqrt)|Arrel quadrada d'un valor.| |[sum](#sum)|Suma dels valors dels elements de referència.| |[tan](#tan)|Tangent d'un valor.| |[truncate](#truncate)|Trunca el valor a decimals.|

en-us	# 6 Media types
ca	# 6 Tipus de suport

en-us	# 6 MongoDB plugin
ca	# 6 Plugin MongoDB

en-us	# 6 Monitor network traffic with Zabbix
ca	# 6 Monitorar el trànsit de xarxa amb Zabbix

en-us	# 6 New template
ca	# 6 Plantilla nova

en-us	# 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 .xml 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 sharing data with Zabbix.  A detailed description of a template, including the full list of macros, items and triggers is available in the template's Readme.md file (accessible by clicking on a template name).   The following templates are available:  -   [MSSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0)
ca	# 6 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 .xml 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 by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mssql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [MySQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [Oracle by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/oracle_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0) -   [PostgreSQL by ODBC](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/postgresql_odbc/README.md?at=refs%2Fheads%2Frelease%2F7.0)

en-us	# 6 Page parameters
ca	# 6 Paràmetres de la pàgina

en-us	##### 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. :::
ca	##### 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. :::

en-us	##### 6 Review component configuration parameters  Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are required.  For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page.
ca	##### 6 Reviseu els paràmetres de configuració dels components  Assegureu-vos de revisar les [Notes d'actualització](/manual/installation/upgrade_notes_700) 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/whatsnew700).

en-us	##### 6 Review component configuration parameters  Make sure to review [Upgrade notes](/manual/installation/upgrade_notes_700) to check if any changes in the configuration parameters are required.  For new optional parameters, see the [What's new](/manual/introduction/whatsnew700) page.
ca	##### 6 Reviseu els paràmetres de configuració dels components  Assegureu-vos de revisar les [Notes d'actualització](/manual/installation/upgrade_notes_700) 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/whatsnew700).

en-us	# 6 Sender
ca	# 6 Sender

en-us	# 6 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).
ca	# 6 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, situat dins dels 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>\_<item>, on  - **tipus** - per als xips de sensor és "in" (tensió), "temp" (temperatura), "ventilador" (ventilador), etc., - **element** - "entrada" (valor mesurat), "màx" (llindar alt), "mínim" (llindar baix), etc., - **nombre** - sempre s'empra per als elements que poden ser 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 són necessaris 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 ser diferent de l'esquema de noms comú (<tipus><nombre>\_<element>):  - si hi ha un fitxer anomenat <tipus><nombre>\_label, s'emprarà l'etiqueta dins d'aquest fitxer en lloc de <tipus><nombre><element> nom; - si no hi ha cap fitxer <tipus><nombre>\_label, el programa cerca dins del fitxer /etc/sensors.conf (també podria ser /etc/sensors3.conf, o diferent) per la substitució de nom.  Aquest etiquetatge permet a l'usuari determinar quin tipus de maquinari s'empra. Si no hi ha ni <tipus><nombre>\_label ni 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 accepta zabbix\_agent, es poden obtenir executant el programa **sensors** amb el paràmetre -u (**sensors -u**).  Al programa **sensor**, els sensors disponibles estan separats pel tipus de bus (adaptador ISA, adaptador PCI, adaptador SPI, dispositiu virtual, interfície ACPI, adaptador HID).

en-us	##### 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.
ca	##### 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.

en-us	# 6 Supported functions  Click on the respective function group to see more details.  |Function group|<|Functions| |-|----------|----------------------------------------| |[Aggregate functions](/manual/appendix/functions/aggregate)|<|avg, bucket\_percentile, count, histogram\_quantile, item\_count, kurtosis, mad, max, min, skewness, stddevpop, stddevsamp, sum, sumofsquares, varpop, varsamp| ||[Foreach functions](/manual/appendix/functions/aggregate/foreach)|avg\_foreach, bucket\_rate\_foreach, count\_foreach, exists\_foreach, last\_foreach, max\_foreach, min\_foreach, sum\_foreach| |[Bitwise functions](/manual/appendix/functions/bitwise)|<|bitand, bitlshift, bitnot, bitor, bitrshift, bitxor| |[Date and time functions](/manual/appendix/functions/time)|<|date, dayofmonth, dayofweek, now, time| |[History functions](/manual/appendix/functions/history)|<|change, changecount, count, countunique, find, first, fuzzytime, last, logeventid, logseverity, logsource, monodec, monoinc, nodata, percentile, rate| |[Trend functions](/manual/appendix/functions/trends)|<|baselinedev, baselinewma, trendavg, trendcount, trendmax, trendmin, trendstl, trendsum| |[Mathematical functions](/manual/appendix/functions/math)|<|abs, acos, asin, atan, atan2, avg, cbrt, ceil, cos, cosh, cot, degrees, e, exp, expm1, floor, log, log10, max, min, mod, pi, power, radians, rand, round, signum, sin, sinh, sqrt, sum, tan, truncate| |[Operator functions](/manual/appendix/functions/operator)|<|between, in| |[Prediction functions](/manual/appendix/functions/prediction)|<|forecast, timeleft| |[String functions](/manual/appendix/functions/string)|<|ascii, bitlength, bytelength, char, concat, insert, jsonpath, left, length, ltrim, mid, repeat, replace, right, rtrim, trim, xmlxpath|  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).
ca	# 6 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 data 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).

en-us	# 6 Tagging
ca	# 6 Etiquetat

en-us	# 6 TimescaleDB setup
ca	# 6 Configuració TimescaleDB

en-us	# 6 Unstable releases
ca	# 6 Versions inestables

en-us	# 6 What's new in Zabbix 7.0.1  See [breaking changes](/manual/installation/upgrade_notes_701#breaking_changes) for this version.
ca	# 6 Què hi ha de nou al Zabbix 7.0.  Veieu els [canvis més importants](/manual/installation/upgrade_notes_701#breaking_changes) per a aquesta versió.

en-us	# 6 Windows performance counters
ca	# 6 Comptadors de rendiment de Windows

en-us	# 6 Zabbix agent 2 (Windows)
ca	# 6 Zabbix agent 2 (Windows)

en-us	# 6 Zabbix appliance
ca	# 6. Aplicació Zabbix

en-us	## 7.0.1
ca	## 7.0.1

en-us	# 7 Alerts
ca	# 7 Alertes

en-us	# 7 Calculated items
ca	# 7 Elements calculats

en-us	# 7 Configuration  Please use the sidebar to access content in the Configuration section.
ca	# 7. Configuració  Empreu la barra lateral per accedir al contingut de la secció Configuració.

en-us	 # 7 Custom LLD rules
ca	 # 7 Regles LLD personalitzades

en-us	# 7 Definitions
ca	# 7. Definicions

en-us	# 7 Discovery
ca	# 7 Descoberta

en-us	# 7 Discovery of IPMI sensors
ca	# 7 Descoberta de sensors IPMI

en-us	# 7 Elasticsearch setup  ::: noteimportant  Elasticsearch support is experimental!  :::  Zabbix supports the storage of historical data by means of Elasticsearch instead of a database. Users can choose the storage place for historical data between a compatible database and Elasticsearch. The setup procedure described in this section is applicable to Elasticsearch version 7.X. In case an earlier or later version of Elasticsearch is used, some functionality may not work as intended.  ::: notewarning  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. :::
ca	# 7 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. :::

en-us	# 7 Gauge
ca	# 7 Calibre

en-us	# 7 Gauge
ca	# 7 Indicador

en-us	# 7 Get
ca	# 7 Get

en-us	##### 7 Install new Zabbix web interface  The minimum required PHP version is 8.0.0. Update if needed and follow [installation instructions](/manual/installation/frontend).
ca	##### 7 Instal·lació de la nova interfície Web de Zabbix  La versió mínima requerida de PHP és la 8.0.0. Actualitzeu-la si cal i seguiu les [instruccions d'instal·lació](/manual/installation/frontend).

en-us	# 7 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).
ca	# 7 Macros  És possible emprar [Macros admeses] (/manual/appendix/macros/supported_by_location) de manera immediata i [Macros d'usuari compatibles amb la ubicació](/manual/appendix/macros/supported_by_location_user).

en-us	# 7 Mass update
ca	# 7 Actualització massiva

en-us	# 7 Monitor network traffic using active checks
ca	# 7 Monitoratge del trànsit de xarxa mitjançant comprovacions actives

en-us	# 7 MQTT plugin
ca	# 7 Plugin MQTT

en-us	# 7 Newline-delimited JSON export protocol  This section presents details of the export protocol in a newline-delimited JSON format, used in:  -   [data export to files](/manual/config/export/files) -   [streaming to external systems](/manual/config/export/streaming)  The following can be exported:  -   [trigger events](#trigger_events) -   [item values](#item_values) -   [trends](#trends) (export to files only)  All files have a .ndjson extension. Each line of the export file is a JSON object.
ca	# 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:  -[exportació de dades a fitxers](/manual/config/export/files) -[transmissió a sistemes externs](/manual/config/export/streaming)  Es pot exportar el següent:  - [esdeveniments de trigger](#trigger_events) - [valors d'element](#element_valors) - [tendències](#tendències) (exportar només a arxius)  Tots els fitxers tenen l'extensió .ndjson. Cada línia del fitxer d'exportació és un objecte JSON.

en-us	# 7 Notes on memtype parameter in proc.mem items
ca	# 7 Notes sobre el paràmetre memtype dels elements proc.mem

en-us	# 7 Notifications
ca	# 7 Notificacions

en-us	# 7 Operator functions  All functions listed here are supported in:  -   [Trigger expressions](/manual/config/triggers/expression) -   [Calculated items](/manual/config/items/itemtypes/calculated)  The functions are listed without additional information. Click on the function to see the full details.  |Function|Description| |--|--------| |[between](#between)|Check if the value belongs to the given range.| |[in](#in)|Check if the value is equal to at least one of the listed values.|
ca	# 7 Funcions de l'operador  Totes les funcions llistades aquí són compatibles amb:  - [Expressions triggers](/manual/config/triggers/expression) - [Elements calculats](/manual/config/items/itemtypes/calculated)  Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.  |Funció|Descripció| |--|---------| |[between](#between)|Comprova si el valor pertany a l'interval donat.| |[in](#in)|Comprova si el valor és igual com a mínim a un dels valors llistats.|

en-us	# 7 Predictive trigger functions
ca	# 7 Funcions predictives de triggers

en-us	# 7 Queue
ca	# 7 Cua

en-us	# 7 Standardized templates for network devices
ca	# 7 Plantilles estandarditzades per a dispositius de xarxa

en-us	##### 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
ca	##### 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

en-us	##### 7 Start Zabbix processes  Start the updated Zabbix components.      service zabbix-server start     service zabbix-proxy start     service zabbix-agent start     service zabbix-agent2 start
ca	##### 7 Inici dels processos de Zabbix  Inicieu els components actualitzats de Zabbix.      service zabbix-server start     service zabbix-proxy start     service zabbix-agent start     service zabbix-agent2 start

en-us	##### 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
ca	##### 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

en-us	# 7 Visualization
ca	# 7 Visualització

en-us	# 7 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.
ca	# 7 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.

en-us	# 7 What's new in Zabbix 7.0.2  :::notewarning Zabbix 7.0.2 is not released yet. :::  See [breaking changes](/manual/installation/upgrade_notes_702#breaking_changes) for this version.
ca	# 7 Novetats a Zabbix 7.0.2  :::notewarning Zabbix 7.0.2 encara no s'ha publicat. :::  Veieu els [canvis més importants](/manual/installation/upgrade_notes_702#breaking_changes) per a aquesta versió.

en-us	# 7 Zabbix agent 2 plugins
ca	# 7 Plugins de l'agent Zabbix 2

en-us	##### 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.
ca	##### 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.

en-us	##### 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.
ca	##### 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.

en-us	##### 8 Clear web browser cookies and cache  You may need to clear web browser cookies and web browser cache after the upgrade for Zabbix web interface to work properly.
ca	##### 8 Esborrar galetes i memòria cau del navegador web  Es possible que hagueu d'esborrar les galetes del navegador web i la memòria cau del navegador web després de l'actualització perquè la interfície web de Zabbix funcioni correctament.

en-us	# 8 Creating your own theme
ca	# 8 Crear el vostre propi tema

en-us	# 8 Discovery of systemd services
ca	# 8 Descoberta de serveis systemd

en-us	# 8 Distribution-specific notes on setting up Nginx for Zabbix
ca	# 8 Notes específiques de la distribució sobre la configuració d'Nginx per a Zabbix

en-us	# 8 Geomap
ca	# 8 Geomapes

en-us	# 8 Geomap
ca	# 8 Geomapes

en-us	# 8 Internal checks
ca	# 8 Verificacions internes

en-us	# 8 JS
ca	# 8 JS

en-us	# 8 MSSQL plugin
ca	# 8 MSSQL plugin

en-us	# 8 Notes on selecting processes in proc.mem and proc.num items
ca	# 8 Notes sobre la selecció de processos als elements proc.mem i proc.num

en-us	# 8 Prediction functions  All functions listed here are supported in:  -   [Trigger expressions](/manual/config/triggers/expression) -   [Calculated items](/manual/config/items/itemtypes/calculated)  The functions are listed without additional information. Click on the function to see the full details.  |Function|Description| |--|--------| |[forecast](#forecast)|The future value, max, min, delta or avg of the item.| |[timeleft](#timeleft)|The time in seconds needed for an item to reach the specified threshold.|
ca	# 8 Funcions de predicció  Totes les funcions llistades aquí són compatibles amb:  - [Expressions trigger](/manual/config/triggers/expression) - [Elements calculats](/manual/config/items/itemtypes/calculated)  Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.  |Funció|Descripció| |--|---------| |[forecast](#forecast)|Valor futur, màxim, mínim, delta o mitjana de l'element.| |[timeleft](#timeleft)|Temps en segons necessaris perquè un element arribi al llindar especificat.|

en-us	# 8 Service monitoring
ca	# 8. Monitoratge de serveis

en-us	# 8 Templates and template groups
ca	# 8 Plantilles i grups de plantilles

en-us	# 8 Unit symbols
ca	# 8 Símbols d'unitats

en-us	# 8 Upgrade procedure
ca	# 8 Procediment d'actualització

en-us	# 8 Users
ca	# 8 Usuaris

en-us	# 8 Value mapping
ca	# 8 Mapatge de valors

en-us	# 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). :::
ca	# 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). :::

en-us	# 9 Administration
ca	# 9 Administració

en-us	# 9 Debug mode
ca	# 9 Mode de depuració

en-us	# 9 Discovery of Windows services
ca	# 9 Descoberta de serveis de Windows

en-us	# 9 Graph
ca	# 9 Gràfic

en-us	# 9 Graph
ca	# 9 Gràfic

en-us	# 9 Implementation details of net.tcp.service and net.udp.service checks  Implementation of net.tcp.service and net.udp.service checks is detailed on this page for various services specified in the service parameter.
ca	# 9 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.

en-us	# 9 Known issues  See also: [Compilation issues](/manual/installation/known_issues/compilation_issues).
ca	# 9 Problemes coneguts  Veieu també: [Problemes de compilació](/manual/installation/known_issues/compilation_issues).

en-us	# 9 MySQL plugin
ca	# 9 Plugin de MySQL

en-us	# 9 Queue
ca	# 9 Cua

en-us	# 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.
ca	# 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.

en-us	# 9 SSH checks
ca	# 9 Verificacions SSH

en-us	 # 9 String functions  All functions listed here are supported in:  -   [Trigger expressions](/manual/config/triggers/expression) -   [Calculated items](/manual/config/items/itemtypes/calculated)  The functions are listed without additional information. Click on the function to see the full details.  |Function|Description| |--|--------| |[ascii](#ascii)|The ASCII code of the leftmost character of the value.| |[bitlength](#bitlength)|The length of value in bits.| |[bytelength](#bytelength)|The length of value in bytes.| |[char](#char)|Return the character by interpreting the value as ASCII code.| |[concat](#concat)|The string resulting from concatenating the referenced item values or constant values.| |[insert](#insert)|Insert specified characters or spaces into the character string beginning at the specified position in the string.| |[jsonpath](#jsonpath)|Return the JSONPath result.| |[left](#left)|Return the leftmost characters of the value.| |[length](#length)|The length of value in characters.| |[ltrim](#ltrim)|Remove specified characters from the beginning of string.| |[mid](#mid)|Return a substring of N characters beginning at the character position specified by 'start'.| |[repeat](#repeat)|Repeat a string.| |[replace](#replace)|Find the pattern in the value and replace with replacement.| |[right](#right)|Return the rightmost characters of the value.| |[rtrim](#rtrim)|Remove specified characters from the end of string.| |[trim](#trim)|Remove specified characters from the beginning and end of string.| |[xmlxpath](#xmlxpath)|Return the XML XPath result.|
ca	 # 9 Funcions de cadena  Totes les funcions listades aquí són compatibles amb:  - [Expressions triggers](/manual/config/triggers/expression) - [Elements calculats](/manual/config/items/itemtypes/calculated)  Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.  |Funció|Descripció| |--|---------| |[ascii](#ascii)|Codi ASCII del caràcter més a l'esquerra del valor.| |[bitlength](#bitlength)|Longitud del valor en bits.| |[bytelength](#bytelength)|Longitud del valor en octets.| |[char](#char)|Retorna el caràcter interpretant el valor com a codi ASCII.| |[concat](#concat)|Cadena resultant de la concatenació dels valors dels elements de referència o dels valors constants.| |[insert](#insert)|Insereix caràcters o espais especificats a la cadena de caràcters començant a la posició especificada de la cadena.| |[jsonpath](#jsonpath)|Retorna el resultat JSONPath.| |[left](#left)|Retorna els caràcters més a l'esquerra del valor.| |[lenght](#lenght)|Longitud del valor en caràcters.| |[ltrim](#ltrim)|Esborra els caràcters especificats del principi de la cadena.| |[mid](#mid)|Retorna una subcadena de N caràcters començant a la posició del caràcter especificada per 'inici'.| |[repeat](#repeat)|Repetir una cadena.| |[replace](#replace)|Cerca el patró al valor i el substitueix.| |[right](#right)|Retorna els caràcters més a la dreta del valor.| |[rtrim](#rtrim)|Esborra els caràcters especificats del final de la cadena.| |[trim](#trim)|Esborra els caràcters especificats del principi i el final de la cadena.| |[xmlxpath](#xmlxpath)|Retorna el resultat XML XPath.|

en-us	# 9 Templates out of the box
ca	# 9 Plantilles de fàbrica

en-us	# 9 Time period syntax
ca	# 9 Sintaxi del període de temps

en-us	# 9 Web monitoring
ca	# 9. Monitoratge Web

en-us	# 9 Web service
ca	# 9 Servei Web

en-us	# 9 Zabbix web service
ca	# 9 Web service Zabbix

en-us	#### 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.
ca	#### 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.

en-us	 ##### abs(value) {#abs}  The absolute value of a value.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*.<br> For strings returns: 0 - the values are equal; 1 - the values differ.  Parameter:   -   **value** - the value to check  The absolute numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = absolute difference): '1' and '5' = `4`; '3' and '1' = `2`; '0' and '-2.5' = `2.5`  Example:      abs(last(/host/key))>10
ca	 ##### abs(value) {#abs}  El valor absolut d'un valor.<br> Tipus de valors admesos: *Flotant*, *Enter*, *Cadena*, *Text*, *Log*.<br> Per a les cadenes retorna: 0 - els valors són iguals; 1 - els valors són diferents.  Paràmetre:  - **valor** - el valor que cal comprovar  Es calcularà la diferència numèrica absoluta, tal com es veu amb aquests valors d'exemple entrants (valor 'anterior' i 'últim' = diferència absoluta): '1' i '5' = `4`; '3' i '1' = `2`; '0' i '-2,5' = `2,5`.  Exemple:       abs(últim(/amfitrió/clau))>10

en-us	#### Access from several user groups  A user may belong to any number of user groups. These groups may have different access permissions to hosts or templates.  Therefore, it is important to know what entities an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B.  -   If Group A has only *Read* access to Hostgroup 1, but Group B     *Read-write* access to Hostgroup 1, the user will get **Read-write**     access to 'X'.  ::: noteimportant “Read-write” permissions have precedence over “Read” permissions. :::  -   In the same scenario as above, if 'X' is simultaneously also in     Hostgroup 2 that is **denied** to Group A or B, access to 'X' will     be **unavailable**, despite a *Read-write* access to Hostgroup 1. -   If Group A has no permissions defined and Group B has a *Read-write*     access to Hostgroup 1, the user will get **Read-write** access to     'X'. -   If Group A has *Deny* access to Hostgroup 1 and Group B has a     *Read-write* access to Hostgroup 1, the user will get access to 'X'     **denied**.
ca	#### 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**.

en-us	#### Access  Host dashboards can be accessed:  - after searching for a host name in [global search](/manual/web_interface/global_search) (click the *Dashboards* link provided in the search results); - after clicking a host name in *Inventory → [Hosts](/manual/web_interface/frontend_sections/inventory/hosts)* (click the *Dashboards* link provided in the host overview); - from the [host menu](/manual/web_interface/menu/host_menu) by clicking *Dashboards*.  ![](../../../../../../assets/en/manual/config/visualization/host_menu_dashboards.png)  Note that host dashboards *cannot* be directly accessed in the *[Dashboards](/manual/web_interface/frontend_sections/dashboards)* section, which is reserved for global dashboards.
ca	#### Accés  Es pot accedir als taulers de control de l'equip:  - després de cercar 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); - després de fer clic a un nom d'equip a *Inventari → [Equips](/manual/web_interface/frontend_sections/inventory/hosts)* (feu clic a l'enllaç *Taulers de control* que es proporciona a la visió general de l'equip ); - des del [menú de l'equip](/manual/web_interface/menu/host_menu) fent clic a *Taulers de control*.  ![](../../../../../../assets/en/manual/config/visualization/host_menu_dashboards.png)  Tingueu en compte que *no es pot* accedir directament als taulers de control a la secció *[Taulers de control](/manual/web_interface/frontend_sections/dashboards)*, que és reservada per als taulers de control globals.

en-us	#### 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*. :::
ca	#### 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*. :::

en-us	#### Access to hosts  Access to any host and template data in Zabbix is granted to [user groups](/manual/config/users_and_usergroups/usergroup) on the host/template group level only.  That means that an individual user cannot be directly granted access to a host (or host group). It can only be granted access to a host by being part of a user group that is granted access to the host group that contains the host.   Similarly, a user can only be granted access to a template by being part of a user group that is granted access to the template group that contains the template.
ca	#### Accés als equips  L'accés a totes les dades d'equips i plantilles a Zabbix es concedeix a [grups d'usuaris](/manual/config/users_and_usergroups/usergroup) només a nivell de grup d'equips/plantilles.  Això vol dir que a un usuari individual no se li pot concedir accés directament a un equip (o grup d'equips). Només pot accedir a un equip pertanyent a un grup d'usuaris que tingui accés al grup d'equips que conté l'equip.  De la mateixa manera, a un usuari només se li pot concedir accés a una plantilla si forma part d'un grup d'usuaris que té accés al grup de plantilles que la contenen.

en-us	 #### 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=zabbix7.0*  Install Zabbix server again:      dnf install zabbix-server-mysql  Notice that official Zabbix packages have the word `release` in their version string:      7.0.0-release1.el8
ca	 #### 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=zabbix7.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ó:      7.0.0-release1.el8

en-us	#### Acknowledging an event  Acknowledge a single event and leave a message.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "event.acknowledge",     "params": {         "eventids": "20427",         "action": 6,         "message": "Problem resolved."     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "eventids": [             "20427"         ]     },     "id": 1 } ```
ca	#### Reconèixer un esdeveniment  Reconèixer un esdeveniment i afegir-hi un missatge.  Petició](/manual/api#performing-requests): [  ```json {     "jsonrpc": "2.0",     "method": "event.acknowledge",     "params": {         "eventids": "20427",         "action": 6,         "message": "Problem resolved."     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "eventids": [             "20427"         ]     },     "id": 1 } ```

en-us	 ##### acos(value) {#acos}  The arccosine of a value as an angle, expressed in radians.  Parameter:   -   **value** - the value to check  The value must be between -1 and 1. For example, the arccosine of a value '0.5' will be '2.0943951'.  Example:      acos(last(/host/key))
ca	 ##### acos(value) {#acos}  Arccosinus d'un valor com a angle, expressat en radians.  Paràmetre:  - **valor** - el valor que cal comprovar  El valor ha d'estar entre -1 i 1. Per exemple, l'arcosinus d'un valor '0,5' serà '2,0943951'.  Exemple:      acos(last(/host/key))

en-us	# action.create
ca	# acció.crear

en-us	# action.delete
ca	# acció.esborrar

en-us	#### Action filter condition  The action filter condition object defines a specific condition that must be checked before running the action operations.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |conditiontype|integer|Type of condition.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a trigger":<br>0 - host group;<br>1 - host;<br>2 - trigger;<br>3 - event name;<br>4 - trigger severity;<br>6 - time period;<br>13 - host template;<br>16 - problem is suppressed;<br>25 - event tag;<br>26 - event tag value.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a discovery rule":<br>7 - host IP;<br>8 - discovered service type;<br>9 - discovered service port;<br>10 - discovery status;<br>11 - uptime or downtime duration;<br>12 - received value;<br>18 - discovery rule;<br>19 - discovery check;<br>20 - proxy;<br>21 - discovery object.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by active agent autoregistration":<br>20 - proxy;<br>22 - host name;<br>24 - host metadata.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "internal event":<br>0 - host group;<br>1 - host;<br>13 - host template;<br>23 - event type;<br>25 - event tag;<br>26 - event tag value.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created on service status update":<br>25 - event tag;<br>26 - event tag value;<br>27 - service;<br>28 - service name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Value to compare with.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value2|string|Secondary value to compare with.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", `conditiontype` is set to any possible value for trigger actions, and the type of condition (see below) is "26"<br>- *required* if `eventsource` of [Action object](#action) is set to "internal event", `conditiontype` is set to any possible value for internal actions, and the type of condition (see below) is "26"<br>- *required* if `eventsource` of [Action object](#action) is set to "event created on service status update", `conditiontype` is set to any possible value for service actions, and the type of condition (see below) is "26"| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<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.|
ca	#### 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ó| |-------|--------------------------------------------------------|-----------| |conditiontype|enter|Tipus de condició.<br><br>Valors possibles si `eventsource` de l'[objecte d'acció](#action) s'ha establert a "esdeveniment creat per un trigger":<br>0 - grup d'equips;<br>1 - equip;<br>2 - trigger;<br>3 - nom del trigger;<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.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|cadena|Valor a comparar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value2<br>|cadena|Valor secundari a comparar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `eventsource` de l'[objecte d'acció](#action) s'ha establert a "esdeveniment creat per un trigger", `conditiontype` s'ha establert a qualsevol valor possible per les accions de triggers, i el tipus de condició (veieu més avall) és "26"<br>- *obligatori* si `eventsource` d'[objecte d'acció](#action) s'estableix en "internal event", `conditiontype` s'estableix en qualsevol valor possible per a les accions internes i el tipus de condició ( vegeu a continuació) és "26"<br>- *obligatori* si `eventsource` d'[objecte d'acció](#action) s'estableix a "esdeveniment creat a l'actualització de l'estat del servei", `conditiontype` s'estableix a qualsevol valor possible per les accions de servei i el tipus de condició (veieu més avall) és "26"| |formulaid|cadena|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* i *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.|

en-us	### Action filter  The action filter object defines a set of conditions that must be met to perform the configured action operations. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |conditions|array|Set of [filter conditions](#action-filter-condition) to use for filtering results. The conditions will be sorted in the order of their placement in the formula.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |evaltype|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |eval\_formula|string|Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"|
ca	### 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|taula|Conjunt de  [condicions de filtre](#action-filter-condition) a emprar per filtrar els resultats. Les condicions s'ordenaran de la mateixa manera que s'han introduït a la fòrmula.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |evaltype|enter|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.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |eval\_formula|cadena|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.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |formula|cadena|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>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `evaltype` s'ha establert a "expressió personalitzada"|

en-us	##### Action for active agent autoregistration  When server receives an autoregistration request from an agent it calls an [action](/manual/config/notifications/action). An action of event source "Autoregistration" must be configured for agent autoregistration.  ::: noteclassic Setting up [network discovery](network_discovery) is not required to have active agents autoregister. :::  In the Zabbix frontend, go to *Alerts → Actions*, select *Autoregistration actions* and click on *Create action*:  -   In the Action tab, give your action a name -   Optionally specify     [conditions](/manual/config/notifications/action/conditions#autoregistration_actions).     You can do a substring match or regular expression match in the     conditions for host name/host metadata. If you are going to use the     "Host metadata" condition, see the next section. -   In the Operations tab, add relevant operations, such as - 'Add     host', 'Add to host group' (for example, *Discovered hosts*), 'Link     templates', etc.  ::: notetip If the hosts that will be autoregistering are likely to be supported for active monitoring only (such as hosts that are firewalled from your Zabbix server) then you might want to create a specific template like *Template\_Linux-active* to link to. :::  Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host group* operation (specifying "Discovered hosts") and also add an *Add to host group* operation (specifying another host group), because a host must belong to a host group.
ca	##### 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 *Alertes → 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.

en-us	# action.get
ca	# action.get

en-us	# Action object  The following objects are directly related to the `action` API.
ca	# Objecte d'acció  Els següents objectes són relacionats amb l'API `action`.

en-us	#### Action operation condition  The action operation condition object defines a condition that must be met to perform the current operation. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |conditiontype|integer|Type of condition.<br><br>Possible values:<br>14 - event acknowledged.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Value to compare with.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |operator|integer|Condition operator.<br><br>Possible values:<br>0 - *(default)* =|  The following operators and values are supported for each operation condition type.  |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |14|Event acknowledged|=|Whether the event is acknowledged.<br><br>Possible values:<br>0 - not acknowledged;<br>1 - acknowledged.|
ca	#### 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ó| |--|--|------| |conditiontype|enter|Tipus de condició.<br><br>Valors possibles:<br>14 - esdeveniment reconegut.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value|cadena|Valor amb el que comparar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |operator|enter|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.|

en-us	#### Action operation message  The operation message object contains data about the message that will be sent by the operation. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |default\_msg|integer|Whether to use the default action message text and subject.<br><br>Possible values:<br>0 - use the data from the operation;<br>1 - *(default)* use the data from the media type.| |mediatypeid|ID|ID of the media type that will be used to send the message.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `operationtype` of [Action operation object](#action-operation), [Action recovery operation object](#action-recovery-operation), or [Action update operation object](#action-update-operation) is set to "send message", or if `operationtype` of [Action update operation object](#action-update-operation) is set to "notify all involved"| |message|string|Operation message text.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `default_msg` is set to "use the data from the operation"| |subject|string|Operation message subject.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `default_msg` is set to "use the data from the operation"|
ca	#### 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.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si l'`operationtype` de l'[objecte d'operació d'acció](#action-operation), [objecte d'operació de recuperació d'acció](#action-recovery-operation), o l'[objecte d'operació d'actualització d'acció](#action-update-operation) s'estableix a "enviar missatge", o si l'`operationtype` de l'[objecte d'operació d'actualització d'acció](#action-update-operation) s'ha establert a "notificar a tots els implicats"| |missatge|cadena|Text del missatge de l'operació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si el `default_msg` s'ha establert a "emprar la informació de l'operació"| |assumpte|cadena|Assumpte del missatge de l'operació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si el `default_msg` s'ha establert a "emprar la informació de l'operació"|

en-us	### Action operation  The action operation object defines an operation that will be performed when an action is executed. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationtype|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>2 - add host;<br>3 - remove host;<br>4 - add to host group;<br>5 - remove from host group;<br>6 - link template;<br>7 - unlink template;<br>8 - enable host;<br>9 - disable host;<br>10 - set host inventory mode;<br>13 - add host tags;<br>14 - remove host tags.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a trigger" or "event created on service status update":<br>0 - "send message";<br>1 - "global script".<br><br>Possible values if `eventsource` of [Action object](#action) is set to "internal event":<br>0 - "send message".<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |esc\_period|string|Duration of an escalation step in seconds. Must be greater than 60 seconds. Accepts seconds, time unit with suffix, or a user macro. If set to 0 or 0s, the default action escalation period will be used.<br><br>Default: 0s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` of [Action object](#action) is set to "event created by a trigger", "internal event", or "event created on service status update"| |esc\_step\_from|integer|Step to start escalation from.<br><br>Default: 1.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` of [Action object](#action) is set to "event created by a trigger", "internal event", or "event created on service status update"| |esc\_step\_to|integer|Step to end escalation at.<br><br>Default: 1.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` of [Action object](#action) is set to "event created by a trigger", "internal event", or "event created on service status update"| |evaltype|integer|Operation condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>1 - AND;<br>2 - OR.| |opcommand|object|Global script to execute.<br><br>The global script must have the `scriptid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script"| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script" and `opcommand_hst` is not set| |opcommand\_hst|array|Host to run global scripts on.<br><br>The hosts must have the `hostid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script" and `opcommand_grp` is not set| |opconditions|array|Operation conditions used for trigger actions.<br><br>The operation condition object is [described in detail below](/manual/api/reference/action/object#action_operation_condition).| |opgroup|array|Host groups to add hosts to.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "add to host group" or "remove from host group"| |opmessage|object|Object containing the data about the message sent by the operation.<br><br>The operation message object is [described in detail below](/manual/api/reference/action/object#action_operation_message).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message"| |opmessage\_grp|array|User groups to send messages to.<br><br>The user groups must have the `usrgrpid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_usr` is not set| |opmessage\_usr|array|Users to send messages to.<br><br>The users must have the `userid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_grp` is not set| |optemplate|array|Templates to link to the hosts.<br><br>The templates must have the `templateid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "link template" or "unlink template"| |opinventory|object|Inventory mode set host to.<br><br>The inventory must have the `inventory_mode` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "set host inventory mode"| |optag|array|Host tags to add or remove.<br><br>Tags must have `tag` property defined.<br>The `value` property is optional. <br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `operationtype` is set to "add host tags" or "remove host tags".|
ca	### 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ó| |--|--|------| |operationtype|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>Els valors possibles d'`eventsource` de l'[objecte acció](#action) si és establert a "esdeveniment creat per trigger" o "esdeveniment creat per acutlització d'estat del servei":<br>0 - "enviar missatge";<br>1 - "script global".<br><br>Valors possibles si l'`eventsource` de l'[objecte acció](#action) és establert a "esdeveniment intern":<br>0 - "enviar missatge".<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |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>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si l'`eventsource` de l'[objecte acció](#action) s'ha establert a "esdeveniment creat per trigger", "esdeveniment intern", o "esdeveniment creat en actualitzar l'estat del servei"| |esc\_step\_from|enter|Graó de partida de l'escalat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si l'`eventsource` de l'[objecte acció](#action) s'ha establert a "esdeveniment creat per trigger", "esdeveniment intern", o "esdeveniment creat en actualitzar l'estat del servei"| |esc\_step\_to|enter|Graó d'escalada destí.<br><br>Per defecte: 1.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si l'`eventsource` de l'[objecte acció](#action) s'ha establert a "esdeveniment creat per trigger", "esdeveniment intern", o "esdeveniment creat en actualitzar l'estat del servei"| |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|Script global a executar.<br><br>L'script global ha de tindre la propietat `scriptid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "script global"| |opcommand\_grp|matriu|Grups d'equips per executar scripts globals.<br><br>Els grups d'equips han de tindre la propietat `groupid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "script global" i no s'ha definit `opcommand_hst`| |opcommand\_hst|matriu|Equip que executa els scripts globals.<br><br>Els grups d'equips han de tindre la propietat `hostid` definida<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "script global" i no s'ha definit `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><br><br>Els grups d'equips han de tindre la propietat `groupid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "afegir a grup d'equips" o "treure de grup d'equips"| |opmessage|objecte|Objecte que conté la informació sobre el missatge enviat per l'operació.<br><br>L'objecte missatge de l'operació és [detallat avall](/manual/api/reference/action/object#action_operation_message).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "enviar missatge"| |opmessage\_grp|matriu|Grups d'usuaris als qui enviar missatges.<br><br>Els grups d'usuaris han de tindre la propietat `usrgrpid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "enviar missatge" i no s'ha establert pas `opmessage_usr`| |opmessage\_usr|matriu|Usuaris als qui enviar missatges.<br><br>Els usuaris han de tindre la propietat `userid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "enviar missatge" i no s'ha establert pas `opmessage_grp`| |optemplate|matriu|Plantilles a les que vincular-hi equips.<br><br>Les plantilles han de tindre la propietat `templateid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "enllaçar a plantilla" o "desenllaçar de plantilla"| |opinventory|objecte|Mode d'inventari definit com equip.<br><br>L'inventari han de tindre la propietat `inventory_mode` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si l'`operationtype` s'ha establert a "definir el mode d'inventari d'equip"|

en-us	### Action recovery operation  The action recovery operation object defines an operation that will be performed when a problem is resolved. Recovery operations are possible **only** for trigger, internal and service actions. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationtype|integer|Type of operation.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "event created by a trigger" or "event created on service status update":<br>0 - send message;<br>1 - global script;<br>11 - notify all involved.<br><br>Possible values if `eventsource` of [Action object](#action) is set to "internal event":<br>0 - send message;<br>11 - notify all involved.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |opcommand|object|Global script to execute.<br><br>The global script must have the `scriptid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script"| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_hst` is not set| |opcommand\_hst|array|Host to run global scripts on.<br><br>The hosts must have the `hostid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_grp` is not set| |opmessage|object|Object containing the data about the message sent by the recovery operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action_operation_message).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message"| |opmessage\_grp|array|User groups to send messages to.<br><br>The user groups must have the `usrgrpid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_usr` is not set| |opmessage\_usr|array|Users to send messages to.<br><br>The users must have the `userid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_grp` is not set|
ca	### Operació de recuperació d'acció  L'objecte d'operació de recuperació d'acció defineix una operació que es realitzarà quan es resolgui un problema. Les operacions de recuperació són possibles **només** per a accions de triggers, internes i de servei. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |operationtype|enter|Tipus d'operació.<br><br>Valors possibles si `eventsource` d'[objecte d'acció](#action) s'estableix a "esdeveniment creat per un trigger" o "esdeveniment creat a l'actualització de l'estat del servei": <br>0 - enviar missatge;<br>1 - script global;<br>11 - notificar a tots els implicats.<br><br>Valors possibles si `eventsource` d'[objecte d'acció](#action) s'estableix a "esdeveniment intern":<br>0 - enviar missatge;<br>11 - notificar a tots els implicats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori *| |opcommand|objecte|Script global per executar.<br><br>L'script global ha de tindre la propietat `scriptid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior) :<br>- *obligatori* si `operationtype` és definit com a "script global"| |opcommand\_grp|array|Grups d'equips per executar scripts globals.<br><br>Els grups d'equips han de tindre la propietat `groupid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary #property-behavior):<br>- *obligatori* si `eventsource` d'[objecte d'acció](#action) s'estableix a "esdeveniment creat per un trigger", i `operationtype` s'estableix a "script global" i `opcommand_hst` no és pas establert| |opcommand\_hst|array|Equip per executar scripts globals.<br><br>Els equips han de tindre la propietat `hostid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property -behavior):<br>- *obligatori* si `eventsource` d'[objecte d'acció](#action) s'estableix a "esdeveniment creat per un trigger", i `operationtype` s'estableix a "script global" i `opcommand_grp ` no està configurat| |opmessage|objecte|Objecte que conté les dades sobre el missatge enviat per l'operació de recuperació.<br><br>L'objecte de missatge de l'operació és [descrit en detall més amunt](/manual/api/reference/action/object#action_operation_message). <br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `operationtype` és configurat a "enviar missatge"| |opmessage\_grp|array|Grups d'usuaris als qui enviar missatges.<br><br>Els grups d'usuaris han de tindre la propietat `usrgrpid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary# property-behavior):<br>- *obligatori* si `operationtype` és definit com a "enviar missatge" i `opmessage_usr` no és pas definit| |opmessage\_usr|array|Usuaris als qui enviar missatges.<br><br>Els usuaris han de tindre definida la propietat `userid`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property- comportament):<br>- *obligatori* si `operationtype` és establert a "enviar missatge" i `omessage_grp` no és pas configurat|

en-us	# Actions  Actions are responsible for 'business logic' of the module. An action usually consists of a [controller](#controller) and an [action view](views#action-view).   A module can:   - Call actions that are already defined in Zabbix frontend. - Override default actions with custom actions. - Define completely new actions.  To override a default action behavior with some custom behavior, define an action with the same name in the module configuration.  When the action is called, the module action will be executed instead of the default Zabbix action.   Action files should be stored in the *actions* folder. The actions need to be specified in the [manifest.json](manifest).
ca	# Accions  Les accions són responsables de la 'lògica de negoci' del mòdul. Una acció normalment consta d'un [controlador](#controller) i una [vista d'acció](views#action-view).  Un mòdul pot:  - Fer accions de crides que són definides a la interfície de Zabbix. - Substituïr les accions predeterminades amb accions personalitzades. - Definir accions totalment noves.  Per anul·lar un comportament d'acció predeterminat amb un comportament personalitzat, definiu una acció amb el mateix nom a la configuració del mòdul. Quan es cridi l'acció, s'executarà l'acció del mòdul en lloc de l'acció Zabbix predeterminada.  Els fitxers d'acció s'han d'emmagatzemar a la carpeta *actions*. Les accions s'han d'especificar al [manifest.json](manifest).

en-us	 ### actions  Actions to register with the module. Defining *class* object key for each action is required, other action keys are optional.  *Type*: Object  Supported object keys if *[type](#type)* is *module*:  -   **write.your.action.name** (object) - action name, should be written in lowercase [a-z], separating words with dots.     Supports the keys:     - **class** (string; required) - action class name.     - **layout** (string) - action layout. Supported values: *layout.json*, *layout.htmlpage* (default), *null*.     - **view** (string) - action view.  *Example*:  ```json "actions": {     "module.example.list": {         "class": "ExampleList",         "view": "example.list",         "layout": "layout.htmlpage"         }     } ```  Supported object keys if *[type](#type)* is *widget*:  -   **widget.{id}.view** (object) - file and class name for widget view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.view*).     Supports the keys:     - **class** (string; required) - action class name for widget view mode to extend the default CControllerDashboardWidgetView class.       The class source file must be located in the *actions* directory.     - **view** (string) - widget view. Must be located in the *views* directory.       If the view file is *widget.view.php*, which is expected by default, this parameter maybe omitted.       If using a different name, specify it here. -   **widget.{id}.edit** (object) - file name for widget configuration view. Replace **{id}** with the widget's [id](#id) value (for example, *widget.example_clock.edit*).     Supports the keys:     - **class** (string; required) - action class name for widget configuration view mode. The class source file must be located in the *actions* directory.     - **view** (string) - widget configuration view. Must be located in the *views* directory.       If the view file is *widget.edit.php*, which is expected by default, this parameter maybe omitted.       If using a different name, specify it here.  *Example*:   ```json "actions": {     "widget.tophosts.view": {         "class": "WidgetView"     },     "widget.tophosts.column.edit": {         "class": "ColumnEdit",         "view": "column.edit",         "layout": "layout.json"     } } ```
ca	### accions  Accions per registrar-se al mòdul. Cal definir la clau d'objecte *classe* per a cada acció, les altres claus d'acció són opcionals.  *Tipus*: Objecte  Tecles d'objecte admeses si *[tipus](#type)* és *mòdul*:  - **write.your.action.name** (objecte) - nom de l'acció, s'ha d'escriure en minúscula [a-z], separant les paraules amb punts.      Admet les tecles:      - **classe** (cadena; obligatori) - nom de la classe d'acció.      - **disposició** (cadena) - disseny d'acció. Valors admesos: *layout.json*, *layout.htmlpage* (per defecte), *null*.      - **layout** (cadena) - vista d'acció.  *Exemple*:  ```json "actions": {     "module.example.list": {         "class": "ExampleList",         "view": "example.list",         "layout": "layout.htmlpage"         }     } ```  Tecles d'objecte admeses si *[tipus](#type)* és *giny*:  - **widget.{id}.view** (objecte) - nom de fitxer i classe per a la vista de widget. Substituïu **{id}** pel valor [id](#id) del giny (per exemple, *widget.example_clock.view*).      Admet les tecles:      - **classe** (cadena; obligatori) - nom de classe d'acció per al mode de visualització de widgets per ampliar la classe CControllerDashboardWidgetView predeterminada.        El fitxer font de la classe s'ha d'ubicar al directori *accions*.      - **visualització** (cadena) - vista de giny. S'ha d'ubicar al directori *views*.        Si el fitxer de visualització és *widget.view.php*, que s'espera per defecte, aquest paràmetre potser s'omet.        Si empreu un nom diferent, especifiqueu-lo aquí. - **widget.{id}.edit** (objecte) - nom del fitxer per a la vista de configuració del giny. Substituïu **{id}** pel valor [id](#id) del giny (per exemple, *widget.example_clock.edit*).      Admet les claus:      - **classe** (cadena; obligatori) - nom de la classe d'acció per al mode de visualització de configuració del widget. El fitxer font de la classe s'ha d'ubicar al directori *actions*.      - **visualització** (cadena) - vista de configuració del widget. S'ha d'ubicar al directori *views*.        Si el fitxer de visualització és *widget.edit.php*, que s'espera per defecte, aquest paràmetre potser s'omet.        Si empreu un nom diferent, especifiqueu-lo aquí.  *Exemple*:  ```json "actions": {     "widget.tophosts.view": {         "class": "WidgetView"     },     "widget.tophosts.column.edit": {         "class": "ColumnEdit",         "view": "column.edit",         "layout": "layout.json"     } } ```

en-us	#### 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)
ca	#### 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)

en-us	#### 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 template" and "unlink template" operations); -   triggers ("trigger" condition); -   discovery rules (when using "discovery rule" and "discovery check" conditions).  :::notetip 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 template" and "unlink template" operations. :::  Actions are not disabled when deleting a user or user group used in a "send message" operation.
ca	#### 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); - plantilles (condició "plantilla", operacions "Enllaçar a la plantilla" i "Desenllaçar de la plantilla"); - triggers (condició "trigger"); - regles de descoberta (quan s'empren les condicions de "regla de descoberta" i "verificació de descoberta").  :::notetip 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çar a la plantilla" i "desenllaç de la plantilla". :::  Les accions no es desactiven en esborrar un usuari o grup d'usuaris emprat en una operació d'"enviament de missatge".

en-us	#### Actions  Discovery events can be the basis of relevant [actions](/manual/config/notifications/action), such as:  -   Sending notifications -   Adding/removing hosts -   Enabling/disabling hosts -   Adding hosts to a group -   Removing hosts from a group -   Adding tags to a host -   Removing tags from a host -   Linking a template to hosts/unlinking a template from hosts -   Executing remote scripts  These actions can be configured with respect to the device type, IP, status, uptime/downtime, etc. For full details on configuring actions for network-discovery based events, see action [operation](/manual/config/notifications/action/operation) and [conditions](/manual/config/notifications/action/conditions) pages.  Since network discovery actions are event-based, they will be triggered both when a discovered host is online and when it is offline. It is highly  recommended to add an action [condition](/manual/config/notifications/action/conditions) *Discovery status: up* to avoid such actions as *Add host* being triggered upon *Service Lost*/*Service Down* events.  Otherwise, if a discovered host is manually removed, it will still generate *Service Lost*/*Service Down* events and will be recreated during the next discovery cycle.  ::: noteclassic Linking templates to a discovered host will fail collectively if any of the linkable templates has a unique entity (e.g. item key) that is the same as a unique entity (e.g. item key) already existing on the host or on another of the linkable templates. :::
ca	#### 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 - Afegir etiquetes a un equip - Treure etiquetes d'un equip - 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. :::

en-us	#### 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.
ca	#### 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.

en-us	#### 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|
ca	#### 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|

en-us	 ### Actions  |Macro|Supported in|Description| |--|--------|--------| |{ACTION.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Numeric ID of the triggered action.*| |{ACTION.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Discovery notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications|*Name of the triggered action.*| |{ALERT.MESSAGE}|→ Alert script parameters<br>→ Webhook parameters|*'Default message' value from action configuration.*| |{ALERT.SENDTO}|→ Alert script parameters<br>→ Webhook parameters|*'Send to' value from user media configuration.*| |{ALERT.SUBJECT}|→ Alert script parameters<br>→ Webhook parameters|*'Default subject' value from action configuration.*| |{ESC.HISTORY} |→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Service-based notifications and commands<br>→ Service update notifications and commands<br>→ Internal notifications |*Escalation history. Log of previously sent messages.*<br>Shows previously sent notifications, on which escalation step they were sent and their status (*sent*, *in progress* or *failed*).|
ca	# Accions  |Macro|Admesa a|Descripció| |--|------|------| |{ACTION.ID}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres basades en servei<br>→ Notificacions i ordres d'actualització del servei<br>→ Notificacions i ordres de descoberta <br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes|*ID numèric de l'acció activada.*| |{ACTION.NAME}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres basades en servei<br>→ Notificacions i ordres d'actualització del servei<br>→ Notificacions i ordres de descoberta <br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes<br>→  Paràmetres de Webhook|*Nom de l'acció activada.*| |{ALERT.MESSAGE}|→ Paràmetres de l'script d'alertesbr>→  Paràmetres de Webhook|*Valor 'Missatge predeterminat' de la configuració de l'acció.*| |{ALERT.SENDTO}|→ Paràmetres de l'script d'alertesbr>→  Paràmetres de Webhook|*Valor 'Envia a' de la configuració dels suports de l'usuari.*| |{ALERT.SUBJECT}|→ Paràmetres de l'script d'alertesbr>→  Paràmetres de Webhook|*Valor 'assumpte predeterminat' de la configuració de l'acció.*| |{ESC.HISTORY} \|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres basades en servei<br>→ Notificacions i ordres d'actualització del servei<br>→ Notificacions internes \|*Historial d'escalat. Registre dels missatges enviats anteriorment.*<br>Mostra les notificacions enviades anteriorment, en quin pas d'escalat s'han enviat i el seu estat (*enviada*, *en curs* o *fallida*).|

en-us	### Action  The action object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |actionid|ID|ID of the action.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |esc\_period|string|Default operation step duration. Must be at least 60 seconds. Accepts seconds, time unit with suffix, or a user macro.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger", "internal event", or "event created on service status update"| |eventsource|integer|Type of events that the action will handle.<br><br>Refer to the [event `source` property](/manual/api/reference/event/object#event) for a list of supported event types.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |name|string|Name of the action.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |status|integer|Whether the action is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |pause\_symptoms|integer|Whether to pause escalation if event is a symptom event.<br><br>Possible values:<br>0 - Don't pause escalation for symptom problems;<br>1 - *(default)* Pause escalation for symptom problems.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger"| |pause\_suppressed|integer|Whether to pause escalation during maintenance periods or not.<br><br>Possible values:<br>0 - Don't pause escalation;<br>1 - *(default)* Pause escalation.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger"| |notify\_if\_canceled|integer|Whether to notify when escalation is canceled.<br><br>Possible values:<br>0 - Don't notify when escalation is canceled;<br>1 - *(default)* Notify when escalation is canceled.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `eventsource` is set to "event created by a trigger"|
ca	### Acció  Lobjecte acció té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |actionid|ID|ID de l'acció.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per a operacions d'actualització| |esc\_period|cadena|Durada de la passa de l'operació per defecte. Ha de ser com a mínim de 60 segons. Accepta segons, unitat de temps amb sufix o una macro d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `eventsource` és establert en "esdeveniment creat per un trigger", "esdeveniment intern" o "esdeveniment creat a l'actualització de l'estat del servei"| |eventsource|enter|Tipus d'esdeveniments que gestionarà l'acció.<br><br>Consulteu la [propietat `source` de l'esdeveniment](/manual/api/reference/event/object#event) per obtindre una llista d'esdeveniments compatibles tipus.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatori* per a operacions de creació| |name|cadena|Nom de l'acció.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a les operacions de creació| |status|enter|Si l'acció és activada o desactivada.<br><br>Valors possibles:<br>0 - *(per defecte)* activat;<br>1 - desactivat.| |pause\_symptoms|enter|Si s'ha d'aturar l'escalada si l'esdeveniment és un esdeveniment símptoma.<br><br>Valors possibles:<br>0 - No atureu l'escalada per problemes de símptomes;<br>1 - *(per defecte)* Posa en pausa l'escalada per problemes de símptomes.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `eventsource` s'estableix com a "esdeveniment creat per un trigger"| |pause\_suppressed|enter|Si s'ha d'aturar l'escalada durant els períodes de manteniment o no.<br><br>Valors possibles:<br>0 - No atureu l'escalada;<br>1 - *(per defecte)* Atura l'escalada. <br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `eventsource` és establert en "esdeveniment creat per un trigger"| |notify\_if\_canceled|enter|Si cal notificar quan es cancel·li l'escalada.<br><br>Valors possibles:<br>0 - No aviseu quan es cancel·li l'escalada;<br>1 - *(per defecte)* Notifiqueu quan es cancel·li l'escalada.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `eventsource` s'estableix com a "esdeveniment creat per un trigger"|

en-us	### Action  The action object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Name of the action.<br><br>Possible values if `type` of the [Role](#role) object is set to "User", "Admin", or "Super admin:<br>`edit_dashboards` - Create and edit dashboards;<br>`edit_maps` - Create and edit maps;<br>`add_problem_comments` - Add problem comments;<br>`change_severity` - Change problem severity;<br>`acknowledge_problems` - Acknowledge problems;<br>`suppress_problems` - Suppress problems;<br>`close_problems` - Close problems;<br>`execute_scripts` - Execute scripts;<br>`manage_api_tokens` - Manage API tokens.<br><br>Possible values if `type` of the [Role](#role) object is set to "Admin" or "Super admin":<br>`edit_maintenance` - Create and edit maintenances;<br>`manage_scheduled_reports` - Manage scheduled reports,<br>`manage_sla` - Manage SLA.<br><br>Possible values if `type` of the [Role](#role) object is set to "User" or "Admin":<br>`invoke_execute_now` - allows to execute item checks for users that have only read permissions on host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |status|integer|Whether access to perform the action is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.|
ca	### Acció  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|string|Nom de l'acció.<br><br>Valors possibles si `type` és "Usuari", "Admin" o "Super admin":<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>`suppress_problems` - Esborrar problemes;<br>`close_problems` - Tanca problemes; <br>`execute_scripts` - executa scripts;<br>`manage_api_tokens` - gestiona els APIs de tokens.<br><br>Valors possibles si `type` és "Admin" o "Super admin":<br>` edit_maintenance` - Crear i editar manteniments;<br>`manage_scheduled_reports` - Gestionar informes programats,<br>`manage_sla` - Gestionar SLA.<br><br>Valors possibles si `type` de l'[objecte Rol](#role) és "User" o "Admin":<br>`invoke_execute_now` - permet executar els elements marcats per usuaris que tenen només permisos de lectura a l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |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.|

en-us	# Action  This class is designed to work with actions.  Object references:  -   [Action](/manual/api/reference/action/object#action) -   [Action operation](/manual/api/reference/action/object#action_operation) -   [Action operation message](/manual/api/reference/action/object#action_operation_message) -   [Action operation condition](/manual/api/reference/action/object#action_operation_condition) -   [Action recovery operation](/manual/api/reference/action/object#action_recovery_operation) -   [Action update operation](/manual/api/reference/action/object#action_update_operation) -   [Action filter](/manual/api/reference/action/object#action_filter) -   [Action filter condition](/manual/api/reference/action/object#action_filter_condition)  Available methods:  -   [action.create](/manual/api/reference/action/create) - create new actions -   [action.delete](/manual/api/reference/action/delete) - delete actions -   [action.get](/manual/api/reference/action/get) - retrieve actions -   [action.update](/manual/api/reference/action/update) - update actions
ca	# Acció  Aquesta classe és dissenyada per treballar amb accions.  Referències d'objectes:\  -   [Action](/manual/api/reference/action/object#action) -   [Action operation](/manual/api/reference/action/object#action_operation) -   [Action operation message](/manual/api/reference/action/object#action_operation_message) -   [Action operation condition](/manual/api/reference/action/object#action_operation_condition) -   [Action recovery operation](/manual/api/reference/action/object#action_recovery_operation) -   [Action update operation](/manual/api/reference/action/object#action_update_operation) -   [Action filter](/manual/api/reference/action/object#action_filter) -   [Action filter condition](/manual/api/reference/action/object#action_filter_condition)  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

en-us	# action.update
ca	# action.update

en-us	### Action update operation  The action update operation object defines an operation that will be performed when a problem is updated (commented upon, acknowledged, severity changed, or manually closed). Update operations are possible **only** for trigger and service actions. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |operationtype|integer|Type of operation.<br><br>Possible values:<br>0 - send message;<br>1 - global script;<br>12 - notify all involved.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |opcommand|object|Global script to execute.<br><br>The global script must have the `scriptid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "global script"| |opcommand\_grp|array|Host groups to run global scripts on.<br><br>The host groups must have the `groupid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_hst` is not set| |opcommand\_hst|array|Host to run global scripts on.<br><br>The hosts must have the `hostid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `eventsource` of [Action object](#action) is set to "event created by a trigger", and `operationtype` is set to "global script", and `opcommand_grp` is not set| |opmessage|object|Object containing the data about the message sent by the update operation.<br><br>The operation message object is [described in detail above](/manual/api/reference/action/object#action_operation_message).| |opmessage\_grp|array|User groups to send messages to.<br><br>The user groups must have the `usrgrpid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_usr` is not set| |opmessage\_usr|array|Users to send messages to.<br><br>The users must have the `userid` property defined.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `operationtype` is set to "send message" and `opmessage_grp` is not set|
ca	### 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 **només** per les accions de triggers i de serveis. Tenen les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |operationtype|enter|Tipus d'operació.<br><br>Valors possibles:<br>0 - enviar missatge;<br>1 - script global;<br>12 - notificar a tots els implicats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |opcommand|objecte|Script global per executar.<br><br>L'script global ha de tindre la propietat `scriptid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `operationtype` és definit com a "script global"| |opcommand\_grp|taula|Grups d'equips per executar scripts globals.<br><br>Els grups d'equips han de tindre la propietat `groupid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary #property-behavior):<br>- *obligatori* si `eventsource` d'[objecte d'acció](#action) s'estableix a "esdeveniment creat per un trigger", i `operationtype` s'estableix a "script global" i `opcommand_hst` no és establert| |opcommand\_hst|taula|Equip per executar scripts globals.<br><br>Els equips han de tindre la propietat `hostid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property -behavior):<br>- *obligatori* si `eventsource` de [Action object](#action) s'estableix a "esdeveniment creat per un trigger", i `operationtype` s'estableix a "script global" i `opcommand_grp` no és configurat| |opmessage|objecte|Objecte que conté les dades sobre el missatge enviat per l'operació d'actualització.<br><br>L'objecte de missatge de l'operació és [descrit en detall més amunt](/manual/api/reference/action/object#action_operation_message). | |opmessage\_grp|taula|Grups d'usuaris als qui enviar missatges.<br><br>Els grups d'usuaris han de tindre la propietat `usrgrpid` definida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary# property-behavior):<br>- *obligatori* si `operationtype` és definit com a "enviar missatge" i `opmessage_usr` no és pas definit| |opmessage\_usr|taula|Usuaris als qui enviar missatges.<br><br>Els usuaris han de tindre definida la propietat `userid`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property- comportament):<br>- *obligatori* si `operationtype` és establert a "enviar missatge" i `omessage_grp` no és pas configurat|

en-us	 ### Action view  This is a reference file for defining an action view.  ````php <?php declare(strict_types = 1);  /** * @var CView $this */  $this->includeJsFile('example.something.view.js.php');  (new CWidget())     ->setTitle(_('Something view'))     ->addItem(new CDiv($data['name']))     ->addItem(new CPartial('module.example.something.reusable', [         'contacts' => $data['contacts']     ])     ->show(); ````
ca	### vista d'acció  Aquest és un arxiu de referència per definir una vista d'acció.  ````php <?php declare(strict_types = 1);  /** * @var CView $this */  $this->includeJsFile('example.something.view.js.php');  (new CWidget())     ->setTitle(_('Something view'))     ->addItem(new CDiv($data['name']))     ->addItem(new CPartial('module.example.something.reusable', [         'contacts' => $data['contacts']     ])     ->show(); ````

en-us	#### action  [ZBXNEXT-6524](https://support.zabbix.com/browse/ZBXNEXT-6524) Added support of two new values in `operationtype` property (13 - Add host tags, 14 - Remove host tags) and new property `optag` for two `eventsource` action types (1 - Discovery, 2 - Autoregistration) available only in the `operations` property.\ [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `action.get`: Filter conditions will be sorted in the order of their placement in the formula.\
ca	#### acció  [ZBXNEXT-6524](https://support.zabbix.com/browse/ZBXNEXT-6524) S'ha afegit el suport de dos nous valors a la propietat `operationtype` (13 - Afegir etiquetes d'equip, 14 - Esborrar etiquetes d'equip) i la nova propietat `optag` per a dos tipus d'acció `eventsource` (1 - Descoberta, 2 - Autoregistre) disponible només a la propietat `operations`.\ [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `action.get`: Les condicions de filtre es poden ordenar en el mateix ordre que es disposi a la fòrmula.\

en-us	#### 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.
ca	#### 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).

en-us	### Active checks
ca	 ### Comprovacions actives

en-us	 ### Active checks
ca	 ### Comprovacions actives

en-us	#### Active checks  Active checks require more complex processing. The agent must first retrieve from the server/proxy a list of items and/or [remote commands](/manual/config/notifications/action/operation/remote_command) for independent processing.  The servers/proxies to get the active checks from are listed in the 'ServerActive' parameter of the agent [configuration file](/manual/appendix/config/zabbix_agent2). The frequency of asking for these checks is set by the 'RefreshActiveChecks' parameter in the same configuration file. However, if refreshing active checks fails, it is retried after hardcoded 60 seconds.
ca	#### Verificacions actives  Les verificacions actives tenen un tractament més complexe. L'agent primer ha de recuperar dels servidors una llista d'elements o [comandes remotes](/manual/config/notifications/action/operation/remote_command) for independent processingper un tractament independent.  Els servidors/proxys des d'on obtenim les verificacions actives són llistats al paràmetre 'ServerActive' de l'[arxiu de configuració](/manual/appendix/config/zabbix_agent2) 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.

en-us	#### Active proxy
ca	#### Proxy actiu

en-us	##### Add a blank module to Zabbix frontend  1. Create a directory *MyAddress* in the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*).  2. Create a *manifest.json* file with basic module metadata (see the description of supported [parameters](../file_structure/manifest)).  **ui/modules/MyAddress/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "my-address",     "name": "My IP Address",     "version": "1.0",     "namespace": "MyAddress",     "description": "My External IP Address." } ```  3. In Zabbix frontend, go to *Administration → General → Modules* section and click on the *Scan directory* button.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  4. Locate the new module *My IP Address* in the list and click on the "Disabled" hyperlink to change the module's status from "Disabled" to "Enabled".  ![](../../../../assets/en/devel/modules/tutorials/module/module_register.png){width="600"}  The module is now registered in the frontend. However, it is not visible yet, because you still need to define the module functionality. Once you add content to the module directory, you will immediately see the changes in Zabbix frontend upon refreshing the page.
ca	##### Afegir un mòdul en blanc a la interfície Zabbix  1. Creeu un directori *MyAddress* al directori de *mòduls* de la instal·lació de Zabbix (per exemple, *zabbix/ui/modules*).  2. Creeu un fitxer *manifest.json* amb metadades de mòduls bàsiques (veieu la descripció dels [paràmetres admesos](../file_structure/manifest)).  **ui/modules/MyAddress/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "la meva adreça",     "name": "La meva adreça IP",     "versió": "1.0",     "namespace": "La meva adreça",     "description": "La meva adreça IP externa" } ```  3. A la interfície Zabbix, aneu a la secció *Administració→General→Mòduls* i feu clic al botó *Escanejar el directori*.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  4. Trobeu el mòdul nou *La meva adreça IP* a la llista i feu clic a l'hiperenllaç "Inhabilitat" per canviar l'estat del mòdul de "Inhabilitat" a "Activat".  ![](../../../../assets/en/devel/modules/tutorials/module/module_register.png){width="600"}  El mòdul és ara registrat a la interfície. Tanmateix, encara no és visible, perquè encara cal definir la funcionalitat del mòdul. Un cop afegiu contingut al directori del mòdul, veureu immediatament els canvis a la interfície de Zabbix en actualitzar la pàgina.

en-us	### Add a blank widget to Zabbix frontend  1. Create a directory *lesson_gauge_chart* in the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*).  ::: noteclassic All custom widgets are treated as external modules and must be added to the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). The directory *zabbix/ui/widgets* is reserved for Zabbix built-in widgets and gets updated along with Zabbix UI. :::  2. Create a *manifest.json* file with basic widget metadata (see the description of supported [parameters](../file_structure/manifest)).  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.1",     "author": "Zabbix" } ```  3. In Zabbix frontend, go to *Administration → General → Modules* section and click on the *Scan directory* button.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  4. Locate the new module *Gauge chart* in the list and click on the "Disabled" hyperlink to change the module's status from "Disabled" to "Enabled".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_register.png){width="600"}  5. Open a dashboard, switch it to the edit mode and add a new widget. In the *Type* field, select "Gauge chart".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_add.png){width="600"}  6. At this point, the *Gauge chart* widget configuration contains only common widget fields *Name* and *Refresh interval*. Click on *Add* to add the widget to the dashboard.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_b.png){width="600"}  7. A blank widget should appear on the dashboard. Click on *Save changes* in the top right corner to save the dashboard.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_blank_b.png){width="600"}
ca	### Afegir un giny buit a la interfície Zabbix  1. Creeu el directori *lesson_gauge_chart* al directori *mòduls* de la vostra instal·lació de Zabbix (com ara *zabbix/ui/modules*).  ::: noteclassic Tots els ginys personalitzats es tracten com a mòduls externs i s'han d'afegir al directori de mòduls de Zabbix (per exemple, *zabbix/ui/modules*). El directori *zabbix/ui/widgets* és reservat per als ginys integrats de Zabbix i s'actualitza juntament amb la interfície d'usuari de Zabbix. :::  2. Creeu el fitxer *manifest.json* amb metadades bàsiques del giny (veieu la descripció dels [paràmetres](../file_structure/manifest) admesos).      **ui/modules/lesson_gauge_chart/manifest.json**      ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix SIA" } ```      3. A la interfície Zabbix aneu a la secció *Administració→General→Mòduls* i premeu el botó *Escanejar directori*.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)   4. Cerqueu el nou mòdul *Diagrama de mesura* a la llista i canvieu l'estat del mòdul de Desactivat a Actiu (feu clic a l'hiperenllaç *Desactivat*).  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_register.png){width="600"}      5. Obriu el *Tauler de control*, canvieu-lo a mode d'edició i afegiu-hi un nou giny. Al camp *Tipus*, trieu *Gràfic de mesura*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_add.png){width="600"}  6. En aquest punt, la configuració del giny *Diagrama de mesura* només conté camps de giny habituals: *Nom* i *Interval d'actualització*. Premeu *Afegir* per afegir el giny al tauler.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_b.png){width=600}        7. Al tauler hauria d'aparèixer un giny en blanc. Premeu Desar els canvis a l'extrem superior dret per desar el tauler.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_blank_b.png){width=600}

en-us	### Add advanced configuration settings to a configuration view  In this section, you will learn how to add an expandable/collapsible *Advanced configuration* section with optional parameters, such as color, minimum and maximum values, units and the *Description* field created earlier.  1. Create a *Widget.php* file in the main widget directory *lesson_gauge_chart* to create a new class *Widget*.  The *Widget* class will extend the *CWidget* base class to add/override the default widget settings (in this case - translations). JavaScript, provided below, displays the string "No data" in case of missing data. The "No data" string is present in the Zabbix UI translation files.  If there are any widget constants, it is recommended to also specify them in the *Widget* class.  **ui/modules/lesson_gauge_chart/Widget.php**  ```php <?php  namespace Modules\LessonGaugeChart;  use Zabbix\Core\CWidget;  class Widget extends CWidget {      public const UNIT_AUTO = 0;     public const UNIT_STATIC = 1;      public function getTranslationStrings(): array {         return [             'class.widget.js' => [                 'No data' => _('No data')             ]         ];     } } ```  2. Open *includes/WidgetForm.php* and add the new fields *Color* (color picker), *Min* (numeric field), *Max* (numeric field), and *Units* (select), and define the default color palette for the color picker, so that it can be used in the next steps.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Modules\LessonGaugeChart\Widget;  use Zabbix\Widgets\{     CWidgetField,     CWidgetForm };  use Zabbix\Widgets\Fields\{     CWidgetFieldColor,     CWidgetFieldMultiSelectItem,     CWidgetFieldNumericBox,     CWidgetFieldSelect,     CWidgetFieldTextBox };  /**  * Gauge chart widget form.  */ class WidgetForm extends CWidgetForm {      public const DEFAULT_COLOR_PALETTE = [         'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D',         '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D'     ];      public function addFields(): self {         return $this             ->addField(                 (new CWidgetFieldMultiSelectItem('itemid', _('Item')))                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)                     ->setMultiple(false)             )             ->addField(                 (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000')             )             ->addField(                 (new CWidgetFieldNumericBox('value_min', _('Min')))                     ->setDefault(0)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldNumericBox('value_max', _('Max')))                     ->setDefault(100)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldSelect('value_units', _('Units'), [                     Widget::UNIT_AUTO => _x('Auto', 'history source selection method'),                     Widget::UNIT_STATIC => _x('Static', 'history source selection method')                 ]))->setDefault(Widget::UNIT_AUTO)             )             ->addField(                 (new CWidgetFieldTextBox('value_static_units'))             )             ->addField(                 new CWidgetFieldTextBox('description', _('Description'))             );     } } ```  3. Open *views/widget.edit.php* and add the field visual components to the configuration view.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->show(); ```  ::: noteclassic The *addField()* method of the *CWidgetFormView* class takes a CSS class string as the second parameter. :::  4. Return to the dashboard, switch to the edit mode and click on the gear icon in the widget to open the widget configuration form. The widget configuration form now contains a new expandable/collapsible section *Advanced configuration*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced.png){width="600"}  5. Expand the *Advanced configuration* section to see additional widget configuration fields. Note that the field *Color* has no color picker yet. This is because the color picker must be initialized with JavaScript, which will be added in the next section - [*Add JavaScript to the widget*](#add-javascript-to-the-widget).  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_a.png){width="600"}
ca	### Afegeix paràmetres de configuració avançats a una vista de configuració  En aquesta secció, aprendreu a afegir una secció de *Configuració avançada* desplegable/plegable amb paràmetres opcionals com ara el color, els valors mínims i màxims, les unitats i el camp *Descripció* creat abans.  1. Creeu un fitxer *Widget.php* al directori principal de widgets *lesson_gauge_chart* per crear una nova classe *Widget*.  La classe *Widget* ampliarà la classe base *CWidget* per afegir/substituir la configuració predeterminada del giny (en aquest cas - traduccions). JavaScript, que es proporciona tot seguit, mostra la cadena "Sense dades" en cas que manquin dades. La cadena "Sense dades" és present als fitxers de traducció de la interfície d'usuari de Zabbix.  Si hi ha constants de giny, es recomana definir-les també a la classe *Widget*.  **ui/modules/lesson_gauge_chart/Widget.php**  ```php <?php  namespace Modules\LessonGaugeChart;  use Zabbix\Core\CWidget;  class Widget extends CWidget {      public const UNIT_AUTO = 0;     public const UNIT_STATIC = 1;      public function getTranslationStrings(): array {         return [             'class.widget.js' => [                 'No data' => _('No data')             ]         ];     } } ```  2. Obriu *includes/WidgetForm.php* i afegiu els nous camps *Color* (selector de colors), *Min* (camp numèric), *Max* (camp numèric) i *Units* (tria) i definiu la paleta de colors predeterminada per al selector de colors, de manera que es pugui emprar a les passes següents.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Modules\LessonGaugeChart\Widget;  use Zabbix\Widgets\{     CWidgetField,     CWidgetForm };  use Zabbix\Widgets\Fields\{     CWidgetFieldColor,     CWidgetFieldMultiSelectItem,     CWidgetFieldNumericBox,     CWidgetFieldSelect,     CWidgetFieldTextBox };  /**   * Formulari de giny de gràfic de calibre.   */ class WidgetForm extends CWidgetForm {      public const DEFAULT_COLOR_PALETTE = [         'FF465C', 'B0AF07', '0EC9AC', '524BBC', 'ED1248', 'D1E754', '2AB5FF', '385CC7', 'EC1594', 'BAE37D',         '6AC8FF', 'EE2B29', '3CA20D', '6F4BBC', '00A1FF', 'F3601B', '1CAE59', '45CFDB', '894BBC', '6D6D6D'     ];      public function addFields(): self {         return $this             ->addField(                 (new CWidgetFieldMultiSelectItem('itemid', _('Item')))                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)                     ->setMultiple(false)             )             ->addField(                 (new CWidgetFieldColor('chart_color', _('Color')))->setDefault('FF0000')             )             ->addField(                 (new CWidgetFieldNumericBox('value_min', _('Min')))                     ->setDefault(0)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldNumericBox('value_max', _('Max')))                     ->setDefault(100)                     ->setFlags(CWidgetField::FLAG_NOT_EMPTY | CWidgetField::FLAG_LABEL_ASTERISK)             )             ->addField(                 (new CWidgetFieldSelect('value_units', _('Units'), [                     Widget::UNIT_AUTO => _x('Auto', 'history source selection method'),                     Widget::UNIT_STATIC => _x('Static', 'history source selection method')                 ]))->setDefault(Widget::UNIT_AUTO)             )             ->addField(                 (new CWidgetFieldTextBox('value_static_units'))             )             ->addField(                 new CWidgetFieldTextBox('description', _('Description'))             );     } } ```  3. Obriu *views/widget.edit.php* i afegiu els components visuals de camp a la vista de configuració.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**   * Visualització del formulari del widget del gràfic de mesura.   *   * @var CView $this   * @var array $data   */  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->show(); ```  ::: noteclassic El mètode *addField()* de la classe *CWidgetFormView* pren una cadena de classe CSS com a segon paràmetre. :::  4. Torneu al tauler, canvieu al mode d'edició i feu clic a la icona d'engranatge del giny per obrir el formulari de configuració del giny. El formulari de configuració del giny ara conté una nova secció desplegable/plegable *Configuració avançada*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced.png){width="600"}  5. Amplieu la secció *Configuració avançada* per veure camps addicionals de configuració de ginys. Tingueu en compte que el camp *Color* encara no té cap selector de colors. Això es deu al fet que el selector de colors s'ha d'inicialitzar amb JavaScript, que s'afegirà a la secció següent: [*Afegir JavaScript al giny*](#add-javascript-to-the-widget).  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_a.png){width="600"}

en-us	#### Add a proxy to a proxy group  Update proxy with ID "5" and add it to proxy group with ID "1".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "proxyid": "5",         "proxy_groupid": "1",         "local_address": "127.0.0.1"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "5"         ]     },     "id": 1 } ```
ca	#### Afegiu un proxy a un grup de proxys  Actualitzeu el proxy amb l'identificador "5" i afegiu-lo al grup de proxys amb l'identificador "1".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "proxyid": "5",         "proxy_groupid": "1",         "local_address": "127.0.0.1"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "5"         ]     },     "id": 1 } ```

en-us	### Add a widget view  :::noteclassic The widget's **view** file should be located in the *views* directory (for this tutorial, *ui/modules/lesson_gauge_chart/views/*). If the file has the default name *widget.view.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *actions/widget.lesson_gauge_chart.view* section of the [manifest.json](devel/modules/file_structure/manifest) file. :::  1. Create a directory *views* in the *lesson_gauge_chart* directory.  2. Create a *widget.view.php* file in the *views* directory.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem(         new CTag('h1', true, 'Hello, world!')     )     ->show(); ```  3. Refresh the dashboard. The *Gauge chart* widget now displays "Hello, world!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_hello_world.png){width="600"}
ca	### Afegir un nou giny  :::noteclassic El fitxer **view** del giny s'ha d'ubicar al directori *views* (per a aquest tutorial, *ui/modules/lesson_gauge_chart/views/*). Si el fitxer té un nom predeterminat *widget.view.php*, no cal que el registreu a manifest.json. Si el fitxer té un nom diferent, especifiqueu-lo a la secció *actions/widget.lesson_gauge_chart.view* de [manifest.json](devel/modules/file_structure/manifest). :::  1. Afegiu un directori *views* al *leson_gauge_chart*.  2. Creeu el fitxer *widget.view.php* dins del directori *views*.      **ui/modules/lesson_gauge_chart/views/widget.view.php**      ```php <?php  /**  * Visualització del giny del gràfic de mesura.  *  * @var CView $this  * @var array $data  */      (new CWidgetView($data))     ->addItem(         new CTag('h1', true, 'Hello, world!')     )     ->show(); ```      3. Recarregueu el tauler Zabbix. El giny *Gràfic de mesura* ara ensenyarà "Hola, món!".   ![](../../../../assets/en/devel/modules/tutorials/widget/widget_hello_world.png){width=850}

en-us	### Add CSS styles to the widget  In this section you will learn how to add custom CSS styles to make the widget look more appealing.  1. For widget styles, create a new directory *css* in the *assets* directory.  2. Create a *widget.css* file in the *assets/css* directory. To style widget elements, use the selector *div.dashboard-widget-{widget id}*. To configure CSS for the whole widget, use the selector *form.dashboard-widget-{widget id}*  **ui/modules/lesson_gauge_chart/assets/css/widget.css**  ```css div.dashboard-widget-lesson_gauge_chart {     display: grid;     grid-template-rows: 1fr;     padding: 0; }  div.dashboard-widget-lesson_gauge_chart .chart {     display: grid;     align-items: center;     justify-items: center; }  div.dashboard-widget-lesson_gauge_chart .chart canvas {     background: white; }  div.dashboard-widget-lesson_gauge_chart .description {     padding-bottom: 8px;     font-size: 1.750em;     line-height: 1.2;     text-align: center; }  .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart {     margin-top: 8px; } ```  3. Open *manifest.json* and add the CSS file name (*widget.css*) to the array in the *assets/css* section. This will allow the CSS styles defined in *widget.css* to load with the dashboard page.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "css": ["widget.css"],         "js": ["class.widget.js"]     } } ```  4. Refresh the dashboard page to see the finished version of the widget.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_finished.png){width="600"}
ca	### Afegir estils CSS al giny.  En aquesta secció aprendreu a afegir estils CSS personalitzats per fer que el giny sembli més atractiu.  1. Per als estils de giny, creeu un nou directori *css* dins del directori *assets*.  2. Afegiu el fitxer *widget.css* a *assets/css*. Per estilitzar els elements del giny, empreu el selector *div.dashboard-widget-{widget id}*. Per configurar CSS per a tot el giny, empreu el selector *form.dashboard-widget-{widget id}*      **ui/modules/lesson_gauge_chart/assets/css/widget.css**      ```css div.dashboard-widget-lesson_gauge_chart {     display: grid;     grid-template-rows: 1fr;     padding: 0;  }        div.dashboard-widget-lesson_gauge_chart .chart {     display: grid;     align-items: center;     justify-items: center;  }          div.dashboard-widget-lesson_gauge_chart .chart canvas {     background: white;  }        div.dashboard-widget-lesson_gauge_chart .description {     padding-bottom: 8px;     font-size: 1.750em;     line-height: 1.2;     text-align: center;  }      .dashboard-grid-widget-hidden-header div.dashboard-widget-lesson_gauge_chart .chart {     margin-top: 8px;  } ```      3.  Obriu *manifest.json* i afegiu el nom del fitxer (widget.css) a la matriu a la secció *assets/css*. Això permetrà que els estils CSS definits al widget.css es carreguin amb la pàgina del tauler.      **ui/modules/lesson_gauge_chart/manifest.json**      ```js {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix SIA",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "css": ["widget.css"],         "js": ["widget.js"]     } } ```      4.  Actualitzeu la pàgina del tauler per veure la versió acabada del giny.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_finished.png){width=850}       

en-us	#### Adding a filter to an LLD rule  Add a filter so that the contents of the *{\#FSTYPE}* macro would match the *\@File systems for discovery* regexp.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#FSTYPE}",                     "value": "@File systems for discovery"                 }             ]         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```
ca	#### 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ó](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "filter": {             "evaltype": 1,             "conditions": [                 {                     "macro": "{#FSTYPE}",                     "value": "@File systems for discovery"                 }             ]         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```

en-us	## Adding a module  Open *Administration→General→Modules* page and press *Scan directory*.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  Locate your module in the list and activate it.  To activate a module, press on the *Disabled* hyperlink - the module's state will change to *Enabled*.  Press on the module name to view additional information about the module, such as author, version, or short description (if defined in the manifest).
ca	## Afegir un mòdul  Obriu la pàgina *Administració→General→Mòduls* i premeu *Escanejar el directori*.  ![](../../../../assets/en/devel/modules/tutorials/widget/scan_dir.png)  Trobeu el vostre mòdul a la llista i activeu-lo.  Per activar el mòdul, premeu l'hiperenllaç *Desactivat*; l'estat del mòdul canviarà a *Activat*.  Premeu el nom del mòdul per veure informació addicional sobre el mòdul, com ara l'autor, la versió o una descripció breu (si es defineix al manifest).

en-us	#### Adding a scheduled downtime  Add a downtime for service with ID "4" scheduled weekly from Monday 22:00 till Tuesday 10:00.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "service.update",     "params": {         "serviceid": "4",         "times": [             {                 "type": "1",                 "ts_from": "165600",                 "ts_to": "201600"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "4"         ]     },     "id": 1 } ```
ca	#### Afegir un temps d'aturada planificat  Afegeix 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ó](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "service.update",     "params": {         "serviceid": "4",         "times": [             {                 "type": "1",                 "ts_from": "165600",                 "ts_to": "201600"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "serviceids": [             "4"         ]     },     "id": 1 } ```

en-us	#### Adding dashboards  To add dashboards to a template in *Data collection* → *Templates*, do the following:  1. Click on *Dashboards* in the row of the template. 2. Configure a dashboard following the guidelines of [configuring dashboards](/manual/web_interface/frontend_sections/dashboards).  ::: noteimportant When configuring widgets on a template dashboard (instead of a global dashboard), the host-related parameters are not available, and some parameters have a different label. This is because template dashboards display data only from the host that the template is linked to. For example, the parameters *Host groups*, *Exclude host groups* and *Hosts* in the [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) widget are not available, the parameter *Host groups* in the [*Host availability*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) widget is not available, and the parameter *Show hosts in maintenance* is renamed to *Show data in maintenance*, etc. For more information on the availability of parameters in template dashboard widgets, see specific parameters for each [dashboard widget](/manual/web_interface/frontend_sections/dashboards/widgets). :::  ::: notetip For details on accessing host dashboards that are created from template dashboards, see the [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards#access) section. :::
ca	#### Afegint taulers  Per afegir taulers a una plantilla a *Recollida de dades* → *Plantilles*, seguiu aquestes passes:  1. Feu clic a *Taulers de control* a la filera de la plantilla. 2. Configureu un tauler seguint les directrius de la [configuració de taulers](/manual/web_interface/frontend_sections/dashboards).  ::: noteimportant Quan es configuren ginys en un tauler de plantilla (en lloc d'un tauler global), els paràmetres relacionats amb l'equip no estan disponibles i alguns paràmetres tenen una etiqueta diferent. Això es deu al fet que els taulers de plantilla només mostren dades de l'equip al qual és enllaçada la plantilla. Per exemple, els paràmetres *Grups d'equips*, *Exclou grups d'equips* i *Equips* al giny [*Problems*](/manual/web_interface/frontend_sections/dashboards/widgets/problems) no estan disponibles, el paràmetre *Grups d'equips* al giny [*Disponibilitat de l'equip*](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) no és disponible i el paràmetre *Mostra els equips en manteniment* es canvia de nom a *Mostra les dades en manteniment. *, etc. Per obtindre més informació sobre la disponibilitat dels paràmetres als ginys del tauler de plantilla, consulteu els paràmetres específics per a cada [dashboard widget](/manual/web_interface/frontend_sections/dashboards/widgets). :::  ::: 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). :::

en-us	#### 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.  ![](../../../../../assets/en/manual/config/visualization/map_element.png){width="600"}  Map element attributes:  |Parameter|Description| |--|--------| |*Type*|Type of the element:<br>**Host** - icon representing status of all triggers of the selected host<br>**Map** - icon representing status of all elements of a map<br>**Trigger** - icon representing status of one or more triggers<br>**[Host group](/manual/config/visualization/maps/host_groups)** - icon representing status of all triggers of all hosts belonging to the selected group<br>**Image** - an icon, not linked to any resource| |*Label*|Icon label, any string.<br>Macros and multiline strings can be used.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>For a full list of supported macros, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map element labels'.| |*Label location*|Label location in relation to the icon:<br>**Default** - map's default label location<br>**Bottom** - beneath the icon<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the icon| |*Host*|Enter the host if the element type is 'Host'. This field is auto-complete so starting to type the name of a host will offer a dropdown of matching hosts. Scroll down to select. Click on 'x' to remove the selected.| |*Map*|Select the map if the element type is 'Map'. This field is auto-complete so starting to type the name of a map will offer a dropdown of matching maps. Scroll down to select. Click on 'x' to remove the selected.| |*Triggers*|If the element type is 'Trigger', select one or more triggers in the *New triggers* field below and click on *Add*.<br>The order of selected triggers can be changed, but only within the same severity of triggers. Multiple trigger selection also affects {HOST.\*} macro resolution both in the editing and view modes.<br>// 1 In editing mode// the first displayed {HOST.\*} macros will be resolved depending on the first trigger in the list (based on trigger severity).<br>// 2 View mode// depends on the [Display problems](/manual/config/visualization/maps/map#creating_a_map) parameter in General map attributes.<br>\* If *Expand single problem* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the latest detected problem trigger (not mattering the severity) or the first trigger in the list (in case no problem detected);<br>\* If *Number of problems and expand most critical one* mode is chosen, the first displayed {HOST.\*} macros will be resolved depending on the trigger severity.<br>| |*Host group*|Enter the host group if the element type is 'Host group'. This field is auto-complete so starting to type the name of a group will offer a dropdown of matching groups. Scroll down to select. Click on 'x' to remove the selected.| |*Tags*|Specify tags to limit the number of problems displayed in the widget. It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br>There are several operators available for each condition:<br>**Exists** - include the specified tag names<br>**Equals** - include the specified tag names and values (case-sensitive)<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>**Does not exist** - exclude the specified tag names<br>**Does not equal** - exclude the specified tag names and values (case-sensitive)<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive)<br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition<br>**Or** - enough if one condition is met<br>This field is available for host and host group element types.| |*Automatic icon selection*|In this case an icon mapping will be used to determine which icon to display.| |*Icons*|You can choose to display different icons for the element in these cases: default, problem, maintenance, disabled.| |*Coordinate X*|X coordinate of the map element.| |*Coordinate Y*|Y coordinate of the map element.| |*URLs*|Element-specific URLs (up to 2048 characters) can be set for the element. A label for the URL can also be defined. These will be displayed as links when a user clicks on the element in the map viewing mode. If the element has its own URLs and there are map level URLs for its type defined, they will be combined in the same menu.<br>Macros can be used in map element names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.|  ::: noteimportant Added elements are not automatically saved. If you navigate away from the page, all changes may be lost.  Therefore it is a good idea to click on the **Update** button in the top 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. :::
ca	#### 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ó *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. .  ![](../../../../../assets/en/manual/config/visualization/map_element.png){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'.Aquest camp s'emplena automàticament, de manera que començar a escriure el nom d'un mapa oferirà un desplegable de mapes coincidents. Desplaceu-vos cap avall per seleccionar. Feu clic a 'x' per eliminar el seleccionat.| |*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 d'un ú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.| |*Tria 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. :::

en-us	##### Adding host  Hosts are added during the discovery process, as soon as a host is discovered, rather than at the end of the discovery process.  ::: notetip As network discovery can take some time due to many unavailable hosts/services having patience and using reasonable IP ranges is advisable. :::  When adding a host, its name is decided by the standard **gethostbyname** function. If the host can be resolved, resolved name is used. If not, the IP address is used. Besides, if IPv6 address must be used for a host name, then all ":" (colons) are replaced by "\_" (underscores), since colons are not allowed in host names.  ::: noteimportant If performing discovery by a proxy, currently hostname lookup still takes place on Zabbix server. :::  ::: noteimportant If a host already exists in Zabbix configuration with the same name as  a newly discovered one, Zabbix will add **\_N** to the hostname,  where **N** is increasing number, starting with 2. :::
ca	##### 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, Zabbix afegirà **\_N** al nom d'equip, on **N** és un nombre creixent, començant per 2. :::

en-us	#### Adding host  Information about configured hosts in Zabbix is available in *Data collection → Hosts* and *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.\ ![](../../../assets/en/manual/quickstart/new_host.png)  All mandatory input fields are marked with a red asterisk.  The bare minimum to enter here is:  ***Host name***  -   Enter a host name. Alphanumerics, spaces, dots, dashes and     underscores are allowed.  ***Host groups***  -   Select one or several existing groups by clicking *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) will suit us with their defaults for now.  When done, click *Add*. Your new host should be visible in the host list.  ![](../../../assets/en/manual/quickstart/host_list.png){width="600"}  The Availability column contains indicators of host availability per each interface. We have defined a Zabbix agent interface, so we can use the agent availability icon (with 'ZBX' on it) to understand host availability:  -   ![icon\_zbx\_gray.png](../../../assets/en/manual/quickstart/icon_zbx_gray.png) -     host status has not been established; no metric check has happened     yet -   ![icon\_zbx\_green.png](../../../assets/en/manual/quickstart/icon_zbx_green.png) -     host is available, a metric check has been successful -   ![icon\_zbx\_red.png](../../../assets/en/manual/quickstart/icon_zbx_red.png) -     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.
ca	#### Afegir un equip  La informació sobre els equips configurats a Zabbix és disponible a *Configuració → Equips* i *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.\ ![](../../../assets/en/manual/quickstart/new_host.png)  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 d'equips***  - 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.  ![](../../../assets/en/manual/quickstart/host_list.png){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:  - ![icon\_zbx\_gray.png](../../../assets/en/manual/quickstart/icon_zbx_gray.png) - l'estat de l'equip no s'ha establert; encara no s'ha fet cap comprovació mètrica - ![icon\_zbx\_green.png](../../../assets/en/manual/quickstart/icon_zbx_green.png) - l'equip és disponible, una comprovació de mètriques ha estat correcta - ![icon\_zbx\_red.png](../../../assets/en/manual/quickstart/icon_zbx_red.png) - 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.

en-us	#### Adding hosts to host groups  Add two hosts to host groups with IDs 5 and 6.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massadd",     "params": {         "groups": [             {                 "groupid": "5"             },             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30001"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```
ca	#### Afegir equips a grups  Afegeix dos equips als grups d'equips amb IDs 5 i 6.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.massadd",     "params": {         "groups": [             {                 "groupid": "5"             },             {                 "groupid": "6"             }         ],         "hosts": [             {                 "hostid": "30050"             },             {                 "hostid": "30001"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "5",             "6"         ]     },     "id": 1 } ```

en-us	#### Adding host tags during discovery/autoregistration  Additional operations are now available for discovery and autoregistration events:  -   Add host tags -   Remove host tags
ca	#### Afegir etiquetes d'equip durant la descoberta/registre automàtic  Ara hi ha operacions addicionals disponibles per a esdeveniments de descoberta i registre automàtic:  - Afegir etiquetes d'equip - Esborrar les etiquetes d'equip

en-us	#### Adding item  All items are grouped around hosts. That is why to configure a sample item we go to *Data collection → Hosts* and find the "New host" we have created.  Click on the *Items* link in the row of "New host", and then click on *Create item*. This will present us with an item definition form.  ![](../../../assets/en/manual/quickstart/new_item.png){width="600"}  All mandatory input fields are marked with a red asterisk.  For our sample item, the essential information to enter is:  ***Name***  -   Enter *CPU load* as the value. This will be the item name displayed     in lists and elsewhere.  ***Key***  -   Manually enter *system.cpu.load* as the value. This is the technical     name of an item that identifies the type of information that will be     gathered. The particular key is just one of [pre-defined     keys](/manual/config/items/itemtypes/zabbix_agent) that come with     Zabbix agent.  ***Type of information***  -   This attribute defines the format of the expected data. For the     *system.cpu.load* key, this field will be automatically set to     *Numeric (float)*.  ::: noteclassic You may also want to reduce the number of days [item history](/manual/config/items/history_and_trends) will be kept, to 7 or 14. This is good practice to relieve the database from keeping lots of historical values. :::  [Other options](/manual/config/items/item#configuration) will suit us with their defaults for now.  When done, click *Add*. The new item should appear in the item list. Click on *Details* above the list to view what exactly was done.  ![](../../../assets/en/manual/quickstart/item_created.png)
ca	#### Afegir un element  Tots els elements s'agrupen al voltant dels equips. Per tant, per configurar un element d'exemple, anem a *Recull de dades → 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.  ![](../../../assets/en/manual/quickstart/new_item.png){width="600"}  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, fes clic a *Afegir*. El nou element hauria d'aparèixer a la llista d'elements. Feu clic a *Detalls* a sobre de la llista per veure exactament què s'ha fet.  ![](../../../assets/en/manual/quickstart/item_created.png)

en-us	#### Adding items, triggers, graphs  ::: noteimportant Items have to be added to a template first. Triggers and graphs cannot be added without the corresponding item. :::  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 *Data collection → 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*.\ 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.
ca	#### Afegir elements, triggers i gràfics  ::: noteimportant Primer s'han d'afegir elements a una plantilla. No es poden afegir triggers ni gràfics sense l'element corresponent. :::  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*  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.

en-us	#### Adding item to template  To add an item to the template, go to the item list for 'New host'. In *Data collection → 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 the item to.  ![](../../../assets/en/manual/quickstart/copy_to_template.png){width="600"}  All mandatory input fields are marked with a red asterisk.  -   Click on *Copy*.  If you now go to *Data collection* → *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).
ca	#### Afegir un model a l'element  Per afegir un element a la plantilla, aneu a la llista d'elements per a "Equip nou". A *Recull de dades→ 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.  ![](../../../assets/en/manual/quickstart/copy_to_template.png){width="600"}   Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  - Feu clic a *Copiar*.  Si ara aneu a *Recull de dades* → *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ó).

en-us	##### 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"]`.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_item.png){width="600"}  All mandatory input fields are marked with a red asterisk.  The fields that require specific information for JMX items are:  |   |   | |--|--------| |*Type*|Set **JMX agent** here.| |*Key*|The `jmx[]` item key contains three parameters:<br>**object name** - the object name of an MBean<br>**attribute name** - an MBean attribute name with optional composite data field names separated by dots<br>**unique short description** - a unique description that allows multiple JMX items with the same object name and attribute name on the host (optional)<br>See below for more detail on JMX item keys.<br>You may discover MBeans and MBean attributes using a `jmx.discovery[]` [low-level discovery](/manual/discovery/low_level_discovery/examples/jmx) item.| |*JMX endpoint*|You may specify a custom JMX endpoint. Make sure that JMX endpoint connection parameters match the JMX interface. This can be achieved by using {HOST.\*} macros as done in the default JMX endpoint.<br>{HOST.\*} [macros](/manual/appendix/macros/supported_by_location) and user macros are supported.| |*User name*|Specify the user name (up to 255 characters), if you have configured authentication on your Java application.<br>User macros are supported.| |*Password*|Specify the password (up to 255 characters), if you have configured authentication on your Java application.<br>User macros are supported.|  If you wish to monitor a Boolean counter that is either "true" or "false", then you specify type of information as "Numeric (unsigned)" and select "Boolean to decimal" preprocessing step in the Preprocessing tab. Server will store Boolean values as 1 or 0, respectively.
ca	##### 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"]`.  ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_item.png){width="600"}  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 (fins a 255 caracters), 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 (fins a 255 caracters), 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.

en-us	#### 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.  ![map\_line.png](../../../../../assets/en/manual/config/visualization/map_line.png){width="600"}
ca	#### 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.  ![map\_line.png](../../../../../assets/en/manual/config/visualization/map_line.png){width="600"}

en-us	#### Adding LLD macro paths  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.json.path"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```
ca	#### Afegir camils de macro LLD  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.update",     "params": {         "itemid": "22450",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.json.path"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "22450"         ]     },     "id": 1 } ```

en-us	#### Adding macros  Add two new macros to two hosts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.massadd",     "params": {         "hosts": [             {                 "hostid": "10160"             },             {                 "hostid": "10167"             }         ],         "macros": [             {                 "macro": "{$TEST1}",                 "value": "MACROTEST1"             },             {                 "macro": "{$TEST2}",                 "value": "MACROTEST2",                 "description": "Test description"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10160",             "10167"         ]     },     "id": 1 } ```
ca	#### Afegir macros  Afegeix dues macros noves a dos equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.massadd",     "params": {         "hosts": [             {                 "hostid": "10160"             },             {                 "hostid": "10167"             }         ],         "macros": [             {                 "macro": "{$TEST1}",                 "value": "MACROTEST1"             },             {                 "macro": "{$TEST2}",                 "value": "MACROTEST2",                 "description": "Test description"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10160",             "10167"         ]     },     "id": 1 } ```

en-us	#### Adding pages  To add a new page to a dashboard:  -   Make sure the dashboard is in the [editing     mode](#editing_a_dashboard) -   Click on the arrow next to the *Add* button and select the *Add     page* option  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_add.png)  -   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.  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_properties.png)  A new page will be added, indicated by a new tab (*Page 2*).  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_new.png)  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.
ca	#### Afegir pàgines  Per afegir una pàgina nova a un tauler:  - Assegureu-vos que el tauler de control sigui al [mode d'edició](#viewing_and_editing_a_dashboard) - Feu clic a la fletxa que hi ha al costat del botó *Afegir* i trieu l'opció *Afegir pàgina*  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_add.png)  - Ompliu els paràmetres generals de la pàgina i feu clic a *Aplicar*. Si deixeu el nom buit, la pàgina s'afegirà amb un nom de "Pàgina N", on "N" és el nombre incremental de la pàgina. El període de visualització de la pàgina permet personalitzar quant de temps es mostra una pàgina en una presentació de diapositives.  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_properties.png)  S'afegirà una pàgina nova, indicada per una nova pestanya (*Pàgina 2*).  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_new.png)  Les pàgines es poden reordenar arrossegant i deixant anar les pestanyes de la pàgina. La reordenació manté el nom de la pàgina original. Sempre és possible anar 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.

en-us	##### Adding permissions  By default, a new user has no permissions to access hosts and templates. To grant the user rights, click on the group of the user in the *Groups* column (in this case - 'Zabbix administrators'). In the group properties form, go to the *Host permissions* tab to assign permissions to host groups. Click on ![](../../../assets/en/manual/config/add_link.png){class="nozoom"} for the host group selection field to be displayed:  ![](../../../assets/en/manual/quickstart/group_permissions.png){width="600"}  Then click on *Select* next to the field to see the list of the host groups. This user is to have read-only access to *Linux servers* group, so mark the appropriate checkbox in the list and click on *Select* to confirm your choice.  ![](../../../assets/en/manual/quickstart/add_permissions.png){width="600"}  Click the *Read* button to set the permission level and then *Update* to save the changes made to the user group configuration.  To grant permissions to templates, you will need to switch to the *Template permissions* tab and specify template groups.   ::: noteimportant In Zabbix, access rights to hosts and templates are assigned to [user groups](/manual/config/users_and_usergroups/usergroup), not individual users. :::  Done! You may try to log in using the credentials of the new user.
ca	##### 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* per assignar permisos als grups d'equips.  ![](../../../assets/en/manual/quickstart/group_permissions.png){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.  ![](../../../assets/en/manual/quickstart/add_permissions.png){width="600"}   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*.  Per donar permisos a les plantilles, podeu canviar a la pestanya "Permisos de plantilles* i especificar grups de plantilles.  ::: 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.