en-us	#### Configuration  We assume that TimescaleDB extension has been already installed on the database server (see [installation instructions](https://docs.timescale.com/latest/getting-started/installation)).  TimescaleDB extension must also be enabled for the specific DB by executing:      echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix  Running this command requires database administrator privileges.  ::: noteclassic If you use a database schema other than 'public' you need to add a SCHEMA clause to the command above. E.g.:\ `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` :::  Then run the `timescaledb.sql` script located in database/postgresql. For new installations the script must be run after the regular PostgreSQL database has been created with initial schema/data (see [database creation](/manual/appendix/install/db_scripts)):      cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix  ::: noteimportant Please ignore warning messages informing that the best practices are not followed while running `timescaledb.sql` script on TimescaleDB version 2.9.0 and higher. Regardless of this warning, the configuration will be completed successfully. :::  The migration of existing history and trend data may take a lot of time. Zabbix server and frontend must be down for the period of migration.  The `timescaledb.sql` script sets the following housekeeping parameters:  -   Override item history period -   Override item trend period  In order to use partitioned housekeeping for history and trends, both these options must be enabled. It is also possible to enable override individually either for history only or trends only.  For PostgreSQL version 10.2 or higher and TimescaleDB version 1.5 or higher, the `timescaledb.sql` script sets two additional parameters:  -   Enable compression -   Compress records older than 7 days
ca	#### Configuració  Assumim que l'extensió TimescaleDB ja s'ha instal·lat al servidor de base de dades (veieu [instruccions d'instal·lació](https://docs.timescale.com/latest/getting-started/installation)).  L'extensió de TimescaleDB s'ha d'activar per la DB específica, executant:      echo "CREATE EXTENSION IF NOT EXISTS timescaledb CASCADE;" | sudo -u postgres psql zabbix  Per executar aquesta comanda cal privilegis d'administrador de la base de dades.  ::: noteclassic Si empreu un esquema de base de dades diferent a 'public', heu d'afegir una clàusula SCHEMA a la comanda de més amunt. Per exemple:\ `echo "CREATE EXTENSION IF NOT EXISTS timescaledb SCHEMA yourschema CASCADE;" | sudo -u postgres psql zabbix` :::  Després, executar l'script `timescaledb.sql` ubicat a database/postgresql. Per instal·lacions noves, l'script ha de córrer després de que la base de dades PostgreSQL s'hagi creat amb l'esquema inicial (veieu [creació de base de dades](/manual/appendix/install/db_scripts)):      cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb.sql | sudo -u zabbix psql zabbix  ::: noteimportant Ignoreu els missatges d'avís informatn que les millors pràctiques no s'han seguit quan executeu l'script `timescaledb.sql` a la versió 2.9.0 o superior de TimescaleDB. A banda d'aquest avís, la configuració s'executarà correctament. :::  La migració de l'historial i informació de tendències existents pot dur molt de temps. El servidor Zabbix i el frontal s'aturaran durant el període de migració.  L'script `timescaledb.sql` estableix els següents paràmetres de neteja:  -   Sobreescriure l'element del període històric -   Sobreescriure l'element del període de tendències  Per emprar neteja particionada per l'històric i les tendències, ambdós paràmetres s'han d'activar. També és possible activar la sobreescriptura individualment només per històric o tendències.  Per la versió 10.2 o superior de PostgreSQL i la versió 1.5 o superior de TimescaleDB, l'script `timescaledb.sql` estableix dos paràmetres més:  -   Permetre compressió -   Comprimir els registres anteriors a 7 dies

en-us	##### Configure database for Zabbix proxy  Edit zabbix\_proxy.conf:      # vi /etc/zabbix/zabbix_proxy.conf     DBHost=localhost     DBName=zabbix     DBUser=zabbix     DBPassword=<password>  In DBName for Zabbix proxy use a separate database from Zabbix server.  In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL.  Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. Refer to the [respective section](/manual/installation/install_from_packages/rhel#selinux_configuration) for RHEL for instructions.
ca	##### Configurar la base de dades per al proxy Zabbix  Modifiqueu l'arxiu zabbix\_proxy.conf :      # vi /etc/zabbix/zabbix_proxy.conf     DBHost=localhost     DBName=zabbix     DBUser=zabbix     DBPassword=<password>  A DBName per al proxy Zabbix, empreu una base de dades independent del servidor Zabbix.  A DBPassword, utilitzeu el mot de pas de la base de dades Zabbix per a MySQL; mot de pas d'usuari de PosgreSQL per a PosgreSQL.  Empreu `DBHost=` amb PostgreSQL. És possible que vulgueu mantindre el `DBHost=localhost` per defecte (o una adreça IP), però això obligaria a PostgreSQL a emprar un sòcol de xarxa per connectar-se a Zabbix. Consulteu la [secció rellevant](/manual/installation/install_from_packages/rhel#selinux_configuration) per obtindre instruccions per a RHEL.

en-us	##### Configure database for Zabbix proxy  Edit zabbix\_proxy.conf:      # vi /etc/zabbix/zabbix_proxy.conf     DBHost=localhost     DBName=zabbix     DBUser=zabbix     DBPassword=<password>  In DBName for Zabbix proxy use a separate database from Zabbix server.  In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL.  Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix. See [SELinux configuration](/manual/installation/install_from_packages/rhel#selinux_configuration) for instructions.
ca	##### Configurar la base de dades per al proxy Zabbix  Modifiqueu l'arxiu zabbix\_proxy.conf :      # vi /etc/zabbix/zabbix_proxy.conf     DBHost=localhost     DBName=zabbix     DBUser=zabbix     DBPassword=<password>  A DBName per al proxy Zabbix, empreu una base de dades independent del servidor Zabbix.  A DBPassword, utilitzeu el mot de pas de la base de dades Zabbix per a MySQL; mot de pas d'usuari de PosgreSQL per a PosgreSQL.  Empreu `DBHost=` amb PostgreSQL. És possible que vulgueu mantindre el `DBHost=localhost` per defecte (o una adreça IP), però això obligaria a PostgreSQL a emprar un sòcol de xarxa per connectar-se a Zabbix. Consulteu la [configuració d'SELinux](/manual/installation/install_from_packages/rhel#selinux_configuration) per obtindre instruccions per a RHEL.

en-us	#### Configure database for Zabbix server/proxy  Edit /etc/zabbix/zabbix\_server.conf (and zabbix\_proxy.conf) to use their respective databases. For example:      # vi /etc/zabbix/zabbix_server.conf     DBHost=localhost     DBName=zabbix     DBUser=zabbix     DBPassword=<password>  In DBPassword use Zabbix database password for MySQL; PostgreSQL user password for PostgreSQL.  Use `DBHost=` with PostgreSQL. You might want to keep the default setting `DBHost=localhost` (or an IP address), but this would make PostgreSQL use a network socket for connecting to Zabbix.
ca	#### Configurar la base de dades per al servidor/proxy Zabbix  Modifiqueu /etc/zabbix/zabbix\_server.conf (i zabbix\_proxy.conf) per emprar les respectives bases de dades. Per exemple:      # vi /etc/zabbix/zabbix_server.conf     DBHost=localhost     DBName=zabbix     DBUser=zabbix     DBPassword=<password>  A DBPassword, empreu el mot de pas de la base de dades Zabbix per MySQL; mot de pas d'usuari PostgreSQL per PostgreSQL.  Empreu `DBHost=` amb PostgreSQL. Voldreu conservar el paràmetre per defecte `DBHost=localhost` (o una adreça IP), però això obligarà que PostgreSQL empri un socket de xarxa per connectar-se a Zabbix.

en-us	#### Configure DB connection  Enter details for connecting to the database. Zabbix database must already be created.  ![](../../../assets/en/manual/installation/install_3a.png){width="550"}  If the *Database TLS encryption* option is checked, then additional fields for [configuring the TLS connection](/manual/appendix/install/db_encrypt) to the database appear in the form (MySQL or PostgreSQL only).  If *Store credentials in* is set to HashiCorp Vault or CyberArk Vault, additional parameters will become available:  - for [HashiCorp Vault](/manual/config/secrets/hashicorp): Vault API endpoint, secret path and authentication token;  - for [CyberArk Vault](/manual/config/secrets/cyberark): Vault API endpoint, secret query string and certificates. Upon marking *Vault certificates* checkbox, two new fields for specifying paths to SSL certificate file and SSL key file will appear.  ![](../../../assets/en/manual/installation/install_3b.png){width="550"}
ca	#### Configuració de la connexió de la base de dades  Introduïu els detalls de connexió de la base de dades. La base de dades Zabbix ja s'hauria de crear.  ![](../../../assets/en/manual/installation/install_3a.png){width="550"}  Si l'opció *Xifrat TLS de la base de dades* és marcada, apareixeran camps addicionals per a [configurar la connexió TLS](/manual/appendix/install/db_encrypt) a la base de dades (només MySQL o PostgreSQL).  Si es tria l'opció d'*emmagatzemar credencials a* HashiCorp Vault o CyberArk Vault, hi ha camps addicionals disponibles:  - per [HashiCorp Vault](/manual/config/secrets/hashicorp): el punt final de l'API Vault, el camí secret i el testimoni d'autenticació;  - per [CyberArk Vault](/manual/config/secrets/cyberark): el punt final de l'API Vault, cadena de consulta secreta i certificats. Un cop marcats *Certificats Vault*, apareixeran dos nous camps per definir les rutes a l'arxiu de certificat SSL i l'arxiu de clau SSL.  ![](../../../assets/en/manual/installation/install_3b.png){width="550"}

en-us	**Configure ODBC**  1\. Install unixODBC. The suggested way of installing unixODBC is to use the Linux operating system default package repositories.      apt install unixodbc  2\. Install the MariaDB unixODBC database driver. Although you have a MySQL database, the MariaDB unixODBC driver is used for compatibility issues.      apt install odbc-mariadb  3\. Check the location of the ODBC configuration files *odbcinst.ini* and *odbc.ini*.      odbcinst -j  The result of executing this command should be similar to the following.      unixODBC 2.3.9     DRIVERS............: /etc/odbcinst.ini     SYSTEM DATA SOURCES: /etc/odbc.ini     FILE DATA SOURCES..: /etc/ODBCDataSources     ...  4\. To configure the ODBC driver for monitoring a MySQL database, you need the driver name, which is located in the *odbcinst.ini* file. In the following *odbcinst.ini* file example, the driver name is "MariaDB Unicode".      [MariaDB Unicode]     Driver=libmaodbc.so     Description=MariaDB Connector/ODBC(Unicode)     Threading=0     UsageCount=1  5\. Copy the following contents to the *odbc.ini* file (replace *<password>* with the password of the "zbx_monitor" user). This guide uses "127.0.0.1" (localhost) as the MySQL server address for monitoring a MySQL server that is installed on the same machine as the ODBC driver. Note the data source name (DSN) "test", which will be required when [configure Zabbix frontend](#configure-zabbix-frontend).      [test]     Driver=MariaDB Unicode     Server=127.0.0.1     User=zbx_monitor     Password=<password>     Port=3306     Database=zabbix
ca	**Configurar ODBC**  1\. Instal·leu unixODBC. La forma suggerida d'instal·lar unixODBC és emprar els dipòsits de paquets predeterminats del sistema operatiu Linux.       apt install unixodbc  2\. Instal·leu el controlador de base de dades MariaDB unixODBC. Tot i que teniu una base de dades MySQL, el controlador MariaDB unixODBC s'empra per a problemes de compatibilitat.       apt install odbc-mariadb  3\. Comproveu la ubicació dels fitxers de configuració ODBC *odbcinst.ini* i *odbc.ini*.       odbcinst -j  El resultat d'executar aquesta ordre hauria de ser similar al següent.      unixODBC 2.3.9     DRIVERS............: /etc/odbcinst.ini     SYSTEM DATA SOURCES: /etc/odbc.ini     FILE DATA SOURCES..: /etc/ODBCDataSources     ...  4\. Per configurar el controlador ODBC per monitorar una base de dades MySQL, necessiteu el nom del controlador, que es troba al fitxer *odbcinst.ini*. A l'exemple de fitxer *odbcinst.ini* següent, el nom del controlador és "MariaDB Unicode".      [MariaDB Unicode]     Driver=libmaodbc.so     Description=MariaDB Connector/ODBC(Unicode)     Threading=0     UsageCount=1  5\. Copieu el contingut següent al fitxer *odbc.ini* (substituïu *<password>* per el mot de pas de l'usuari "zbx_monitor"). Aquesta guia empra "127.0.0.1" (localhost) com a adreça del servidor MySQL per monitorar un servidor MySQL que és instal·lat a la mateixa màquina que el controlador ODBC. Tingueu en compte el nom de la font de dades (DSN) "prova", que serà necessari quan [configureu la interfície Zabbix] (#configuring-zabbix-frontend).      [test]     Driver=MariaDB Unicode     Server=127.0.0.1     User=zbx_monitor     Password=<password>     Port=3306     Database=zabbix

en-us	 ###### Configure request  A request to execute the *Configure* function of the *Configurator* interface.  |   |   | |---|---| |direction|agent → plugin| |response|n/a|  Parameters specific to *Configure* requests:  |Name|Type|Comments| |---------|--------|----------| |global_options|JSON object|JSON object containing global agent configuration options.| |private_options|JSON object (optional)|JSON object containing private plugin configuration options, if provided.|  *Example:*      {"id":6,"type":8,"global_options":{...},"private_options":{...}}
ca	###### Petició de configuració  Una petició per executar la funció *Configure* de la interfície *Configurator*.  |   |   | |---|---| |direction|agent → plugin| |response|n/a|  Paràmetres específics de les peticions *Configure*:  |Nom|Tipus|Comentaris| |---------|--------|----------| |global_options|JSON object|Objecte JSON que conté les opcions de configuració globals de l'agent.| |private_options|JSON object (optional)|Objecte JSON que conté les opcions de configuració del plug-in privat, si es proporciona.|  *Exemple:*      {"id":6,"type":8,"global_options":{...},"private_options":{...}}

en-us	**Configure Zabbix agent**  1\. Navigate to the Zabbix agent additional configurations directory.      cd /usr/local/etc/zabbix/zabbix_agentd.d  ::: noteimportant The Zabbix agent additional configurations directory should be located in the same directory as your Zabbix agent configuration file (*zabbix_agentd.conf*). Depending on your OS and Zabbix installation, this directory can have a different location than specified in this guide. For default locations, check the [`Include`](/manual/appendix/config/zabbix_agentd#include) parameter in the Zabbix agent configuration file. :::  Instead of defining all of the necessary user parameters for monitoring the MySQL server in the Zabbix agent configuration file, these parameters will be defined in a separate file in the additional configurations directory.  2\. Create a *template_db_mysql.conf* file in the Zabbix agent additional configurations directory.      vi template_db_mysql.conf  3\. Copy the contents from the [*template_db_mysql.conf*](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/template_db_mysql.conf?at=refs%2Fheads%2Frelease%2F6.4) file (located in the Zabbix repository) to the *template_db_mysql.conf* file you created, and save.  4\. Restart Zabbix agent to update its configuration.      systemctl restart zabbix-agent  Once you have configured Zabbix agent user parameters, you can move on to configure the credentials that will allow Zabbix agent to access the MySQL server.
ca	**Configurar l'agent de Zabbix**  1\. Aneu al directori de configuracions addicionals de l'agent Zabbix.       cd /usr/local/etc/zabbix/zabbix_agentd.d  ::: noteimportant El directori de configuracions addicionals de l'agent Zabbix ha de ser al mateix directori que el fitxer de configuració de l'agent Zabbix (*zabbix_agentd.conf*). Segons el vostre sistema operatiu i la instal·lació de Zabbix, aquest directori pot tindre una ubicació diferent de la que s'especifica en aquesta guia. Per a les ubicacions predeterminades, comproveu el paràmetre [`Include`](/manual/appendix/config/zabbix_agentd#include) al fitxer de configuració de l'agent Zabbix. :::  En lloc de definir tots els paràmetres d'usuari necessaris per monitorar el servidor MySQL al fitxer de configuració de l'agent Zabbix, aquests paràmetres es definiran en un fitxer separat al directori de configuracions addicionals.  2\. Creeu un fitxer *template_db_mysql.conf* al directori de configuracions addicionals de l'agent Zabbix.       vi template_db_mysql.conf  3\. Copieu el contingut de [*template_db_mysql.conf*](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/db/mysql_agent/template_db_mysql.conf?at=refs%2Fheads%2Frelease%2F6.4) (situat al dipòsit Zabbix) al fitxer *template_db_mysql.conf* que heu creat i deseu-lo.  4\. Reinicieu l'agent Zabbix per actualitzar la seva configuració.       systemctl restart zabbix-agent  Un cop hagueu configurat els paràmetres d'usuari de l'agent Zabbix, podeu passar a configurar les credencials que permetran a l'agent Zabbix accedir al servidor MySQL.

en-us	 ## Configure Zabbix for monitoring  1\. Log into Zabbix frontend.  2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface.   This host will represent your Apache server.   3\. In the *Interfaces* parameter, add *Agent* interface and specify your Apache instance IP address.  **You don't need to install Zabbix agent on the machine**, the interface will only be used for resolving {HOST.CONN} macro.  This macro is used in template items to locate Apache instance.    4\. In the *Templates* parameter, type or select *Apache by HTTP*.   ![](../../../assets/en/manual/guides/apache_host.png)  5\. Switch to the **Macros** tab and select *Inherited and host macros* mode. Check that values of the macros  {$APACHE.STATUS.PORT} and {$APACHE.STATUS.SCHEME} suit your installation settings.  By default, the port is 80 and the scheme is http. Change macro values if you use different port and/or scheme.   ![](../../../assets/en/manual/guides/apache_host_macros.png){width="600"}
ca	 ## Configurar Zabbix per monitorar  1\. Inicieu sessió a la interfície de Zabbix.  2\. [Creeu un equip](/manual/config/hosts/host) a la interfície web de Zabbix.  Aquest equip representarà el vostre servidor Apache.  3\. Al paràmetre *Interfícies*, afegiu la interfície *Agent* i especifiqueu l'adreça IP de la vostra instància d'Apache. **No cal que instal·leu l'agent Zabbix a la màquina**, la interfície només s'emprarà per resoldre la macro {HOST.CONN}. Aquesta macro s'empra als elements de plantilla per localitzar la instància d'Apache.  4\. Al paràmetre *Plantilles*, escriviu o trieu *Apache per HTTP*.  ![](../../../assets/en/manual/guides/apache_host.png)  5\. Canvieu a la pestanya **Macros** i trieu el mode *Macros heretades i equips*. Comproveu que els valors de les macros {$APACHE.STATUS.PORT} i {$APACHE.STATUS.SCHEME} s'adaptin a la configuració d'instal·lació. Per defecte, el port és 80 i l'esquema és http. Canvieu els valors de la macro si feu servir un port i/o un esquema diferent.  ![](../../../assets/en/manual/guides/apache_host_macros.png){width="600"}

en-us	 ## Configure Zabbix for monitoring  Zabbix agent can collect metrics in active or passive mode (simultaneously).   ::: noteclassic A passive check is a simple data request. Zabbix server or proxy asks for some data (for example, CPU load) and Zabbix  agent sends back the result to the server. Active checks require more complex processing. The agent must first retrieve  from the server(s) a list of items for independent processing and then bulk send the data back.  See [Passive and active agent checks](/manual/appendix/items/activepassive) for more info. :::  Monitoring templates provided by Zabbix usually offer two alternatives - a template for Zabbix agent and a template for  Zabbix agent (active). With the first option, the agent will collect metrics in passive mode.  Such templates will deliver identical monitoring results, but using different communication protocols.   Further Zabbix configuration depends on whether you select a template for [active](#active-checks) or  [passive](#passive-checks) Zabbix agent checks.
ca	 ## Configurar Zabbix per monitorar  L'agent Zabbix pot recopilar mètriques en mode actiu o passiu (simultàniament).  ::: noteclassic Una comprovació passiva és una simple petició de dades. El servidor o el proxy Zabbix demana algunes dades (per exemple, la càrrega de la CPU) i l'agent Zabbix envia el resultat al servidor. Els controls actius requereixen un processament més complex. L'agent primer ha de recuperar dels servidors una llista d'elements per al processament independent i després enviar les dades de manera massiva. Consulteu [Comprovacions d'agent passiu i actiu](/manual/appendix/items/activepassive) per obtindre més informació. :::  Les plantilles de monitoratge proporcionades per Zabbix solen oferir dues alternatives: una plantilla per a l'agent Zabbix i una plantilla per a l'agent Zabbix (actiu). Amb la primera opció, l'agent recopilarà mètriques en mode passiu. Aquestes plantilles oferiran resultats de seguiment idèntics, però emprant protocols de comunicació diferents.  La configuració addicional de Zabbix depèn de si trieu una plantilla per a les comprovacions de l'agent Zabbix [activa](#active-checks) o [passiva](#passive-checks).

en-us	 ## Configure Zabbix for monitoring  Zabbix agent can collect metrics in active or passive mode (simultaneously).   ::: noteclassic A passive check is a simple data request. Zabbix server or proxy asks for some data (for example, CPU load) and Zabbix  agent sends back the result to the server. Active checks require more complex processing. The agent must first retrieve  from the server(s) a list of items for independent processing and then bulk send the data back. See  [Passive and active agent checks](/manual/appendix/items/activepassive) for more info. :::  Monitoring templates provided by Zabbix usually offer two alternatives - a template for Zabbix agent and a template for  Zabbix agent (active). With the first option, the agent will collect metrics in passive mode. Such templates will deliver  identical monitoring results, but using different communication protocols.   Further Zabbix configuration depends on whether you select a template for [active](#active-checks) or  [passive](#passive-checks) Zabbix agent checks.
ca	 ## Configura Zabbix per al monitoratge  L'agent Zabbix pot recollir mètriques en mode actiu o passiu (simultàniament).  ::: noteclassic Una comprovació passiva és una simple petició de dades. El servidor o proxy Zabbix demana algunes dades (per exemple, la càrrega de la CPU) i l'agent Zabbix retorna el resultat al servidor. Els controls actius requereixen un processament més complex. L'agent primer ha de recuperar des del servidor(s) una llista d'elements per al processament independent i, a continuació, enviar les dades de manera massiva. Veieu [Comprovacions d'agent passiu i actiu](/manual/appendix/items/activepassive) per obtindre més informació. :::  Les plantilles de monitoratge proporcionades per Zabbix solen oferir dues alternatives: una plantilla per a l'agent de Zabbix i una plantilla per a l'Agent Zabbix (actiu). Amb la primera opció, l'agent recopilarà mètriques en mode passiu. Aquestes plantilles es lliuraran resultats de seguiment idèntics, però emprant protocols de comunicació diferents.  La configuració addicional de Zabbix depèn de si trieu una plantilla per a comprovacions [actives](#active-checks) o [passives](#passive-checks) de l'agent Zabbix.

en-us	#### Configure Zabbix frontend  1\. Log into Zabbix frontend.  2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface:  -   In the *Host name* field, enter a host name (e.g., "MySQL server"). -   In the *Templates* field, type or select the template "MySQL by Zabbix agent 2" that will be [linked](/manual/config/templates/linking) to the host. -   In the *Host groups* field, type or select a host group (e.g., "Databases"). -   In the *Interfaces* field, add an interface of type "Agent" and specify your MySQL server IP address.     This guide uses "127.0.0.1" (localhost) for monitoring a MySQL server that is installed on the same machine as Zabbix server and Zabbix agent 2.  ![](../../../assets/en/manual/guides/mysql_host.png){width="600"}  -   In the *Macros* tab, switch to *Inherited and host macros*, look for the following macros and click on *Change* next to the macro value to update it:     -   {$MYSQL.DSN} - set the data source of the MySQL server (the [connection string of a named session](/manual/appendix/config/zabbix_agent2_plugins/mysql_plugin#parameters) from the MySQL Zabbix agent 2 plugin configuration file).         This guide uses the default data source "tcp://localhost:3306" for monitoring a MySQL server that is installed on the same machine as Zabbix server and Zabbix agent 2.     -   {$MYSQL.PASSWORD} - set the password of the previously [created MySQL user](#create-mysql-user) "zbx_monitor".     -   {$MYSQL.USER} - set the name of the previously [created MySQL user](#create-mysql-user) "zbx_monitor".  ![](../../../assets/en/manual/guides/mysql_macros.png){width="600"}  3\. Click on *Add* to add the host. This host will represent your MySQL server.
ca	### Configurar la interfície de Zabbix  1\. Inicieu sessió a la interfície de Zabbix.  2\. [Creeu un equip](/manual/config/hosts/host) a la interfície web de Zabbix:  - Al camp *Nom d'equip*, introduïu un nom d'equip (p. ex., "Servidor MySQL"). - Al camp *Plantilles*, escriviu o trieu la plantilla "MySQL by Zabbix agent 2" que serà [enllaçada](/manual/config/templates/linking) a l'equip. - Al camp *Grups d'equip*, escriviu o trieu un grup d'equip (p. ex., "Bases de dades"). - Al camp *Interfícies*, afegiu una interfície de tipus "Agent" i especifiqueu l'adreça IP del vostre servidor MySQL.      Aquesta guia empra "127.0.0.1" (localhost) per monitorar un servidor MySQL que és instal·lat a la mateixa màquina que el servidor Zabbix i l'agent Zabbix 2.  ![](../../../assets/en/manual/guides/mysql_host.png){width="600"}  - A la pestanya *Macros*, canvieu a *Macros heretades i equip*, cerqueu les macros següents i feu clic a *Canviar* al costat del valor de la macro per actualitzar-la:      - {$MYSQL.DSN} - estableix la font de dades del servidor MySQL (la [cadena de connexió d'una sessió anomenada](/manual/appendix/config/zabbix_agent2_plugins/mysql_plugin#parameters) des del fitxer de configuració del connector MySQL Zabbix agent 2) .          Aquesta guia empra la font de dades predeterminada "tcp://localhost:3306" per monitorar un servidor MySQL que és instal·lat a la mateixa màquina que el servidor Zabbix i l'agent Zabbix 2.      - {$MYSQL.PASSWORD} - estableix el mot de pas de l'usuari anterior [creat a MySQL](#creating-a-mysql-user) "zbx_monitor".      - {$MYSQL.USER} - estableix el nom de l'usuari anterior [creat a MySQL](#creating-a-mysql-user) "zbx_monitor".  ![](../../../assets/en/manual/guides/mysql_macros.png){width="600"}  3\. Feu clic a *Afegir* per afegir l'equip. Aquest equip representarà el vostre servidor MySQL.

en-us	#### Configure Zabbix frontend  1\. Log into Zabbix frontend.  2\. [Create a host](/manual/config/hosts/host) in Zabbix web interface:  - In the *Host name* field, enter a host name (for example, "VMware environment"). - In the *Templates* field, type or select the "VMware FQDN" (or "VMware") template. For more information on these templates, see [Virtual machine monitoring](/manual/vm_monitoring#ready-to-use-templates). - In the *Host groups* field, type or select a host group (for example, a new host group "VMware").  ![](../../../assets/en/manual/guides/vmware_host.png){width="600"}  - In the *Macros* tab, set the following host macros:     - {$VMWARE.URL} - VMware service (vCenter or ESXi hypervisor) SDK URL (https://servername/sdk)     - {$VMWARE.USERNAME} - VMware service user name     - {$VMWARE.PASSWORD} - VMware service {$VMWARE.USERNAME} user password  ![](../../../assets/en/manual/guides/vmware_macros.png){width="600"}  3\. Click the *Add* button to create the host. This host will represent your VMware environment.
ca	#### Configura la interfície Zabbix  1\. Inicieu sessió a la interfície de Zabbix.  2\. [Creeu un equip](/manual/config/hosts/host) a la interfície web de Zabbix:  - Al camp *Nom d'equip*, poseu-hi un nom d'equip (per exemple, "Entorn VMware"). - Al camp *Plantilles*, escriviu o trieu la plantilla "VMware FQDN" (o "VMware"). Per obtindre més informació sobre aquestes plantilles, veieu [Monitoratge de màquines virtuals](/manual/vm_monitoring#ready-to-use-templates). - Al camp *Grups d'equips*, escriviu o trieu un grup d'equips (per exemple, un grup d'equips nou "VMware").  ![](../../../assets/en/manual/guides/vmware_host.png){width="600"}  - A la pestanya *Macros*, configureu les macros d'equip següents:     - {$VMWARE.URL} - Servei VMware (vCenter o hipervisor ESXi) URL SDK (https://servername/sdk)     - {$VMWARE.USERNAME}: nom d'usuari del servei VMware     - {$VMWARE.PASSWORD} - Mot de pas d'usuari del servei VMware {$VMWARE.USERNAME}  ![](../../../assets/en/manual/guides/vmware_macros.png){width="600"}  3\. Feu clic al botó *Afegir* per crear l'equip. Aquest equip representarà el vostre entorn VMware.

en-us	**Configure Zabbix frontend and test your configuration**  To configure Zabbix frontend, follow the instructions in the [*Configure Zabbix frontend*](#configure-zabbix-frontend) section with the following adjustments:  -   In the *Templates* field, type or select the template "MySQL by ODBC" that will be [linked](/manual/config/templates/linking) to the host. -   Configuring *Interfaces* is not required. -   The {$MYSQL.DSN} macro value In the *Inherited and host macros* section of the MySQL server host configuration should be set to the DSN name from the *odbc.ini* file.  Once you have configured Zabbix frontend, you can [view collected metrics](#view-collected-metrics), [set up problem alerts](#set-up-problem-alerts) and [test your configuration](#test-your-configuration).
ca	**Configuració de la interfície de Zabbix i prova de la configuració**  Per configurar la interfície Zabbix, seguiu les instruccions de la secció [*Configuració de la interfície Zabbix*](#configuring-zabbix-frontend) amb els següents canvis:  - Al camp *Plantilles*, escriviu o trieu la plantilla "MySQL per ODBC" que serà [enllaçada](/manual/config/templates/linking) a l'equip. - No cal configurar *Interfícies*. - El valor de la macro {$MYSQL.DSN} A la secció *Macros heretades i d'equip* de la configuració de l'equip del servidor MySQL s'ha d'establir amb el nom DSN del fitxer *odbc.ini*.  Un cop hagueu configurat la interfície de Zabbix, podeu [veure les mètriques recopilades](#viewing-collected-metrics), [configurar alertes de problemes](#setting-up-problem-alerts) i [provar la vostra configuració](#testing-your -configuració).

en-us	**Configure Zabbix frontend and test your configuration**  To configure Zabbix frontend, follow the instructions in the [*Configure Zabbix frontend*](#configure-zabbix-frontend) section with the following adjustments:  -   In the *Templates* field, type or select the template "MySQL by Zabbix agent" that will be [linked](/manual/config/templates/linking) to the host. -   Configuring *Macros* is not required.  Once you have configured Zabbix frontend, you can [view collected metrics](#view-collected-metrics) and [set up problem alerts](#set-up-problem-alerts).  To test your configuration, follow the instructions in the [*Test your configuration*](#test-your-configuration) section with the following adjustments:  -   In the *Inherited and host macros* section of the MySQL server host configuration, click on *Change* next to the {$MYSQL.PORT} macro value and set a different port (e.g., "6033").  ![](../../../assets/en/manual/guides/mysql_port.png){width="600"}
ca	**Configuració de la interfície de Zabbix i prova de la vostra configuració**  Per configurar la interfície Zabbix, seguiu les instruccions de la secció [*Configuració de la interfície Zabbix*](#configuring-zabbix-frontend) amb els següents canvis:  - Al camp *Plantilles*, escriviu o trieu la plantilla "MySQL by Zabbix agent" que serà [enllaçada](/manual/config/templates/linking) a l'equip. - No cal configurar *Macros*.  Un cop hagueu configurat la interfície Zabbix, podeu [veure les mètriques recollides](#viewing-collected-metrics) i [configurar alertes de problemes](#setting-up-problem-alerts).  Per provar la vostra configuració, seguiu les instruccions de la secció [*Provar la configuració configuració*](#testing-your-configuration) amb els canvis següents:  - A la secció *Macros heretades i d'equip* de la configuració de l'equip del servidor MySQL, feu clic a *Canviar* al costat del valor de la macro {$MYSQL.PORT} i configureu un port diferent (p. ex., "6033").  ![](../../../assets/en/manual/guides/mysql_port.png){width="600"}

en-us	#### Configure Zabbix server  To monitor VMware, the *vmware collector* Zabbix processes need to be enabled. For more information on how VMware monitoring is performed, see [Virtual machine monitoring](/manual/vm_monitoring#data-collection).  1\. Open the Zabbix server configuration file.  ```bash vi /etc/zabbix/zabbix_server.conf ```  2\. Locate and set the [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) parameter in Zabbix server configuration file to `2` [or more](/manual/vm_monitoring#configuration) (the default value is `0`).  ```ini ### Option: StartVMwareCollectors #       Number of pre-forked vmware collector instances. # # Mandatory: no # Range: 0-250 # Default: # StartVMwareCollectors=0  StartVMwareCollectors=2 ```  3\. Restart Zabbix server.  ```bash systemctl restart zabbix-server ```  Once the *vmware collector* processes have been started, move on to the next step.
ca	#### Configurar el servidor Zabbix  Per monitorar VMware, cal que els processos Zabbix *col·lector de vmware* siguin habilitats. Per obtindre més informació sobre com es realitza el monitoratge de VMware, consulteu [Monitoratge de màquines virtuals](/manual/vm_monitoring#data-collection).  1\. Obriu el fitxer de configuració del servidor Zabbix.  ```bash vi /etc/zabbix/zabbix_server.conf ```  2\. Cerqueu i configureu el paràmetre [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) al fitxer de configuració del servidor Zabbix a `2` [o a](/manual/vm_monitoring#configuration) (el valor predeterminat és `0 `).  ```ini ### Option: StartVMwareCollectors #Number of pre-forked vmware collector instances. # # Mandatory: no # Range: 0-250 # Default: # StartVMwareCollectors=0  StartVMwareCollectors=2 ```  3\. Reinicieu el servidor Zabbix.  ```bash systemctl restart zabbix-server ```  Un cop iniciats els processos *vmware collector*, passeu a la passa següent.

en-us	#### Configuring a *Clock* widget  Configure a *Clock* widget that displays local date, time and time zone in a customized digital clock.   [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "clock",                         "name": "Clock",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "clock_type",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "adv_conf",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "date_size",                                 "value": 20                             },                             {                                 "type": 1,                                 "name": "date_color",                                 "value": "E1E1E1"                             },                             {                                 "type": 0,                                 "name": "time_bold",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "tzone_size",                                 "value": 10                             },                             {                                 "type": 1,                                 "name": "tzone_color",                                 "value": "E1E1E1"                             },                             {                                 "type": 1,                                 "name": "tzone_timezone",                                 "value": "Europe/Riga"                             },                             {                                 "type": 0,                                 "name": "tzone_format",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *Rellotge*  Configurar el giny *Rellotge* que ensenya l'hora local i la zona horària en un rellotge digital personalitzat.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "clock",                         "name": "Clock",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "clock_type",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "adv_conf",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "date_size",                                 "value": 20                             },                             {                                 "type": 1,                                 "name": "date_color",                                 "value": "E1E1E1"                             },                             {                                 "type": 0,                                 "name": "time_bold",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "tzone_size",                                 "value": 10                             },                             {                                 "type": 1,                                 "name": "tzone_color",                                 "value": "E1E1E1"                             },                             {                                 "type": 1,                                 "name": "tzone_timezone",                                 "value": "Europe/Riga"                             },                             {                                 "type": 0,                                 "name": "tzone_format",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Data overview* widget  Configure a *Data overview* widget that displays data for host "10084" and only for items for which the tag with the name "component" contains value "cpu". In addition, display the data with hosts located on top.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "dataover",                         "name": "Data overview",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 3,                                 "name": "hostids",                                 "value": 10084                             },                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "component"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "cpu"                             },                             {                                 "type": 0,                                 "name": "style",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *Vista general de dades*  Configura un giny *Vista general de dades* que ensenya la informació de l'equip "10084" i només per elements on el nom d'etiqueta "component" contingui el valor "cpu". A més, ensenyarà la informació amb l'equip a dalt de tot.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "dataover",                         "name": "Data overview",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 3,                                 "name": "hostids",                                 "value": 10084                             },                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "component"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "cpu"                             },                             {                                 "type": 0,                                 "name": "style",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Favorite graphs* widget  Configure a *Favorite graphs* widget with the refresh interval set to 10 minutes.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "favgraphs",                         "name": "Favorite graphs",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "rf_rate",                                 "value": 600                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *Gràfics preferits*  Configura un giny de *Gràfics preferits* amb l'interval de refresc establert a 10 minuts.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "favgraphs",                         "name": "Favorite graphs",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "rf_rate",                                 "value": 600                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Favorite maps* widget  Configure a *Favorite maps* widget with the refresh interval set to 10 minutes.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "favmaps",                         "name": "Favorite maps",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "rf_rate",                                 "value": 600                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *Mapes preferits*  Configura un giny de *Mapes preferits* amb interval de refresc de 10 minuts.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "favmaps",                         "name": "Mapes preferits",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "rf_rate",                                 "value": 600                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring agent  Both generations of Zabbix agents run as a Windows service. For Zabbix agent 2, replace *agentd* with *agent2* in the instructions below.  You can run a single instance of Zabbix agent or multiple instances of the agent on a Microsoft Windows host. A single instance can use the default configuration file `C:\zabbix_agentd.conf` or a configuration file specified in the command line. In case of multiple instances each agent instance must have its own configuration file (one of the instances can use the default configuration file).  An example configuration file is available in Zabbix source archive as `conf/zabbix_agentd.win.conf`.  See the [configuration file](/manual/appendix/config/zabbix_agentd_win) options for details on configuring Zabbix Windows agent.
ca	#### Configuració de l'agent  Les dues generacions d'agents Zabbix s'executen com a servei de Windows. Per l'agent Zabbix 2, canvieu *agentd* per *agent2* a les instruccions de sota.  Podeu executar una sola instància de l'agent Zabbix o més d'una en un equip Microsoft Windows. Una sola instància pot emprar l'arxiu de configuració per defecte `C:\zabbix_agentd.conf` o un arxiu de configuració especificat a la línia de comandes. En cas d'instàncies múltiples, cadascuna de les instàncies de l'agent ha de tindre el seu propi fitxer de configuració (una de les instàncies sí que pot emprar l'arxiu de configuració per defecte).  Un exemple d'arxiu de configuració (`conf/zabbix_agentd.win.conf`) es pot trobar a l'arxiu font de Zabbix.  Veieu les opcions de l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) per tindre més detalls de la configuració de l'agent Windows de Zabbix.

en-us	#### Configuring a *Geomap* widget  Configure a *Geomap* widget that displays hosts from host groups "2" and "22" based on the following tag configuration: tag with the name "component" contains value "node", and tag with the name "location" equals value "New York". In addition, set the map initial view to coordinates "40.6892494" (latitude), "-74.0466891" (longitude) with the zoom level "10".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "geomap",                         "name": "Geomap",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 22                             },                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "default_view",                                 "value": "40.6892494,-74.0466891,10"                             },                             {                                 "type": 0,                                 "name": "evaltype",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "component"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "node"                             },                             {                                 "type": 1,                                 "name": "tags.tag.1",                                 "value": "location"                             },                             {                                 "type": 0,                                 "name": "tags.operator.1",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.value.1",                                 "value": "New York"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configura un giny de *Geomapa*  Configura un giny de *Geomapa* que ensenya els equips dels grups "2" i "22" segons la següent configuració d'etiqueta: l'etiqueta amb el nom "component" té el valor "node", i l'etiqueta amb el nom "ubicació" té com a valor "Nova York". A més, establim la vista inicial del mapa a les coordenades "40.6892494" (latitud), "-74.0466891" (longitud) amb nivell de zoom "10".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "geomap",                         "name": "Mapa geogràfic",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 22                             },                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "default_view",                                 "value": "40.6892494,-74.0466891,10"                             },                             {                                 "type": 0,                                 "name": "evaltype",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "component"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "node"                             },                             {                                 "type": 1,                                 "name": "tags.tag.1",                                 "value": "ubicació"                             },                             {                                 "type": 0,                                 "name": "tags.operator.1",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.value.1",                                 "value": "Nova York"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a global script  ![](../../../../../assets/en/manual/web_interface/script.png)  Script attributes:  |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique name of the script.<br>E.g. `Clear /tmp filesystem`| |*Scope*|<|Scope of the script - action operation, manual host action or manual event action. This setting determines where the script can be used - in remote commands of action operations, from the [host menu](/manual/web_interface/menu/host_menu) or from the [event menu](/manual/web_interface/menu/event_menu) respectively.<br>Setting the scope to 'Action operation' makes the script available for all users with access to *Alerts* → *Actions*.<br>If a script is actually used in an action, its scope cannot be changed away from 'action operation'.<br>**Macro support**<br>The scope affects the range of available macros. For example, user-related macros ({USER.\*}) are supported in scripts to allow passing information about the user that launched the script. However, they are not supported if the script scope is action operation, as action operations are executed automatically.<br>To find out which macros are supported, do a search for 'Trigger-based notifications and commands/Trigger-based commands', 'Manual host action scripts' and 'Manual event action scripts' in the [supported macro](/manual/appendix/macros/supported_by_location) table. Note that if a macro may resolve to a value with spaces (for example, host name), don't forget to quote as needed.| |*Menu path*|<|The desired menu path to the script. For example, `Default` or `Default/`, will display the script in the respective directory. Menus can be nested, e.g. `Main menu/Sub menu1/Sub menu2`. When accessing scripts through the host/event menu in monitoring sections, they will be organized according to the given directories.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Type*|<|Click the respective button to select script type:<br>**URL**, **Webhook**, **Script**, **SSH**, **Telnet** or **[IPMI](/manual/config/notifications/action/operation/remote_command#ipmi_remote_commands)** command.<br> The type **URL** is available only when 'Manual host action' or 'Manual event action' is selected as *Scope*. | | |Script type: URL|<| |^|*URL*|Specify the URL for quick access from the [host menu](/manual/web_interface/menu/host_menu) or [event menu](/manual/web_interface/menu/event_menu).<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported. Macro support depends on the scope of the script (see *Scope* above). <br> Macro values must not be URL-encoded. | |^|*Open in new window*|Determines whether the URL should be opened in a new or the same browser tab.| | |Script type: Webhook|<| |^|*Parameters*|Specify the webhook variables as attribute-value pairs.<br>See also: [Webhook](/manual/config/notifications/media/webhook) media configuration.<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported in parameter values. Macro support depends on the scope of the script (see *Scope* above).| |^|*Script*|Enter the JavaScript code in the block that appears when clicking in the parameter field (or on the view/edit button next to it).<br>Macro support depends on the scope of the script (see *Scope* above).<br>See also: [Webhook](/manual/config/notifications/media/webhook) media configuration, [Additional Javascript objects](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Timeout*|JavaScript execution timeout (1-60s, default 30s).<br>Time suffixes are supported, e.g. 30s, 1m.| | |Script type: Script|<| |^|*Execute on*|Click the respective button to execute the shell script on:<br>**Zabbix agent** - the script will be executed by Zabbix agent (if the system.run item is [allowed](/manual/config/items/restrict_checks)) on the host<br>**Zabbix server (proxy)** - the script will be executed by Zabbix server or proxy (if enabled by [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy)) - depending on whether the host is monitored by server or proxy<br>**Zabbix server** - the script will be executed by Zabbix server only| |^|*Commands*|Enter full path to the commands to be executed within the script.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: SSH|<| |^|*Authentication method*|Select authentication method - password or public key.| |^|*Username*|Enter the username.| |^|*Password*|Enter the password.<br>This field is available if 'Password' is selected as the authentication method.| |^|*Public key file*|Enter the path to the public key file.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Private key file*|Enter the path to the private key file.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Passphrase*|Enter the passphrase.<br>This field is available if 'Public key' is selected as the authentication method.| |^|*Port*|Enter the port.| |^|*Commands*|Enter the commands.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: Telnet|<| |^|*Username*|Enter the username.| |^|*Password*|Enter the password.| |^|*Port*|Enter the port.| |^|*Commands*|Enter the commands.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| | |Script type: IPMI|<| |^|*Command*|Enter the IPMI command.<br>Macro support depends on the scope of the script (see *Scope* above). Custom [user macros](/manual/config/macros/user_macros) are supported.| |*Description*|<|Enter a description for the script.| |*Host group*|<|Select the host group that the script will be available for (or *All* for all host groups).| |*User group*|<|Select the user group that the script will be available to (or *All* for all user groups).<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Required host permissions*|<|Select the permission level for the host group - *Read* or *Write*. Only users with the required permission level will have access to executing the script.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Enable confirmation*|<|Mark the checkbox to display a confirmation message before executing the script. This feature might be especially useful with potentially dangerous operations (like a reboot script) or ones that might take a long time.<br>This option is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.| |*Confirmation text*|<|Enter a custom confirmation text for the confirmation popup enabled with the checkbox above (for example, *Remote system will be rebooted. Are you sure?*). To see how the text will look like, click on *Test confirmation* next to the field.<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported.<br>*Note:* the macros will not be expanded when testing the confirmation message.<br>This field is displayed only if 'Manual host action' or 'Manual event action' is selected as *Scope*.|
ca	#### Configuració d'un script global  ![](../../../../../assets/en/manual/web_interface/script.png)  Attributs de l'script:  |Paràmetre|<|Descripció| |-|----------|----------------------------------------| |*Nom*|<|Nom únic de l'script.<br>Ex. `Busqueu el sistema de fitxers /tmp`| |*Àmbit*|<|Àmbit de l'script: operació d'acció, acció manual de l'equip o acció manual d'esdeveniments. Aquesta configuració determina on es pot emprar l'script: a les comandes remotes d'operacions d'acció, des del [menú equips](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu) o des del [menú d'esdeveniments](/manual/web_interface/frontend_sections/monitoring/problems#event_menu) respectivament.<br>Establir l'abast a "Acció d'operació" fa que l'script sigui disponible per a tots els usuaris amb accés a *Configuració* → *Accions*.<br>Si realment s'empra un script en un acció, el seu abast no es pot canviar fora de l'"Acció d'operació".<br>**Compatibilitat amb macros**<br>L'abast afecta el rang de macros disponibles. Per exemple, les macros relacionades amb l'usuari ({USER.\*}) s'admeten als scripts per permetre que es transmeti informació sobre l'usuari que va iniciar l'script. Tanmateix, no s'admeten si l'abast de l'script és una operació d'acció, ja que les operacions d'acció es fan automàticament.<br>Per esbrinar quines macros s'admeten, cerqueu "Notificacions i comandes basades en triggers/comandes basades en triggers", "Scripts d'acció manual de l'equip" i "Scripts d'acció manual d'esdeveniments" a la taula de [macros compatibles](/manual/appendix/ macros/supported_by_location). Tingueu en compte que si una macro pot resoldre un valor amb espais (per exemple, nom d'equip), cal citar quan sigui necessari.| |*Camí del menú*|<|Camí del menú desitjat a l'script. Per exemple, `Default` o `Default/`, mostrarà l'script al directori respectiu. Els menús es poden niuar, p. `Menú principal/Submenú1/Submenú2`. En accedir als scripts mitjançant el menú d'equip/esdeveniment a les seccions de monitoratge, s'organitzaran segons els directoris donats.<br>Aquest camp només es veu si s'ha triat "Acció manual de l'equip" o "Acció manual de l'esdeveniment" com a *Extensió*. | |*Tipus*|<|Feu clic al botó corresponent per seleccionar el tipus d'script:<br>**Webhook**, **Script**, **SSH**, **Telnet** o **[IPMI] (/manual/config/notifications/action/operation/remote_command#ipmi_remote_commands)**.| | |Tipus d'script: URL|<| |^|*URL*|Especifiqueu l'URL d'accés ràpid del [menú d'equips](/manual/web_interface/menu/host_menu) o [menú d'esdeveniments](/manual/web_interface/menu/event_menu).<br>S'admeten [macros](/manual/appendix/macros/supported_by_location) i [macros d'usuari](/manual/config/macros/user_macros) personalitzades. El suport de les macros depèn de l'àmbit de l'script (veieu *Àmbit* més amunt). <br> Els valors de les macros no han d'ésser codificats per URL. | |^|*Obrir a una finestra nova*|Si l'URL s'ha d'obrir a una finestra nova o a una pestanya del mateix navegador.| | |Tipus d'script: Webhook|<| |^|*Configuració*|Especifiqueu les variables de webhook com a parelles d'atribut-valor.<br>Veieu també: [Configuració de mitjans Webhook](/manual/config/notifications/media/webhook).<br>Macros i [usuari personalitzat]( Les macros /manual/config/macros/user_macros) són compatibles amb els valors dels paràmetres. La compatibilitat amb les macros depèn de l'abast de l'script (veieu *Ambit* més amunt).| |^|*Script*|Introduïu el codi JavaScript al bloc que apareix quan feu clic al camp de paràmetres (o al botó de visualització/edició al costat).<br>El suport de macro depèn de l'abast de l'script (veieu *Extensió* a dalt).<br>Veieu també: [Configuració de mitjans Webhook](/manual/config/notifications/media/webhook), [Objectes Javascript addicionals](/manual/config/items/preprocessing/javascript/javascript_objects).| |^|*Temps d'espera*|Temps d'espera d'execució de JavaScript (1-60 s, 30 s per defecte).<br>S'admeten sufixos de temps, p. 30 anys, 1m.| | |Tipus de script: Script|<| |^|*Executar*|Feu clic al botó corresponent per executar l'script de l'intèrpret de comandes a:<br>**agent Zabbix** - l'agent Zabbix executarà l'script (si l'element system.run és [permès](/manual/config/items/restrict_checks)) a l'equip<br>**Servidor Zabbix (proxy)** - l'script s'executarà pel servidor o proxy Zabbix (si és activat per [EnableRemoteCommands](/manual/appendix/config/zabbix_proxy)) - depenent de si l'equip és monitorat per un servidor o un proxy<br>**servidor Zabbix** - l'script només l'executarà el servidor Zabbix| |^|*Comandes*|Introduïu el camí complet de les comandes que s'han d'executar a l'script.<br>El suport de macro depèn de l'abast de l'script (veieu *Àmbit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| | |Tipus d'script: SSH|<| |^|*Mètode d'autenticació*|Trieu el mètode d'autenticació: mot de pas o clau pública.| |^|*Nom d'usuari*|Introdueix el nom d'usuari.| |^|*Mot de pas*|Introduïu el mot de pas.<br>Aquest camp és disponible si s'ha triat "Mot de pas" com a mètode d'autenticació.| |^|*Fitxer de clau pública*|Introduïu la ruta al fitxer de clau pública.<br>Aquest camp és disponible si es tria "Clau pública" com a mètode d'autenticació.| |^|*Fitxer de clau privada*|Introduïu la ruta al fitxer de clau privada.<br>Aquest camp és disponible si es tria "Clau pública" com a mètode d'autenticació.| |^|*Clau de pas*|Introduïu la frase de pas.<br>Aquest camp és disponible si s'ha triat "Clau pública" com a mètode d'autenticació.| |^|*Port*|Introduïu el port.| |^|*Comandes*|Introduïu les comandes.<br>El suport de macro depèn de l'abast de l'script (veieu *Àmbit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| | |Tipus d'script: Telnet|<| |^|*Nom d'usuari*|Introduïu el nom d'usuari.| |^|*Mot de pas*|Introduïu el mot de pas.| |^|*Port*|Introduïu el port.| |^|*Comandes*|Introduïu les comandes.<br>El suport de macro depèn de l'abast de l'script (veieu *Àmbit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| | |Tipus d'script: IPMI|<| |^|*Comandes*|Introduïu les comandes IPMI.<br>La compatibilitat amb macros depèn de l'abast de l'script (veieu *Ambit* més amunt). S'admeten [macros d'usuari](/manual/config/macros/user_macros) personalitzades.| |*Descripció*|<|Introduïu una descripció per a l'script.| |*Grup d'equips*|<|Trieu el grup d'equips per al qual serà disponible l'script (o *Tot* per a tots els grups d'equips).| |*Grup d'usuaris*|<|Trieu el grup d'usuaris per al qual serà disponible l'script (o *Tot* per a tots els grups d'usuaris).<br>Aquest camp només apareix si "Acció manual de l'equip" o "Acció manual d'esdeveniment" és triat com a *Àmbit*.| |*Permisos d'equip necessaris*|<|Trieu el nivell de permís per al grup d'equip: *Lectura* o *Escriptura*. Només els usuaris amb el nivell de permís necessari tindran accés per executar l'script.<br>Aquest camp només es mostra si s'ha triat "Acció manual de l'equip" o "Acció manual d'esdeveniment" com a *Àmbit *.| |*Activa la confirmació*|<|Marqueu la casella per mostrar un missatge de confirmació abans d'executar l'script. Aquesta funció pot ser especialment útil amb operacions potencialment perilloses (com un script de reinici) o aquelles que poden trigar molt de temps.<br>Aquesta opció només apareix si s'ha triat com a *Àmbit* "Acció manual de l'equip" o "Acció manual de l'equip".| |*Text de confirmació*|<|Introduïu un text de confirmació personalitzat per a la finestra emergent de confirmació activada amb la casella de selecció de dalt (per exemple, *El sistema remot es reiniciarà. N'esteu segur?*). Per veure com serà el text, feu clic a *Confirmació de la prova* al costat del camp.<br>S'admeten les macros {HOST.\*} i {USER.\*}. Les [macros d'usuari](/manual/config/macros/user_macros) personalitzades s'admeten.<br>*Nota:* les macros no s'ampliaran en provar el missatge de confirmació.<br>Aquest camp només es mostra si "Acció manual de l'equip" o L'"Acció d'esdeveniment manual" són triades com a *Àmbit*.|

en-us	#### Configuring a *Graph (classic)* widget  Configure a *Graph (classic)* widget that displays a simple graph for the item "42269".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "graph",                         "name": "Graph (classic)",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "source_type",                                 "value": 1                             },                             {                                 "type": 4,                                 "name": "itemid",                                 "value": 42269                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configura un giny de *Gràfic (clàssic)*  Configura un giny de *Gràfic (clàssic)* que ensenya un gràfic simple de l'element "42269".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "gràfic",                         "name": "Gràfic (clàssic)",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "source_type",                                 "value": 1                             },                             {                                 "type": 4,                                 "name": "itemid",                                 "value": 42269                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Graph prototype* widget  Configure a *Graph prototype* widget that displays a grid of 3 graphs (3 columns, 1 row) created from an item prototype (ID: "42316") by low-level discovery.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "graphprototype",                         "name": "Graph prototype",                         "x": 0,                         "y": 0,                         "width": 16,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "source_type",                                 "value": 3                             },                             {                                 "type": 5,                                 "name": "itemid",                                 "value": 42316                             },                             {                                 "type": 0,                                 "name": "columns",                                 "value": 3                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *Prototip de gràfic*  Configura un giny de *Prototip de gràfic* que ensenya una graella de 3 gràfics (3 columnes, 1 filera) creada des d'un prototip d'element (ID: "42316") per una descoberta de baix nivell.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "graphprototype",                         "name": "Prototip de gràfic",                         "x": 0,                         "y": 0,                         "width": 16,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "source_type",                                 "value": 3                             },                             {                                 "type": 5,                                 "name": "itemid",                                 "value": 42316                             },                             {                                 "type": 0,                                 "name": "columns",                                 "value": 3                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Graph* widget  Configure a *Graph* widget in the following way:  -   2 data sets for a total of 9 items on 1 host. -   The first data set is of type "Item list" and consists of 3 items that are represented by lines with a different color, but the same width, transparency, and fill. -   The second data set is of type "Item pattern", consists of 6 items, has a configured aggregation, and is represented by a line with a custom color, width, transparency, and fill. -   The second data set also has a custom data set label. -   Data in the graph are displayed for a time period of the last 3 hours. -   Problems in the graph are displayed only for the configured items. -   Graph has two Y axes of which the right Y axis displays values only for the second data set. -   Graph legend displays configured items in 4 rows, as well as minimum, maximum and average values of the data sets.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "svggraph",                         "name": "Graph",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "ds.dataset_type.0",                                 "value": 0                             },                             {                                 "type": 4,                                 "name": "ds.itemids.0.1",                                 "value": 23264                             },                             {                                 "type": 1,                                 "name": "ds.color.0.1",                                 "value": "FF0000"                             },                             {                                 "type": 4,                                 "name": "ds.itemids.0.2",                                 "value": 23269                             },                             {                                 "type": 1,                                 "name": "ds.color.0.2",                                 "value": "BF00FF"                             },                             {                                 "type": 4,                                 "name": "ds.itemids.0.3",                                 "value": 23257                             },                             {                                 "type": 1,                                 "name": "ds.color.0.3",                                 "value": "0040FF"                             },                             {                                 "type": 0,                                 "name": "ds.width.0",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "ds.transparency.0",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "ds.fill.0",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "ds.hosts.1.0",                                 "value": "Zabbix server"                             },                             {                                 "type": 1,                                 "name": "ds.items.1.0",                                 "value": "*: Number of processed *values per second"                             },                             {                                 "type": 1,                                 "name": "ds.color.1",                                 "value": "000000"                             },                             {                                 "type": 0,                                 "name": "ds.transparency.1",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "ds.fill.1",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "ds.axisy.1",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "ds.aggregate_function.1",                                 "value": 3                             },                             {                                 "type": 1,                                 "name": "ds.aggregate_interval.1",                                 "value": "1m"                             },                             {                                 "type": 0,                                 "name": "ds.aggregate_grouping.1",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "ds.data_set_label.1",                                 "value": "Number of processed values per second"                             },                             {                                 "type": 0,                                 "name": "graph_time",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "time_from",                                 "value": "now-3h"                             },                             {                                 "type": 0,                                 "name": "legend_statistic",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "legend_lines",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "show_problems",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny *Gràfic*  Configura un giny *Gràfic* de la manera següent:  - 2 conjunts de dades per a un total de 9 elements en 1 equip. - El primer conjunt de dades és de tipus "Llista d'elements" i consta de 3 elements que es representen per línies amb un color diferent, però amb la mateixa amplada, transparència i farciment. - El segon conjunt de dades és de tipus "Patró d'elements", consta de 6 elements, té una agregació configurada i es representa amb una línia amb un color, amplada, transparència i farciment personalitzats. - El segon conjunt de dades també té una etiqueta de conjunt de dades personalitzada. - Les dades del gràfic es mostren durant un període de temps de les últimes 3 hores. - Els problemes del gràfic només es mostren per als elements configurats. - El gràfic té dos eixos Y dels quals l'eix Y dret només mostra valors per al segon conjunt de dades. - La llegenda del gràfic mostra els elements configurats en 4 files, així com els valors mínims, màxims i mitjans dels conjunts de dades.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "svggraph",                         "name": "Graph",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "ds.dataset_type.0",                                 "value": 0                             },                             {                                 "type": 4,                                 "name": "ds.itemids.0.1",                                 "value": 23264                             },                             {                                 "type": 1,                                 "name": "ds.color.0.1",                                 "value": "FF0000"                             },                             {                                 "type": 4,                                 "name": "ds.itemids.0.2",                                 "value": 23269                             },                             {                                 "type": 1,                                 "name": "ds.color.0.2",                                 "value": "BF00FF"                             },                             {                                 "type": 4,                                 "name": "ds.itemids.0.3",                                 "value": 23257                             },                             {                                 "type": 1,                                 "name": "ds.color.0.3",                                 "value": "0040FF"                             },                             {                                 "type": 0,                                 "name": "ds.width.0",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "ds.transparency.0",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "ds.fill.0",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "ds.hosts.1.0",                                 "value": "Zabbix server"                             },                             {                                 "type": 1,                                 "name": "ds.items.1.0",                                 "value": "*: Number of processed *values per second"                             },                             {                                 "type": 1,                                 "name": "ds.color.1",                                 "value": "000000"                             },                             {                                 "type": 0,                                 "name": "ds.transparency.1",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "ds.fill.1",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "ds.axisy.1",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "ds.aggregate_function.1",                                 "value": 3                             },                             {                                 "type": 1,                                 "name": "ds.aggregate_interval.1",                                 "value": "1m"                             },                             {                                 "type": 0,                                 "name": "ds.aggregate_grouping.1",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "ds.data_set_label.1",                                 "value": "Number of processed values per second"                             },                             {                                 "type": 0,                                 "name": "graph_time",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "time_from",                                 "value": "now-3h"                             },                             {                                 "type": 0,                                 "name": "legend_statistic",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "legend_lines",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "show_problems",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Host availability* widget  Configure a *Host availability* widget that displays availability information (in a vertical layout) for hosts in host group "4" with "Zabbix agent" and "SNMP" interfaces configured.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "hostavail",                         "name": "Host availability",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "interface_type",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "interface_type",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "layout",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny de *Disponibilitat d'equip*  Configura el giny de *Disponibilitat d'equip* que ensenya la informació de disponibilitat (en disposició vertical) dels equips del grup d'equips "4" amb "agent de Zabbix" i les interfícies "SNMP" configuredes.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "hostavail",                         "name": "Host availability",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "interface_type",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "interface_type",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "layout",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring alert actions  Actions determine which notifications should be sent via the webhook. Steps for [configuring actions](/manual/config/notifications/action) involving webhooks are the same as for all other media types with these exceptions:  -   If a webhook uses tags to store ticket\\message ID and to follow up     with update\\resolve operations, this webhook should not be used in     several alert actions for a single problem event. If     {EVENT.TAGS.<name>} already exists, and is updated in the     webhook, then its resulting value is not defined. For such a case, a     new tag name should be used in the webhook to store updated values.     This applies to Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS,     Redmine, ServiceNow, Slack, Zammad, and Zendesk webhooks provided by     Zabbix and to the majority of webhooks that utilize *Include event     menu entry* option. Using the webhook in several operations is     allowed if those operations or escalation steps belong to the same     action. It is also ok to use this webhook in different actions if     the actions will not be applied to the same problem event due to     different filter conditions. -   When using a webhook in actions for [internal     events](/manual/config/events/sources#internal_events): in the     action operation configuration, check the *Custom message* checkbox     and define the custom message, otherwise, a notification will not be     sent.
ca	#### Configuració de les accions d'alertes  Les accions determinen quines notificacions s'han d'enviar mitjançant el webhook. Les passes per a [configurar accions](/manual/config/notifications/action) que involucren webhooks són les mateixes que per a tots els altres tipus de suport amb aquestes excepcions:  - Si un webhook empra etiquetes per emmagatzemar el bitllet\\ID del missatge i per fer un seguiment de les operacions d'actualització\\resolució, aquest webhook no s'hauria d'emprar a diverses accions d'alerta per a un únic esdeveniment problema. Si {EVENT.TAGS.<nom>} ja existeix i s'actualitza al webhook, el seu valor resultant no serà definit. En aquest cas, s'ha d'emprar un nom d'etiqueta nova al webhook per emmagatzemar els valors actualitzats. Això s'aplica als webhooks Jira, Jira Service Desk, Mattermost, Opsgenie, OTRS, Redmine, ServiceNow, Slack, Zammad i Zendesk proporcionats per Zabbix i la majoria dels webhooks que empren l'opció *Inclou l'entrada del menú*. Es permet emprar el webhook en diverses operacions si aquestes operacions o passes d'escalat pertanyen a la mateixa acció. També és acceptable emprar aquest webhook en diferents accions si les accions no s'apliquen al mateix esdeveniment problemàtic a causa de diferents condicions de filtre. - Quan empreu un webhook en accions per a [esdeveniments interns](/manual/config/events/sources#internal_events): a la configuració de l'operació d'acció, marqueu la casella *Missatge personalitzat* i configureu el missatge personalitzat, en cas contrari, no hi haurà cap notificació quan s'enviï.

en-us	#### Configuring a linked *Map* widget  Configure a *Map* widget that is linked to a [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget) widget.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "map",                         "name": "Map",                         "x": 0,                         "y": 5,                         "width": 18,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "source_type",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "filter_widget_reference",                                 "value": "ABCDE"                             }                         ]                     },                     {                         "type": "navtree",                         "name": "Map navigation tree",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "navtree.name.1",                                 "value": "Element A"                             },                             {                                 "type": 1,                                 "name": "navtree.name.2",                                 "value": "Element B"                             },                             {                                 "type": 1,                                 "name": "navtree.name.3",                                 "value": "Element C"                             },                             {                                 "type": 1,                                 "name": "navtree.name.4",                                 "value": "Element A1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.5",                                 "value": "Element A2"                             },                             {                                 "type": 1,                                 "name": "navtree.name.6",                                 "value": "Element B1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.7",                                 "value": "Element B2"                             },                             {                                 "type": 0,                                 "name": "navtree.parent.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.5",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.6",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.parent.7",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.1",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.2",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.3",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "navtree.order.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.5",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.6",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.7",                                 "value": 2                             },                             {                                 "type": 8,                                 "name": "navtree.sysmapid.6",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "reference",                                 "value": "ABCDE"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny enllaçat de *Mapa*  Configurar un giny *Mapa* enllaçat al giny [*arbre de navegació de mapa*](/manual/api/reference/dashboard/widget_fields/map_tree#configuring-a-map-navigation-tree-widget).  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "map",                         "name": "Map",                         "x": 0,                         "y": 5,                         "width": 18,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "source_type",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "filter_widget_reference",                                 "value": "ABCDE"                             }                         ]                     },                     {                         "type": "navtree",                         "name": "Map navigation tree",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "navtree.name.1",                                 "value": "Element A"                             },                             {                                 "type": 1,                                 "name": "navtree.name.2",                                 "value": "Element B"                             },                             {                                 "type": 1,                                 "name": "navtree.name.3",                                 "value": "Element C"                             },                             {                                 "type": 1,                                 "name": "navtree.name.4",                                 "value": "Element A1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.5",                                 "value": "Element A2"                             },                             {                                 "type": 1,                                 "name": "navtree.name.6",                                 "value": "Element B1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.7",                                 "value": "Element B2"                             },                             {                                 "type": 0,                                 "name": "navtree.parent.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.5",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.6",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.parent.7",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.1",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.2",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.3",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "navtree.order.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.5",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.6",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.7",                                 "value": 2                             },                             {                                 "type": 8,                                 "name": "navtree.sysmapid.6",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "reference",                                 "value": "ABCDE"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Map navigation tree* widget  Configure a *Map navigation tree* widget that displays the following map navigation tree:  -   Element A     - Element A1     - Element A2 -   Element B     - Element B1 (contains linked map "1" that can be displayed in a [linked *Map widget*](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget))     - Element B2 -   Element C  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "navtree",                         "name": "Map navigation tree",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "navtree.name.1",                                 "value": "Element A"                             },                             {                                 "type": 1,                                 "name": "navtree.name.2",                                 "value": "Element B"                             },                             {                                 "type": 1,                                 "name": "navtree.name.3",                                 "value": "Element C"                             },                             {                                 "type": 1,                                 "name": "navtree.name.4",                                 "value": "Element A1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.5",                                 "value": "Element A2"                             },                             {                                 "type": 1,                                 "name": "navtree.name.6",                                 "value": "Element B1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.7",                                 "value": "Element B2"                             },                             {                                 "type": 0,                                 "name": "navtree.parent.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.5",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.6",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.parent.7",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.1",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.2",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.3",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "navtree.order.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.5",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.6",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.7",                                 "value": 2                             },                             {                                 "type": 8,                                 "name": "navtree.sysmapid.6",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "reference",                                 "value": "ABCDE"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny *Arbre de navegació del mapa*  Configura un giny *Arbre de navegació del mapa* que ensenya el següent arbre de navegació del mapa:  -   Element A     - Element A1     - Element A2 -   Element B     - Element B1 (conté el mapa enllaçat "1" que es pot veure al [*giny de mapa* enllaçat](/manual/api/reference/dashboard/widget_fields/map#configuring-a-linked-map-widget))     - Element B2 -   Element C  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "navtree",                         "name": "Map navigation tree",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "navtree.name.1",                                 "value": "Element A"                             },                             {                                 "type": 1,                                 "name": "navtree.name.2",                                 "value": "Element B"                             },                             {                                 "type": 1,                                 "name": "navtree.name.3",                                 "value": "Element C"                             },                             {                                 "type": 1,                                 "name": "navtree.name.4",                                 "value": "Element A1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.5",                                 "value": "Element A2"                             },                             {                                 "type": 1,                                 "name": "navtree.name.6",                                 "value": "Element B1"                             },                             {                                 "type": 1,                                 "name": "navtree.name.7",                                 "value": "Element B2"                             },                             {                                 "type": 0,                                 "name": "navtree.parent.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.5",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.parent.6",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.parent.7",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.1",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.2",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.3",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "navtree.order.4",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.5",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "navtree.order.6",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "navtree.order.7",                                 "value": 2                             },                             {                                 "type": 8,                                 "name": "navtree.sysmapid.6",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "reference",                                 "value": "ABCDE"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Map* widget  Configure a *Map* widget that displays the map "1".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "map",                         "name": "Map",                         "x": 0,                         "y": 0,                         "width": 18,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 8,                                 "name": "sysmapid",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny *Mapa*  Configura un giny *Mapa* que ensenya el mapa "1".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "map",                         "name": "Map",                         "x": 0,                         "y": 0,                         "width": 18,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 8,                                 "name": "sysmapid",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring an *Action log* widget  Configure an *Action log* widget that displays 10 entries of action operation details, sorted by time (in ascending order). In addition, display details only for those action operations that attempted to send an email to user "1", but were unsuccessful.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "actionlog",                         "name": "Action log",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "show_lines",                                 "value": 10                             },                             {                                 "type": 0,                                 "name": "sort_triggers",                                 "value": 3                             },                             {                                 "type": 11,                                 "name": "userids",                                 "value": 1                             },                             {                                 "type": 13,                                 "name": "mediatypeids",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "statuses",                                 "value": 2                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *registre d'acció*  Configureu un giny de *Registre d'acció* que ensenyi 10 entrades dels detalls d'operacions d'acció, ordenats per data (en ordre ascendent). A més, ensenya detalls només per aquelles operacions que han provat d'enviar correu-e a l'usuari "1", però ha fallat.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "actionlog",                         "name": "Action log",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "show_lines",                                 "value": 10                             },                             {                                 "type": 0,                                 "name": "sort_triggers",                                 "value": 3                             },                             {                                 "type": 11,                                 "name": "userids",                                 "value": 1                             },                             {                                 "type": 13,                                 "name": "mediatypeids",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "statuses",                                 "value": 2                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring an action  To configure an action, do the following:  -   Go to *Alerts* → *Actions* and select     the required action type from the submenu (you can     switch to another type later, using the title dropdown) -   Click on *Create action* -   Name the action -   Choose [conditions](/manual/config/notifications/action/conditions)     upon which operations are carried out -   Choose the     [operations](/manual/config/notifications/action/operation) to carry     out  General action attributes:  ![](../../../../assets/en/manual/config/notifications/action.png)  All mandatory input fields are marked with a red asterisk.  |Parameter|Description| |--|--------| |*Name*|Unique action name.| |*Type of calculation*|Select the evaluation [option](/manual/config/notifications/action/conditions#type_of_calculation) for action conditions (with more than one condition):<br>**And** - all conditions must be met.<br>**Or** - enough if one condition is met.<br>**And/Or** - combination of the two: AND with different condition types and OR with the same condition type.<br>**Custom expression** - a user-defined calculation formula for evaluating action conditions.| |*Conditions*|List of action conditions.<br>Click on *Add* to add a new [condition](/manual/config/notifications/action/conditions).<br>If no conditions are configured, the action will run for every event that corresponds to the [action type](#overview) being configured.| |*Enabled*|Mark the checkbox to enable the action. Otherwise, it will be disabled.|
ca	#### Configurar una acció  Per configurar una acció, feu el següent:  - Aneu a *Alertes* → *Accions* i trieu el tipus d'acció requerit al submenú (podeu canviar a un altre tipus més endavant, emprant el menú desplegable del títol) - Feu clic a *Crea una acció* - Anomena l'acció - Trieu les [condicions](/manual/config/notifications/action/conditions) per a les quals es realitzen les operacions - Trieu les [operacions](/manual/config/notifications/action/operation) a fer  Atributs generals de l'acció:  ![](../../../../assets/en/manual/config/notifications/action.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic de l'acció.| |*Tipus de càlcul*|Trieu l'[opció](/manual/config/notifications/action/conditions#type_of_calculation) d'avaluació per a les condicions d'acció (amb més d'una condició):<br>**I** - totes les condicions s'han de complir<br>**O** - n'hi ha prou si es compleix una condició<br>**I/O** - combinació de totes dugues: AND amb diferents tipus de condició i OR amb el mateix tipus de condició<br>**Expressió personalitzada** - una fórmula de càlcul definida per l'usuari per avaluar les condicions d'acció.| |*Condicions*|Llistat de condicions d'acció.<br>Feu clic a *Afegir* per afegir una nova [condició](/manual/config/notifications/action/conditions).| |*Activat*|Marqueu la casella per habilitar l'acció. En cas contrari, es desactivarà.|

en-us	#### Configuring and running Java gateway  By default, Java gateway listens on port 10052. If you plan on running Java gateway on a different port, you can specify that in settings.sh script. See the description of [Java gateway configuration file](/manual/appendix/config/zabbix_java) for how to specify this and other options.  ::: notewarning Port 10052 is not [IANA registered](http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). :::  Once you are comfortable with the settings, you can start Java gateway by running the startup script:      $ ./startup.sh  Likewise, once you no longer need Java gateway, run the shutdown script to stop it:      $ ./shutdown.sh  Note that unlike server or proxy, Java gateway is lightweight and does not need a database.
ca	#### Configuració i execució de la passarel·la Java  Per defecte, la passarel·la de Java escolta el port 10052. Si teniu previst executar la passarel·la de Java en un port diferent, podeu especificar-ho a l'script settings.sh. Consulteu la descripció del [fitxer de configuració de la passarel·la Java](/en/manual/appendix/config/zabbix_java) per saber com especificar aquesta i altres opcions.  ::: notewarning El port 10052 no és pas [registrat a IANA] (http://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.txt). :::  Un cop familiaritzat amb aquesta configuració, podeu iniciar la passarel·la de Java executant l'script d'inici:       $ ./startup.sh  De la mateixa manera, quan ja no us calgui la passarel·la Java, executeu l'script d'aturada per tancar-la:       $ ./apagat.sh  Tingueu en compte que, a diferència del servidor o el proxy, Java Gateway és lleuger i no requereix d'una base de dades.

en-us	#### Configuring and running Java gateway  Configuration parameters of Zabbix Java gateway may be tuned in the file:      /etc/zabbix/zabbix_java_gateway.conf  For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java).  To start Zabbix Java gateway:      # service zabbix-java-gateway restart  To automatically start Zabbix Java gateway on boot:  RHEL 7 and later:      # systemctl enable zabbix-java-gateway  RHEL prior to 7:      # chkconfig --level 12345 zabbix-java-gateway on
ca	#### Configuració i execució de la passarel·la Java  Els paràmetres de configuració de la passarel·la Java Zabbix es poden personalitzar a l'arxiu:      /etc/zabbix/zabbix_java_gateway.conf  Per tindre més detalls, veieu els [paràmetres](/manual/appendix/config/zabbix_java) de configuració de la passarel·la Java Zabbix.  Per engegar la passarel·la Java Zabbix:      # service zabbix-java-gateway restart  Per engegar automàticament la passarel·la Java Zabbix quan s'engegui el sistema operatiu:  RHEL 7 and later:      # systemctl enable zabbix-java-gateway  Versions anteriors de RHEL 7:      # chkconfig --level 12345 zabbix-java-gateway on

en-us	#### Configuring and running Java gateway  Java gateway configuration may be tuned in the file:      /etc/zabbix/zabbix_java_gateway.conf  For more details, see Zabbix Java gateway configuration [parameters](/manual/appendix/config/zabbix_java).  To start Zabbix Java gateway:      # service zabbix-java-gateway restart  To automatically start Zabbix Java gateway on boot:      # systemctl enable zabbix-java-gateway
ca	#### Configuració i execució de la passarel·la Java  Els paràmetres de configuració de la passarel·la Java Zabbix es poden personalitzar a l'arxiu:      /etc/zabbix/zabbix_java_gateway.conf  Per tindre més detalls, veieu els [paràmetres](/manual/appendix/config/zabbix_java) de configuració de la passarel·la Java Zabbix.  Per engegar la passarel·la Java Zabbix :      # service zabbix-java-gateway restart  Per engegar automàticament la passarel·la Java Zabbix quan s'engegui el sistema operatiu:      # systemctl enable zabbix-java-gateway

en-us	#### Configuring an *Item value* widget  Configure an *Item value* widget that displays the item value for the item "42266" (Zabbix agent availability). In addition, visually fine-tune the widget with multiple advanced options, including a dynamic background color that changes based on the availability status of Zabbix agent.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "item",                         "name": "Item value",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 4,                                 "name": "itemid",                                 "value": 42266                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "adv_conf",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "description",                                 "value": "Agent status"                             },                             {                                 "type": 0,                                 "name": "desc_h_pos",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "desc_v_pos",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "desc_bold",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "desc_color",                                 "value": "F06291"                             },                             {                                 "type": 0,                                 "name": "value_h_pos",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "value_size",                                 "value": 25                             },                             {                                 "type": 1,                                 "name": "value_color",                                 "value": "FFFF00"                             },                             {                                 "type": 0,                                 "name": "units_show",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "time_h_pos",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "time_v_pos",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "time_size",                                 "value": 10                             },                             {                                 "type": 0,                                 "name": "time_bold",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "time_color",                                 "value": "9FA8DA"                             },                             {                                 "type": 1,                                 "name": "thresholds.color.0",                                 "value": "E1E1E1"                             },                             {                                 "type": 1,                                 "name": "thresholds.threshold.0",                                 "value": "0"                             },                             {                                 "type": 1,                                 "name": "thresholds.color.1",                                 "value": "D1C4E9"                             },                             {                                 "type": 1,                                 "name": "thresholds.threshold.1",                                 "value": "1"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny *Valor d'element*  Configura un giny *Valor d'element* que mostra el valor de l'element "42266" (disponibilitat de l'agent Zabbix ). A més, visualment afina el giny amb més opcions avançades, fins i tot amb un color de fons dinàmic que canvia en base a l'estat de disponibilitat de l'agent Zabbix.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "item",                         "name": "Item value",                         "x": 0,                         "y": 0,                         "width": 4,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 4,                                 "name": "itemid",                                 "value": 42266                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "show",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "adv_conf",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "description",                                 "value": "Agent status"                             },                             {                                 "type": 0,                                 "name": "desc_h_pos",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "desc_v_pos",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "desc_bold",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "desc_color",                                 "value": "F06291"                             },                             {                                 "type": 0,                                 "name": "value_h_pos",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "value_size",                                 "value": 25                             },                             {                                 "type": 1,                                 "name": "value_color",                                 "value": "FFFF00"                             },                             {                                 "type": 0,                                 "name": "units_show",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "time_h_pos",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "time_v_pos",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "time_size",                                 "value": 10                             },                             {                                 "type": 0,                                 "name": "time_bold",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "time_color",                                 "value": "9FA8DA"                             },                             {                                 "type": 1,                                 "name": "thresholds.color.0",                                 "value": "E1E1E1"                             },                             {                                 "type": 1,                                 "name": "thresholds.threshold.0",                                 "value": "0"                             },                             {                                 "type": 1,                                 "name": "thresholds.color.1",                                 "value": "D1C4E9"                             },                             {                                 "type": 1,                                 "name": "thresholds.threshold.1",                                 "value": "1"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring an operation  To configure an operation, go to the *Operations* tab in [action](/manual/config/notifications/action) configuration.  ![](../../../../../assets/en/manual/config/notifications/action_operation2.png){width="600"}  General operation attributes:  |Parameter|Description| |--|-----------| |*Default operation step duration*|Duration of one operation step by default (60 seconds to 1 week).<br>For example, an hour-long step duration means that if an operation is carried out, an hour will pass before the next step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 60s, 1m, 2h, 1d, since Zabbix 3.4.0.<br>[User macros](/manual/config/macros/user_macros) are supported, since Zabbix 3.4.0.| |*Operations*|Action operations (if any) are displayed, with these details:<br>**Steps** - escalation step(s) to which the operation is assigned.<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Start in** - how long after an event the operation is performed.<br>**Duration (sec)** - step duration is displayed. *Default* is displayed if the step uses default duration, and a time is displayed if custom duration is used.<br>**Action** - links for editing and removing an operation are displayed.| |*Recovery operations*|Action operations (if any) are displayed, with these details:<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Action** - links for editing and removing an operation are displayed.| |*Update operations*|Action operations (if any) are displayed, with these details:<br>**Details** - type of operation and its recipient/target.<br>The operation list also displays the media type (email, SMS or script) used as well as the name and surname (in parentheses after the username) of a notification recipient.<br>**Action** - links for editing and removing an operation are displayed.| |*Pause operations for symptom problems*|Mark this checkbox to pause operations (after the first operation) for symptom problems.<br>Note that this setting affects only problem escalations; recovery and update operations will not be affected.<br>This option is available for *Trigger actions* only.| |*Pause operations for suppressed problems*|Mark this checkbox to delay the start of operations for the duration of a maintenance period. When operations are started, after the maintenance, all operations are performed including those for the events during the maintenance.<br>Note that this setting affects only problem escalations; recovery and update operations will not be affected.<br>If you unmark this checkbox, operations will be executed without delay even during a maintenance period.<br>This option is not available for *Service actions*.| |*Notify about canceled escalations*|Unmark this checkbox to disable notifications about canceled escalations (when host, item, trigger or action is disabled).|  All mandatory input fields are marked with a red asterisk.  To configure details of a new operation, click on ![](../../../../../assets/en/manual/config/add_link.png) in the *Operations* block. To edit an existing operation, click on ![](../../../../../assets/en/manual/config/edit_link.png) next to the operation. A pop-up window will open where you can edit the operation step details.
ca	#### Configurar una operació  Per configurar una operació, aneu a la pestanya *Operacions* a la configuració [acció] (/manual/config/notifications/action).  ![](../../../../../assets/en/manual/config/notifications/action_operation.png){width="600"}  Atributs generals de funcionament:  |Paràmetre|Descripció| |--|------------| |*Durada de la passa de l'operació per defecte*|Durada de la passa de l'operació per defecte (de 60 segons a 1 setmana).<br>Per exemple, una durada de la passa d'1 hora significa que si es realitza una operació, passarà una hora abans de la passa següent.< br>S'admeten [sufixos de temps](/manual/appendix/sufixos), per exemple 60s, 1m, 2h, 1d, des de Zabbix 3.4.0.<br>Les [macros d'usuari](/manual/config/macros/user_macros) són compatibles, des de Zabbix 3.4.0.| |*Operacions*|Es mostren les operacions d'acció (si n'hi han) amb aquests detalls:<br>**Passes** - passes d'escalada a les quals s'assigna l'acord<br>**Detalls** - tipus d'operació i el seu destinatari/destinatari.<br>La llista d'operacions també mostra el tipus de suport emprat (correu electrònic, SMS o script), així com el nom i cognoms (entre parèntesis després del nom, nom d'usuari) d'un destinatari de la notificació.< br>**Comença a** - quan després d'un esdeveniment es realitza l'operació<br>**Durada** - es mostra la durada de la passa. Es mostra *Predeterminat* si la passa empra una durada predeterminada, i es mostra un temps si s'empra una durada personalitzada.<br>**Acció** - es mostren els enllaços per editar i suprimir una operació.| |*Operacions de recuperació*|Es mostren les operacions d'acció (si n'hi han) amb aquests detalls:<br>**Detalls** - tipus d'operació i el seu receptor/destí.<br>La llista d'operacions també mostra el tipus de mitjans emprats (correu electrònic, SMS o script), així com el nom i els cognoms (entre parèntesis després del nom d'usuari) d'un destinatari de la notificació.<br>**Acció** - els enllaços per modificar i esborrar es mostren a l'operació.| |*Operacions d'actualització*|Es mostren les operacions d'acció (si n'hi han) amb aquests detalls:<br>**Detalls** - tipus d'operació i el seu destinatari/destinatari.<br>Les operacions de llista també mostren el tipus de suport emprat (correu electrònic, SMS o script), així com el nom i els cognoms (entre parèntesis després del nom d'usuari) d'un destinatari de la notificació.<br>**Acció** - es mostren els enllaços per modificar i esborrar una operació.| |*Atura les operacions dels problemes esborrats*|Marqueu aquesta casella per endarrerir l'inici de les operacions mentre duri una finestra de manteniment. Quan s'inicien les operacions, després del manteniment, es realitzen totes les operacions, incloses les operacions d'esdeveniments durant el manteniment.<br>Tingueu en compte que aquesta configuració només afecta les escalades de problemes; les operacions de recuperació i actualització no es veuran afectades.<br>Si desmarqueu aquesta casella, les operacions s'executaran sense demora fins i tot durant un període de manteniment.<br>Aquesta opció no és disponible per al *servei d'accions*.| |*Notificar sobre les escalades cancel·lades*|Desmarqueu aquesta casella per desactivar les notificacions sobre les escalades cancel·lades (quan l'equip, l'element, el trigger o l'acció són desactivats).|  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Per configurar els detalls d'una operació nova, feu clic a ![](../../../../../assets/en/manual/config/add_link.png) al bloc Operacions. Per editar una operació existent, feu clic a ![](../../../../../assets/en/manual/config/edit_link.png) al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls de la passa de l'operació.

en-us	#### Configuring an *SLA report* widget  Configure an *SLA report* widget that displays the SLA report for SLA "4" service "2" for the period of last 30 days.   [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "slareport",                         "name": "SLA report",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 10,                                 "name": "slaid",                                 "value": 4                             },                             {                                 "type": 9,                                 "name": "serviceid",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "date_from",                                 "value": "now-30d"                             },                             {                                 "type": 1,                                 "name": "date_to",                                 "value": "now"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny d'*Informe SLA*  Configura un giny d'*Informe SLA* que ensenya l'informe per als SLAs "4" servei "2" per el període dels darrers 30 dies.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "slareport",                         "name": "SLA report",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 10,                                 "name": "slaid",                                 "value": 4                             },                             {                                 "type": 9,                                 "name": "serviceid",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "date_from",                                 "value": "now-30d"                             },                             {                                 "type": 1,                                 "name": "date_to",                                 "value": "now"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring an update operation  To configure an update operation go to the *Operations* tab in action [configuration](/manual/config/notifications/action).  ![](../../../../../assets/en/manual/config/notifications/action_operation.png){width="600"}  To configure details of a new update operation, click on ![](../../../../../assets/en/manual/config/add_link.png) in the *Update operations* block. To edit an existing operation, click on ![](../../../../../assets/en/manual/config/edit_link.png) next to the operation. A pop-up window will open where you can edit the operation step details.
ca	#### Configuració d'una operació d'actualització  Per configurar una operació d'actualització, aneu a la pestanya *Operacions* a la [configuració](/manual/config/notifications/action) de l'acció.  ![](../../../../../assets/en/manual/config/notifications/action_operation.png){width="600"}   Per configurar els detalls d'una nova operació d'actualització, feu clic a ![](../../../../../assets/en/manual/config/add_link.png) al bloc *Operacions d'actualització*. Per editar una operació existent, feu clic a ![](../../../../../assets/en/manual/config/edit_link.png) al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls de la passa de l'operació.

en-us	#### Configuring a *Plain text* widget  Configure a *Plain text* widget that displays latest data for items "42269" and "42253". In addition, configure the item names to be located at the top of the data columns, and only 15 lines of data to be displayed.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "plaintext",                         "name": "Plain text",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 4,                                 "name": "itemids",                                 "value": 42269                             },                             {                                 "type": 4,                                 "name": "itemids",                                 "value": 42253                             },                             {                                 "type": 0,                                 "name": "style",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show_lines",                                 "value": 15                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar un giny de *Text pla*  Configura un giny de *Text pla* que  ensenya la darrera informació dels elements "42269" i "42253". A més, configura el nom dels elements per veure'ls damunt de les columnes, i només ensenyarà 15 línies de dades.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "el meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "plaintext",                         "name": "Plain text",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 4,                                 "name": "itemids",                                 "value": 42269                             },                             {                                 "type": 4,                                 "name": "itemids",                                 "value": 42253                             },                             {                                 "type": 0,                                 "name": "style",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show_lines",                                 "value": 15                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Problem hosts* widget  Configure a *Problem hosts* widget that displays hosts from host groups "2" and "4" that have problems with a name that includes the string "CPU" and that have the following severities: "Warning", "Average", "High", "Disaster".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problemhosts",                         "name": "Problem hosts",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 2                             },                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 1,                                 "name": "problem",                                 "value": "cpu"                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 5                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny *Equips amb problemes*  Configura el giny *Equips amb problemes* per mostrar equips dels grups d'equips "2" i "4" els que tenen problemes amb el nom que inclogui la cadena "CPU" i que tingui les gravetats següents: "Avís", "Mitjana", "Alta", "Desastre".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problemhosts",                         "name": "Problem hosts",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 2                             },                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 1,                                 "name": "problem",                                 "value": "cpu"                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 5                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Problems by severity* widget  Configure a *Problems by severity* widget that displays problem totals for all host groups.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problemsbysv",                         "name": "Problems by severity",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "show_type",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny *Problemes per gravetat*  Configura el giny *Problemes per gravetat* que ensenya el total de problemes per tots els grups d'equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problemsbysv",                         "name": "Problems by severity",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "show_type",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Problems* widget  Configure a *Problems* widget that displays problems for host group "4" that satisfy the following conditions:  -   Problems that have a tag with the name "scope" that contains values "performance" or "availability", or "capacity". -   Problems that have the following severities: "Warning", "Average", "High", "Disaster".  In addition, configure the widget to show tags and operational data.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problems",                         "name": "Problems",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "performance"                             },                             {                                 "type": 1,                                 "name": "tags.tag.1",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.1",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.1",                                 "value": "availability"                             },                             {                                 "type": 1,                                 "name": "tags.tag.2",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.2",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.2",                                 "value": "capacity"                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 5                             },                             {                                 "type": 0,                                 "name": "show_tags",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show_opdata",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurant el giny de *Problemes*  Configura el giny de *Problemes* per veure els problemes del grup d'equips "4" que compleix les següents condicions:  -   Problemes que tenen etiqueta amb el nom "àmbit" que conté els valors "rendiment", "disponibilitat" o "capacitat". -   Problemes que tenen les gravetats següents: "Avís", "Mitjana", "Alta", "Desastre".  A més, configura el giny per ensenyar etiquetes i dades operacionals.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problems",                         "name": "Problems",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "performance"                             },                             {                                 "type": 1,                                 "name": "tags.tag.1",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.1",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.1",                                 "value": "availability"                             },                             {                                 "type": 1,                                 "name": "tags.tag.2",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.2",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.2",                                 "value": "capacity"                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 2                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 3                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 4                             },                             {                                 "type": 0,                                 "name": "severities",                                 "value": 5                             },                             {                                 "type": 0,                                 "name": "show_tags",                                 "value": 1                             },                             {                                 "type": 0,                                 "name": "show_opdata",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	### Configuring a recovery operation  To configure a recovery operation, go to the *Operations* tab in [action](/manual/config/notifications/action) configuration.  ![](../../../../../assets/en/manual/config/notifications/action_operation.png){width="600"}  To configure details of a new recovery operation, click on ![](../../../../../assets/en/manual/config/add_link.png) in the *Recovery operations* block. To edit an existing operation, click on ![](../../../../../assets/en/manual/config/edit_link.png) next to the operation. A pop-up window will open where you can edit the operation step details.
ca	### Configuració d'una operació de recuperació  Per configurar una operació de recuperació, aneu a la pestanya *Operacions* a la configuració d'[acció](/manual/config/notifications/action).  ![](../../../../../assets/en/manual/config/notifications/action_operation.png){width="600"}   Per configurar els detalls d'una nova operació de recuperació, feu clic a ![](../../../../../assets/en/manual/config/add_link.png) al bloc d'*Operacions de recuperació*. Per editar una operació existent, feu clic a ![](../../../../../assets/en/manual/config/edit_link.png) al costat de l'operació. S'obrirà una finestra emergent on podeu editar els detalls del pas de l'operació.

en-us	#### Configuring a *System information* widget  Configure a *System information* widget that displays system stats with a refresh interval of 10 minutes.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "systeminfo",                         "name": "System information",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "rf_rate",                                 "value": 600                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny d'*Informació del sistema*  Configura el giny d'*Informació del sistema* mostrant l'estat del sistema amb un temps de refresc de 10 minuts.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "systeminfo",                         "name": "System information",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 0,                                 "name": "rf_rate",                                 "value": 600                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Top hosts* widget  Configure a *Top hosts* widget that displays top hosts by CPU utilization in host group "4". In addition, configure the following custom columns: "Host name", "CPU utilization in %", "1m avg", "5m avg", "15m avg", "Processes".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "tophosts",                         "name": "Top hosts",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 1,                                 "name": "columns.name.0",                                 "value": ""                             },                             {                                 "type": 0,                                 "name": "columns.data.0",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "columns.base_color.0",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.0",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.1",                                 "value": "CPU utilization in %"                             },                             {                                 "type": 0,                                 "name": "columns.data.1",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.1",                                 "value": "4CAF50"                             },                             {                                 "type": 1,                                 "name": "columns.item.1",                                 "value": "CPU utilization"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.1",                                 "value": ""                             },                             {                                 "type": 0,                                 "name": "columns.display.1",                                 "value": 3                             },                             {                                 "type": 1,                                 "name": "columns.min.1",                                 "value": "0"                             },                             {                                 "type": 1,                                 "name": "columns.max.1",                                 "value": "100"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.color.1.0",                                 "value": "FFFF00"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.threshold.1.0",                                 "value": "50"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.color.1.1",                                 "value": "FF8000"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.threshold.1.1",                                 "value": "80"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.color.1.2",                                 "value": "FF4000"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.threshold.1.2",                                 "value": "90"                             },                             {                                 "type": 1,                                 "name": "columns.name.2",                                 "value": "1m avg"                             },                             {                                 "type": 0,                                 "name": "columns.data.2",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.2",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.2",                                 "value": "Load average (1m avg)"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.2",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.3",                                 "value": "5m avg"                             },                             {                                 "type": 0,                                 "name": "columns.data.3",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.3",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.3",                                 "value": "Load average (5m avg)"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.3",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.4",                                 "value": "15m avg"                             },                             {                                 "type": 0,                                 "name": "columns.data.4",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.4",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.4",                                 "value": "Load average (15m avg)"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.4",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.5",                                 "value": "Processes"                             },                             {                                 "type": 0,                                 "name": "columns.data.5",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.5",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.5",                                 "value": "Number of processes"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.5",                                 "value": ""                             },                             {                                 "type": 0,                                 "name": "columns.decimal_places.5",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "column",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny d'*Equips principals*  Configurar un giny d'*Equips principals* que ensenya els principals equips per ús de CPU del grup d'equips "4". A més, configura les següents columnes a mida: "Nom d'equip", "Ús de CPU, en %", "1m avg", "5m avg", "15m avg", "Processos".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "tophosts",                         "name": "Top hosts",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             },                             {                                 "type": 1,                                 "name": "columns.name.0",                                 "value": ""                             },                             {                                 "type": 0,                                 "name": "columns.data.0",                                 "value": 2                             },                             {                                 "type": 1,                                 "name": "columns.base_color.0",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.0",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.1",                                 "value": "CPU utilization in %"                             },                             {                                 "type": 0,                                 "name": "columns.data.1",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.1",                                 "value": "4CAF50"                             },                             {                                 "type": 1,                                 "name": "columns.item.1",                                 "value": "CPU utilization"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.1",                                 "value": ""                             },                             {                                 "type": 0,                                 "name": "columns.display.1",                                 "value": 3                             },                             {                                 "type": 1,                                 "name": "columns.min.1",                                 "value": "0"                             },                             {                                 "type": 1,                                 "name": "columns.max.1",                                 "value": "100"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.color.1.0",                                 "value": "FFFF00"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.threshold.1.0",                                 "value": "50"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.color.1.1",                                 "value": "FF8000"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.threshold.1.1",                                 "value": "80"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.color.1.2",                                 "value": "FF4000"                             },                             {                                 "type": 1,                                 "name": "columnsthresholds.threshold.1.2",                                 "value": "90"                             },                             {                                 "type": 1,                                 "name": "columns.name.2",                                 "value": "1m avg"                             },                             {                                 "type": 0,                                 "name": "columns.data.2",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.2",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.2",                                 "value": "Load average (1m avg)"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.2",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.3",                                 "value": "5m avg"                             },                             {                                 "type": 0,                                 "name": "columns.data.3",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.3",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.3",                                 "value": "Load average (5m avg)"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.3",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.4",                                 "value": "15m avg"                             },                             {                                 "type": 0,                                 "name": "columns.data.4",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.4",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.4",                                 "value": "Load average (15m avg)"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.4",                                 "value": ""                             },                             {                                 "type": 1,                                 "name": "columns.name.5",                                 "value": "Processes"                             },                             {                                 "type": 0,                                 "name": "columns.data.5",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "columns.base_color.5",                                 "value": "FFFFFF"                             },                             {                                 "type": 1,                                 "name": "columns.item.5",                                 "value": "Number of processes"                             },                             {                                 "type": 1,                                 "name": "columns.timeshift.5",                                 "value": ""                             },                             {                                 "type": 0,                                 "name": "columns.decimal_places.5",                                 "value": 0                             },                             {                                 "type": 0,                                 "name": "column",                                 "value": 1                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *Trigger overview* widget  Configure a *Trigger overview* widget that displays trigger states for all host groups that have triggers with a tag that has the name "scope" and contains value "availability".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "trigover",                         "name": "Trigger overview",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "availability"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny de *Vista general de trigger*  configura un giny de *Vista general de trigger* que ensenya l'estat del trigger per tots els grups d'equips que tenen triggers amb una etiqueta de nom "àmbit" i valor "disponibilitat".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "el meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "trigover",                         "name": "Vista general dels triggers",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "scope"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 0                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "availability"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a *URL* widget  Configure a *URL* widget that displays the home page of Zabbix manual.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "url",                         "name": "URL",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "url",                                 "value": "https://www.zabbix.com/documentation/6.4/en"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny *URL*  Configurar un giny *URL* que ensenyi la pàgina inicial del manual de Zabbix.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "url",                         "name": "URL",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "url",                                 "value": "https://www.zabbix.com/documentation/6.4/en"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring authentication  The **Authentication** tab allows you to configure scenario authentication options. A green dot next to the tab name indicates that some type of HTTP authentication is enabled.  ![](../../assets/en/manual/config/scenario_d.png)  Authentication parameters:  |Parameter|Description| |--|--------| |*Authentication*|Authentication options.<br>**None** - no authentication used.<br>**Basic** - basic authentication is used.<br>**NTLM** - NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) authentication is used.<br>**Kerberos** - Kerberos authentication is used. See also: [Configuring Kerberos with Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - Digest authentication is used.<br>Selecting an authentication method will provide two additional fields for entering a user name and password.<br>User macros can be used in user and password fields.| |*SSL verify peer*|Mark the checkbox to verify the SSL certificate of the web server.<br>The server certificate will be automatically taken from system-wide certificate authority (CA) location. You can override the location of CA files using Zabbix server or proxy configuration parameter [SSLCALocation](/manual/appendix/config/zabbix_server).<br>This sets the [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html) cURL option.| |*SSL verify host*|Mark the checkbox to verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>This sets the [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html) cURL option.| |*SSL certificate file*|Name of the SSL certificate file used for client authentication. The certificate file must be in PEM^1^ format. If the certificate file contains also the private key, leave the *SSL key file* field empty. If the key is encrypted, specify the password in *SSL key password* field. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html) cURL option.| |*SSL key file*|Name of the SSL private key file used for client authentication. The private key file must be in PEM^1^ format. The directory containing this file is specified by Zabbix server or proxy configuration parameter [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>`HOST.*` macros and user macros can be used in this field.<br>This sets the [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html) cURL option.| |*SSL key password*|SSL private key file password.<br>User macros can be used in this field.<br>This sets the [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html) cURL option.|  ::: noteimportant  \[1\] Zabbix supports certificate and private key files in PEM format only. In case you have your certificate and private key data in PKCS \#12 format file (usually with extension \*.p12 or \*.pfx) you may generate the PEM file from it using the following commands:      openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem     openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes  -out ssl-cert.key   :::  ::: noteclassic  Zabbix server picks up changes in certificates without a restart.  :::  ::: noteclassic  If you have client certificate and private key in a single file just specify it in a "SSL certificate file" field and leave "SSL key file" field empty. The certificate and key must still be in PEM format. Combining certificate and key is easy:      cat client.crt client.key > client.pem   :::
ca	#### Configurant l'autenticació  La pestanya **Autenticació** us permet configurar les opcions d'autenticació d'escenaris. Un punt verd al costat del nom de la pestanya indica que hi ha habilitat algun tipus d'autenticació HTTP.  ![](../../assets/en/manual/config/scenario_d.png)  Paràmetres d'autenticació:  |Paràmetre|Descripció| |--|---------| |*Autenticació*|Opcions d'autenticació.<br>**Cap** - no s'empra cap autenticació.<br>**Bàsica** - s'empra l'autenticació bàsica.<br>**NTLM** - S'empra l'autenticació NTLM ([Windows NT LAN Manager)](http://en.wikipedia.org/wiki/NTLM) .<br>**Kerberos** - s'empra l'autenticació Kerberos. Veieu també: [Configuració de Kerberos amb Zabbix](/manual/appendix/items/kerberos).<br>**Digest** - s'empra l'autenticació de Digest.<br>Seleccionar un mètode d'autenticació proporcionarà dos camps addicionals per introduir un nom d'usuari i mot de pas.<br>Les macros d'usuari es poden emprar als camps d'usuari i mot de pas.| |*Verificar peer SSL*|Marqueu la casella de selecció per verificar el certificat SSL del servidor web.<br>El certificat del servidor s'agafarà automàticament de la ubicació de l'autoritat de certificació (CA) de tot el sistema. Podeu substituir la ubicació dels fitxers CA mitjançant el paràmetre de configuració del servidor o proxy Zabbix [SSLCALocation](/manual/appendix/config/zabbix_server).<br>Això estableix la opció cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).| |*Verificat equip SSL*|Marqueu la casella de selecció per verificar que el camp *Common Name* o el camp *Subject Alternate Name* del certificat del servidor web coincideix.<br>Això estableix la opció cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).| |*Fitxer de certificat SSL*|Nom del fitxer de certificat SSL emprat per a l'autenticació del client. El fitxer del certificat ha de ser en format PEM^1^. Si el fitxer de certificat també conté la clau privada, deixeu el camp *Fitxer de clau SSL* buit. Si la clau és xifrada, especifiqueu el mot de pas al camp *Mot de pas de la clau SSL*. El directori que conté aquest fitxer l'especifica el servidor Zabbix o el paràmetre de configuració del servidor proxy [SSLCertLocation](/manual/appendix/config/zabbix_server).<br>En aquest camp es poden emprar les macros `HOST.*` i les macros d'usuari.<br> Això estableix l'opció cURL [CURLOPT\_SSLCERT](http://curl.haxx.se/libcurl/c/CURLOPT_SSLCERT.html). |*Fitxer de clau SSL*|Nom del fitxer de clau privada SSL emprat per a l'autenticació del client. El fitxer de clau privada ha de ser en format PEM^1^. El directori que conté aquest fitxer l'especifica el servidor Zabbix o el paràmetre de configuració del proxy [SSLKeyLocation](/manual/appendix/config/zabbix_server).<br>En aquest camp es poden emprar macros `HOST.*` i macros d'usuari.<br> Això estableix l'opció cURL [CURLOPT\_SSLKEY](http://curl.haxx.se/libcurl/c/CURLOPT_SSLKEY.html). |*Mot de pas de clau SSL*|Mot de pas del fitxer de clau privada SSL.<br>En aquest camp es poden emprar macros d'usuari.<br>Això estableix la opció cURL [CURLOPT\_KEYPASSWD](http://curl.haxx.se/libcurl/c/CURLOPT_KEYPASSWD.html).|  ::: noteimportant   \[1\] Zabbix només admet fitxers de certificat i clau privada en format PEM. En cas que tingueu el vostre certificat i les vostres dades de clau privada en un fitxer de format PKCS \#12 (normalment amb l'extensió \*.p12 o \*.pfx), podeu generar-ne el fitxer PEM mitjançant les ordres següents:       openssl pkcs12 -in ssl-cert.p12 -clcerts -nokeys -out ssl-cert.pem      openssl pkcs12 -in ssl-cert.p12 -nocerts -nodes -out ssl-cert.key   :::  ::: noteclassic   El servidor Zabbix recull els canvis als certificats sense reiniciar-los. :::  ::: noteclassic   Si teniu un certificat de client i una clau privada en un sol fitxer, només heu d'especificar-los en un camp "Fitxer de certificat SSL" i deixar el camp "Fitxer de clau SSL" buit. El certificat i la clau han de ser en format PEM. Combinar certificat i clau és fàcil:      cat client.crt client.key > client.pem   :::

en-us	#### Configuring a *Web monitoring* widget  Configure a *Web monitoring* widget that displays a status summary of the active web monitoring scenarios for host group "4".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "web",                         "name": "Web monitoring",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```
ca	#### Configurar el giny de *Monitoratge web*  Configura un giny de *Monitoratge web* que ensenya un resum de l'estat dels escenaris de monitoratge web actius per al grup d'equips "4".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "web",                         "name": "Monitoratge Weg",                         "x": 0,                         "y": 0,                         "width": 6,                         "height": 3,                         "view_mode": 0,                         "fields": [                             {                                 "type": 2,                                 "name": "groupids",                                 "value": 4                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": 7,                 "permission": 2             }         ],         "users": [             {                 "userid": 1,                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Configuring a web scenario  To configure a web scenario:  -   Go to: *Data collection → Hosts* (or *Templates*) -   Click on *Web* in the row of the host/template -   Click on *Create web scenario* to the right (or on the scenario name to     edit an existing scenario) -   Enter parameters of the scenario in the form  The **Scenario** tab allows you to configure the general parameters of a web scenario.  ![](../../assets/en/manual/config/scenario.png)  All mandatory input fields are marked with a red asterisk.  Scenario parameters:  |Parameter|Description| |--|--------| |*Name*|Unique scenario name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*Update interval*|How often the scenario will be executed.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 2h, 1d.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if a user macro is used and its value is changed (e.g. 5m → 30s), the next check will be executed according to the previous value (farther in the future with the example values). <br> New web scenarios will be checked within 60 seconds of their creation.| |*Attempts*|The number of attempts for executing web scenario steps. In case of network problems (timeout, no connectivity, etc) Zabbix can repeat executing a step several times. The figure set will equally affect each step of the scenario. Up to 10 attempts can be specified, default value is 1.<br>*Note*: Zabbix will not repeat a step because of a wrong response code or the mismatch of a required string.| |*Agent*|Select a client agent.<br>Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.<br>User macros can be used in this field.| |*HTTP proxy*|You can specify an HTTP proxy to use, using the format `[protocol://][username[:password]@]proxy.example.com[:port]`.<br>This sets the [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html) cURL option.<br>The optional `protocol://` prefix may be used to specify alternative proxy protocols (the protocol prefix support was added in cURL 7.21.7). With no protocol specified, the proxy will be treated as an HTTP proxy.<br>By default, 1080 port will be used.<br>If specified, the proxy will overwrite proxy related environment variables like http\_proxy, HTTPS\_PROXY. If not specified, the proxy will not overwrite proxy-related environment variables. The entered value is passed on "as is", no sanity checking takes place.<br>You may also enter a SOCKS proxy address. If you specify the wrong protocol, the connection will fail and the item will become unsupported.<br>*Note* that only simple authentication is supported with HTTP proxy.<br>User macros can be used in this field.| |*Variables*|Variables that may be used in scenario steps (URL, post variables).<br>They have the following format:<br>**{macro1}**=value1<br>**{macro2}**=value2<br>**{macro3}**=regex:<regular expression><br>For example:<br>{username}=Alexei<br>{password}=kj3h5kJ34bd<br>{hostid}=regex:hostid is (\[0-9\]+)<br>The macros can then be referenced in the steps as {username}, {password} and {hostid}. Zabbix will automatically replace them with actual values. Note that variables with `regex:` need one step to get the value of the regular expression so the extracted value can only be applied to the step after.<br>If the value part starts with `regex:` then the part after it is treated as a regular expression that searches the web page and, if found, stores the match in the variable. At least one subgroup must be present so that the matched value can be extracted.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|HTTP Headers are used when performing a request. Default and custom headers can be used.<br>Headers will be assigned using default settings depending on the Agent type selected from a drop-down list on a scenario level, and will be applied to all the steps, unless they are custom defined on a step level.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>To unset the header on a scenario level, the header should be named and attributed with no value on a step level.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol, optionally using some additional features supported by the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.<br>For example:<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Enabled*|The scenario is active if this box is checked, otherwise - disabled.|  Note that when editing an existing scenario, two extra buttons are available in the form:  |   |   | |--|--------| |![](../../assets/en/manual/web_monitoring/buttons_clone.png)|Create another scenario based on the properties of the existing one.| |![](../../assets/en/manual/web_monitoring/buttons_clear.png)|Delete history and trend data for the scenario. This will make the server perform the scenario immediately after deleting the data.|  ::: notetip If *HTTP proxy* field is left empty, another way for using an HTTP proxy is to set proxy related environment variables.  For HTTP checks - set the **http\_proxy** environment variable for the Zabbix server user. For example, `http_proxy=http://proxy_ip:proxy_port`.  For HTTPS checks - set the **HTTPS\_PROXY** environment variable. For example, `HTTPS_PROXY=http://proxy_ip:proxy_port`. More details are available by running a shell command: *\# man curl*. :::  The **Steps** tab allows you to configure the web scenario steps. To add a web scenario step, click on *Add* in the *Steps* block.  ![](../../assets/en/manual/config/scenario_b.png){width="600"}  ::: noteclassic Secret [user macros](/manual/config/macros/user_macros#configuration) must not be used in URLs as they will resolve to "\*\*\*\*\*\*". :::
ca	#### Configurant un escenari web  Per configurar un escenari web:  - Aneu a: *Recull de dades → Equips* (o *Plantilles*) - Feu clic a *Web* a la filera de l'equip/plantilla - Feu clic a *Crear un escenari* a la dreta (o al nom de l'escenari per editar un escenari existent) - Introduïu els paràmetres de l'escenari al formulari  La pestanya **Escenari** us permet configurar els paràmetres generals d'un escenari web.  ![](../../assets/en/manual/config/scenario.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Paràmetres de l'escenari:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom de l'escenari únic.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros). *Tingueu en compte* que si s'empren macros d'usuari, aquestes es deixaran sense resoldre en els noms [element de monitoratge web](/manual/web_monitoring/items).| |*Interval d'actualització*|Amb quina freqüència s'executarà l'escenari.<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), p. 30s, 1m, 2h, 1d.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros). *Tingueu en compte* que si s'empra una macro d'usuari i es canvia el seu valor (per exemple, 5m → 30s), la següent comprovació s'executarà d'acord amb el valor anterior (més en el futur amb els valors d'exemple). <br> Els nous escenaris web es comprovaran dins dels 60 segons de la seva creació.| |*Intents*|Nombre d'intents per executar passes d'escenari web. En cas de problemes de xarxa (temps d'espera, sense connectivitat, etc.) Zabbix pot repetir l'execució d'una passa diversos cops. El conjunt de xifres afectarà per igual a cada passa de l'escenari. Es poden especificar fins a 10 intents, el valor per defecte és 1.<br>*Nota*: Zabbix no repetirà cap passa a causa d'un codi de resposta incorrecte o de la falta de coincidència d'una cadena requerida.| |*Agent*|Trieu un agent client.<br>Zabbix simularà ser el navegador triat. Això és útil quan un lloc web retorna contingut diferent per a diferents navegadors.<br>En aquest camp es poden emprar macros d'usuari.| |*Proxy HTTP*|Podeu especificar un proxy HTTP per emprar, emprant el format `[protocol://][nom d'usuari[:motdepas]@]proxy.exemple.cat[:port]`.<br>Això estableix la opció de cURL [CURLOPT\_PROXY](https://curl.haxx.se/libcurl/c/CURLOPT_PROXY.html).<br>El prefix opcional `protocol://` es pot emprar per especificar protocols alternatius de proxy (el suport de prefix de protocol es va afegir a cURL 7.21.7). Sense cap protocol especificat, el proxy es tractarà com un proxy HTTP.<br>De manera predeterminada, s'emprarà el port 1080.<br>Si s'especifica, el proxy sobreescriurà variables d'entorn relacionades amb el proxy, com ara http\_proxy, HTTPS\_PROXY. Si no s'especifica, el proxy no sobreescriurà les variables d'entorn relacionades amb el proxy. El valor introduït es transmet "tal com és", no es fa cap comprovació de seny.<br>També podeu introduir una adreça proxy SOCKS. Si especifiqueu un protocol incorrecte, la connexió fallarà i l'element no s'admetrà.<br>*Tingueu en compte* que només s'admet l'autenticació simple amb el proxy HTTP.<br>En aquest camp es poden emprar macros d'usuari.| |*Variables*|Variables que es poden emprar a les passes de l'escenari (URL, variables de publicació).<br>Tenen el format següent:<br>**{macro1}**=valor1<br>**{macro2}* *=valor2<br>**{macro3}**=regex:<expressió regular><br>Per exemple:<br>{nom d'usuari}=Alexei<br>{motdepas}=kj3h5kJ34bd<br>{hostid}=regex :hostid és (\[0-9\]+)<br>Tot seguit, es pot fer referència a les macros a les passes com a {nom d'usuari}, {motdepas} i {identificador}. Zabbix els substituirà automàticament per valors reals. Tingueu en compte que les variables amb `regex:` necessiten una passa per obtindre el valor de l'expressió regular, de manera que el valor extret només es pot aplicar a la passa posterior.<br>Si la part del valor comença amb `regex:` aleshores la part posterior es tracta com una expressió regular que cerca a la pàgina web i, si es troba, emmagatzema la coincidència a la variable. Hi ha d'haver com a mínim un subgrup perquè es pugui extreure el valor coincident.<br>S'admeten macros d'usuari i [macros](/manual/appendix/macros/supported_by_location)  {HOST.\*}.<br>Les variables són automàticament codificades per URL quan s'empra a camps de consulta o dades de formulari per a variables de publicació, però s'ha de codificar per URL manualment quan s'empra a la publicació sense processar o directament a l'URL.| |*Capçaleres*|Les capçaleres HTTP s'empren quan es fa una petició. Es poden emprar capçaleres predeterminades i personalitzades.<br>Les capçaleres s'assignaran mitjançant la configuració predeterminada en funció del tipus d'agent triat d'una llista desplegable a nivell d'escenari, i s'aplicaran a totes les passes, tret que siguin definides personalment a un nivell de passa.<br>**S'ha de tindre en compte que la definició de la capçalera en un nivell de passa descarta automàticament totes les capçaleres definides anteriorment, excepte una capçalera predeterminada que s'assigna triant l'"Agent d'usuari" d'un menú desplegable de llista a nivell d'escenari.**<br>Tot i això, fins i tot la capçalera predeterminada "Agent d'usuari" es pot substituir especificant-la a un nivell de passa.<br>Per desactivar la capçalera a nivell d'escenari, la capçalera s'hauria d'anomenar i s'atribueix sense cap valor a un nivell de passa.<br>Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP, opcionalment emprant algunes funcions addicionals compatibles amb l'opció cURL [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html).<br>Per exemple:<br>Accept-Charset=utf-8<br>Accept-Language=en-US<br>Content-Type=application/xml; charset=utf-8<br>S'admeten macros d'usuari i [macros](/manual/appendix/macros/supported_by_location) {HOST.\*}.| |*Activat*|L'escenari és actiu si aquesta casella és marcada, en cas contrari - desactivat.|  Tingueu en compte que en editar un escenari existent, hi ha dos botons addicionals disponibles al formulari:  | | | |--|---------| |![](../../assets/en/manual/web_monitoring/buttons_clone.png)|Crear un altre escenari basat en les propietats de l'existent.| |![](../../assets/en/manual/web_monitoring/buttons_clear.png)|Esborra l'historial i les dades de tendències de l'escenari. Això farà que el servidor faci l'escenari immediatament després d'esborrar les dades.|  ::: notetip Si el camp *Proxy HTTP* es deixa buit, una altra manera d'emprar un proxy HTTP és establir variables d'entorn relacionades amb el proxy.  Per a les comprovacions HTTP: establiu la variable d'entorn **http\_proxy** per a l'usuari del servidor Zabbix. Per exemple, `http_proxy=http://proxy_ip:proxy_port`.  Per a les comprovacions HTTPS: establiu la variable d'entorn **HTTPS\_PROXY**. Per exemple, `HTTPS_PROXY=http://proxy_ip:proxy_port`. Hi ha més detalls disponibles executant una ordre de shell: *\# man curl*. :::  La pestanya **Passes** us permet configurar les passes de l'escenari web. Per afegir una passa d'escenari web, feu clic a *Afegir* al bloc *Passes*.  ![](../../assets/en/manual/config/scenario_b.png){width="600"}  ::: noteclassic Les [macros d'usuari] secretes (/manual/config/macros/user_macros#configuration) no s'han d'emprar a les URL, ja que es resoldran en "\*\*\*\*\*\*". :::