en-us	#### Configuring steps  ![](../../assets/en/manual/config/scenario_step.png){width="600"}  Step parameters:  |Parameter|Description| |--|--------| |*Name*|Unique step name.<br>[User macros](/manual/config/macros/user_macros) are supported. *Note* that if user macros are used, these macros will be left unresolved in [web monitoring item](/manual/web_monitoring/items) names.| |*URL*|URL to connect to and retrieve data. For example:<br>https://www.example.com<br>http://www.example.com/download<br>Domain names can be specified in Unicode characters. They are automatically punycode-converted to ASCII when executing the web scenario step.<br>The *Parse* button can be used to separate optional query fields (like ?name=Admin&password=mypassword) from the URL, moving the attributes and values into *Query fields* for automatic URL-encoding.<br>Variables can be used in the URL, using the {macro} syntax. Variables can be URL-encoded manually using a {{macro}.urlencode()} syntax.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.<br>Limited to 2048 characters.| |*Query fields*|HTTP GET variables for the URL.<br>Specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically. Using a {{macro}.urlencode()} syntax will double URL-encode them.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Post*|HTTP POST variables.<br>In **Form data** mode, specified as attribute and value pairs.<br>Values are URL-encoded automatically. Values from scenario variables, user macros or {HOST.\*} macros are resolved and then URL-encoded automatically.<br>In **Raw data** mode, attributes/values are displayed on a single line and concatenated with a **&** symbol.<br>Raw values can be URL-encoded/decoded manually using a {{macro}.urlencode()} or {{macro}.urldecode()} syntax.<br>For example: id=2345&userid={user}<br>If {user} is defined as a variable of the web scenario, it will be replaced by its value when the step is executed. If you wish to URL-encode the variable, substitute {user} with {{user}.urlencode()}.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Variables*|Step-level variables that may be used for GET and POST functions.<br>Specified as attribute and value pairs.<br>Step-level variables override scenario-level variables or variables from the previous step. However, the value of a step-level variable only affects the step after (and not the current step).<br>They have the following format:<br>**{macro}**=value<br>**{macro}**=regex:<regular expression><br>For more information see variable description on the [scenario](web_monitoring#configuring_a_web_scenario) level.<br>Variables are automatically URL-encoded when used in query fields or form data for post variables, but must be URL-encoded manually when used in raw post or directly in URL.| |*Headers*|Custom HTTP headers that will be sent when performing a request.<br>Specified as attribute and value pairs.<br>A header defined on a step level will be used for that particular step.<br>**It should be noted that defining the header on a step level automatically discards all the previously defined headers, except for a default header that is assigned by selecting the 'User-Agent' from a drop-down list on a scenario level.**<br>However, even the 'User-Agent' default header can be overridden by specifying it on a step level.<br>For example, assigning the name to a header, but setting no value will unset the default header on a scenario level.<br>User macros and {HOST.\*} macros are supported.<br>This sets the [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html) cURL option.| |*Follow redirects*|Mark the checkbox to follow HTTP redirects.<br>This sets the [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html) cURL option.| |*Retrieve mode*|Select the retrieve mode:<br>**Body** - retrieve only body from the HTTP response<br>**Headers** - retrieve only headers from the HTTP response<br>**Body and headers** - retrieve body and headers from the HTTP response| |*Timeout*|Zabbix will not spend more than the set amount of time on processing the URL (from one second to maximum of 1 hour). Actually this parameter defines the maximum time for making connection to the URL and maximum time for performing an HTTP request. Therefore, Zabbix will not spend more than **2 x Timeout** seconds on the step.<br>[Time suffixes](/manual/appendix/suffixes) are supported, e.g. 30s, 1m, 1h. [User macros](/manual/config/macros/user_macros) are supported.| |*Required string*|Required regular expression pattern.<br>Unless retrieved content (HTML) matches the required pattern the step will fail. If empty, no check on required string is performed.<br>For example:<br>Homepage of Zabbix<br>Welcome.\*admin<br>*Note*: Referencing [regular expressions](regular_expressions) created in the Zabbix frontend is not supported in this field.<br>User macros and {HOST.\*} [macros](/manual/appendix/macros/supported_by_location) are supported.| |*Required status codes*|List of expected HTTP status codes. If Zabbix gets a code which is not in the list, the step will fail.<br>If empty, no check on status codes is performed.<br>For example: 200,201,210-299<br>User macros are supported.|  ::: noteclassic Any changes in web scenario steps will only be saved when the whole scenario is saved. :::  See also a [real-life example](/manual/web_monitoring/example) of how web monitoring steps can be configured.
ca	#### Configurant passes  ![](../../assets/en/manual/config/scenario_step.png){width="600"}  Paràmetre de passes:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic de la passa.<br>S'admeten [macros d'usuari](/manual/config/macros/user_macros). *Tingueu en compte* que si s'empren macros d'usuari, aquestes es deixaran sense resoldre en els noms [element de monitoratge web](/manual/web_monitoring/items).| |*URL*|URL per connectar-se i recuperar dades. Per exemple:<br>https://www.exemple.cat<br>http://www.exemple.cat/download<br>Els noms de domini es poden especificar en caràcters Unicode. Es converteixen automàticament en codi punycode a ASCII quan s'executa la passa de l'escenari web.<br>El botó *Analitzar* es pot emprar per separar els camps de consulta opcionals (com ara ?name=Admin&password=mypassword) de l'URL, movent els atributs i els valors a *Camps de consulta* per a la codificació automàtica d'URL.<br>Es poden emprar variables a l'URL mitjançant la sintaxi {macro}. Les variables es poden codificar per URL manualment mitjançant una sintaxi {{macro}.urlencode()}.<br>S'admeten macros d'usuari i {HOST.\*} [macros](/manual/appendix/macros/supported_by_location).<br >Limitat a 2048 caràcters.| |*Camps de consulta*|Variables HTTP GET per a l'URL.<br>Especificat com a parelles d'atribut i valor.<br>Els valors es codifiquen automàticament per URL. Els valors de les variables d'escenari, les macros d'usuari o les macros {HOST.\*} es resolen i després es codifiquen automàticament per URL. L'ús d'una sintaxi {{macro}.urlencode()} els codificarà per doble URL.<br>S'admeten macros d'usuari i [macros](/manual/appendix/macros/supported_by_location) {HOST.\*} .| |*Publicació*|Variables HTTP POST.<br>En el mode **Dades de formulari**, especificat com a parelles d'atributs i valors.<br>Els valors es codifiquen automàticament per URL. Els valors de les variables d'escenari, les macros d'usuari o les macros {HOST.\*} es resolen i després es codifiquen automàticament per URL.<br>En el mode **Dades en brut**, els atributs/valors es mostren en una sola línia i es concatenen amb un * Símbol *&**.<br>Els valors en brut es poden codificar/descodificar manualment mitjançant una sintaxi {{macro}.urlencode()} o {{macro}.urldecode()}.<br>Per exemple: id= 2345&userid={usuari}<br>Si {usuari} es defineix com una variable de l'escenari web, es substituirà pel seu valor quan s'executi la passa. Si voleu codificar l'URL de la variable, substituïu {user} per {{user}.urlencode()}.<br>Macros d'usuari i [macros](/manual/appendix/macros/supported_by_location) {HOST.\*} són compatibles.| |*Variables*|Variables de nivell de la passa que es poden emprar per a les funcions GET i POST.<br>Especificades com a parelles d'atributs i valors.<br>Les variables de nivell de la passa anul·len les variables de nivell d'escenari o les variables de la passa anterior. Tanmateix, el valor d'una variable de nivell de la passa només afecta la passa posterior (i no la passa actual).<br>Tenen el format següent:<br>**{macro}**=valor<br>**{ macro}**=regex:<expressió regular><br>Per obtindre més informació, consulteu la descripció de la variable al nivell [escenari](web_monitoring#configuring_a_web_scenario).<br>Les variables es codifiquen automàticament en URL quan s'empren en camps de consulta o dades de formulari per a variables de publicació, però s'han de codificar manualment per URL quan s'empren a la publicació en brut o directament a l'URL.| |*Capçaleres*|Capçaleres HTTP personalitzades que s'enviaran quan es faci una petició.<br>Especificada com a parelles d'atribut i valor.<br>S'emprarà una capçalera definida en un nivell de la passa per a aquest pas en concret.<br>** Cal tindre en compte que la definició de la capçalera en un nivell de la passa descarta automàticament totes les capçaleres definides anteriorment, excepte una capçalera predeterminada que s'assigna triant "User-Agent" d'una llista desplegable a nivell d'escenari.**< br>tot i això, fins i tot la capçalera predeterminada "Agent d'usuari" es pot anul·lar especificant-la en un nivell de la passa.<br>Per exemple, assignar el nom a una capçalera, però no establir cap valor anul·larà la capçalera predeterminada a nivell d'escenari.<br>S'admeten macros d'usuari i macros {HOST.\*}.<br>Això estableix l'opció cURL [CURLOPT\_HTTPHEADER](http://curl.haxx.se/libcurl/c/CURLOPT_HTTPHEADER.html). | |*Follow redirects*|Marqueu la casella de selecció per seguir les redireccions HTTP.<br>Això estableix l'opció cURL [CURLOPT\_FOLLOWLOCATION](http://curl.haxx.se/libcurl/c/CURLOPT_FOLLOWLOCATION.html).| |*Mode de recuperació*|Trieu el mode de recuperació:<br>**Cos** - recupera només el cos de la resposta HTTP<br>**Capçaleres** - recupera només les capçaleres de la resposta HTTP<br>**Cos i capçaleres** - recupera el cos i les capçaleres de la resposta HTTP| |*Temps d'espera*|Zabbix no dedicarà més del temps establert a processar l'URL (d'un segon fins a un màxim d'1 hora). En realitat, aquest paràmetre defineix el temps màxim per fer la connexió a l'URL i el temps màxim per realitzar una petició HTTP. Per tant, Zabbix no dedicarà més de **2 x Temps d'espera** segons la passa.<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), p. ex. 30s, 1m, 1h. [Les macros d'usuari](/manual/config/macros/user_macros) són compatibles.| |*Cadena obligatòria*|Patró d'expressió regular obligatori.<br>Llevat que el contingut recuperat (HTML) coincideixi amb el patró requerit, la passa fallarà. Si és buit, no es fa cap comprovació de la cadena necessària.<br>Per exemple:<br>Pàgina d'inici de Zabbix<br>Benvingut.\*administrador<br>*Nota*: En aquest camp no s'admeten referències a [expressions regulars](expressions_regulars) creades a la interfície Zabbix.<br>S'admeten macros d'usuari i [macros](/manual/appendix/macros/supported_by_location) {HOST.\*}.| |*Codis d'estat obligatoris*|Llista de codis d'estat HTTP esperats. Si Zabbix obté un codi que no és a la llista, la passa fallarà.<br>Si és buit, no es fa cap comprovació dels codis d'estat.<br>Per exemple: 200,201,210-299<br>S'admeten macros d'usuari.|  ::: noteclassic Qualsevol canvi en les passes de l'escenari web només es desarà quan es desi tot l'escenari. :::  Veieu també un [exemple de la vida real](/manual/web_monitoring/example) de com es poden configurar les passes de monitoratge web.

en-us	#### Configuring tags  The **Tags** tab allows to define scenario-level [tags](/manual/config/tagging).  ![](../../assets/en/manual/config/scenario_c.png)  Tagging allows to filter web scenarios and web monitoring [items](/manual/web_monitoring/items).
ca	#### Configuració de les etiquetes  La pestanya **Etiquetes** permet definir [etiquetes](/manual/config/tagging) a nivell d'escenari.  ![](../../assets/en/manual/config/scenario_c.png)  Les etiquetes s'empren per filtrar escenaris web i monitoratge d'[elements](/manual/web_monitoring/items) web.

en-us	#### Configuring unixODBC  To configure unixODBC, you must edit the `odbcinst.ini` and `odbc.ini` files. You can verify the location of these files by executing the following command:  ```bash odbcinst -j ```  The command result should contain information that is similar to the following:  ```bash unixODBC 2.3.9 DRIVERS............: /etc/odbcinst.ini SYSTEM DATA SOURCES: /etc/odbc.ini FILE DATA SOURCES..: /etc/ODBCDataSources ```
ca	#### Configuració de unixODBC  La configuració d'ODBC es fa editant els fitxers `odbcinst.ini` i `odbc.ini`. Per comprovar la ubicació del fitxer de configuració, escriviu:  ```bash odbcinst -j ```  La comanda hauria de retornar informació similar a la següent:  ``` bashunixODBC 2.3.9 DRIVERS............: /etc/odbcinst.ini SYSTEM DATA SOURCES: /etc/odbc.ini FILE DATA SOURCES..: /etc/ODBCDataSources ```

en-us	##### Configuring Zabbix agent  1\. Open the agent configuration file on the machine where the agent is installed (by default, the path is */usr/local/etc/zabbix_agentd.conf*):      sudo vi /usr/local/etc/zabbix_agentd.conf  2\. Add the IP address or DNS name of your Zabbix server to the *ServerActive* parameter. For example:      ServerActive=192.0.2.22  3\. Define the *Hostname* parameter - it must match the host name defined in Zabbix frontend. In our example, it is:      Hostname=Remote host  4\. Restart Zabbix agent:      systemctl restart zabbix-agent
ca	##### Configurar l'agent Zabbix  1\. Obriu el fitxer de configuració de l'agent a la màquina on és instal·lat l'agent (per defecte, la ruta és */usr/local/etc/zabbix_agentd.conf*):      sudo vi /usr/local/etc/zabbix_agentd.conf  2\. Afegiu l'adreça IP o el nom DNS del vostre servidor Zabbix al paràmetre *ServerActive*. Per exemple:      ServerActive=192.0.2.22  3\. Definiu el paràmetre *Hostname* - ha de coincidir amb el nom d'equip definit a la interfície Zabbix. Al nostre exemple, és:      Hostname=Equip remot  4\. Reinicieu l'agent Zabbix:      systemctl restart zabbix-agent

en-us	##### Configuring Zabbix agent  1\. Open the agent configuration file on the machine where the agent is installed (by default, the path is */usr/local/etc/zabbix_agentd.conf*):       sudo vi /usr/local/etc/zabbix_agentd.conf  2\. Add the IP address or DNS name of your Zabbix server to the *Server* parameter. For example:      Server=192.0.2.22  3\. Restart Zabbix agent:      systemctl restart zabbix-agent
ca	##### Configurar l'agent Zabbix  1\. Obriu el fitxer de configuració de l'agent a la màquina on és instal·lat l'agent (per defecte, la ruta és */usr/local/etc/zabbix_agentd.conf*):      sudo vi /usr/local/etc/zabbix_agentd.conf  2\. Afegiu l'adreça IP o el nom DNS del vostre servidor Zabbix al paràmetre *Server*. Per exemple:      Server=192.0.2.22  3\. Reinicieu l'agent Zabbix:      systemctl restart zabbix-agent

en-us	##### Configuring Zabbix server/proxy  To read the traps, Zabbix server or proxy must be configured to start the SNMP trapper process and point to the trap file that is being written by SNMPTT or a Bash/Perl trap receiver. To do that, edit the configuration file ([zabbix\_server.conf](/manual/appendix/config/zabbix_server) or [zabbix\_proxy.conf](/manual/appendix/config/zabbix_proxy)):  ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ```  ::: notewarning If systemd parameter **[PrivateTmp](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=)** is used, this file is unlikely to work in */tmp*. :::  ##### Configuring Bash trap receiver  Requirements: only snmptrapd.  A Bash trap receiver [script](https://raw.githubusercontent.com/zabbix/zabbix-docker/master/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) can be used to pass traps to Zabbix server from snmptrapd using trapper file. To configure it, add the `traphandle` option to snmptrapd configuration file (`snmptrapd.conf`), see [example](https://raw.githubusercontent.com/zabbix/zabbix-docker/master/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf).  :::notetip snmptrapd might need to be restarted to pick up changes to its configuration. :::
ca	##### Configurant el servidor/proxy Zabbix  Per llegir els traps, s'ha de configurar el servidor o el proxy Zabbix per iniciar el procés de traps SNMP i apuntar al fitxer de traps que és escrivint SNMPTT o un receptor de traps Bash/Perl. Per fer-ho, editeu el fitxer de configuració ([zabbix\_server.conf](/manual/appendix/config/zabbix_server) o [zabbix\_proxy.conf](/manual/appendix/config/zabbix_proxy)):  ```ini StartSNMPTrapper=1 SNMPTrapperFile=[TRAP FILE] ```  ::: notewarning Si s'empra el paràmetre systemd **[PrivateTmp](http://www.freedesktop.org/software/systemd/man/systemd.exec.html#PrivateTmp=)**, és poc probable que aquest fitxer funcioni a */tmp*. :::  ##### Configurant el receptor de traps Bash  Requisits: només snmptrapd.  Es pot emprar un receptor de traps d'[script de bash](https://raw.githubusercontent.com/zabbix/zabbix-docker/master/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) per passar traps al servidor Zabbix directament des d'snmptrapd. Per configurar-lo, afegiu l'opció `traphandle` al fitxer de configuració snmptrapd (`snmptrapd.conf`), veieu l'[exemple](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.2/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf).  :::notetip segurament calgui reiniciar l'snmptrapd per aplicar els canvis a la seva configuració. :::

en-us	#### Connection encryption management  Connections in Zabbix can use:  -   no encryption (default) -   [RSA certificate-based     encryption](/manual/encryption/using_certificates) -   [PSK-based encryption](/manual/encryption/using_pre_shared_keys)  There are two important parameters used to specify encryption between Zabbix components:  -   TLSConnect - specifies what encryption to use for outgoing     connections (unencrypted, PSK or certificate) -   TLSAccept - specifies what types of connections are allowed for     incoming connections (unencrypted, PSK or certificate). One or more     values can be specified.  `TLSConnect` is used in the configuration files for Zabbix proxy (in active mode, specifies only connections to server) and Zabbix agent (for active checks). In Zabbix frontend the TLSConnect equivalent is the *Connections to host* field in *Data collection → Hosts → <some host> → Encryption* tab and the *Connections to proxy* field in *Administration → Proxies → <some proxy> → Encryption* tab. If the configured encryption type for connection fails, no other encryption types will be tried.  `TLSAccept` is used in the configuration files for Zabbix proxy (in passive mode, specifies only connections from server) and Zabbix agent (for passive checks). In Zabbix frontend the TLSAccept equivalent is the *Connections from host* field in *Data collection → Hosts → <some host> → Encryption* tab and the *Connections from proxy* field in *Administration → Proxies → <some proxy> → Encryption* tab.  Normally you configure only one type of encryption for incoming encryptions. But you may want to switch the encryption type, e.g. from unencrypted to certificate-based with minimum downtime and rollback possibility. To achieve this:  -   Set `TLSAccept=unencrypted,cert` in the agent configuration file and     restart Zabbix agent -   Test connection with zabbix\_get to the agent using certificate. If     it works, you can reconfigure encryption for that agent in Zabbix     frontend in the *Data collection → Hosts → <some host> →     Encryption* tab by setting *Connections to host* to "Certificate". -   When server configuration cache gets updated (and proxy     configuration is updated if the host is monitored by proxy) then     connections to that agent will be encrypted -   If everything works as expected you can set `TLSAccept=cert` in the     agent configuration file and restart Zabbix agent. Now the agent     will be accepting only encrypted certificate-based connections.     Unencrypted and PSK-based connections will be rejected.  In a similar way it works on server and proxy. If in Zabbix frontend in host configuration *Connections from host* is set to "Certificate" then only certificate-based encrypted connections will be accepted from the agent (active checks) and zabbix\_sender (trapper items).  Most likely you will configure incoming and outgoing connections to use the same encryption type or no encryption at all. But technically it is possible to configure it asymmetrically, e.g. certificate-based encryption for incoming and PSK-based for outgoing connections.  Encryption configuration for each host is displayed in the Zabbix frontend, in *Data collection → Hosts* in the *Agent encryption* column. For example:  |Example|Connections to host|Allowed connections from host|Rejected connections from host| |-------|-------------------|-----------------------------|------------------------------| |![none\_none.png](../../assets/en/manual/encryption/none_none.png)|Unencrypted|Unencrypted|Encrypted, certificate and PSK-based encrypted| |![cert\_cert.png](../../assets/en/manual/encryption/cert_cert.png)|Encrypted, certificate-based|Encrypted, certificate-based|Unencrypted and PSK-based encrypted| |![psk\_psk.png](../../assets/en/manual/encryption/psk_psk.png)|Encrypted, PSK-based|Encrypted, PSK-based|Unencrypted and certificate-based encrypted| |![psk\_none\_psk.png](../../assets/en/manual/encryption/psk_none_psk.png)|Encrypted, PSK-based|Unencrypted and PSK-based encrypted|Certificate-based encrypted| |![cert\_all.png](../../assets/en/manual/encryption/cert_all.png)|Encrypted, certificate-based|Unencrypted, PSK or certificate-based encrypted|\-|  ::: noteimportant Connections are unencrypted by default. Encryption must be configured for each host and proxy individually. :::
ca	#### Gestió del xifrat de les connexions  Les connexions a Zabbix poden emprar:  - sense xifrat (per defecte) - [Xifrat basat en certificat RSA](/manual/encryption/using_certificates) - [Xifrat basat en PSK](/manual/encryption/using_pre_shared_keys)  S'empren dos paràmetres importants per especificar el xifrat entre components Zabbix:  - TLSConnect: especifica el xifrat que s'emprarà per a les connexions sortints (sense xifrar, PSK o certificat) - TLSAccept: especifica quins tipus de connexió es permeten per a connexions entrants (sense xifrar, PSK o certificat). Es poden especificar un o més valors.  `TLSConnect` s'empra als fitxers de configuració per al proxy Zabbix (en mode actiu, només especifica les connexions del servidor) i l'agent Zabbix (per a comprovacions actives). A la interfície de Zabbix, l'equivalent de TLSConnect és el camp *Connexions a l'equip* a *Configuració → Equips → <un equip> → Pestanya Xifrat* i el camp *Connexions al proxy* a la pestanya *Administració → Proxys → <un proxy> → Xifrat* . Si el tipus de xifrat configurat per a la connexió falla, no es provarà cap altre tipus de xifrat.  `TLSAccept` s'empra als fitxers de configuració per al proxy Zabbix (en mode passiu, només especifica connexions des del servidor) i l'agent Zabbix (per a comprovacions passives). A la interfície de Zabbix, l'equivalent de TLSAccept és el camp *Connexions des de l'equip* a la pestanya *Configuració → Equips → <un equip> → Xifrat* i el camp *Connexions des del proxy* a la pestanya *Administració → Proxys → <un proxy> → Xifrat* .  Normalment, només configureu un tipus de xifrat per a xifrats entrants. Però és possible que vulgueu canviar el tipus de xifrat, per exemple, de no xifrat a basat en certificats amb un temps d'inactivitat i una capacitat de retrocés mínims. Per aconseguir-ho:  - Establiu `TLSAccept=unencrypted,cert` al fitxer de configuració de l'agent i reinicieu l'agent Zabbix - Proveu la connexió amb zabbix\_get amb l'agent mitjançant el certificat. Si funciona, podeu tornar a configurar el xifrat per a aquest agent a la interfície Zabbix a la pestanya *Configuració → Equips → <un equip> → Xifrat* configurant *Connexions a l'equip* a "Certificat". - Quan s'actualitza la memòria cau de configuració del servidor (i la configuració del proxy s'actualitza si l'equip és monitorat per el proxy), les connexions a aquest agent es xifraran - Si tot funciona com s'esperava, podeu establir `TLSAccept=cert` al fitxer de configuració de l'agent i reiniciar l'agent Zabbix. Ara l'agent només admetrà connexions basades en certificats xifrats. Les connexions no xifrades i basades en PSK seran rebutjades.  De la mateixa manera, funciona al servidor i al proxy. Si a la interfície Zabbix, a la configuració de l'equip, *Connexions des de l'equip* s'estableix a "Certificat", només les connexions xifrades basades en certificats seran acceptades per l'agent (comprovacions actives) i el \_sender de zabbix (elements trapper).  El més probable és que configureu les connexions entrants i sortints per emprar el mateix tipus de xifrat o cap xifrat. Però tècnicament és possible configurar-ho de manera asimètrica, com ara xifrat basat en certificats per a connexions entrants i encriptació basat en PSK per a connexions sortints.  La configuració de xifrat per a cada equip es mostra a la interfície Zabbix, a *Recull de dades → Equips* a la columna *Xifrat de l'agent*. Per exemple:  |Exemple|Connexions a l'equip|Connexions permeses des de l'equip|Connexions no permeses des de l'equip| |-------|--------------------|-----|---------------- ----| |![none\_none.png](../../assets/en/manual/encryption/none_none.png)|No xifrat|No xifrat|Xifrat, certificat i xifrat basat en PSK| |![cert\_cert.png](../../assets/en/manual/encryption/cert_cert.png)|Xifrat, basat en certificats|Xifrat, basat en certificats|No xifrat i xifrat amb PSK| |![psk\_psk.png](../../assets/en/manual/encryption/psk_psk.png)|Xifrat, basat en PSK|Xifrat, basat en PSK|Xifrat sense xifrar i xifrat en certificat| |![psk\_none\_psk.png](../../assets/en/manual/encryption/psk_none_psk.png)|Xifrat, basat en PSK|Sense xifrat i xifrat amb PSK|Xifrat basat en certificat| |![cert\_all.png](../../assets/en/manual/encryption/cert_all.png)|Xifrat, basat en certificat|Sense xifrat, PSK o xifrat basat en certificat|\-|  ::: noteimportant Les connexions no són xifrades per defecte. El xifrat s'ha de configurar per a cada equip i proxy individualment. :::

en-us	#### Connection setup  Zabbix supports two types of connect identifiers (connection methods):  -   Easy Connect -   Net Service Name  Connection configuration parameters for Zabbix server and Zabbix proxy can be set in the configuration files. Important parameters for the server and proxy are *DBHost*, *DBUser*, *DBName* and *DBPassword*. The same parameters are important for the frontend: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*.  Zabbix uses the following connection string syntax:      {DBUser/DBPassword[@<connect_identifier>]}   <connect\_identifier> can be specified either in the form of "Net Service Name" or "Easy Connect".      @[[//]Host[:Port]/<service_name> | <net_service_name>]
ca	#### Configuració de la connexió  Zabbix suporta dos tipus d'identificadors de la connexió (mètodes de connexió):  - Easy Connect - Net Service Name  Els paràmetres de configuració de connexió per al servidor Zabbix i el proxy Zabbix poden definir-se a l'arxiu de configuració. Els paràmetres importants per al servidor i el proxy són *DBHost*, *DBUser*, *DBName* i *DBPassword*. Els mateixos paràmetres són importants per a la interfície Web : *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*.  Zabbix empra la sintaxi de cadena de connexió següent:      {DBUser/DBPassword[@<connect_identifier>]}  <connect\_identifier> es pot especificar amb la forma "Net Nom del servei" o sota la forma "Easy Connect".      @[[//]Host[:Port]/<service_name> | <net_service_name>]

en-us	##### Connections  Some plugins support gathering metrics from multiple instances simultaneously. Both local and remote instances can be monitored. TCP and Unix-socket connections are supported.  It is recommended to configure plugins to keep connections to instances in an open state. The benefits are reduced network congestion, latency, and CPU and memory usage due to the lower number of connections. The client library takes care of this.  ::: notetip Time period for which unused connections should remain open can be determined by *Plugins.<PluginName>.KeepAlive* parameter. Example: *Plugins.Memcached.KeepAlive* :::
ca	#### Connexions  Alguns connectors admeten la recollida de mètriques de diverses instàncies simultàniament. Es poden controlar tant les instàncies locals com les remotes. S'admeten tant les connexions de socket TCP com Unix.  Es recomana configurar connectors per mantindre les connexions d'instància en estat obert. Els avantatges són la reducció de la congestió de la xarxa, la latència i l'ús de la CPU i la memòria a causa de menys connexions. La biblioteca del client s'encarrega d'això.  ::: notetip   Es pot determinar quant de temps han de romandre obertes les connexions no emprades mitjançant *Plugins.<PluginName>.KeepAlive*.\ Exemple: *Plugins.Memcached.KeepAlive* :::

en-us	# connector.create
ca	# creació del connector

en-us	# connector.delete
ca	# connector.delete

en-us	# connector.get
ca	# connector.get

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

en-us	## Connectors  The [data streaming](/manual/config/export/streaming) functionality is no longer experimental.
ca	## Connectors  La funcionalitat [streaming de dades](/manual/config/export/streaming) ja no és experimental.

en-us	#### - Connectors  This section allows to configure connectors for Zabbix data [streaming to external systems](/manual/config/export/streaming) over HTTP.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_connectors.png){width="600"}  Click on *Create connector* to configure a new [connector](/manual/config/export/streaming#configuration).  You may filter connectors by name or status (enabled/disabled). Click on the connector status in the list to enable/disable a connector.  You may also mass enable/disable connectors by selecting them in the list and then clicking on the *Enable/Disable* buttons below the list.
ca	#### - Connectors  Aquesta secció permet configurar connectors per a [transmissió de dades de Zabbix a sistemes externs](/manual/config/export/streaming) a través d'HTTP.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_connectors.png){width="600"}  Feu clic a *Crear connector* per configurar un nou [connector](/manual/config/export/streaming#configuration).  Podeu filtrar els connectors per nom o estat (activat/desactivat). Feu clic a l'estat del connector a la llista per activar/desactivar un connector. També podeu activar/desactivar connectors en massa seleccionant-los a la llista i fent clic als botons *Activar/Desactivar* a sota de la llista.

en-us	### Connector  The connector object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |connectorid|ID|ID of the connector.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the connector.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |url|string|Endpoint URL, that is, URL of the receiver.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |protocol|integer|Communication protocol.<br><br>Possible values:<br>0 - *(default)* Zabbix Streaming Protocol v1.0.| |data\_type|integer|Data type.<br><br>Possible values:<br>0 - *(default)* Item values;<br>1 - Events.| |item\_value\_type|integer|A sum of item value types to be sent.<br><br>Possible values:<br>1 - Numeric (float);<br>2 - Character;<br>4 - Log;<br>8 - Numeric (unsigned);<br>16 - Text.<br><br>Default: 31 - All item types.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `data_type` is set to "Item values".| |max\_records|integer|Maximum number of events or items that can be sent within one message.<br><br>Possible values: 0-2147483647 (max value of 32-bit signed integer).<br><br>Default: 0 - Unlimited.| |max\_senders|integer|Number of sender processes to run for this connector.<br><br>Possible values: 1-100.<br><br>Default: 1.| |max\_attempts|integer|Number of attempts.<br><br>Possible values: 1-5.<br><br>Default: 1.| |attempt\_interval|string|The interval between retry attempts.<br>Accepts seconds.<br><br>Possible values: 0s-10s.<br><br>Default: 5s.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `max_attempts` is greater than 1.| |timeout|string|Timeout.<br>Time suffixes are supported (e.g., 30s, 1m).<br>User macros are supported.<br><br>Possible values: 1s-60s.<br><br>Default: 5s.| |http\_proxy|string|HTTP(S) proxy connection string given as <br>*\[protocol\]://\[username\[:password\]@\]proxy.example.com\[:port\]*.<br><br>User macros are supported.| |authtype|integer|HTTP authentication method.<br><br>Possible values:<br>0 - *(default)* None;<br>1 - Basic;<br>2 - NTLM;<br>3 - Kerberos;<br>4 - Digest;<br>5 - Bearer.| |username|string|User name.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` is set to "Basic", "NTLM", "Kerberos", or "Digest"| |password|string|Password.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` is set to "Basic", "NTLM", "Kerberos", or "Digest"| |token|string|Bearer token.<br>User macros are supported.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `authtype` is set to "Bearer"| |verify\_peer|integer|Whether to validate that the host's certificate is authentic.<br><br>Possible values:<br>0 - Do not validate;<br>1 - *(default)* Validate.| |verify\_host|integer|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Possible values:<br>0 - Do not validate;<br>1 - *(default)* Validate.| |ssl\_cert\_file|string|Public SSL Key file path.<br>User macros are supported.| |ssl\_key\_file|string|Private SSL Key file path.<br>User macros are supported.| |ssl\_key\_password|string|Password for SSL Key file.<br>User macros are supported.| |description|text|Description of the connector.| |status|integer|Whether the connector is enabled.<br><br>Possible values:<br>0 - Disabled;<br>1 - *(default)* Enabled.| |tags\_evaltype|integer|Tag evaluation method.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.|
ca	### Connector  L'objecte connector té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |connectorid|ID|ID del connector.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |name|cadena|Nom del connector.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per a operacions de creació| |url|cadena|URL del punt final, és a dir, URL del receptor.<br>S'admeten macros d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br> - *obligatori* per a operacions de creació| |protocol|enter|Protocol de comunicació.<br><br>Valors possibles:<br>0 - *(per defecte)* Zabbix Streaming Protocol v1.0.| |data_type|enter|Tipus de dades.<br><br>Valors possibles:<br>0 - *(per defecte)* Valors d'element;<br>1 - Esdeveniments.| |max\_records|enter|Nombre màxim d'esdeveniments o elements que es poden enviar dins d'un missatge.<br><br>Valors possibles: 0-2147483647 (valor màxim d'enter signat de 32 bits).<br><br> Per defecte: 0 - Il·limitat.| |max\_senders|enter|Nombre de processos del remitent que s'han d'executar per a aquest connector.<br><br>Valors possibles: 1-100.<br><br>Per defecte: 1.| |max\_attempts|enter|Nombre d'intents.<br><br>Valors possibles: 1-5.<br><br>Per defecte: 1.| |timeout|cadena|Temps d'espera.<br>S'admeten sufixos de temps (p. ex., 30s, 1m).<br>S'admeten macros d'usuari.<br><br>Valors possibles: 1s-60s.<br><br>Per defecte. : 5s.| |http\_proxy|cadena|Cadena de connexió de proxy HTTP(S) donada com a <br>*\[protocol\]://\[nom d'usuari\[:mot de pas\]@\]proxy.exemple.com\[:port\]*.<br><br>S'admeten macros d'usuari.| |authtype|enter|Mètode d'autenticació HTTP.<br><br>Valors possibles:<br>0 - *(per defecte)* Cap;<br>1 - Bàsic;<br>2 - NTLM;<br>3 - Kerberos ;<br>4 - Digest;<br>5 - Bearer.| |username|cadena|Nom d'usuari.<br>S'admeten macros d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `authtype` s'estableix a "Basic", "NTLM", "Kerberos" o "Digest"| |password|cadena|Mot de pas.<br>S'admeten macros d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *suportat* si `authtype` s'estableix a "Basic", "NTLM", "Kerberos" o "Digest"| |token|cadena|Token de portador.<br>S'admeten macros d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `authtype` és establert a "Bearer"| |verify\_peer|enter|Valida que el certificat de l'equip sigui autèntic.<br><br>Valors possibles:<br>0 - No validar;<br>1 - *(per defecte)* Validar.| |verify\_host|enter|Valida que el nom de l'equip de la connexió coincideixi amb el del certificat de l'equip.<br><br>Valors possibles:<br>0 - No validar;<br>1 - *(per defecte)* Validar.| |ssl\_cert\_file|cadena|Camí del fitxer de la clau SSL pública.<br>S'admeten macros d'usuari.| |ssl\_key\_file|cadena|Camí del fitxer de la clau SSL privada.<br>S'admeten macros d'usuari.| |ssl\_key\_password|cadena|Mot de pas del fitxer de clau SSL.<br>S'admeten macros d'usuari.| |description|text|Descripció del connector.| |status|enter|Si el connector és habilitat.<br><br>Valors possibles:<br>0 - Inhabilitat;<br>1 - *(per defecte)* Habilitat.| |tags\_evaltype|enter|Mètode d'avaluació de l'etiqueta.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.|

en-us	# Connector  This class is designed to work with connectors.  Object references:  - [Connector](/manual/api/reference/connector/object#connector) - [Tag filter](/manual/api/reference/connector/object#tag-filter)  Available methods:  - [connector.create](/manual/api/reference/connector/create) - create new connectors - [connector.delete](/manual/api/reference/connector/delete) - delete connectors - [connector.get](/manual/api/reference/connector/get) - retrieve connectors - [connector.update](/manual/api/reference/connector/update) - update connectors
ca	# Connector  Aquesta classe és dissenyada per treballar amb connectors.  Referències d'objecte:  - [Connector](/manual/api/reference/connector/object#connector) - [Filtre d'etiqueta](/manual/api/reference/connector/object#tag-filter)  Mètodes disponibles:  - [connector.create](/manual/api/reference/connector/create) - crear connectors - [connector.delete](/manual/api/reference/connector/delete) - esborrar connectors - [connector.get](/manual/api/reference/connector/get) - recuperar connectors - [connector.update](/manual/api/reference/connector/update) - actualitzar connectors

en-us	# connector.update
ca	# actualització del connector

en-us	#### connector  [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Added new property `item_value_type`, which is supported if `data_type` is set to "Item values" (0).\ [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Added new property `attempt_interval`, which is supported if `max_attempts` is greater than 1.\
ca	#### connector  [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Afegida la nova propietat `item_value_type`, admesa si `data_type` s'estableix a "Item values" (0).\ [ZBXNEXT-8735](https://support.zabbix.com/browse/ZBXNEXT-8735) Afegida la nova propietat `attempt_interval`, admesa si `max_attempts` és més gran d'1.\

en-us	 #### Consistent default history storage period  The default period for keeping item history has been made consistent at 31 days in the frontend and in the database. This change affects item, template item and item prototype configuration forms as well as the history storage period override in low-level discovery. 
ca	 #### Període coherent d'emmagatzematge de l'historial predeterminat  El període predeterminat per mantenir l'historial d'elements s'ha fet coherent en 31 dies a la interfície i a la base de dades. Aquest canvi afecta els formularis de configuració de l'element, l'element de plantilla i el prototip d'element, així com la substitució del període d'emmagatzematge de l'historial a la descoberta de baix nivell. 

en-us	 #### Content  The event context menu has six sections: *View*, *Actions*, *Configuration*, *Problem*, *Links*, and *Scripts*. For the entities that are not configured, links are disabled and displayed in gray. The sections *Scripts* and *Links* are displayed if their entities are configured.  The *View* section contains links to:  -  **Problems** - opens the list of unresolved problems of the underlying trigger; -  **History** - leads to the *Latest data* graph/item history for the underlying item(s).    If a trigger uses several items, links will be available for each of them.  The *Actions* section is available in *Trigger overview* widgets only.  It contains a link to:  -  **Update problem** - opens the [problem update](manual/acknowledgment#updating-problems) screen.  The *Configuration* section contains links to the configuration of:  -  **Trigger** that fired the problem; -  **Items** used in the trigger expression.  ::: notetip Note that configuration section is available only for Admin and Super admin users. :::  The *Problem* section contains the options to:  -  **Mark as cause** - mark the problem as cause; -  **Mark selected as symptoms** - mark the selected problems as symptoms of this problem.  The *Links* section contains links to:  -  access a configured [trigger URL](/manual/config/triggers/trigger#configuration); -  access custom links configured in [Global scripts](/manual/web_interface/frontend_sections/alerts/scripts)   (with scope 'Manual event action' and type 'URL'); - access a configured external ticket for the problem (see the *Include event menu entry* option when configuring [webhooks](/manual/config/notifications/media/webhook)).  The *Scripts* section contains links to execute a global [script](/manual/web_interface/frontend_sections/alerts/scripts) (with scope *Manual event action*). This feature may be handy for running scripts used for managing problem tickets in external systems.
ca	 ## Contingut  El menú contextual de l'esdeveniment té quatre seccions: *Visualització*, *Configuració*, *Problema*, *Enllaços* i *Scripts*. Per a les entitats que no són configurades, els enllaços són desactivats i es mostren en gris. Les seccions *Scripts* i *Enllaços* es mostren si les seves entitats són configurades.  La secció *Visualitza* conté enllaços a:  - **Problemes** - obre la llista de problemes no resolts del trigger subjacent; - **Problema d'actualització** - obre la pantalla [Actualització del problema](manual/aconsellament#problemes d'actualització); - **Historial** - porta al gràfic/historial d'elements *Dades més recents* per als elements subjacents.     Si un trigger empra diversos elements, hi haurà enllaços disponibles per a cadascun d'ells.  La secció *Configuració* conté enllaços a la configuració de:  - **Trigger** que va disparar el problema; - **Elements** emprats a l'expressió trigger.  ::: notetip Tingueu en compte que la secció de configuració només és disponible per a usuaris administradors i superadministradors. :::  La secció *Problema* conté les opcions per:  - **Marcar com a causa** - marca el problema com a causa; - **Marcar seleccionat com a símptomes** - marca els problemes seleccionats com a símptomes d'aquest problema.  La secció *Enllaços* conté enllaços a:  - accedir a un [trigger URL] configurat (/manual/config/triggers/trigger#configuration); - accedir als enllaços personalitzats configurats a [Guions globals](/manual/web_interface/frontend_sections/alerts/scripts) (amb l'abast "Acció manual d'esdeveniment" i escriviu "URL"); - accediu a un bitllet extern configurat per al problema (veieu l'opció *Inclou l'entrada del menú d'esdeveniments* quan configureu [webhooks](/manual/config/notifications/media/webhook)).  La secció *Scripts* conté enllaços per executar un [script](/manual/web_interface/frontend_sections/alerts/scripts) global. (amb abast *Acció d'esdeveniment manual*). Aquesta característica pot ser útil per executar scripts emprats per gestionar els tiquets de problemes en sistemes externs.

en-us	 #### Content  The host context menu has four sections: *View*, *Configuration*, *Links*, and *Scripts*. For the entities that are not configured, links are disabled and displayed in gray color. The sections *Scripts* and *Links* are displayed if their entities are configured.  *View* section contains links to:  -  **Dashboards** - opens widgets and graphs. -  **Problems** - opens the *Problems* section with the list of unresolved problems of the underlying trigger. -  **Latest data** - opens the *Latest data* section with the list of all the latest data of the current host. -  **Graphs** - opens simple graphs of the current host. -  **Web**- opens the link to the configured web scenarios. -  **Inventory** - opens the link to the inventory of the current host.  *Configuration* section contains links to:  -  **Host** - configuration form of the current host. -  **Items** - the list of the current host items. -  **Triggers** - the list of the current host triggers. -  **Graphs** - simple graphs of the current host. -  **Discovery** - the list of low-level discovery rules of the current host. -  **Web** - the list of web scenarios of the current host.  ::: notetip Note that configuration section is available only for Admin and Super admin users. :::  *Links* section contains links to:  -  access a configured [trigger URL](/manual/config/triggers/trigger#configuration). -  access custom links configured in [Global scripts](/manual/web_interface/frontend_sections/alerts/scripts)   (with scope *Manual host action* and type 'URL').  *Scripts* section allows to execute [global scripts](/manual/web_interface/frontend_sections/alerts/scripts) configured for the current host. These scripts need to have their scope defined as *Manual host action* to be available in the host menu.
ca	 ## Contingut  El menú contextual de l'equip té quatre seccions: *Visualització*, *Configuració*, *Enllaços* i *Scripts*. Per a les entitats que no són configurades, els enllaços són desactivats i es mostren en color gris. Les seccions *Scripts* i *Enllaços* es mostren si les seves entitats són configurades.  La secció *Veure* conté enllaços a:  - **Taulers** - obre ginys i gràfics. - **Problemes** - obre la secció *Problemes* amb la llista de problemes no resolts del trigger subjacent. - **Darreres dades** - obre la secció *Darreres dades* amb la llista de totes les dades més recents de l'equip actual. - **Gràfics** - obre gràfics senzills de l'equip actual. - **Web**- obre l'enllaç als escenaris web configurats. - **Inventari** - obre l'enllaç a l'inventari de l'equip actual.  La secció *Configuració* conté enllaços a:  - **Equips** - forma de configuració de l'equip actual. - **Elements** - llista dels elements de l'equip actuals. - **Triggers** - llista dels triggers de l'equip actuals. - **Gràfics** - gràfics simples de l'equip actual. - **Descoberta** - llista de regles de descoberta de baix nivell de l'equip actual. - **Web** - llista d'escenaris web de l'equip actual.  ::: notetip Tingueu en compte que la secció de configuració només és disponible per a usuaris administradors i superadministradors. :::  La secció *Enllaços* conté enllaços a:  - accedir a un [trigger URL] configurat (/manual/config/triggers/trigger#configuration). - accedir als enllaços personalitzats configurats a [Guions globals](/manual/web_interface/frontend_sections/alerts/scripts) (amb l'abast *Acció manual de l'equip* i escriviu "URL").  La secció *Scripts* permet executar [scripts globals](/manual/web_interface/frontend_sections/alerts/scripts) configurats per a l'equip actual. Aquests scripts han de tenir el seu abast definit com a *Acció manual de l'equip* perquè siguin disponibles al menú de l'equip.

en-us	 #### Content  The item context menu has three sections: *View*, *Configuration*, and *Actions*.  *View* section contains links to:  -  **Latest data** - opens the *Latest data* section filtered by the current host and item. -  **Graph** - opens simple graph of the current item. -  **Values** - opens the list of all values received for the current item within the past 60 minutes. -  **500 latest values** - opens the list of 500 latest values for the current item.  *Configuration* section contains links to:  -  **Item** - opens the configuration form of the current item. -  **Triggers** - displays a list of existing triggers based on the current item;    clicking on a trigger name opens the trigger's configuration form. -  **Create trigger** - opens a trigger configuration form to create a new trigger based on the current item. -  **Create dependent item** - opens an item configuration form to create a dependent item for the current item. -  **Create dependent discovery rule** - opens a discovery rule configuration form    to create a low-level discovery rule for the current item.  Links to *Create dependent item* and *Create dependent discovery rule* are enabled only when the item context menu is accessed from *Data collection* section.  ::: notetip Note that configuration section is available only for Admin and Super admin users. :::  *Actions* section contains a link to **Execute now** - the option to [execute a check](/manual/config/items/check_now) for a new item value immediately.
ca	 ### Contingut  El menú contextual de l'element té tres seccions: *Visualització*, *Configuració* i *Accions*.  La secció *Visualització* conté enllaços a:  - **Darreres dades** - obre la secció *Darreres dades* filtrada per l'equip i l'element actuals. - **Gràfic** - obre un gràfic senzill de l'element actual. - **Valors** - obre la llista de tots els valors rebuts per a l'element actual durant els darrers 60 minuts. - **500 valors més recents** - obre la llista dels 500 valors més recents per a l'element actual.  La secció *Configuració* conté enllaços a:  - **Element** - obre el formulari de configuració de l'element actual. - **Triggers** - mostra una llista dels triggers existents en funció de l'element actual; fent clic al nom d'un trigger s'obre el formulari de configuració del trigger. - **Crear trigger** - obre un formulari de configuració del trigger per crear un trigger nou basat en l'element actual. - **Crear un element dependent** - obre un formulari de configuració de l'element per crear un element dependent per a l'element actual. - **Crear una regla de descoberta dependent** - obre un formulari de configuració de regla de descoberta per crear una regla de descoberta de baix nivell per a l'element actual.  Els enllaços a *Crear un element dependent* i *Crear una regla de descoberta dependent* només s'activen quan s'accedeix al menú contextual de l'element des de la secció *Recollida de dades*.  ::: notetip Tingueu en compte que la secció de configuració només és disponible per a usuaris administradors i superadministradors. :::  La secció *Accions* conté un enllaç a **Execute now** - l'opció per [executar una comprovació](/manual/config/items/check_now) per a un valor d'element nou immediatament.

en-us	#### Context menus  In addition to the main menu, Zabbix provides context menus for [host](/manual/web_interface/menu/host_menu), [item](/manual/web_interface/menu/item_menu), and  [event](/manual/web_interface/menu/event_menu) for quick access to frequently used entities, such as the latest values, simple graph, configuration form, related scripts or external links.  The context menus are accessible by clicking on the host, item or problem/trigger name in supported locations.
ca	### Menús contextuals  A més del menú principal, Zabbix ofereix [menú contextual de l'equip](/manual/web_interface/menu/host_menu), [menú contextual de l'element](/manual/web_interface/menu/item_menu) i [menú contextual de l'esdeveniment](/manual /web_interface/menu/event_menu) per accedir i configurar ràpidament les entitats d'ús freqüent, com ara els darrers  valors, gràfics senzills, formulari de configuració, scripts relacionats o enllaços externs.  Els menús contextuals són accessibles fent clic a l'equip, l'element o el nom del problema/trigger a les ubicacions admeses (seguiu els enllaços indicats més amunt).

en-us	### Controller  Action controller workflow:  1) Check that all parameters passed in an HTTP request are valid: - Call the controller's *checkInput()* method - Use validation rules defined in CNewValidator.php - Call *validateInput()* method  2) Check user permissions.  3) Prepare the data according to passed parameters: if *checkInput()* returns true, Zabbix calls the controller's *doAction()* method.  4) Prepare the **$data** array for the view. Use *CControllerResponseData* and *setResponse()* method to store response in the **$data** array.  Example:  ````php /**  * Validate input parameters.  *  * @return bool  */ protected function checkInput(): bool {     $ret = $this->validateInput([         'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED])     ]);      if (!$ret) {         $this->setResponse(new CControllerResponseFatal());     }      return $ret; }  /**  * Check user permissions.  *  * @return bool  */ protected function checkPermissions() {     return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; }  /**  * Execute action and generate response object.  */ protected function do Action(): void {     $data = [          'hosts_count' => API::Host()->get([             'countOutput' => true,             'filter' => [                 'status' => $this->getInput('status')             ]         ])      ];          $this->setResponse(new CControllerResponseData($data)); } ````  ::: notetip You can view the full list of available controller classes in Zabbix [source code](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers). :::
ca	### Control·lador  Flux de treball del controlador d'acció:  1) Comproveu que tots els paràmetres passats en una petició HTTP siguin vàlids: - Crideu al mètode *checkInput()* del controlador - Empreu les regles de validació definides a CNewValidator.php - Crideu al mètode *validateInput()*  2) Comproveu els permisos dels usuaris.  3) Prepareu les dades segons els paràmetres passats: si *checkInput()* retorna cert, Zabbix crida al mètode *doAction()* del controlador.  4) Prepareu la matriu **$data** per a la vista. Empreu el mètode *CControllerResponseData* i *setResponse()* per emmagatzemar la resposta a la matriu **$data**.  Exemple:  ````php /**  * Validació dels paràmetres d'entrada.  *  * @return bool  */ protected function checkInput(): bool {     $ret = $this->validateInput([         'status' => 'in '.implode(',', [HOST_STATUS_MONITORED, HOST_STATUS_NOT_MONITORED])     ]);      if (!$ret) {         $this->setResponse(new CControllerResponseFatal());     }      return $ret; }  /**  * Comproveu els permisos dels usuaris.  *  * @return bool  */ protected function checkPermissions() {     return $this->getUserType() >= USER_TYPE_ZABBIX_ADMIN; }  /**  * Executar acció i generar objecte de resposta.  */ protected function do Action(): void {     $data = [          'hosts_count' => API::Host()->get([             'countOutput' => true,             'filter' => [                 'status' => $this->getInput('status')             ]         ])      ];          $this->setResponse(new CControllerResponseData($data)); } ````  ::: notetip Podeu veure la llista completa de les classes de controlador disponibles al [codi font](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/ui/app/controllers) de Zabbix. :::

en-us	##### ControlSocket  The control socket, used to send runtime commands with the '-R' option.  Default: `\\.\pipe\agent.sock`
ca	##### ControlSocket  El sòcol de control, emprat per enviar ordres d'execució amb l'opció '-R'.  Per defecte: `\\.\pipe\agent.sock`

en-us	##### ControlSocket  The control socket, used to send runtime commands with the '-R' option.  Default: `/tmp/agent.sock`
ca	##### ControlSocket  El sòcol de control, emprat per enviar ordres d'execució amb l'opció '-R'.  Per defecte: `/tmp/agent.sock`

en-us	#### Cookie  The `Cookie` object is returned by the [`Browser`](#browser) object `getCookies()` method and passed to the `addCookie()` method.  While the `Cookie` object does not have any methods, it can contain the following properties:  |Property|Type|Description| |--|--|------| |name|string|Name of the cookie.| |value|string|Value of the cookie.| |path|string|Path for which the cookie is valid.<br>Defaults to `"/"` if omitted when adding a cookie.| |domain|string|Domain to which the cookie is visible.<br>Defaults to the URL domain of the session's current browsing context's active document if omitted when adding a cookie.| |secure|boolean|Indicates whether the cookie is secure.<br>Defaults to `false` if omitted when adding a cookie.| |httpOnly|boolean|Indicates whether the cookie is HTTP-only.<br>Defaults to `false` if omitted when adding a cookie.| |expiry|integer|Expiration time of the cookie (in seconds since the Unix Epoch). Must not be set if omitted when adding a cookie.| |sameSite|string|The `sameSite` attribute of the cookie, which controls whether the cookie should be restricted to a first-party or same-site context.<br>Can be set to either `"Lax"` or `"Strict"`.<br>Defaults to `"None"` if omitted when adding a cookie.|
ca	#### Galeta  L'objecte `Cookie` és retornat pel mètode [`Navegador`](#browser) `getCookies()` i passa al mètode `addCookie()`.  Tot i que l'objecte `Cookie` no té cap mètode, pot contenir les propietats següents:  |Propietat|Tipus|Descripció| |--|--|------| |nom|string|Nom de la galeta.| |valor|string|Valor de la galeta.| |camí|string|Camí per al qual la galeta és vàlida.<br>El valor per defecte és `"/"` si s'omet en afegir una galeta.| |domini|string|Domini al qual és visible la galeta.<br>Per defecte és el domini de l'URL del document actiu del context de navegació actual de la sessió si s'omet en afegir una galeta.| |secure|boolean|Indica si la galeta és segura.<br>El valor per defecte és `false` si s'omet en afegir una galeta.| |httpOnly|boolean|Indica si la galeta només és HTTP.<br>El valor per defecte és `false` si s'omet en afegir una galeta.| |expiry|integer|Temps d'expiració de la galeta (en segons des de l'època Unix). No s'ha d'establir si s'omet en afegir una galeta.| |sameSite|string|L'atribut `sameSite` de la galeta, que controla si la galeta s'ha de restringir a un context propi o del mateix lloc.<br>Es pot establir com a `"Lax"` o `"Estricte "`.<br>El valor predeterminat és `"Cap"` si s'omet en afegir una galeta.|

en-us	#### Copy an LLD rule to multiple hosts  Copy an LLD rule to two hosts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.copy",     "params": {         "discoveryids": [             "27426"         ],         "hostids": [             "10196",             "10197"         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```
ca	#### copiar una regla LLD a diversos equips  Copia una regla LLD a dos equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.copy",     "params": {         "discoveryids": [             "27426"         ],         "hostids": [             "10196",             "10197"         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```

en-us	#### Copying/pasting pages  Dashboard pages can be copied and pasted, allowing to create a new page with the properties of an existing one. They can be pasted from the same dashboard or a different dashboard.  To paste an existing page to the dashboard, first copy it, using the [page menu](#page_menu):  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_copy.png)  To paste the copied page:  -   Make sure the dashboard is in the [editing     mode](#viewing_and_editing_a_dashboard) -   Click on the arrow next to the *Add* button and select the *Paste     page* option
ca	#### Copiar/enganxar pàgines  Les pàgines del tauler es poden copiar i enganxar, la qual cosa permet crear una pàgina nova amb les propietats d'una pàgina existent. Es poden enganxar des del mateix tauler o des d'un tauler diferent.  Per enganxar una pàgina existent al tauler, primer copieu-la mitjançant el [menú de la pàgina](#page_menu):  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_page_copy.png)  Per enganxar la pàgina copiada:  - Assegureu-vos que el tauler és en [mode d'edició](#viewing_and_editing_a_dashboard) - Feu clic a la fletxa al costat del botó *Afegir* i trieu l'opció *Enganxar pàgina*

en-us	#### Copying/pasting widgets  Dashboard widgets can be copied and pasted, allowing to create a new widget with the properties of an existing one. They can be copy-pasted within the same dashboard, or between dashboards opened in different tabs.  A widget can be copied using the [widget menu](#widget_menu). To paste the widget:  -   click on the arrow next to the *Add* button and selecting the *Paste     widget* option, when editing the dashboard -   use the *Paste widget* option when adding a new widget by selecting     some area in the dashboard (a widget must be copied first for the     paste option to become available)  A copied widget can be used to paste over an existing widget using the *Paste* option in the [widget menu](#widget_menu).
ca	#### Copiar/enganxar ginys widgets  Els ginys del tauler de control es poden copiar i enganxar, la qual cosa permet crear un giny nou amb les propietats d'un giny existent. Es poden copiar i enganxar dins del mateix tauler o entre taulers oberts en diferents pestanyes.  Es pot copiar un giny emprant el [menú del giny](#widget_menu). Per enganxar el giny:  - feu clic a la fletxa que hi ha al costat del botó *Afegir* i trieu l'opció *Enganxar widget* quan editeu el tauler. - Empreu l'opció *Enganxar giny* quan afegiu un giny nou triat una àrea al tauler (primer s'ha de copiar un giny perquè l'opció d'enganxar sigui disponible)  Un giny copiat es pot enganxar sobre un giny existent amb l'opció *Enganxar* al [menú del giny](#widget_menu).

en-us	##### Copying PHP files  Zabbix frontend is written in PHP, so to run it a PHP supported webserver is needed. Installation is done by simply copying the PHP files from the ui directory to the webserver HTML documents directory.  Common locations of HTML documents directories for Apache web servers include:  -   /usr/local/apache2/htdocs (default directory when installing Apache     from source) -   /srv/www/htdocs (OpenSUSE, SLES) -   /var/www/html (Debian, Ubuntu, Fedora, RHEL)  It is suggested to use a subdirectory instead of the HTML root. To create a subdirectory and copy Zabbix frontend files into it, execute the following commands, replacing the actual directory:      mkdir <htdocs>/zabbix     cd ui     cp -a . <htdocs>/zabbix  If planning to use any other language than English, see [Installation of additional frontend languages](/manual/appendix/install/locales) for instructions.
ca	##### Copiar els arxius PHP  La interfície de Zabbix és escrit en PHP, de manera que per executar-lo cal un servidor web que admeti PHP. La instal·lació es fa senzillament copiant els fitxers PHP de frontends/php al directori HTML del servidor web.  Les ubicacions habituals dels directoris HTML per als servidors web Apache inclouen:  - /usr/local/apache2/htdocs (directori per defecte quan s'instal·la Apache des de la font) - /srv/www/htdocs (OpenSUSE, SLES) - /var/www/html (Debian, Ubuntu, Fedora, RHEL)  Es recomana emprar el subdirectori en lloc de l'arrel HTML. Per crear un subdirectori i copiar-hi fitxers de l'interfície Zabbix, executeu les ordres següents substituint el directori actual:       mkdir <htdocs>/zabbix      cd ui      cp -a. <htdocs>/zabbix  Si teniu previst fer servir un idioma diferent de l'anglès, consulteu la [instal·lació d'idiomes d'interfície addicionals](/manual/appendix/install/locales) per obtindre instruccions.

en-us	 ### Copyright notice  Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use  of Zabbix documentation is subject to the following terms:   You may create a printed copy of this documentation solely for your  own personal use. Conversion to other formats is allowed as long as  the actual content is not altered or edited in any way. You shall  not publish or distribute this documentation in any form or on any  media, except if you distribute the documentation in a manner similar  to how Zabbix disseminates it (that is, electronically for download  on a Zabbix web site) or on a USB or similar medium, provided however  that the documentation is disseminated together with the software on  the same medium. Any other use, such as any dissemination of printed  copies or use of this documentation, in whole or in part, in another  publication, requires the prior written consent from an authorized  representative of Zabbix. Zabbix reserves any and all rights to this  documentation not expressly granted above.
ca	### Avís de drets d'autor  La documentació de Zabbix NO es distribueix sota una llicència GPL. L'ús de la documentació de Zabbix és subjecta als termes següents:  Podeu crear una còpia impresa d'aquesta documentació únicament per al vostre ús personal. Es permet la conversió a altres formats sempre que el contingut real no s'alteri ni s'editi de cap manera. No publicareu ni distribuireu aquesta documentació de cap forma ni en cap suport, excepte si distribuïu la documentació d'una manera similar a com la difon Zabbix (és a dir, electrònicament per descarregar-la des d'un lloc web de Zabbix) o en un USB o suport similar, sempre que la documentació es difongui juntament amb el programari en el mateix suport. Qualsevol altre ús, com ara qualsevol difusió de còpies impreses o ús d'aquesta documentació, total o parcialment, en una altra publicació, requereix el consentiment previ per escrit d'un representant autoritzat de Zabbix. Zabbix es reserva tots els drets sobre aquesta documentació no concedits expressament anteriorment.

en-us	 ### Copyright notice  Zabbix documentation is NOT distributed under the AGPL-3.0 license. Use  of Zabbix documentation is subject to the following terms:   You may create a printed copy of this documentation solely for your  own personal use. Conversion to other formats is allowed as long as  the actual content is not altered or edited in any way. You shall  not publish or distribute this documentation in any form or on any  media, except if you distribute the documentation in a manner similar  to how Zabbix disseminates it (that is, electronically for download  on a Zabbix web site) or on a USB or similar medium, provided however  that the documentation is disseminated together with the software on  the same medium. Any other use, such as any dissemination of printed  copies or use of this documentation, in whole or in part, in another  publication, requires the prior written consent from an authorized  representative of Zabbix. Zabbix reserves any and all rights to this  documentation not expressly granted above.
ca	 ### Avís de drets d'autor  La documentació de Zabbix NO es distribueix sota una llicència AGPL-3.0. L'ús de la documentació de Zabbix és subjecte als termes següents:  Podeu crear una còpia impresa d'aquesta documentació únicament per al vostre ús personal. La conversió a altres formats és permesa sempre que el contingut real no s'alteri o editi de cap manera. No publicareu ni distribuireu aquesta documentació de cap forma ni en cap suport, excepte si distribueixes la documentació d'una manera similar a com la difon Zabbix (és a dir, electrònicament per descarregar-la en un lloc web de Zabbix) o en un USB o similar, sempre que la documentació es difongui juntament amb el programari en el mateix suport. Qualsevol altre ús, com ara qualsevol difusió de còpies impreses o ús d'aquesta documentació, total o parcialment, en una altra publicació, requereix el consentiment previ per escrit d'un representant autoritzat de Zabbix. Zabbix es reserva tots els drets sobre aquesta documentació no concedits expressament anteriorment.

en-us	# correlation.create
ca	# Creació de correlació

en-us	# correlation.delete
ca	# correlation.delete

en-us	#### Correlation filter condition  The correlation filter condition object defines a specific condition that must be checked before running the correlation operations.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |type|integer|Type of condition.<br><br>Possible values:<br>0 - old event tag;<br>1 - new event tag;<br>2 - new event host group;<br>3 - event tag pair;<br>4 - old event tag value;<br>5 - new event tag value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |tag|string|Event tag (old or new).<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "old event tag", "new event tag", "old event tag value", or "new event tag value"| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "new event host group"| |oldtag|string|Old event tag.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "event tag pair"| |newtag|string|Old event tag.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "event tag pair"| |value|string|Event tag (old or new) value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "old event tag value" or "new event tag value"| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "new event host group", "old event tag value", or "new event tag value"|  ::: notetip To better understand how to use filters with various types of expressions, see examples on the [correlation.get](get#retrieve_correlations) and [correlation.create](create#using_a_custom_expression_filter) method pages. :::  The following operators and values are supported for each condition type.  |Condition|Condition name|Supported operators|Expected value| |---------|--------------|-------------------|--------------| |2|Host group|=, <>|Host group ID.| |4|Old event tag value|=, <>, like, not like|string| |5|New event tag value|=, <>, like, not like|string|
ca	#### Condició del filtre de correlació  L'objecte de condició de filtre de correlació defineix una condició específica que s'ha de verificar abans d'executar les operacions de correlació.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |type|integer|Tipus de condició.<br><br>Valors possibles:<br>0 - tag d'esdeveniment antic;<br>1 - tag d'esdeveniment nou;<br>2 - nou esdeveniment de grup d'equips;<br>3 - parell de tag d'esdeveniment;<br>4 - valor antic de tag d'esdeveniment;<br>5 - valor nou de tag d'esdeveniment.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |tag|string|Etiqueta d'esdeveniment (antic o nou).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` s'ha establert a "etiqueta d'esdeveniment antic", "etiqueta d'esdeveninemt nou", "valor d'etiqueta d'esdeveniment antic" o "valor d'etiqueta d'esdeveniment nou"| |groupid|string|ID del grup d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*  si `type` s'ha establert a "parella d'etiquetes d'esdeveniment"| |oldtag|string|Tag d'esdeveniment antic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*  si `type` s'ha establert a "parella d'etiquetes d'esdeveniment"| |newtag|string|Tag d'esdeveniment nou.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*  si `type` s'ha establert a "parella d'etiquetes d'esdeveniment"| |value|string|Valor de tag d'esdeveniment (antic o nou).<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*  si `type` s'ha establert a "valor d'etiqueta d'esdeveniment antic" o "valor d'etiqueta d'esdeveniment nou"| |formulaid|string|ID únic arbitrari emprat per referenciar la condició a partir d'una expressió personalitzada. No pot pas contindre lletres majúscules. L'ID ha d'ésser definit per l'usuari quan es modifiquin les condicions de filtrat, però haurà de generar-se de nou quan hi hagi una petició posterior.| |operator|integer|Operador de condició.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*  si `type` s'ha establert a "nou esdeveniment de grup d'equips", "valor d'etiqueta d'esdeveniment antic" o "valor d'etiqueta d'esdeveniment nou"|  ::: notetip Per entendre millor com fer anar els filtres amb diferents tipus d'expressions, veieu els exemples a les pàgines dels mètodes [correlation.get](get#retrieve_correlations) i [correlation.create](create#using_a_custom_expression_filter). :::  Les operacions i valors següents són suportats per cada tipus de condició.  |Condició|Nom de condició|Operadors suportats|Valor esperat| |---------|--------------|-------------------|--------------| |2|Grup d'equips|=, <>|ID del grup d'equips.| |4|Valor de tag d'esdeveniment antic|=, <>, like, not like|string| |5|Valor de tag d'esdeveniment nou|=, <>, like, not like|string|

en-us	### Correlation filter  The correlation filter object defines a set of conditions that must be met to perform the configured correlation operations. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |conditions|array|Set of [filter conditions](#correlation-filter-condition) to use for filtering results. The conditions will be sorted in the order of their placement in the formula.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |evaltype|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |eval\_formula|string|Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `evaltype` is set to "custom expression"|
ca	### Filtre de correlació  L'objecte de filtre de correlació defineix el conjunt de condicions que s'han de complir per dur a terme les operacions de correlacions configurades. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |conditions|taula|Conjunt de condicions de filtre a emprar per filtrar els resultats.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |evaltype|enter|Mètode d'avaluació de la condició del filtre.<br><br>Valors acceptats:<br>0 - i/o;<br>1 - i;<br>2 - o;<br>3 - expressió a mida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |eval\_formula|cadena|*(només lectura)* Expressió generada que s'emprarà per avaluar les condicions de filtrat. L'expressió conté els ID que referencien les condicions de filtrat específiques per la seva `formulaid`. El valor d'`eval_formula` equival al valor de `formula` per als filtres amb expressions a mida.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |formula|cadena|Expressió definida per l'usuari a emprar per avaluar les condicions dels filtres amb una expressió personalitzada. L'expressió ha de contindre els IDs que referencien les condicions de filtrat específiques per a la seva `formulaid`. Els IDs emprats a l'expressió han de correspondre als definits per les condicions de filtrat: cap condició no pot pas restar sense ús o omesa.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `evaltype` s'ha establert a "expressió personalitzada"|

en-us	# correlation.get
ca	# correlation.get

en-us	# Correlation object  The following objects are directly related to the `correlation` API.
ca	# Objecte de correlació  Els següents objectes són relacionats amb l'API `correlation`.

en-us	### Correlation operation  The correlation operation object defines an operation that will be performed when a correlation is executed. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |type|integer|Type of operation.<br><br>Possible values:<br>0 - close old events;<br>1 - close new event.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Operació de correlació  L'objecte d'operació de correlació defineix una operació que es durà a terme quan la correlació s'executi. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |type|enter|Tipus d'operació.<br><br>Valors possibles:<br>0 - tancar esdeveniments antics;<br>1 - tancar un nou esdeveniment.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Correlation  The correlation object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |correlationid|ID|ID of the correlation.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the correlation.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |description|string|Description of the correlation.| |status|integer|Whether the correlation is enabled or disabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.|
ca	### Correlació  L'objecte de correlació té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |correlationid|ID|*(només lectura)* ID de la correlació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per opcions d'actualització| |**name**<br>(obligatori)|cadena|Nom de la correlació.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per opcions de creació| |description|cadena|Descripció de la correlació.| |status|cadena|Diu si la correlació és activa o desactivada.<br><br>Els valors possibles són:<br>0 - *(per defecte)* actiu;<br>1 - desactivat.|

en-us	# Correlation  This class is designed to work with correlations.  Object references:\  -   [Correlation](/manual/api/reference/correlation/object#correlation) -   [Correlation operation](/manual/api/reference/correlation/object#correlation_operation) -   [Correlation filter](/manual/api/reference/correlation/object#correlation_filter) -   [Correlation filter condition](/manual/api/reference/correlation/object#correlation_filter_condition)  Available methods:\  -   [correlation.create](/manual/api/reference/correlation/create) - create new correlations -   [correlation.delete](/manual/api/reference/correlation/delete) - delete correlations -   [correlation.get](/manual/api/reference/correlation/get) - retrieve correlations -   [correlation.update](/manual/api/reference/correlation/update) - update correlations
ca	# Correlació  Aquesta classe és dissenyada per treballar amb correlacions.  Referències d'objectes:\  -   [Correlació](/manual/api/reference/correlation/object#correlation) -   [Operació de correlació](/manual/api/reference/correlation/object#correlation_operation) -   [Filtre de correlació](/manual/api/reference/correlation/object#correlation_filter) -   [Condició de filtre de correlació](/manual/api/reference/correlation/object#correlation_filter_condition)  Mètodes disponibles:\  -   [correlation.create](/manual/api/reference/correlation/create) - crear noves correlacions -   [correlation.delete](/manual/api/reference/correlation/delete) - esborrar correlacions -   [correlation.get](/manual/api/reference/correlation/get) - recuperar correlacions -   [correlation.update](/manual/api/reference/correlation/update) - actualitzar correlacions

en-us	# correlation.update
ca	# correlation.update

en-us	#### correlation  [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `correlation.get`: Filter conditions will be sorted in the order of their placement in the formula.\
ca	#### correlació  [ZBX-21850](https://support.zabbix.com/browse/ZBX-21850) `correlation.get`: Les condicions de filtre s'ordenaran en l'ordre que s'hagin posat a la fòrmula.\

en-us	 ##### cosh(value) {#cosh}  The hyperbolic cosine of a value. Returns the value as a real number, not as scientific notation.  Parameter:   -   **value** - the value to check  For example, the hyperbolic cosine of a value '1' will be '1.54308063482'.  Example:      cosh(last(/host/key))
ca	 ##### cosh(value) {#cosh}  Cosinus hiperbòlic d'un valor. Retorna el valor com a nombre real, no com a notació científica.  Paràmetre:  - **valor** - valor que cal comprovar  Per exemple, el cosinus hiperbòlic d'un valor '1' serà '1,54308063482'.  Exemple:      cosh(last(/host/key))

en-us	 ##### cos(value) {#cos}  The cosine of a value, where the value is an angle expressed in radians.  Parameter:   -   **value** - the value to check  For example, the cosine of a value '1' will be '0.54030230586'.  Example:      cos(last(/host/key))
ca	 ##### cos(value) {#cos}  Cosinus d'un valor, on el valor és un angle expressat en radians.  Paràmetre:  - **valor** - valor que cal comprovar  Per exemple, el cosinus d'un valor '1' serà '0,54030230586'.  Exemple:      cos(last(/host/key))

en-us	 ##### cot(value) {#cot}  The cotangent of a value, where the value is an angle expressed in radians.  Parameter:   -   **value** - the value to check  For example, the cotangent of a value '1' will be '0.54030230586'.  Example:      cot(last(/host/key))
ca	 ##### cot(value) {#cot}  Cotangent d'un valor, on el valor és un angle expressat en radians.  Paràmetre:  - **valor** - valor que cal comprovar  Per exemple, la cotangent d'un valor '1' serà '0,54030230586'.  Exemple:      cot(last(/host/key))

en-us	 ##### count(func_foreach(item filter,<time period>),<operator>,<pattern>) {#count}  The count of values in an array returned by a foreach function.<br> Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.  Parameters:   -   **func_foreach** - foreach function for which the number of returned values should be counted (with supported arguments). See [foreach functions](/manual/appendix/functions/aggregate/foreach) for details. -   **item filter** - see [item filter](/manual/appendix/functions/aggregate/foreach#item_filter_syntax);<br> -   **time period** - see [time period](/manual/appendix/functions/aggregate/foreach#time_period);<br> -   **operator** (must be double-quoted). Supported `operators`:<br>*eq* - equal<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> -   **pattern** - the required pattern (string arguments must be double-quoted); supported if *operator* is specified in the third parameter.  Comments:   -   Using **count()** with a history-related foreach function (max_foreach, avg_foreach, etc.) may lead to performance implications, whereas using **exists_foreach()**, which works only with configuration data, will not have such effect. -   Optional parameters *operator* or *pattern* can't be left empty after a comma, only fully omitted. -   With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). -   With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.  Examples:      count(max_foreach(/*/net.if.in[*],1h)) #the number of net.if.in items that received data in the last hour until now     count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #the number of file systems with over 95% of disk space used
ca	 ##### count(func_foreach(filtre d'elements,<període de temps>),<operador>,<patró>) {#count}  El recompte de valors d'una matriu retornats per una funció foreach.<br> [Funcions foreach](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.  Paràmetres:   - **func_foreach** - funció foreach per a la qual s'ha de comptar el nombre de valors retornats (amb arguments compatibles). Vegeu [funcions foreach](/manual/appendix/functions/aggregate/foreach) per obtenir més informació. - **filtre d'elements** - vegeu [filtre d'elements](/manual/appendix/functions/aggregate/foreach#item_filter_syntax);<br> - **període de temps** - vegeu [període de temps](/manual/appendix/functions/aggregate/foreach#time_period);<br> - **operador** (ha d'estar entre cometes). "Operadors" admesos:<br>*eq* - igual<br>*ne* - no igual<br>*gt* - major<br>*ge* - major o igual<br>*lt* - menys<br >*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - coincidència sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br> - **patró** - el patró requerit (els arguments de cadena han d'estar entre cometes); suportat si s'especifica *operador* al tercer paràmetre.  Comentaris:   - L'ús de **count()** amb una funció foreach relacionada amb l'historial (max_foreach, avg_foreach, etc.) pot comportar implicacions de rendiment, mentre que emprar **exists_foreach()**, que només funciona amb dades de configuració, no tindrà tal efecte. - Els paràmetres opcionals *operador* o *patró* no es poden deixar buits després d'una coma, només s'ometen completament. - Amb *bitand* com a tercer paràmetre, el quart paràmetre `patró` es pot especificar com a dos números, separats per '/': **número_a_comparar_amb/màscara**. count() calcula "AND per bits" a partir del valor i la *màscara* i compara el resultat amb *número_per_comparar_amb*. Si el resultat de "AND bit a bit" és igual a *nombre_a_comparar_amb*, es compta el valor.<br>Si *número_a_comparar_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/'). - Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser una expressió regular ordinària o [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global de les expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemat a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.  Exemples:      count(max_foreach(/*/net.if.in[*],1h)) #el nombre d'elements net.if.in que han rebut dades durant la darrera hora fins ara     count(last_foreach(/*/vfs.fs.dependent.size[*,pused]),"gt",95) #el nombre de sistemes de fitxers amb més del 95% d'espai de disc emprat

en-us	 ##### count(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#count}  The number of values within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*.  Parameters:   -   See [common parameters](#common-parameters);<br> -   **operator** (must be double-quoted). Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> -   **pattern** - the required pattern (string arguments must be double-quoted).  Comments:  -   Float items match with the precision of 2.22e-16; -   *like* is not supported as operator for integer values;  -   *like* and *bitand* are not supported as operators for float values; -   For string, text, and log values only *eq*, *ne*, *like*, *regexp* and *iregexp* operators are supported; -   With *bitand* as operator, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). -   With *regexp* or *iregexp* as operator, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.  Examples:      count(/host/key,10m) #the values for the last 10 minutes until now     count(/host/key,10m,"like","error") #the number of values for the last 10 minutes until now that contain 'error'     count(/host/key,10m,,12) #the number of values for the last 10 minutes until now that equal '12'     count(/host/key,10m,"gt",12) #the number of values for the last 10 minutes until now that are over '12'     count(/host/key,#10,"gt",12) #the number of values within the last 10 values until now that are over '12'     count(/host/key,10m:now-1d,"gt",12) #the number of values between 24 hours and 10 minutes and 24 hours ago from now that were over '12'     count(/host/key,10m,"bitand","6/7") #the number of values for the last 10 minutes until now having '110' (in binary) in the 3 least significant bits     count(/host/key,10m:now-1d) #the number of values between 24 hours and 10 minutes and 24 hours ago from now
ca	 ##### count(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#count}  El nombre de valors dins del període d'avaluació definit.<br> Tipus de valors admesos: *Flotant*, *Enter*, *Cadena*, *Text*, *Registre*.  Paràmetres:   - Veieu [paràmetres comuns](#common-parameters);<br> - **operador** (ha d'ésser entre cometes). `Operadors` admesos:<br>*eq* - igual (per defecte per a enter, flotant)<br>*ne* - no igual<br>*gt* - major<br>*ge* - major o igual<br> *lt* - menys<br>*le* - menys o igual<br>*like* (per defecte per a cadena, text, registre) - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - bit a bit I< br>*regexp* - concordança que distingeix entre majúscules i minúscules de l'expressió regular donada a "patró"<br>*iregexp* - concordança sense distinció entre majúscules i minúscules de l'expressió regular donada a "patró"<br> - **patró**-  el patró requerit (els arguments de cadena han d'ésser entre cometes dobles).  Comentaris:  - Els elements flotants coincideixen amb la precisió de 2.22e-16; - *like* no és compatible com a operador per a valors enters;  - *like* i *bitand* no s'admeten com a operadors per a valors flotants; - Per als valors de cadena, text i registre només s'admeten els operadors *eq*, *ne*, *like*, *regexp* i *iregexp*; - Amb *bitand* com a operador, el quart paràmetre `patró` es pot especificar com a dos números, separats per '/': **number_to_compare_with/mask**. count() calcula "AND bit a bit" a partir del valor i la *mask* i compara el resultat amb *number_to_compare_with*. Si el resultat de "AND bit a bit" és igual a *number_to_compare_with/mask*, es compta el valor.<br>Si *nnumber_to_compare_with* i *mask* són iguals, només cal especificar la *mask* (sense '/'). - Amb *regexp* o *iregexp* com a operador, el quart paràmetre `pattern` pot ser una expressió regular ordinària o [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global de les expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemat a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.  Exemples:      count(/host/key,10m) #els valors dels darrers 10 minuts fins ara     count(/host/key,10m,"like","error") #el nombre de valors dels darrers 10 minuts fins ara que contenen "error"     count(/host/key,10m,,12) #el nombre de valors dels darrers 10 minuts fins ara que és igual a '12'     count(/host/key,10m,"gt",12) #el nombre de valors dels darrers 10 minuts fins ara que són superiors a '12'     count(/host/key,#10,"gt",12) #el nombre de valors dels darrers 10 valors fins ara que són superiors a '12'     count(/host/key,10m:now-1d,"gt",12) #el nombre de valors entre 24 hores i 10 minuts i fa 24 hores a partir d'ara que van ser superiors a '12'     count(/host/key,10m,"bitand","6/7") #el nombre de valors dels darrers 10 minuts fins ara amb '110' (en binari) als 3 bits menys significatius     count(/host/key,10m:now-1d) #el nombre de valors entre 24 hores i 10 minuts i fa 24 hores a partir d'ara

en-us	#### Counting of lines in Windows event log  A new [`eventlog.count`](/manual/config/items/itemtypes/zabbix_agent/win_keys#eventlog.count) item has been added to Zabbix agent/agent 2 on Windows. This item returns an integer value with the count of lines in the Windows event log based on the specified parameters.
ca	#### Recompte de línies al registre d'esdeveniments de Windows  S'ha afegit un nou element [`eventlog.count`](/manual/config/items/itemtypes/zabbix_agent/win_keys#eventlog.count) a l'agent/agent 2 del Zabbix a Windows. Aquest element retorna un valor enter amb el recompte de línies al registre d'esdeveniments de Windows en funció dels paràmetres especificats.

en-us	##### Counting of threads in `proc.mem[]` and `proc.num[]` items  Linux kernel threads are counted by `proc.num[]` item but do not report memory in `proc.mem[]` item. For example:      $ ps -ef | grep kthreadd     root         2     0  0 09:51 ?        00:00:00 [kthreadd]      $ zabbix_get -s localhost -k 'proc.num[kthreadd]'     1      $ zabbix_get -s localhost -k 'proc.mem[kthreadd]'     ZBX_NOTSUPPORTED: Cannot get amount of "VmSize" memory.  But what happens if there is a user process with the same name as a kernel thread ? Then it could look like this:      $ ps -ef | grep kthreadd     root         2     0  0 09:51 ?        00:00:00 [kthreadd]     zabbix    9611  6133  0 17:58 pts/1    00:00:00 ./kthreadd      $ zabbix_get -s localhost -k 'proc.num[kthreadd]'     2      $ zabbix_get -s localhost -k 'proc.mem[kthreadd]'     4157440  `proc.num[]` counted both the kernel thread and the user process. `proc.mem[]` reports memory for the user process only and counts the kernel thread memory as if it was 0. This is different from the case above when ZBX\_NOTSUPPORTED was reported.  Be careful when using `proc.mem[]` and `proc.num[]` items if the program name happens to match one of the thread.  Before putting parameters into `proc.mem[]` and `proc.num[]` items, you may want to test the parameters using `proc.num[]` item and `ps` command.
ca	##### El recompte dels fils dels elements `proc.mem[]` i `proc.num[]`  Els fils de kernel Linux es compten amb l'element `proc.num[]`, però no assenyalen pas la memòria de l'element `proc.mem[]`. Per exemple:      $ ps -ef | grep kthreadd     root         2     0  0 09:51 ?        00:00:00 [kthreadd]      $ zabbix_get -s localhost -k 'proc.num[kthreadd]'     1      $ zabbix_get -s localhost -k 'proc.mem[kthreadd]'     ZBX_NOTSUPPORTED: Cannot get amount of "VmSize" memory.  Però què passa si un procés d'usuari porta el mateix nom que un fil de kernel? S'assemblarà a això:      $ ps -ef | grep kthreadd     root         2     0  0 09:51 ?        00:00:00 [kthreadd]     zabbix    9611  6133  0 17:58 pts/1    00:00:00 ./kthreadd      $ zabbix_get -s localhost -k 'proc.num[kthreadd]'     2      $ zabbix_get -s localhost -k 'proc.mem[kthreadd]'     4157440  `proc.num[]` compta tant els fils de kernel com els processos d'usuari. `proc.mem[]` reporta la memòria només per als processos d'usuaris i compta la memòria del fil de kernel com si tingués estat 0. Aquesta és diferent del cas que hi ha aquí dalt, quan ZBX\_NOTSUPPORTED ha estat reportat.  Mireu d'ésser prudents quan empreu els elements `proc.mem[]` i `proc.num[]` si el nom del programa correspon a un dels fils.  Abans d'afegir els paràmetres als elements `proc.mem[]` i `proc.num[]`, podeu testar amb l'ajuda de l'element `proc.num[]` i la comanda `ps`.

en-us	 ##### countunique(/host/key,(sec|#num)<:time shift>,<operator>,<pattern>) {#countunique}  The number of unique values within the defined evaluation period.<br> Supported value types: *Float*, *Integer*, *String*, *Text*, *Log*.  Parameters:   -   See [common parameters](#common-parameters);<br> -   **operator** (must be double-quoted). Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> -   **pattern** - the required pattern (string arguments must be double-quoted).  Comments:  -   Float items match with the precision of 2.22e-16; -   *like* is not supported as operator for integer values;  -   *like* and *bitand* are not supported as operators for float values; -   For string, text, and log values only *eq*, *ne*, *like*, *regexp* and *iregexp* operators are supported; -   With *bitand* as operator, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. countunique() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). -   With *regexp* or *iregexp* as operator, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.  Examples:      countunique(/host/key,10m) #the number of unique values for the last 10 minutes until now     countunique(/host/key,10m,"like","error") #the number of unique values for the last 10 minutes until now that contain 'error'     countunique(/host/key,10m,,12) #the number of unique values for the last 10 minutes until now that equal '12'     countunique(/host/key,10m,"gt",12) #the number of unique values for the last 10 minutes until now that are over '12'     countunique(/host/key,#10,"gt",12) #the number of unique values within the last 10 values until now that are over '12'     countunique(/host/key,10m:now-1d,"gt",12) #the number of unique values between 24 hours and 10 minutes and 24 hours ago from now that were over '12'     countunique(/host/key,10m,"bitand","6/7") #the number of unique values for the last 10 minutes until now having '110' (in binary) in the 3 least significant bits     countunique(/host/key,10m:now-1d) #the number of unique values between 24 hours and 10 minutes and 24 hours ago from now
ca	 ##### countunique(/host/key,(sec|#num)<:time shift>,<operador>,<pattern>) {#countunique}  El nombre de valors únics dins del període d'avaluació definit.<br> Tipus de valors admesos: *Flotant*, *Enter*, *Cadena*, *Text*, *Registre*.  Paràmetres:   - Vegeu [paràmetres comuns](#common-parameters);<br> - **operador** (ha d'estar entre cometes). "Operadors" admesos:<br>*eq* - igual (per defecte per a enter, flotant)<br>*ne* - no igual<br>*gt* - major<br>*ge* - major o igual<br> *lt* - menys<br>*le* - menys o igual<br>*like* (per defecte per a cadena, text, registre) - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - bit a bit I< br>*regexp* - concordança que distingeix entre majúscules i minúscules de l'expressió regular donada a `patró`<br>*iregexp* - concordança sense distinció entre majúscules i minúscules de l'expressió regular donada a `patró`<br> - **patró** - el patró requerit (els arguments de cadena han d'estar entre cometes dobles).  Comentaris:  - Els elements flotants coincideixen amb la precisió de 2.22e-16; - *like* no és compatible com a operador per a valors enters;  - *like* i *bitand* no s'admeten com a operadors per a valors flotants; - Per als valors de cadena, text i registre només s'admeten els operadors *eq*, *ne*, *like*, *regexp* i *iregexp*; - Amb *bitand* com a operador, el quart paràmetre `patró` es pot especificar com a dos números, separats per '/': **number_to_compare_with/mask**. countunique() calcula "AND bit a bit" a partir del valor i la *mask* i compara el resultat amb *number_to_compare_with*. Si el resultat de "AND bit a bit" és igual a *number_to_compare_with*, es compta el valor.<br>Si *number_to_compare_with/mask* i *mask* són iguals, només cal especificar la *mask* (sense '/'). - Amb *regexp* o *iregexp* com a operador, el quart paràmetre `pattern` pot ser una expressió regular ordinària o [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global de les expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.  Exemples:      countunique(/host/key,10m) #el nombre de valors únics durant els darrers 10 minuts fins ara     countunique(/host/key,10m,"like","error") #el nombre de valors únics dels darrers 10 minuts fins ara que contenen "error"     countunique(/host/key,10m,,12) #el nombre de valors únics dels darrers 10 minuts fins ara que és igual a '12'     countunique(/host/key,10m,"gt",12) #el nombre de valors únics dels darrers 10 minuts fins ara que són superiors a '12'     countunique(/host/key,#10,"gt",12) #el nombre de valors únics dels darrers 10 valors fins ara que són superiors a '12'     countunique(/host/key,10m:now-1d,"gt",12) #el nombre de valors únics entre 24 hores i 10 minuts i fa 24 hores a partir d'ara que van ser superiors a '12'     countunique(/host/key,10m,"bitand","6/7") #el nombre de valors únics dels darrers 10 minuts fins ara amb '110' (en binari) als 3 bits menys significatius     countunique(/host/key,10m:now-1d) #el nombre de valors únics entre 24 hores i 10 minuts i fa 24 hores a partir d'ara

en-us	**CPU**  Zabbix and especially Zabbix database may require significant CPU resources depending on number of monitored parameters and chosen database engine.
ca	**CPU**  Zabbix i en particular la base de dades Zabbix poden requerir recursos de CPU importants en funció del nombre de paràmetres monitorats i del motor de base de dades triat.

en-us	#### Create a custom script  Create a custom script that will reboot a server. The script will require write access to the host and will prompt the user for  manual input. Upon successful input submission, script will display confirmation message in the frontend.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Reboot server",         "command": "reboot server {MANUALINPUT}",         "type": 0,         "scope": 2,         "confirmation": "Are you sure you would like to reboot the server {MANUALINPUT}?",         "manualinput": 1,         "manualinput_prompt": "Which server you want to reboot?",         "manualinput_validator": "[1-9]",         "manualinput_validator_type": 0,         "manualinput_default_value": "1"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "4"         ]     },     "id": 1 } ```
ca	#### Creeu un script personalitzat  Crea un script personalitzat que reiniciarà un servidor. L'script requereix accés d'escriptura a l'equip i demanarà a l'usuari  entrada manual. Quan s'hagi enviat l'entrada correctament, es veurà el  missatge de l'script de confirmació a la interfície.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Reiniciar servidor",         "command": "reiniciar el servidor {MANUALINPUT}",         "type": 0,         "scope": 2,         "confirmation": "Segur que voleu reiniciar el servidor {MANUALINPUT}?",         "manualinput": 1,         "manualinput_prompt": "Quin servidor voleu reiniciar?",         "manualinput_validator": "[1-9]",         "manualinput_validator_type": 0,         "manualinput_default_value": "1"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "4"         ]     },     "id": 1 } ```

en-us	#### Create a discovery action  Create a discovery action that will link template "10001" to discovered hosts.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Discovery action",         "eventsource": 1,         "filter": {             "evaltype": 0,             "conditions": [                 {                     "conditiontype": 21,                     "operator": 0,                     "value": "1"                 },                 {                     "conditiontype": 10,                     "operator": 0,                     "value": "2"                 }             ]         },         "operations": [             {                 "operationtype": 6,                 "optemplate": [                     {                         "templateid": "10001"                     }                 ]             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             "18"         ]     },     "id": 1 } ```
ca	#### Crear una acció de descoberta  Crea una acció que vincularà els equips descoberts amb la plantilla "10001".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Discovery action",         "eventsource": 1,         "filter": {             "evaltype": 0,             "conditions": [                 {                     "conditiontype": 21,                     "operator": 0,                     "value": "1"                 },                 {                     "conditiontype": 10,                     "operator": 0,                     "value": "2"                 }             ]         },         "operations": [             {                 "operationtype": 6,                 "optemplate": [                     {                         "templateid": "10001"                     }                 ]             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             "18"         ]     },     "id": 1 } ```

en-us	#### Create a discovery rule  Create a discovery rule to find machines running the Zabbix agent in the local network. The rule must use a single Zabbix agent check on port 10050.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "drule.create",     "params": {         "name": "Zabbix agent discovery",         "iprange": "192.168.1.1-255",         "concurrency_max": "10",         "dchecks": [             {                 "type": "9",                 "key_": "system.uname",                 "ports": "10050",                 "uniq": "0"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "druleids": [             "6"         ]     },     "id": 1 } ```
ca	#### Crear una regla de descoberta  Crear una regla de descoberta per trobar a la xarxa local màquines que corren l'agent de Zabbix. La regla ha d'emprar un únic test de descoberta d'agent de Zabbix sota el port 10050.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "drule.create",     "params": {         "name": "Zabbix agent discovery",         "iprange": "192.168.1.1-255",         "concurrency_max": "10",         "dchecks": [             {                 "type": "9",                 "key_": "system.uname",                 "ports": "10050",                 "uniq": "0"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "druleids": [             "6"         ]     },     "id": 1 } ```

en-us	#### Create agent autoregistration rule  Create an autoregistration action that adds a host to host group "2" when the host name contains "SRV" or metadata contains "AlmaLinux".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Register Linux servers",         "eventsource": "2",         "filter": {             "evaltype": "2",             "conditions": [                 {                     "conditiontype": "22",                     "operator": "2",                     "value": "SRV"                 },                 {                     "conditiontype": "24",                     "operator": "2",                     "value": "AlmaLinux"                 }             ]         },         "operations": [             {                 "operationtype": "4",                 "opgroup": [                     {                         "groupid": "2"                     }                 ]             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             19         ]     },     "id": 1 } ```
ca	#### Crear una regla de registre automàtic d'agent  Crea una acció d'autoregistre que afegeix un equip al grup d'equips "2" quan el nom d'equip contingui "SRV" o trobi "AlmaLinux" a les metadades.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Registrar servidors Linux",         "eventsource": "2",         "filter": {             "evaltype": "2",             "conditions": [                 {                     "conditiontype": "22",                     "operator": "2",                     "value": "SRV"                 },                 {                     "conditiontype": "24",                     "operator": "2",                     "value": "AlmaLinux"                 }             ]         },         "operations": [             {                 "operationtype": "4",                 "opgroup": [                     {                         "groupid": "2"                     }                 ]             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             19         ]     },     "id": 1 } ```

en-us	#### Create agent autoregistration rule with host tags  Create an autoregistration action that adds a host to host group "2" and adds two host tags.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Register Linux servers with tags",         "eventsource": "2",         "operations": [             {                 "operationtype": "4",                 "opgroup": [                     {                         "groupid": "2"                     }                 ]             },             {                 "operationtype": "13",                 "optag": [                     {                         "tag": "Location",                         "value": "Office"                     },                     {                         "tag": "City",                         "value": "Riga"                     }                 ]             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             20         ]     },     "id": 1 } ```
ca	#### Creació d'una regla d'autoregistre de l'agent amb etiquetes d'equip  Crea una acció de registre automàtic que afegeix un equip al grup d'equips "2" i afegeix dues etiquetes d'equip.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Register Linux servers with tags",         "eventsource": "2",         "operations": [             {                 "operationtype": "4",                 "opgroup": [                     {                         "groupid": "2"                     }                 ]             },             {                 "operationtype": "13",                 "optag": [                     {                         "tag": "Location",                         "value": "Office"                     },                     {                         "tag": "City",                         "value": "Riga"                     }                 ]             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             20         ]     },     "id": 1 } ```

en-us	#### Create a host  1\. Go to *Data collection* → [*Hosts*](/manual/web_interface/frontend_sections/data_collection/hosts).  2\. [Create](/manual/config/hosts/host) a host:  - In the *Host name* field, enter a host name (for example, "VMware VMs"). - In the *Host groups* field, type or select a host group (for example, "Virtual machines").  ![](../../../assets/en/manual/vm_monitoring/vmware_host.png){width="600"}  - In the *Macros* tab, set the following host macros:     - {$VMWARE.URL} - VMware service (ESXi hypervisor) SDK URL (https://servername/sdk)     - {$VMWARE.USERNAME} - VMware service user name     - {$VMWARE.PASSWORD} - VMware service {$VMWARE.USERNAME} user password  ![](../../../assets/en/manual/vm_monitoring/vmware_host_macros.png){width="600"}  3\. Click the *Add* button to create the host. This host will represent your VMware environment.
ca	#### Crear un equip  1\. Aneu a *Recull de dades* → [*Equips*](/manual/web_interface/frontend_sections/data_collection/hosts).  2\. [Crear](/manual/config/hosts/host) un equip:  - Al camp *Nom d'equip*, introduïu un nom d'equip(per exemple, "VMware VMs"). - Al camp *Grups d'equips*, escriviu o trieu un grup d'equips (per exemple, "Màquines virtuals").  ![](../../../assets/en/manual/vm_monitoring/vmware_host.png){width="600"}  - A la pestanya *Macros*, configureu les macros d'equipsegüents:     - {$VMWARE.URL} - URL de l'SDK del servei VMware (hipervisor ESXi) (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/vm_monitoring/vmware_host_macros.png){width="600"}  3\. Feu clic al botó *Afegir* per crear l'equip. Aquest equip representarà el vostre entorn VMware.

en-us	#### Create a host map  Create a map with two host elements and a link between them. Note the use of temporary "selementid1" and "selementid2" values in the map link object to refer to map elements.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Host map",         "width": 600,         "height": 600,         "selements": [             {                 "selementid": "1",                 "elements": [                     {"hostid": "1033"}                 ],                 "elementtype": 0,                 "iconid_off": "2"             },              {                 "selementid": "2",                 "elements": [                     {"hostid": "1037"}                 ],                 "elementtype": 0,                 "iconid_off": "2"             }         ],         "links": [             {                 "selementid1": "1",                 "selementid2": "2"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 1 } ```
ca	#### Crear un mapa d'equips  Crear un mapa amb dos equips i un enllaç entre ells. Tindre en compte que emprar els valors temporals "selementid1" i "selementid2" dins l'objecte vinculat del mapa pot fer referència els elements del mapa.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Host map",         "width": 600,         "height": 600,         "selements": [             {                 "selementid": "1",                 "elements": [                     {"hostid": "1033"}                 ],                 "elementtype": 0,                 "iconid_off": "2"             },              {                 "selementid": "2",                 "elements": [                     {"hostid": "1037"}                 ],                 "elementtype": 0,                 "iconid_off": "2"             }         ],         "links": [             {                 "selementid1": "1",                 "selementid2": "2"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 1 } ```

en-us	#### Create a host prototype  1\. In the list of low-level discovery rules, click *Host prototypes* for the previously created low-level discovery rule.  2\. [Create](/manual/discovery/low_level_discovery/host_prototypes#configuration) a host prototype. Since host prototypes are blueprints for creating hosts through low-level discovery rules, most fields will contain [low-level discovery macros](/manual/config/macros/lld_macros). This ensures that the hosts are created with properties based on the [content retrieved](/manual/vm_monitoring/discovery_fields) by the previously created low-level discovery rule.  - In the *Host name* field, enter the macro {#VM.UUID}. - In the *Visible name* field, enter the macro {#VM.NAME}. - In the *Templates* field, enter or select the "VMware Guest" template. This template contains [VMware items](/manual/vm_monitoring/vmware_keys) and discovery rules for monitoring the power state of a virtual machine, CPU usage, memory usage, network devices, etc. - In the *Host groups* field, enter or select a host group (for example, "Discovered hosts"). - In the *Interfaces* field, add a custom [host interface](/manual/discovery/low_level_discovery/host_prototypes#host-interfaces). Then, enter the macro {#VM.DNS} in the *DNS name* field, or enter the macro {#VM.IP} in the *IP address* field. Alternatively, if your VMware environment virtual machines have multiple interfaces, proceed to the [*Advanced host interface configuration*](#advanced-host-interface-configuration) section. Configuring a custom host interface is necessary for the correct functioning of the *VMware Guest* template.  ![](../../../assets/en/manual/vm_monitoring/vmware_host_prototype.png){width="600"}  - In the *Macros* tab, set the {$VMWARE.VM.UUID} macro with the value {#VM.UUID}. This is necessary for the correct functioning of the *VMware Guest* template that uses this macro as a host-level user macro in item parameters (for example, *vmware.vm.net.if.discovery\[{$VMWARE.URL}, {$VMWARE.VM.UUID}\]*).  ![](../../../assets/en/manual/vm_monitoring/vmware_host_prototype_macros.png){width="600"}  3\. Click the *Add* button to create the host prototype. This host prototype will be used to create hosts for virtual machines discovered by the previously created low-level discovery rule.
ca	#### Creeu un prototip d'equip  1\. A la llista de regles de descoberta de baix nivell, feu clic a *Prototips d'equips* per a la regla de descoberta de baix nivell creada anteriorment.  2\. [Crear](/manual/discovery/low_level_discovery/host_prototypes#configuration) un prototip d'equip. Com que els prototips d'equips són plantilles per crear equips mitjançant regles de descoberta de baix nivell, la majoria dels camps contindran [macros de descoberta de baix nivell](/manual/config/macros/lld_macros). Això garanteix que els equips es creïn amb propietats basades en el [contingut recuperat](/manual/vm_monitoring/discovery_fields) per la regla de descoberta de baix nivell creada anteriorment.  - Al camp *Nom de l'equip*, introduïu la macro {#VM.UUID}. - Al camp *Nom visible*, introduïu la macro {#VM.NAME}. - Al camp *Plantilles*, introduïu o seleccioneu la plantilla "VMware Guest". Aquesta plantilla conté [elements de VMware](/manual/vm_monitoring/vmware_keys) i regles de descoberta per monitorar l'estat d'alimentació d'una màquina virtual, l'ús de la CPU, l'ús de la memòria, els dispositius de xarxa, etc. - Al camp *Grups d'equip*, introduïu o trieu un grup d'equip (per exemple, "Equips descoberts"). - Al camp *Interfícies*, afegiu una [interfície d'equip] personalitzada (/manual/discovery/low_level_discovery/host_prototypes#host-interfaces). Tot seguit, introduïu la macro {#VM.DNS} al camp *nom DNS* o introduïu la macro {#VM.IP} al camp *adreça IP*. Alternativament, si les màquines virtuals de l'entorn VMware tenen diverses interfícies, aneu a la secció [*Configuració de la interfície d'equip avançada*](#advanced-host-interface-configuration). Cal la configuració d'una interfície d'equip personalitzada per al correcte funcionament de la plantilla *VMware Guest*.  ![](../../../assets/en/manual/vm_monitoring/vmware_host_prototype.png){width="600"}  - A la pestanya *Macros*, configureu la macro {$VMWARE.VM.UUID} amb el valor {#VM.UUID}. Això és necessari per al correcte funcionament de la plantilla *VMware Guest* que empra aquesta macro com a macro d'usuari a nivell d'equip als paràmetres de l'element. (per exemple, *vmware.vm.net.if.discovery\[{$VMWARE.URL}, {$VMWARE.VM.UUID}\]*).  ![](../../../assets/en/manual/vm_monitoring/vmware_host_prototype_macros.png){width="600"}  3\. Feu clic al botó *Afegir* per crear el prototip d'equip. Aquest prototip d'equip s'emprarà per crear equips per a màquines virtuals trobades per la regla de descoberta de baix nivell creada anteriorment.

en-us	#### Create a low-level discovery rule  1\. Click *Discovery* for the created host to go to the list of low-level discovery rules for that host.  2\. [Create](/manual/discovery/low_level_discovery#configuring-low-level-discovery) a low-level discovery rule:  - In the *Name* field, enter a low-level discovery rule name (for example, "Discover VMware VMs"). - In the *Type* field, select "[Simple check](/manual/config/items/itemtypes/simple_checks)". - In the *Key* field, enter the built-in item key for discovering VMware virtual machines: [`vmware.vm.discovery[{$VMWARE.URL}]`](/manual/vm_monitoring/vmware_keys#vmware.vm.discovery) - In the *User name* and *Password* fields, enter the corresponding macros previously configured on the host.  ![](../../../assets/en/manual/vm_monitoring/vmware_host_discovery.png){width="600"}  3\. Click the *Add* button to create the low-level discovery rule. This discovery rule will discover virtual machines in your VMware environment.
ca	#### Creació d'una regla de descoberta de baix nivell  1\. Feu clic a *Discovery* per a l'equip creat per anar a la llista de regles de descoberta de baix nivell per a aquest equip.  2\. [Creeu](/manual/discovery/low_level_discovery#configuring-low-level-discovery) una regla de descoberta de baix nivell:  - Al camp *Nom*, introduïu un nom de regla de descoberta de baix nivell (per exemple, "Trobeu màquines virtuals de VMware"). - Al camp *Tipus*, trieu "[Comprovació simple](/manual/config/items/itemtypes/simple_checks)". - Al camp *Clau*, introduïu la clau d'element integrada per trobar les màquines virtuals VMware: [`vmware.vm.discovery[{$VMWARE.URL}]`](/manual/vm_monitoring/vmware_keys#vmware.vm.discovery) . - Als camps *Nom d'usuari* i *Mot de pas*, introduïu les macros corresponents configurades prèviament a l'equip.  ![](../../../assets/en/manual/vm_monitoring/vmware_host_discovery.png){width="600"}  3\. Feu clic al botó *Afegir* per crear la regla de descoberta de baix nivell. Aquesta regla de descoberta descobrirà màquines virtuals al vostre entorn VMware.

en-us	##### Create a menu section  1. Create a *Module.php* file in the *MyAddress* directory.  This file implements a new *Module* class that extends the default *CModule* class. The *Module* class will insert a new *My Address* menu section into the main menu.  The *setAction()* method specifies an action to be executed upon clicking on the menu section. To start with, you can use the predefined action *userprofile.edit*, which will open the *User profile* page. In [part III](#part-iii---module-action) of this tutorial, you will learn how to create a custom action.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenuItem;  class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->add((new CMenuItem(_('My Address')))             ->setAction('userprofile.edit'));     } } ```  :::noteclassic You can replace `'userprofile.edit'` with other actions, for example, `'charts.view'` (opens custom graphs), `'problems.view'` (opens *Monitoring → Problems*), or `'report.status'` (opens *System information* report). :::  3. Refresh Zabbix frontend. There is now a new *My Address* section at the bottom of the Zabbix main menu. Click on *My Address* to open the *User profile* page.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_top_menu.png){width="600"}
ca	##### Crear una secció de menú  1. Creeu un fitxer *Module.php* al directori *MyAddress*.  Aquest fitxer implementa una nova classe *Module* que amplia la classe *CModule* per defecte. La classe *Mòdul* inserirà una nova secció de menú *La meva adreça* al menú principal.  El mètode *setAction()* especifica una acció que cal executar en fer clic a la secció del menú. Per començar, podeu emprar l'acció predefinida *userprofile.edit*, que obrirà la pàgina *Perfil d'usuari*. A la [part III](#part-iii---module-action) d'aquest tutorial, aprendràs a crear una acció personalitzada.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenuItem;  Class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->add((new CMenuItem(_('La meva adreça')))             ->setAction('userprofile.edit'));     } } ```  :::noteclassic Podeu substituir `'userprofile.edit'` per altres accions, per exemple, `'charts.view'` (obre gràfics personalitzats), `'problems.view'` (obre *Monitoratge→Problemes*) o `'report.status'` (obre l'informe *Informació del sistema*). :::  3. Actualitzeu la interfície Zabbix. Ara hi ha una nova secció *La meva adreça* a la part inferior del menú principal de Zabbix. Feu clic a *La meva adreça* per obrir la pàgina *Perfil d'usuari*.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_top_menu.png){width="600"}

en-us	# Create a module (tutorial)
ca	# Crear un mòdul (tutorial)

en-us	#### Create an active proxy  Create an action proxy "Active proxy" and assign a host to be monitored by it.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "name": "Active proxy",         "operating_mode": "0",         "hosts": [             {                 "hostid": "10279"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10280"         ]     },     "id": 1 } ```
ca	#### Crear un proxy actiu  Crear un proxy actiu "Active proxy" i assignar-lo a un equip per monitorar-lo.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "name": "Active proxy",         "operating_mode": "0",         "hosts": [             {                 "hostid": "10279"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10280"         ]     },     "id": 1 } ```

en-us	#### Create an empty map  Create a map with no elements.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map",         "width": 600,         "height": 600     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "8"         ]     },     "id": 1 } ```
ca	#### Crear un mapa buit  Crear un mapa sense elements.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map",         "width": 600,         "height": 600     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "8"         ]     },     "id": 1 } ```

en-us	#### Create a new event tag correlation  Create a correlation using evaluation method `AND/OR` with one condition and one operation. By default the correlation will be enabled.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "correlation.create",     "params": {         "name": "new event tag correlation",         "filter": {             "evaltype": 0,             "conditions": [                 {                     "type": 1,                     "tag": "ok"                 }             ]         },         "operations": [             {                 "type": 0             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "1"         ]     },     "id": 1 } ```
ca	#### Crear un nou tag d'esdeveniment de correlació  Crear una correlació emprant el mètode d'avaluació `AND/OR` amb una condició i una operació. Per defecte, la correlació s'activarà.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "correlation.create",     "params": {         "name": "new event tag correlation",         "filter": {             "evaltype": 0,             "conditions": [                 {                     "type": 1,                     "tag": "ok"                 }             ]         },         "operations": [             {                 "type": 0             }         ]     },     "auth": "343baad4f88b4106b9b5961e77437688",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "correlationids": [             "1"         ]     },     "id": 1 } ```

en-us	#### Create a new interface  Create a secondary IP agent interface on host "30052."  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.create",     "params": {         "hostid": "30052",         "main": "0",         "type": "1",         "useip": "1",         "ip": "127.0.0.1",         "dns": "",         "port": "10050"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30062"         ]     },     "id": 1 } ```
ca	#### Crear una nova interfície  Crear una interfície d'agent IP secundària a l'equip "30052."  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.create",     "params": {         "hostid": "30052",         "main": "0",         "type": "1",         "useip": "1",         "ip": "127.0.0.1",         "dns": "",         "port": "10050",     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30062"         ]     },     "id": 1 } ```

en-us	#### Create an icon map  Create an icon map to display hosts of different types.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "iconmap.create",     "params": {         "name": "Type icons",         "default_iconid": "2",         "mappings": [             {                 "inventory_link": 1,                 "expression": "server",                 "iconid": "3"             },             {                 "inventory_link": 1,                 "expression": "switch",                 "iconid": "4"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "iconmapids": [             "2"         ]     },     "id": 1 } ```
ca	#### Crear un mapa d'icones  Crea un mapa d'icones per veure els equips de diferent tipus.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "iconmap.create",     "params": {         "name": "Type icons",         "default_iconid": "2",         "mappings": [             {                 "inventory_link": 1,                 "expression": "server",                 "iconid": "3"             },             {                 "inventory_link": 1,                 "expression": "switch",                 "iconid": "4"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "iconmapids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Create an image  Create a cloud icon.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "image.create",     "params": {         "imagetype": 1,         "name": "Cloud_(24)",         "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII="     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "imageids": [             "188"         ]     },     "id": 1 } ```
ca	#### Crear una imatge  Crea una icona de núvol.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "image.create",     "params": {         "imagetype": 1,         "name": "Cloud_(24)",         "image": "iVBORw0KGgoAAAANSUhEUgAAABgAAAANCAYAAACzbK7QAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAACmAAAApgBNtNH3wAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAIcSURBVDjLrZLbSxRRHMdPKiEiRQ89CD0s+N5j9BIMEf4Hg/jWexD2ZEXQbC9tWUFZimtLhswuZiVujK1UJmYXW9PaCUdtb83enL3P7s6ss5f5dc7EUsmqkPuFH3M4/Ob7+V0OAgC0UyDENFEU03rh1uNOs/lFG75o2i2/rkd9Y3Tgyj3HiaezbukdH9A/rP4E9vWi0u+Y4fuGnMf3DRgYc3Z/84YrQSkD3mgKhFAC+KAEK74Y2Lj3MjPoOokQ3Xyx/1GHeXCifbfO6lRPH/wi+AvZQhGSsgKxdB5CCRkCGPbDgMXBMbukTc4vK5/WRHizsq7fZl2LFuvE4T0BZDTXHtgv4TNUqlUolsqQL2qQwbDEXzBBTIJ7I4y/cfAENmHZF4XrY9Mc+X9HAFmoyXS2ddy1IOg6/KNyBcM0DFP/wFZFCcOy4N9Mw0YkCTOfhdL5AfZQXQBFn2t/ODXHC8FYVcoWjNEQ03qqwTJ5FdI44jg/msoB2Zd5ZKq3q6evA1FUS60bYyyj3AJf3V72HiLZJQxTtRLk1C2IYEg4mTNg63hPd1mOJd7Ict911OMNlWEf0nFxpCt16zcshTuLpGSwDDuPIfv0xzNyQYVGicC0cgUUDLM6Xp02lvvW/V2EBssnxlSGmWsxljw0znV9XfPLjTCW84r+cn7Jc8c2eWrbM6Wbe6/aTJbhJ/TNkWc9/xXW592Xb9iPkKnUfH8BKdLgFy0lDyQAAAAASUVORK5CYII="     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "imageids": [             "188"         ]     },     "id": 1 } ```

en-us	#### Create an interface with SNMP details  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.create",     "params": {         "hostid": "10456",         "main": "0",         "type": "2",         "useip": "1",         "ip": "127.0.0.1",         "dns": "",         "port": "1601",         "details": {             "version": "2",             "bulk": "1",             "community": "{$SNMP_COMMUNITY}"         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30063"         ]     },     "id": 1 } ```
ca	#### Crear una interfícia am dealls SNMP  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostinterface.create",     "params": {         "hostid": "10456",         "main": "0",         "type": "2",         "useip": "1",         "ip": "127.0.0.1",         "dns": "",         "port": "1601",         "details": {             "version": "2",             "bulk": "1",             "community": "{$SNMP_COMMUNITY}"         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "interfaceids": [             "30063"         ]     },     "id": 1 } ```

en-us	 Create another child service of Zabbix cluster with name "Zabbix server node 2".   Set the Problem tags as:   - Name: component - Operation: Equals - Value: HA node 2  Switch to the *Tags* tab and add a service tag: `Zabbix server:node 2`.  Save the new service. 
ca	Creeu un altre servei secundari de clúster Zabbix amb el nom "Node del servidor Zabbix 2".  Definiu les etiquetes de problemes com:  - Nom: component - Funcionament: Igual - Valor: HA node 2  Canvieu a la pestanya *Etiquetes* i afegiu una etiqueta de servei: `Servidor Zabbix:node 2`.  Deseu el nou servei.

en-us	#### Create an SSH script  Create an SSH script with public key authentication that can be executed on a host and has a context menu.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "SSH script",         "command": "my script command",         "type": 2,         "authtype": 1,         "username": "John",         "publickey": "pub.key",         "privatekey": "priv.key",         "password": "secret",         "port": "12345",         "scope": 2,         "menu_path": "All scripts/SSH",         "usrgrpid": "7",         "groupid": "4"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un script SSH  Crea un script SSH amb autenticació de clau pública que pugui executar-se sobre un equip i tingui un menú contextual.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "SSH script",         "command": "my script command",         "type": 2,         "authtype": 1,         "username": "John",         "publickey": "pub.key",         "privatekey": "priv.key",         "password": "secret",         "port": "12345",         "scope": 2,         "menu_path": "All scripts/SSH",         "usrgrpid": "7",         "groupid": "4"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Create a passive proxy  Create a passive proxy "Passive proxy" and assign two hosts to be monitored by it.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "name": "Passive proxy",         "operating_mode": "1",         "address": "127.0.0.1",         "port": "10051",         "hosts": [             {                 "hostid": "10192"             },             {                 "hostid": "10139"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10284"         ]     },     "id": 1 } ```
ca	#### Crear un proxy passiu  Crear un proxy passiu "Passive proxy" i assignar-lo a dos equips a monitorar.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "name": "Passive proxy",         "operating_mode": "1",         "address": "127.0.0.1",         "port": "10051",         "hosts": [             {                 "hostid": "10192"             },             {                 "hostid": "10139"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "10284"         ]     },     "id": 1 } ```

en-us	 # Create a plugin (tutorial)
ca	# Crear un plugin (tutorial)

en-us	#### Create a proxy group  Create a proxy group with custom settings.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxygroup.create",     "params": {         "name": "Proxy group",         "failover_delay": "5m",         "min_online": "10"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxy_groupids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un grup de proxys  Crear un grup de proxys amb configuracions personalitzades.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxygroup.create",     "params": {         "name": "Proxy group",         "failover_delay": "5m",         "min_online": "10"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "proxy_groupids": [             "5"         ]     },     "id": 1 } ```

en-us	#### Create a token  Create an enabled token that never expires and authenticates user of ID 2.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.create",     "params": {         "name": "Your token",         "userid": "2"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "tokenids": [             "188"         ]     },     "id": 1 } ```  Create a disabled token that expires at January 21st, 2021. This token will authenticate current user.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.create",     "params": {         "name": "Your token",         "status": "1",         "expires_at": "1611238072"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "tokenids": [             "189"         ]     },     "id": 1 } ```
ca	#### Crear un token  Crear un token actiu que no caduqui mai i autentifiqui l'usuari amb ID "2".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "token.create",     "params": {         "name": "Your token",         "userid": "2"     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "tokenids": [             "188"         ]     },     "id": 1 } ```  Create a disabled token that expires at January 21st, 2021. This token will authenticate current user.  Request:  ```json {     "jsonrpc": "2.0",     "method": "token.create",     "params": {         "name": "Your token",         "status": "1",         "expires_at": "1611238072"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "tokenids": [             "189"         ]     },     "id": 1 } ```

en-us	#### Create a trigger action  Create a trigger action that will begin once a trigger (with the word "memory" in its name) from host "10084" goes into a PROBLEM state. The action will have 4 configured operations. The first and immediate operation will send a message to all users in user group "7" via media type "1". If the event is not resolved in 30 minutes, the second operation will run [script](/manual/web_interface/frontend_sections/alerts/scripts#configuring-a-global-script) "5" (script with scope "Action operation") on all hosts in group "2". If the event is resolved, a recovery operation will notify all users who received any messages regarding the problem. If the event is updated, an acknowledge/update operation will notify (with a custom subject and message) all users who received any messages regarding the problem.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Trigger action",         "eventsource": 0,         "esc_period": "30m",         "filter": {             "evaltype": 0,             "conditions": [                 {                     "conditiontype": 1,                     "operator": 0,                     "value": "10084"                 },                 {                     "conditiontype": 3,                     "operator": 2,                     "value": "memory"                 }             ]         },         "operations": [             {                 "operationtype": 0,                 "esc_step_from": 1,                 "esc_step_to": 1,                 "opmessage_grp": [                     {                         "usrgrpid": "7"                     }                 ],                 "opmessage": {                     "default_msg": 1,                     "mediatypeid": "1"                 }             },             {                 "operationtype": 1,                 "esc_step_from": 2,                 "esc_step_to": 2,                 "opconditions": [                     {                         "conditiontype": 14,                         "operator": 0,                         "value": "0"                     }                 ],                 "opcommand_grp": [                     {                         "groupid": "2"                     }                 ],                 "opcommand": {                     "scriptid": "5"                 }             }         ],         "recovery_operations": [             {                 "operationtype": "11",                 "opmessage": {                     "default_msg": 1                 }             }         ],         "update_operations": [             {                 "operationtype": "12",                 "opmessage": {                     "default_msg": 0,                     "message": "Custom update operation message body",                     "subject": "Custom update operation message subject"                 }             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             "17"         ]     },     "id": 1 } ```
ca	#### Crear una acció de trigger  Crear una acció que serà executada quan un trigger de l'equip "10084"que tingui la paraula "memòria" al seu nom entri en estat de PROBLEMA. L'acció tindrà 4 operacions configurades. L'acció ha de, primerament, enviar un missatge a tots els usuaris del grup d'usuaris "7" per via del tipus de suport "1". Si l'esdeveniment no fos pas corregit en 30 minuts, llavors farà córrer l'[script](/manual/web_interface/frontend_sections/administration/scripts#configuring-a-global-script) "5" (script amb àmbit "Operació d'acció" a tots els equips del grup "2". Quan l'esdeveniment quedi resolt, una operació de recuperació notificarà a tots els usuaris que hagin rebut qualsevol dels missatges d'avís del problema. Si l'esdeveniment s'actualitza, es notificaran les operacions de reconeixement/actualització (amb un assumpte i missatge a mida) a tots els usuaris que hagin rebut qualsevol missatge veient el problema.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Trigger action",         "eventsource": 0,         "esc_period": "30m",         "filter": {             "evaltype": 0,             "conditions": [                 {                     "conditiontype": 1,                     "operator": 0,                     "value": "10084"                 },                 {                     "conditiontype": 3,                     "operator": 2,                     "value": "memory"                 }             ]         },         "operations": [             {                 "operationtype": 0,                 "esc_step_from": 1,                 "esc_step_to": 1,                 "opmessage_grp": [                     {                         "usrgrpid": "7"                     }                 ],                 "opmessage": {                     "default_msg": 1,                     "mediatypeid": "1"                 }             },             {                 "operationtype": 1,                 "esc_step_from": 2,                 "esc_step_to": 2,                 "opconditions": [                     {                         "conditiontype": 14,                         "operator": 0,                         "value": "0"                     }                 ],                 "opcommand_grp": [                     {                         "groupid": "2"                     }                 ],                 "opcommand": {                     "scriptid": "5"                 }             }         ],         "recovery_operations": [             {                 "operationtype": "11",                 "opmessage": {                     "default_msg": 1                 }             }             ],         "update_operations": [             {                 "operationtype": "12",                 "opmessage": {                     "default_msg": 0,                     "message": "Custom update operation message body",                     "subject": "Custom update operation message subject"                 }             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             "17"         ]     },     "id": 1 } ```

en-us	#### Create a trigger map  Create a map with trigger element, which contains two triggers.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Trigger map",         "width": 600,         "height": 600,         "selements": [             {                 "elements": [                     {"triggerid": "12345"},                     {"triggerid": "67890"}                 ],                 "elementtype": 2,                 "iconid_off": "2"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "10"         ]     },     "id": 1 } ```
ca	#### Crear un mapa de triggers  Crear un mapa un element de trigger, que contenen dos triggers.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Trigger map",         "width": 600,         "height": 600,         "selements": [             {                 "elements": [                     {"triggerid": "12345"},                     {"triggerid": "67890"}                 ],                 "elementtype": 2,                 "iconid_off": "2"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "10"         ]     },     "id": 1 } ```

en-us	#### Create a URL type script  Create a URL type script for host scope that remains in the same window and has confirmation text.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "URL script",         "type": 6,         "scope": 2,         "url": "http://zabbix/ui/zabbix.php?action=host.edit&hostid={HOST.ID}",         "confirmation": "Edit host {HOST.NAME}?",         "new_window": 0     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "56"         ]     },     "id": 1 } ```
ca	#### Crear un script de tipus URL  Crea un script de tipus URL per a un àmbit d'equips de la mateixa finestra i té un text de confirmació.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "URL script",         "type": 6,         "scope": 2,         "url": "http://zabbix/ui/zabbix.php?action=host.edit&hostid={HOST.ID}",         "confirmation": "Edit host {HOST.NAME}?",         "new_window": 0     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "56"         ]     },     "id": 1 } ```

en-us	#### Create a URL type script with manual input  Create a URL type script for event scope that opens in a new window and has manual input.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "URL script with manual input",         "type": 6,         "scope": 4,         "url": "http://zabbix/ui/zabbix.php?action={MANUALINPUT}",         "new_window": 1,         "manualinput": 1,         "manualinput_prompt": "Select a page to open:",         "manualinput_validator": "dashboard.view,script.list,actionlog.list",         "manualinput_validator_type": 1     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "57"         ]     },     "id": 1 } ```
ca	#### Creeu un script de tipus d'URL amb entrada manual  Creeu un script de tipus d'URL per a l'abast de l'esdeveniment que s'obri en una finestra nova i tingui entrada manual.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Script d'URL amb entrada manual",         "type": 6,         "scope": 4,         "url": "http://zabbix/ui/zabbix.php?action={MANUALINPUT}",         "new_window": 1,         "manualinput": 1,         "manualinput_prompt": "Triar quina pàgina obrir:",         "manualinput_validator": "dashboard.view,script.list,actionlog.list",         "manualinput_validator_type": 1     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "57"         ]     },     "id": 1 } ```

en-us	#### Create a webhook script  Create a webhook script that sends HTTP request to external service.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Webhook script",         "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",         "type": 5,         "timeout": "40s",         "parameters": [             {                 "name": "token",                 "value": "{$WEBHOOK.TOKEN}"             },             {                 "name": "host",                 "value": "{HOST.HOST}"             },             {                 "name": "v",                 "value": "2.2"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "3"         ]     },     "id": 1 } ```
ca	#### Crear un script de webhook  Crear un script de webhook que envia una consulta HTTP a un servei extern.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Webhook script",         "command": "try {\n var request = new HttpRequest(),\n response,\n data;\n\n request.addHeader('Content-Type: application/json');\n\n response = request.post('https://localhost/post', value);\n\n try {\n response = JSON.parse(response);\n }\n catch (error) {\n response = null;\n }\n\n if (request.getStatus() !== 200 || !('data' in response)) {\n throw 'Unexpected response.';\n }\n\n data = JSON.stringify(response.data);\n\n Zabbix.Log(3, '[Webhook Script] response data: ' + data);\n\n return data;\n}\ncatch (error) {\n Zabbix.Log(3, '[Webhook Script] script execution failed: ' + error);\n throw 'Execution failed: ' + error + '.';\n}",         "type": 5,         "timeout": "40s",         "parameters": [             {                 "name": "token",                 "value": "{$WEBHOOK.TOKEN}"             },             {                 "name": "host",                 "value": "{HOST.HOST}"             },             {                 "name": "v",                 "value": "2.2"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "3"         ]     },     "id": 1 } ```

en-us	# Create a widget (tutorial)
ca	# Crear un giny (tutorial)

en-us	#### Create HTTP agent item  Create POST request method item with JSON response preprocessing.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "url":"http://127.0.0.1/http.php",         "query_fields": [             {                 "name": "mode",                 "value": "json"             },             {                 "name": "min",                 "value": "10"             },             {                 "name": "max",                 "value": "100"             }         ],         "interfaceid": "1",         "type": 19,         "hostid": "10254",         "delay": "5s",         "key_": "json",         "name": "HTTP agent example JSON",         "value_type": 0,         "output_format": 1,         "preprocessing": [             {                 "type": 12,                 "params": "$.random",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```
ca	#### Crear un element d'agent HTTP  Crea un element de mètode de petició POST amb el pretractament de la resposta JSON.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "url":"http://127.0.0.1/http.php",         "query_fields": [             {                 "name": "mode",                 "value": "json"             },             {                 "name": "min",                 "value": "10"             },             {                 "name": "max",                 "value": "100"             }         ],         "interfaceid": "1",         "type": 19,         "hostid": "10254",         "delay": "5s",         "key_": "json",         "name": "HTTP agent example JSON",         "value_type": 0,         "output_format": 1,         "preprocessing": [             {                 "type": 12,                 "params": "$.random",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```

en-us	#### Create HTTP agent item prototype  Create item prototype with URL using user macro, query fields and custom headers.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "type": "19",         "hostid": "10254",         "ruleid": "28256",         "interfaceid": "2",         "name": "api item prototype example",         "key_": "api_http_item",         "value_type": 3,         "url": "{$URL_PROTOTYPE}",         "query_fields": [             {                 "name": "min",                 "value": "10"             },             {                 "name": "max",                 "value" "100"             }         ],         "headers": [             {                 "name": "X-Source",                 "value": "api"             }         ],         "delay": "35"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28305"         ]     },     "id": 1 } ```
ca	#### Crear un prototiups d'element d'agent HTTP agent  Crear un prototip d'element amb una URL emprant una macro d'usuari, camps de cerca i capçaleres a mida.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "type": "19",         "hostid": "10254",         "ruleid": "28256",         "interfaceid": "2",         "name": "api item prototype example",         "key_": "api_http_item",         "value_type": 3,         "url": "{$URL_PROTOTYPE}",         "query_fields": [             {                 "name": "min",                 "value": "10"             },             {                 "name": "max",                 "value" "100"             }         ],         "headers": [             {                 "name": "X-Source",                 "value": "api"             }         ],         "delay": "35"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28305"         ]     },     "id": 1 } ```

en-us	### Create items  Follow the instructions on [creating an item](/manual/config/items/item) to add the items for traffic monitoring, namely:  -   [Incoming traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.in) -   [Outgoing traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.out) -   [Total traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.total)  A simple setup for the incoming traffic monitoring item with an active check would look as follows:  ![](../../../assets/en/manual/guides/traffic_item_active.png){width="600"}  To make the collected data suitable for practical use, you can set some [preprocessing](/manual/config/items/preprocessing) steps when creating the items. In the given case, those can be multiplication by 8 (to convert bytes to bits) and presentation as change per second.  ![](../../../assets/en/manual/guides/traffic_item_prepr.png){width="600"}
ca	### Crear elements  Seguiu les instruccions sobre com [crear d'un element](/manual/config/items/item) per afegir els elements per al seguiment del trànsit, és a dir:  - [Trànsit entrant](/manual/config/items/itemtypes/zabbix_agent#net.if.in) - [Trànsit sortint](/manual/config/items/itemtypes/zabbix_agent#net.if.out) - [Trànsit total](/manual/config/items/itemtypes/zabbix_agent#net.if.total)  Una configuració senzilla per a l'element de control de trànsit entrant amb una comprovació activa seria el següent:  ![](../../../assets/en/manual/guides/traffic_item_active.png){width="600"}  Per tal que les dades recollides siguin adequades per a un ús pràctic, podeu configurar algunes passes de [preprocessament](/manual/config/items/preprocessing) a l'hora de crear els elements. En el cas donat, es poden multiplicar per 8 (per convertir octets a bits) i presentar-ho com a canvi per segon.  ![](../../../assets/en/manual/guides/traffic_item_prepr.png){width="600"}

en-us	### Create items  Follow the instructions on [creating an item](/manual/config/items/item) to add the items for traffic monitoring, namely:  -   [Incoming traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.in) -   [Outgoing traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.out) -   [Total traffic](/manual/config/items/itemtypes/zabbix_agent#net.if.total)  A simple setup for the incoming traffic monitoring item would look as follows:  ![](../../../assets/en/manual/guides/traffic_item.png){width="600"}  To make the collected data suitable for practical use, you can set some [preprocessing](/manual/config/items/preprocessing) steps when creating the items. In the given case, those can be multiplication by 8 (to convert bytes to bits) and presentation as change per second.  ![](../../../assets/en/manual/guides/traffic_item_prepr.png){width="600"}
ca	### Crear elements  Seguiu les instruccions sobre com [crear d'un element](/manual/config/items/item) per afegir els elements per al seguiment del trànsit, és a dir:  - [Trànsit entrant](/manual/config/items/itemtypes/zabbix_agent#net.if.in) - [Trànsit sortint](/manual/config/items/itemtypes/zabbix_agent#net.if.out) - [Trànsit total](/manual/config/items/itemtypes/zabbix_agent#net.if.total)  Una configuració senzilla per a l'element de control de trànsit entrant seria el següent:  ![](../../../assets/en/manual/guides/traffic_item.png){width="600"}  Per tal que les dades recollides siguin adequades per a un ús pràctic, podeu configurar algunes passes de [preprocessament](/manual/config/items/preprocessing) a l'hora de crear els elements. En el cas donat, es poden multiplicar per 8 (per convertir octets a bits) i presentar-ho com a canvi per segon.  ![](../../../assets/en/manual/guides/traffic_item_prepr.png){width="600"}

en-us	#### Create LLD rule with a specified time period for disabling and no deletion  Create an LLD rule with custom time period for disabling entity after it is no longer discovered, with the setting that it will never be deleted.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "lld disable after 1h",         "key_": "lld.disable",         "hostid": "10001",         "type": 2,         "lifetime_type": 1,         "enabled_lifetime_type": 0,          "enabled_lifetime": "1h"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "46864"         ]     },     "id": 1 } ```
ca	#### Creeu una regla LLD amb un període de temps especificat per a la desactivació i sense supressió  Creeu una regla LLD amb un període de temps personalitzat per desactivar l'entitat després ja no es descobreix, amb l'escenari que no serà mai esborrat.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "lld disable after 1h",         "key_": "lld.disable",         "hostid": "10001",         "type": 2,         "lifetime_type": 1,         "enabled_lifetime_type": 0,          "enabled_lifetime": "1h"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "46864"         ]     },     "id": 1 } ```

en-us	#### Create MySQL user  To monitor a MySQL server, Zabbix requires access to it and its processes. Your MySQL installation already has a user with the required level of access (the user "zabbix" that was created when installing Zabbix), however, this user has more privileges than necessary for simple monitoring (privileges to DROP databases, DELETE entries from tables, etc.). Therefore, a MySQL user for the purpose of *only* monitoring the MySQL server needs to be created.  1\. Connect to the MySQL client, create a "zbx_monitor" user (replace *<password>* for the "zbx_monitor" user with a password of your choice), and [GRANT](https://dev.mysql.com/doc/refman/8.0/en/grant.html) the necessary privileges to the user:      mysql -u root -p     # Enter password:      mysql> CREATE USER 'zbx_monitor'@'%' IDENTIFIED BY '<password>';     mysql> GRANT REPLICATION CLIENT,PROCESS,SHOW DATABASES,SHOW VIEW ON *.* TO 'zbx_monitor'@'%';     mysql> quit;  Once the user is created, you can move on to the next step.
ca	### Crear un usuari de MySQL  Per monitorar un servidor MySQL, Zabbix requereix accés a aquest i als seus processos. La vostra instal·lació de MySQL ja té un usuari amb el nivell d'accés necessari (l'usuari "zabbix" que es va crear en instal·lar Zabbix); tanmateix, aquest usuari té més privilegis dels necessaris per a un seguiment senzill (privilegis per a DROPAR bases de dades, ESBORRAR entrades de taules, etc.). Per tant, cal crear un usuari de MySQL amb el propòsit de *només* monitorar el servidor MySQL.  1\. Connecteu-vos al client MySQL, creeu un usuari "zbx_monitor" (substituïu *<mot de pas>* per l'usuari "zbx_monitor" per un mot de pas de la vostra elecció), i [GRANT](https://dev.mysql.com/doc/refman/8.0/en/grant.html) els privilegis necessaris per a l'usuari:      mysql -u root -p     # Entreu el mot de pas:      mysql> CREATE USER 'zbx_monitor'@'%' IDENTIFIED BY '<mot de pas>';     mysql> GRANT REPLICATION CLIENT,PROCESS,SHOW DATABASES,SHOW VIEW ON *.* TO 'zbx_monitor'@'%';     mysql> quit;  Un cop creat l'usuari, podeu passar a la següent passa.

en-us	#### Create script item  Create a simple data collection using a script item.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Script example",         "key_": "custom.script.item",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```
ca	#### Crear un element d'script  Crea una col·lecció senzilla e dades emprant un element d'script.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Script example",         "key_": "custom.script.item",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

en-us	#### Create script item prototype  Create a simple data collection using a script item prototype.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Script example",         "key_": "custom.script.itemprototype",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```
ca	#### Crear un prototipus d'element d'script  Crear una col·lecció de dades simple emprant un prototipus d'element d'script.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Script example",         "key_": "custom.script.itemprototype",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new CurlHttpRequest();\nreturn request.Post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [             {                 "name": "host",                 "value": "{HOST.CONN}"             }         ],         "timeout": "6s",         "delay": "30s"     },     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

en-us	#### Create script LLD rule  Create a simple data collection using a script LLD rule.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Script example",         "key_": "custom.script.lldrule",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new HttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [{             "name": "host",             "value": "{HOST.CONN}"         }],         "timeout": "6s",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 1 } ```
ca	#### Creear una regla LLD script  Crear una recollida simple de dades mercès a una regla LLD script.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Script example",         "key_": "custom.script.lldrule",         "hostid": "12345",         "type": 21,         "value_type": 4,         "params": "var request = new lHttpRequest();\nreturn request.post(\"https://postman-echo.com/post\", JSON.parse(value));",         "parameters": [{                 "name": "host",                 "value": "{HOST.CONN}"         }],         "timeout": "6s",         "delay": "30s"     },     "id": 4 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 4 } ```

en-us	#### Creating a connector  Create a connector to export trigger events with a tag filter. HTTP authentication will be performed using Bearer token.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "connector.create",     "params": [         {             "name": "Export of events",             "data_type": 1,             "url": "{$DATA_EXPORT_URL}",             "authtype": 5,             "token": "{$DATA_EXPORT_BEARER_TOKEN}",             "tags": [                 {                     "tag": "service",                     "operator": 0,                     "value": "mysqld"                 }             ]         }     ],     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "connectorid": [             "3"         ]     },     "id": 1 } ```
ca	#### Creació d'un connector  Crea un connector per exportar esdeveniments de disparador amb un filtre de tags. L'autenticació HTTP es durà a terme mitjançant un token de Bearer.  [Petició](/manual/api#performing-requests): ```json {     "jsonrpc": "2.0",     "method": "connector.create",     "params": [         {             "name": "Exportació d'esdeveniments",             "data_type": 1,             "url": "{$DATA_EXPORT_URL}",             "authtype": 5,             "token": "{$DATA_EXPORT_BEARER_TOKEN}",             "tags": [                 {                     "tag": "servei",                     "operador": 0,                     "valor": "mysqld"                 }             ]         }     ],     "id": 1 } ```  Resposta: ```json {     "jsonrpc": "2.0",     "result": {         "connectorid": ["3"]     },     "id": 1 } ```

en-us	#### Creating a dashboard  Create a dashboard named "My dashboard" with one Problems widget with tags and using two types of sharing (user group and user) on a single dashboard page.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problems",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.0.tag",                                 "value": "service"                             },                             {                                 "type": 0,                                 "name": "tags.0.operator",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.0.value",                                 "value": "zabbix_server"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": 2             }         ],         "users": [             {                 "userid": "4",                 "permission": 3             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```
ca	#### Creant un tauler  Crea un tauler amb el nom de "El meu tauler" amb un giny de Problemes amb tags, i emprant dos tipus de comparticions (grups d'usuaris i usuari) en una única pàgina del tauler.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "dashboard.create",     "params": {         "name": "My dashboard",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "problems",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.0.tag",                                 "value": "service"                             },                             {                                 "type": 0,                                 "name": "tags.0.operator",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.0.value",                                 "value": "zabbix_server"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": 2             }         ],         "users": [             {                 "userid": "4",                 "permission": 3             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "dashboardids": [             "2"         ]     },     "id": 1 } ```

en-us	#### Creating a dashboard  It is possible to create a new dashboard in two ways:  -   Click on *Create dashboard*, when viewing all dashboards -   Select *Create new* from the action menu, when viewing a single     dashboard  You will be first asked to enter general dashboard parameters:  ![dashboard\_properties.png](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_properties.png)  |Parameter|Description| |--|--------| |*Owner*|Select system user that will be the dashboard owner.| |*Name*|Enter dashboard name.| |*Default page display period*|Select period for how long a dashboard page is displayed before rotating to the next page in a [slideshow](#creating_a_slideshow).| |*Start slideshow automatically*|Mark this checkbox to run a slideshow automatically one more than one dashboard page exists.|  When you click on *Apply*, an empty dashboard is opened:  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_add.png){width="600"}  To populate the dashboard, you can add widgets and pages.  Click on the *Save changes* button to save the dashboard. If you click on *Cancel*, the dashboard will not be created.
ca	#### Crear un tauler  És possible crear un tauler nou de dues maneres:  - Feu clic a *Crear un tauler de control* quan visualitzeu tots els taulers - Seleccioneu *Crear nou* al menú d'accions, quan visualitzeu un únic tauler  Primer se us demanarà que introduïu els paràmetres generals del tauler de control:  ![tauler\_properties.png](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_properties.png)  |Paràmetre|Descripció| |--|---------| |*Propietari*|Seleccioneu l'usuari del sistema que serà el propietari del tauler.| |*Nom*|Introduïu el nom del tauler.| |*Període de visualització de la pàgina predeterminat*|Seleccioneu el període durant quant de temps es mostrarà una pàgina del tauler abans de girar a la pàgina següent en una [presentación de diapositives](#creating_a_slideshow).| |*Inicia la presentació de diapositives automàticament*|Marqueu aquesta casella de selecció per executar una presentació de diapositives automàticament, hi ha més d'una pàgina del tauler de control.|  Quan feu clic a *Aplicar*, s'obre un tauler de control buit:  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_add.png){width="600"}  Per omplir el tauler, podeu afegir ginys i pàgines.  Feu clic al botó *Desa els canvis* per desar el tauler. Si feu clic a *Cancel·la*, el tauler no es crearà.

en-us	#### Creating a global macro  Create a global macro "{$SNMP\_COMMUNITY}" with value "public".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "usermacro.createglobal",     "params":  {         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "globalmacroids": [             "6"         ]     },     "id": 1 } ```
ca	#### Crear una macro global  Crea una macro global "{$SNMP\_COMMUNITY}" amb el valor "public".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "usermacro.createglobal",     "params":  {         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "globalmacroids": [             "6"         ]     },     "id": 1 } ```

en-us	#### Creating a graph  Create a graph with two items.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "graph.create",     "params": {         "name": "MySQL bandwidth",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```
ca	#### Crear un gràfic  Crear un gràfic amb dos elements.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "graph.create",     "params": {         "name": "MySQL bandwidth",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```

en-us	#### Creating a graph prototype  Create a graph prototype with two items.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "graphprototype.create",     "params": {         "name": "Disk space usage {#FSNAME}",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```
ca	#### Crear un prototip de gràfic  Crear un protip de gràfic amb dos elements.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "graphprototype.create",     "params": {         "name": "Ús d'espai de disc {FSNAME}",         "width": 900,         "height": 200,         "gitems": [             {                 "itemid": "22828",                 "color": "00AA00"             },             {                 "itemid": "22829",                 "color": "3333FF"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "graphids": [             "652"         ]     },     "id": 1 } ```

en-us	#### Creating a host  Create a host called "Linux server" with an IP interface and tags, add it to a group, link a template to it and set the MAC addresses in the host inventory.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Linux server",         "interfaces": [             {                 "type": 1,                 "main": 1,                 "useip": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050"             }         ],         "groups": [             {                 "groupid": "50"             }         ],         "tags": [             {                 "tag": "Host name",                 "value": "Linux server"             }         ],         "templates": [             {                 "templateid": "20045"             }         ],         "macros": [             {                 "macro": "{$USER_ID}",                 "value": "123321"             },             {                 "macro": "{$USER_LOCATION}",                 "value": "0:0:0",                 "description": "latitude, longitude and altitude coordinates"             }         ],         "inventory_mode": 0,         "inventory": {             "macaddress_a": "01234",             "macaddress_b": "56768"         }     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "107819"         ]     },     "id": 1 } ```
ca	#### Crear un equip  Crear un equip anomenat "Linux server" amb una interfície IP i etiquetes; afegir-lo a un grup, vincular-lo a una plantilla i establir les adreces MAC dins de l'inventari d'equips.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Linux server",         "interfaces": [             {                 "type": 1,                 "main": 1,                 "useip": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050"             }         ],         "groups": [             {                 "groupid": "50"             }         ],         "tags": [             {                 "tag": "Host name",                 "value": "Linux server"             }         ],         "templates": [             {                 "templateid": "20045"             }         ],         "macros": [             {                 "macro": "{$USER_ID}",                 "value": "123321"             },             {                 "macro": "{$USER_LOCATION}",                 "value": "0:0:0",                 "description": "latitude, longitude and altitude coordinates"             }         ],         "inventory_mode": 0,         "inventory": {             "macaddress_a": "01234",             "macaddress_b": "56768"         }     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "107819"         ]     },     "id": 1 } ```

en-us	#### Creating a host group  Create a host group called "Linux servers".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.create",     "params": {         "name": "Linux servers"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "107819"         ]     },     "id": 1 } ```
ca	#### Crear un grup d'equips  Crea un grup d'equips anomenat "Servidors Linux".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostgroup.create",     "params": {         "name": "Servidors Linux"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "107819"         ]     },     "id": 1 } ```

en-us	#### Creating a host group  ::: noteimportant Only Super Admin users can create host groups. :::  To create a host group in Zabbix frontend, do the following:  -   Go to: *Data collection* → *Host groups* -   Click on *Create host group* in the upper right corner of the screen -   Enter the group name in the form  ![](../../../../assets/en/manual/config/host_group.png)  To create a nested host group, use the '/' forward slash separator, for example `Europe/Latvia/Riga/Zabbix servers`. You can create this group even if none of the three parent host groups (`Europe/Latvia/Riga/`) exist. In this case creating these parent host groups is up to the user; they will not be created automatically.<br>Leading and trailing slashes, several slashes in a row are not allowed. Escaping of '/' is not supported.
ca	#### Crear un grup d'equips  ::: noteimportant Només els usuaris superadministradors poden crear grups d'equips. :::  Per crear un grup d'equips a la interfície de Zabbix, feu el següent:  - Aneu a: *Recollida de dades* → *Grups d'equips* - Feu clic a *Crea un grup d'equips* a la cantonada superior dreta de la pantalla - Introduïu el nom del grup al formulari  ![](../../../../assets/en/manual/config/host_group.png)  Per crear un grup d'equips niuat, empreu el separador de barra inclinada '/', per exemple `Servidors Europa/Letònia/Riga/Zabbix'. Podeu crear aquest grup encara que no existeixi cap dels tres grups d'equips principals (`Europa/Letònia/Riga/`). En aquest cas, la creació d'aquests grups d'equips pare depèn de l'usuari; no es crearan automàticament.<br>Les barres inclinades inicials i posteriors no es permeten diverses barres inclinades seguides. L'escapament de "/" no és compatible.

en-us	#### Creating a host inventory item  Create a Zabbix agent item to populate the host's "OS" inventory field.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "uname",         "key_": "system.uname",         "hostid": "30021",         "type": 0,         "interfaceid": "30007",         "value_type": 1,         "delay": "10s",         "inventory_link": 5     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 1 } ```
ca	#### Crear un element d'inventari d'equip  Crea un element d'agent Zabbix per emplenar el camp d'inventari "OS" de l'equip.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "uname",         "key_": "system.uname",         "hostid": "30021",         "type": 0,         "interfaceid": "30007",         "value_type": 1,         "delay": "10s",         "inventory_link": 5     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 1 } ```

en-us	#### Creating a host macro  Create a host macro "{$SNMP\_COMMUNITY}" with the value "public" on host "10198".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "usermacro.create",     "params": {         "hostid": "10198",         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostmacroids": [             "11"         ]     },     "id": 1 } ```
ca	#### Crear una macro d'equip  Crea una macro d'equip "{$SNMP\_COMMUNITY}" amb el valor "public" a l'equip "10198".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "usermacro.create",     "params": {         "hostid": "10198",         "macro": "{$SNMP_COMMUNITY}",         "value": "public"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostmacroids": [             "11"         ]     },     "id": 1 } ```

en-us	#### Creating a host monitored by a proxy  Create a host that will be monitored by proxy with ID "1".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Host monitored by proxy",         "groups": [             {                 "groupid": "2"             }         ],         "monitored_by": 1,         "proxyid": 1     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10591"         ]     },     "id": 1 } ```
ca	#### Crear un equip monitorat per un proxy  Crea un equip que serà monitorat per el proxy amb ID "1".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Equip monitorat per el proxy",         "groups": [             {                 "groupid": "2"             }         ],         "monitored_by": 1,         "proxyid": 1     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10591"         ]     },     "id": 1 } ```

en-us	#### Creating a host monitored by a proxy group  Create a host that will be monitored by proxy group with ID "1".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Host monitored by proxy group",         "groups": [             {                 "groupid": "2"             }         ],         "monitored_by": 2,         "proxy_groupid": 1     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10592"         ]     },     "id": 1 } ```
ca	#### Crear un equip monitorat per un grup de proxys  Crea un equip que serà monitorat per el grup de proxys amb ID "1".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "Equip monitorat per un grup de proxys",         "groups": [             {                 "groupid": "2"             }         ],         "monitored_by": 2,         "proxy_groupid": 1     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10592"         ]     },     "id": 1 } ```

en-us	#### Creating a host prototype  Create a host prototype "{\#VM.NAME}" on LLD rule "23542" with a group prototype "{\#HV.NAME}", tag pair "Datacenter": "{\#DATACENTER.NAME}" and custom SNMPv2 interface 127.0.0.1:161 with community {$SNMP\_COMMUNITY}. Link it to host group "2".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.create",     "params": {         "host": "{#VM.NAME}",         "ruleid": "23542",         "custom_interfaces": "1",         "groupLinks": [             {                 "groupid": "2"             }         ],         "groupPrototypes": [             {                 "name": "{#HV.NAME}"             }         ],         "tags": [             {                 "tag": "Datacenter",                 "value": "{#DATACENTER.NAME}"             }         ],         "interfaces": [             {                 "main": "1",                 "type": "2",                 "useip": "1",                 "ip": "127.0.0.1",                 "dns": "",                 "port": "161",                 "details": {                     "version": "2",                     "bulk": "1",                     "community": "{$SNMP_COMMUNITY}"                 }             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10103"         ]     },     "id": 1 } ```
ca	#### Crear un prototip d'equip  Crear un prototip d'equip "{\#VM.NAME}" sobre la regla LLD "23542" amb un prototip de grup "{\#HV.NAME}", una parella d'etiquetes "Datacenter": "{\#DATACENTER.NAME}" i una interfície SNMPv2 personalitzada 127.0.0.1:161 amb la comunitat {$SNMP\_COMMUNITY}. Enllaçar-lo al grup d'equips "2".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "hostprototype.create",     "params": {         "host": "{#VM.NAME}",         "ruleid": "23542",         "custom_interfaces": "1",         "groupLinks": [             {                 "groupid": "2"             }         ],         "groupPrototypes": [             {                 "name": "{#HV.NAME}"             }         ],         "tags": [             {                 "tag": "Datacenter",                 "value": "{#DATACENTER.NAME}"             }         ],         "interfaces": [             {                 "main": "1",                 "type": "2",                 "useip": "1",                 "ip": "127.0.0.1",                 "dns": "",                 "port": "161",                 "details": {                     "version": "2",                     "bulk": "1",                     "community": "{$SNMP_COMMUNITY}"                 }             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10103"         ]     },     "id": 1 } ```

en-us	#### Creating a host with PSK encryption  Create a host called "PSK host" with PSK encryption configured. Note that the host has to be [pre-configured to use PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "PSK host",         "interfaces": [             {                 "type": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050",                 "useip": 1,                 "main": 1             }         ],         "groups": [             {                 "groupid": "2"             }         ],         "tls_accept": 2,         "tls_connect": 2,         "tls_psk_identity": "PSK 001",         "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10590"         ]     },     "id": 1 } ```
ca	#### Crear un equip amb xifrat PSK  Crear un equip anomenat "equip PSK" amb xifrat PSK configurat. Fixeu-vos qu l'equip ha d'ésser [pre-configurat per emprar PSK](/manual/encryption/using_pre_shared_keys#configuring-psk-for-server-agent-communication-example).  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "PSK host",         "interfaces": [             {                 "type": 1,                 "ip": "192.168.3.1",                 "dns": "",                 "port": "10050",                 "useip": 1,                 "main": 1             }         ],         "groups": [             {                 "groupid": "2"             }         ],         "tls_accept": 2,         "tls_connect": 2,         "tls_psk_identity": "PSK 001",         "tls_psk": "1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10590"         ]     },     "id": 1 } ```

en-us	#### Creating a host with SNMP interface  Create a host called "SNMP host" with an SNMPv3 interface with details.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "host.create",     "params": {         "host": "SNMP host",         "interfaces": [             {                 "type": 2,                 "main": 1,                 "useip": 1,                 "ip": "127.0.0.1",                 "dns": "",                 "port": "161",                 "details": {                     "version": 3,                     "bulk": 0,                     "securityname": "mysecurityname",                     "contextname": "",                     "securitylevel": 1                 }             }         ],         "groups": [             {                 "groupid": "4"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "hostids": [             "10658"         ]     },     "id": 1 } ```
ca	#### Crear un equip amb una interfície SNMP  Crear un equip anomenat "equip SNMP" amb una interfície SNMPv3 i els seus detalls.  [Petició](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "host.create", "params": { "host": "SNMP host", "interfaces": [ { "type": 2, "main": 1, "useip": 1, "ip": "127.0.0.1", "dns": "", "port": "161", "details": { "version": 3, "bulk": 0, "securityname": "mysecurityname", "contextname": "", "securitylevel": 1 } } ], "groups": [ { "groupid": "4" } ] }, "id": 1 } ```  Resposta:  ```json { "jsonrpc": "2.0", "result": { "hostids": [ "10658" ] }, "id": 1 } ```

en-us	#### Creating a LLD rule with macro paths  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "LLD rule with LLD macro paths",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.path.1"             },             {                 "lld_macro": "{#MACRO2}",                 "path": "$.path.2"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb rutes de macros  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "LLD rule with LLD macro paths",         "key_": "lld",         "hostid": "10116",         "type": 0,         "interfaceid": "13",         "delay": "30s",         "lld_macro_paths": [             {                 "lld_macro": "{#MACRO1}",                 "path": "$.path.1"             },             {                 "lld_macro": "{#MACRO2}",                 "path": "$.path.2"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with overrides  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discover database host",         "key_": "lld.with.overrides",         "hostid": "10001",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "overrides": [             {                 "name": "Discover MySQL host",                 "step": "1",                 "stop": "1",                 "filter": {                     "evaltype": "2",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mysqld\\.service$"                         },                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mariadb\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10170"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "MySQL"                             }                         ]                     }                 ]             },             {                 "name": "Discover PostgreSQL host",                 "step": "2",                 "stop": "1",                 "filter": {                     "evaltype": "0",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^postgresql\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10263"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "PostgreSQL"                             }                         ]                     }                 ]             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "30980"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb substitucions  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discover database host",         "key_": "lld.with.overrides",         "hostid": "10001",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "overrides": [             {                 "name": "Discover MySQL host",                 "step": "1",                 "stop": "1",                 "filter": {                     "evaltype": "2",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mysqld\\.service$"                         },                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^mariadb\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10170"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "MySQL"                             }                         ]                     }                 ]             },             {                 "name": "Discover PostgreSQL host",                 "step": "2",                 "stop": "1",                 "filter": {                     "evaltype": "0",                     "conditions": [                         {                             "macro": "{#UNIT.NAME}",                             "operator": "8",                             "value": "^postgresql\\.service$"                         }                     ]                 },                 "operations": [                     {                         "operationobject": "3",                         "operator": "2",                         "value": "Database host",                         "opstatus": {                             "status": "0"                         },                         "optemplate": [                             {                                 "templateid": "10263"                             }                         ],                         "optag": [                             {                                 "tag": "Database",                                 "value": "PostgreSQL"                             }                         ]                     }                 ]             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "30980"         ]     },     "id": 1 } ```

en-us	#### Creating a LLD rule with preprocessing  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discovery rule with preprocessing",         "key_": "lld.with.preprocessing",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 20,                 "params": "20",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD amb preprocessament  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Discovery rule with preprocessing",         "key_": "lld.with.preprocessing",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 20,                 "params": "20",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Creating a maintenance  Create a maintenance with data collection for host group with ID "2" and with problem tags **service:mysqld** and **error**. It must be active from 22.01.2013 till 22.01.2014, come in effect each Sunday at 18:00 and last for one hour.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "maintenance.create",     "params": {         "name": "Sunday maintenance",         "active_since": 1358844540,         "active_till": 1390466940,         "tags_evaltype": 0,         "groups": [             {"groupid": "2"}         ],         "timeperiods": [             {                 "period": 3600,                 "timeperiod_type": 3,                 "start_time": 64800,                 "every": 1,                 "dayofweek": 64             }         ],         "tags": [             {                 "tag": "service",                 "operator": "0",                 "value": "mysqld"             },             {                 "tag": "error",                 "operator": "2",                 "value": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```
ca	#### Crear un manteniment  Crea un manteniment amb un recull de dades per al grup d'equips amb ID "2" i amb els tags de problema **service:mysqld** i **error**. Ha d'ésser actiu des de 22.01.2013 fins a 22.01.2014, entrar en vigor cada diumenge a les 6 de la tarda i durar una hora.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "maintenance.create",     "params": {         "name": "Sunday maintenance",         "active_since": 1358844540,         "active_till": 1390466940,         "tags_evaltype": 0,         "groups": [             {"groupid": "2"}         ],         "timeperiods": [             {                 "period": 3600,                 "timeperiod_type": 3,                 "start_time": 64800,                 "every": 1,                 "dayofweek": 64             }         ],         "tags": [             {                 "tag": "service",                 "operator": "0",                 "value": "mysqld"             },             {                 "tag": "error",                 "operator": "2",                 "value": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "maintenanceids": [             "3"         ]     },     "id": 1 } ```

en-us	#### Creating a map  To create a map, do the following:  -   Go to *Monitoring → Maps* -   Go to the view with all maps -   Click on *Create map*  You can also use the *Clone* button in the configuration form of an existing map to create a new map. This map will have all of the properties of the existing map, including general layout attributes, as well as the elements of the existing map.  The **Map** tab contains general map attributes:  ![](../../../../../assets/en/manual/config/visualization/map_config.png)  All mandatory input fields are marked with a red asterisk.  General map attributes:  |Parameter|Description| |--|--------| |*Owner*|Name of map owner.| |*Name*|Unique map name.| |*Width*|Map width in pixels.| |*Height*|Map height in pixels.| |*Background image*|Use background image:<br>**No image** - no background image (white background)<br>**Image** - selected image to be used as a background image. No scaling is performed. You may use a geographical map or any other image to enhance your map.| |*Automatic icon mapping*|You can set to use an automatic icon mapping, configured in *Administration → General → Icon mapping*. Icon mapping allows mapping certain icons against certain host inventory fields.| |*Icon highlighting*|If you check this box, map elements will receive highlighting.<br>Elements with an active trigger will receive a round background, in the same color as the highest severity trigger. Moreover, a thick green line will be displayed around the circle, if all problems are acknowledged.<br>Elements with "disabled" or "in maintenance" status will get a square background, gray and orange respectively.<br>See also: [Viewing maps](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)| |*Mark elements on trigger status change*|A recent change of trigger status (recent problem or resolution) will be highlighted with markers (inward-pointing red triangles) on the three sides of the element icon that are free of the label. Markers are displayed for 30 minutes.| |*Display problems*|Select how problems are displayed with a map element:<br>**Expand single problem** - if there is only one problem, the problem name is displayed. Otherwise, the total number of problems is displayed.<br>**Number of problems** - the total number of problems is displayed<br>**Number of problems and expand most critical one** - the name of the most critical problem and the total number of problems is displayed.<br>'Most critical' is determined based on problem severity and, if equal, problem event ID (higher ID or later problem displayed first). For a *trigger map element* it is based on problem severity and if equal, trigger position in the trigger list. In case of multiple problems of the same trigger, the most recent one will be displayed.| |*Advanced labels*|If you check this box you will be able to define separate label types for separate element types.| |*Map element label type*|Label type used for map elements:<br>**Label** - map element label<br>**IP address** - IP address<br>**Element name** - element name (for example, host name)<br>**Status only** - status only (OK or PROBLEM)<br>**Nothing** - no labels are displayed| |*Map element label location*|Label location in relation to the map element:<br>**Bottom** - beneath the map element<br>**Left** - to the left<br>**Right** - to the right<br>**Top** - above the map element| |*Problem display*|Display problem count as:<br>**All** - full problem count will be displayed<br>**Separated** - unacknowledged problem count will be displayed separated as a number of the total problem count<br>**Unacknowledged only** - only the unacknowledged problem count will be displayed| |*Minimum trigger severity*|Problems below the selected minimum severity level will not be displayed on the map.<br>For example, with *Warning* selected, changes with *Information* and *Not classified* level triggers will not be reflected in the map.| |*Show suppressed problems*|Mark the checkbox to display problems that would otherwise be suppressed (not shown) because of host maintenance.| |*URLs*|URLs (up to 2048 characters) for each element type can be defined. A label for the URL can also be defined. These will be displayed as links when a user clicks on the element in the map viewing mode.<br>Macros can be used in map URL names and values. For a full list, see [supported macros](/manual/appendix/macros/supported_by_location) and search for 'map URL names and values'.|
ca	#### Crear un mapa  Per crear un mapa, seguiu aquestes passes:  - Aneu a *Monitoratge → Mapes* - Aneu a veure tots els mapes - Feu clic a *Crea un mapa*  També podeu emprar els botons *Clonar* al formulari de configuració del mapa existent per crear un mapa nou. Aquest mapa tindrà totes les propietats del mapa existent, incloent els atributs de disposició generals, així com tots els elements del mapa originals.  La pestanya **Mapa** conté els atributs generals del mapa:  ![](../../../../../assets/en/manual/config/visualization/map_config.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Atributs generals del mapa:  |Paràmetre|Descripció| |--|---------| |*Propietari*|Nom del propietari de la tarja.| |*Nom*|Nom únic del mapa.| |*Amplada*|Amplada del mapa en píxels.| |*Alçada*|Alçada del mapa en píxels.| |*Imatge de fons*|Empra la imatge de fons:<br>**Sense imatge** - sense imatge de fons (fons blanc)<br>**Imatge** - imatge seleccionada per emprar-la com a imatge de fons. No es fa cap escalat. Podeu emprar un mapa o qualsevol altra imatge per millorar el vostre mapa.| |*Mapatge automàtic d'icones*|Podeu configurar l'ús de l'assignació automàtica d'icones, configurat a *Administració → General → Mapatge d'icones*. L'assignació d'icones permet assignar certes icones a determinats camps d'inventari de l'equip.| |*Icona destacada*|Si marqueu aquesta casella, els elements del mapa es ressaltaran.<br>Els elements amb un trigger actiu rebran un fons rodó, del mateix color que el trigger de més gravetat. A més, es mostrarà una línia verda gruixuda al voltant del cercle, si es reconeixen tots els problemes.<br>Els elements amb estat "desactivat" o "en manteniment" tindran un fons quadrat, gris i carbassa respectivament.<br>Veieu també: [visualització de mapes](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps)| |*Marca els elements al canvi d'estat de trigger*|Un canvi d'estat de trigger recent (problema o resolució recent) es ressaltarà amb marcadors (triangles vermells cap a dins) als tres costats de la icona de l'element que no contenen l'etiqueta. Els marcadors es mostren durant 30 minuts.| |*Veure problemes*|Seleccioneu com es mostren els problemes amb un element del mapa:<br>**Detalleu el problema únic** - si només hi ha un problema, el nom del problema s'adjunta. En cas contrari, es mostra el nombre total de problemes.<br>**Nombre de problemes** - es mostra el nombre total de problemes<br>**Nombre de problemes i detall més crític** -: el nom del problema més crític i es mostra el nombre total de problemes.<br>El "Més crític" es determina en funció de la gravetat del problema i, si és igual, de l'identificador d'esdeveniment del problema (l'identificador superior o el problema es mostra més tard primer). Per a un *element del mapa trigger*, es basa en la gravetat del problema i, si és igual, la posició del trigger a la llista de trigger. En cas de diversos problemes del mateix trigger, es mostrarà el més recent.| |*Etiquetes avançades*|Si marqueu aquesta casella, podreu definir tipus d'etiquetes separats per a tipus d'elements separats.| |*Tipus d'etiqueta d'element del mapa*|Tipus d'etiqueta emprat per als elements del mapa:<br>**Etiqueta** - etiqueta de l'element del mapa<br>**Adreça IP** - Adreça IP<br>**Nom de l'element** - nom de l'element (p. ex., nom d'equip)<br>**Només estat** - només estat (BÉ o PROBLEMA)<br>** Res** - no es mostra cap etiqueta| |*Ubicació de l'etiqueta de l'element del mapa*|Ubicació de l'etiqueta en relació amb l'element del mapa:<br>**Sota** - a sota de l'element del mapa<br>**Esquerra** - esquerra<br>**Dreta** - dreta< br>**Sobre** - a sobre de l'element del mapa| |*Visualització del problema*|Mostra el nombre de problemes com a:<br>**Tots** - es mostrarà el nombre total de problemes<br>**Separats** - el nombre de problemes no reconeguts es mostrarà separat com un recompte del nombre total de problemes <br>**Només no reconegut** - només es mostrarà el nombre de problemes no reconeguts| |*Gravetat mínima del trigger*|Els problemes per sota del nivell de gravetat mínima triada no es mostraran al mapa.<br>Per exemple, amb *Avís* triat, els canvis amb *Informació* i *Triggers de nivell no classificat* no es reflectiran al mapa.| |*Veure els problemes esborrats*|Marqueu la casella per mostrar els problemes que, d'altra manera, s'esborrarien (no es mostren) a causa del manteniment d'equip.| |*URLs*|Es poden definir URL per a cada tipus d'element (amb una etiqueta). Aquests es mostraran com a enllaços quan un usuari faci clic a l'element en mode de visualització de mapa.<br>Les macros es poden emprar en els noms i els valors d'URL del mapa. Per obtindre una llista completa, veieu [macros compatibles](/manual/appendix/macros/supported_by_location) i cerqueu ' noms i valors d'URL del mapa' .|

en-us	#### Creating an email media type  Create a new email media type with a custom SMTP port and message templates.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "0",         "name": "Email",         "smtp_server": "mail.example.com",         "smtp_helo": "example.com",         "smtp_email": "zabbix@example.com",         "smtp_port": "587",         "message_format": "1",         "message_templates": [             {                 "eventsource": "0",                 "recovery": "0",                 "subject": "Problem: {EVENT.NAME}",                 "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}."             },             {                 "eventsource": "0",                 "recovery": "1",                 "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}",                 "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}."             },             {                 "eventsource": "0",                 "recovery": "2",                 "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}",                 "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}."             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "7"         ]     },     "id": 1 } ```
ca	#### Crear un nou tipus de suport correu-e  Crear un nou tipus de suport correu-e amb un port SMTP a mida i els models de missatge.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "mediatype.create",     "params": {         "type": "0",         "name": "Email",         "smtp_server": "mail.example.com",         "smtp_helo": "example.com",         "smtp_email": "zabbix@example.com",         "smtp_port": "587",         "message_format": "1",         "message_templates": [             {                 "eventsource": "0",                 "recovery": "0",                 "subject": "Problem: {EVENT.NAME}",                 "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}."             },             {                 "eventsource": "0",                 "recovery": "1",                 "subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}",                 "message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}."             },             {                 "eventsource": "0",                 "recovery": "2",                 "subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}",                 "message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}."             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "mediatypeids": [             "7"         ]     },     "id": 1 } ```

en-us	#### Creating a new global regular expression.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "regexp.create",     "params": {       "name": "Storage devices for SNMP discovery",       "test_string": "/boot",       "expressions": [         {           "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$",           "expression_type": "4",           "case_sensitive": "1"         }       ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "regexpids": [             "16"         ]     },     "id": 1 } ```
ca	#### Crear una nova expressió regular global.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "regexp.create",     "params": {       "name": "Dispositius d'emmagatzematge per descoberta SNMP",       "test_string": "/boot",       "expressions": [         {           "expression": "^(Physical memory|Virtual memory|Memory buffers|Cached memory|Swap space)$",           "expression_type": "4",           "case_sensitive": "1"         }       ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "regexpids": [             "16"         ]     },     "id": 1 } ```

en-us	#### Creating a new item  Now, create a new [item](/manual/api/reference/item/object) on the host "Zabbix server" using the data you have obtained from the previous `host.get` request. This can be done using the [item.create](/manual/api/reference/item/create) method:  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"item.create","params":{"name":"Free disk space on /home/joe/","key_":"vfs.fs.size[/home/joe/,free]","hostid":"10084","type":0,"value_type":3,"interfaceid":"1","delay":30},"id":3}' ```  A successful response will contain the ID of the newly created item, which can be used to reference the item in the following requests:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 3 } ```  ::: notetip The `item.create` method as well as other *create methods* can also accept arrays of objects and create multiple items with one API call. :::
ca	#### Creació d'un element nou  Creem un nou [element](/manual/api/reference/item/object) a l'equip "Servidor Zabbix" emprant les dades que vam obtindre de la petició `host.get` anterior. Això es pot fer mitjançant el mètode [item.create](/manual/api/reference/item/create):  ```bash curl --request POST \ --url 'https://example.com/zabbix/api_jsonrpc.php' \ --header 'Authorization: Bearer ${AUTHORIZATION_TOKEN}' \ --header 'Content-Type: application/json-rpc' \ --data '{"jsonrpc":"2.0","method":"item.create","params":{"name":"Free disk space on /home/joe/","key_":"vfs.fs.size[/home/joe/,free]","hostid":"10084","type":0,"value_type":3,"interfaceid":"1","delay":30},"id":3}' ```  Una resposta correcta contindrà l'ID de l'element que s'acaba de crear, que es pot emprar per fer referència a l'element en peticions posteriors:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24759"         ]     },     "id": 3 } ```  ::: notetip El mètode `item.create` i altres mètodes de creació també poden admetre matrius d'objectes i crear diversos elements amb una única crida a l'API. :::

en-us	#### Creating an item  Create a numeric Zabbix agent item with 2 item tags to monitor free disk space on host with ID "30074".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Free disk space on /home/joe/",         "key_": "vfs.fs.size[/home/joe/,free]",         "hostid": "30074",         "type": 0,         "value_type": 3,         "interfaceid": "30084",         "tags": [             {                 "tag": "Disk usage"             },             {                 "tag": "Equipment",                 "value": "Workstation"             }         ],         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24758"         ]     },     "id": 1 } ```
ca	#### Crear un element  Crear un element d'agent Zabbix numèric amb dues etiquetes d'element per monitorar l'espai en disc lliure de l'equip amb ID "30074".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Free disk space on /home/joe/",         "key_": "vfs.fs.size[/home/joe/,free]",         "hostid": "30074",         "type": 0,         "value_type": 3,         "interfaceid": "30084",         "tags": [             {                 "tag": "Disc usage"             },             {                 "tag": "Equipment",                 "value": "Workstation"             }         ],         "delay": "30s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "24758"         ]     },     "id": 1 } ```

en-us	#### Creating an item prototype  Create an item prototype to monitor free disk space on a discovered file system. Discovered items should be numeric Zabbix agent items updated every 30 seconds.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Free disk space on {#FSNAME}",         "key_": "vfs.fs.size[{#FSNAME},free]",         "hostid": "10197",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27666"         ]     },     "id": 1 } ```
ca	#### Crear un prototip d'element  Crear un prototip d'element per monitorar l'espai lliure de disc d'un sistema d'arxius descobert. Els elements trobats han de tindre els elements numèrics de l'agent de Zabbix actualitzats cada 30 segons.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Free disk space on {#FSNAME}",         "key_": "vfs.fs.size[{#FSNAME},free]",         "hostid": "10197",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27666"         ]     },     "id": 1 } ```

en-us	#### Creating an item prototype with preprocessing  Create an item using change per second and a custom multiplier as a second step.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Incoming network traffic on {#IFNAME}",         "key_": "net.if.in[{#IFNAME}]",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "units": "bps",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 10,                 "params": "",                 "error_handler": 0,                 "error_handler_params": ""             },             {                 "type": 1,                 "params": "8",                 "error_handler": 2,                 "error_handler_params": "10"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```
ca	#### Crear un prototip d'elememt amb preprocessament  Crear un element emprant el canvi per segon i un multiplicador a mida com a segona passa.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "itemprototype.create",     "params": {         "name": "Incoming network traffic on {#IFNAME}",         "key_": "net.if.in[{#IFNAME}]",         "hostid": "10001",         "ruleid": "27665",         "type": 0,         "value_type": 3,         "delay": "60s",         "units": "bps",         "interfaceid": "1155",         "preprocessing": [             {                 "type": 10,                 "params": "",                 "error_handler": 0,                 "error_handler_params": ""             },             {                 "type": 1,                 "params": "8",                 "error_handler": 2,                 "error_handler_params": "10"             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44211"         ]     },     "id": 1 } ```

en-us	#### Creating an item with preprocessing  Create an item using custom multiplier.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Device uptime",         "key_": "sysUpTime",         "hostid": "11312",         "type": 4,         "snmp_oid": "SNMPv2-MIB::sysUpTime.0",         "value_type": 1,         "delay": "60s",         "units": "uptime",         "interfaceid": "1156",         "preprocessing": [             {                 "type": 1,                 "params": "0.01",                 "error_handler": 1,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44210"         ]     },     "id": 1 } ```
ca	#### Crear un element nou amb preprocessament  Crear un element emprant un multiplicador a mida.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "item.create",     "params": {         "name": "Device uptime",         "key_": "sysUpTime",         "hostid": "11312",         "type": 4,         "snmp_oid": "SNMPv2-MIB::sysUpTime.0",         "value_type": 1,         "delay": "60s",         "units": "uptime",         "interfaceid": "1156",         "preprocessing": [             {                 "type": 1,                 "params": "0.01",                 "error_handler": 1,                 "error_handler_params": ""             }         ]     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "44210"         ]     },     "id": 1 } ```

en-us	#### Creating an LLD rule  Create a Zabbix agent LLD rule to discover mounted file systems. Discovered items will be updated every 30 seconds.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Mounted filesystem discovery",         "key_": "vfs.fs.discovery",         "hostid": "10197",         "type": 0,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```
ca	#### Crear una regla LLD  Crear una regla de descoberta de baix nivell per descobrir els sistemes d'arxius muntats. Els objectes descoberts seran actualitzats cada 30 segons.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "discoveryrule.create",     "params": {         "name": "Descoberta de sistemes d'arxius muntats",         "key_": "vfs.fs.discovery",         "hostid": "10197",         "type": 0,         "interfaceid": "112",         "delay": "30s"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "27665"         ]     },     "id": 1 } ```

en-us	#### Creating an SLA  Instruct to create an SLA entry for: * tracking uptime for SQL-engine related services; * custom schedule of all weekdays excluding last hour on Saturday; * an effective date of the last day of the year 2022; * with 1 hour and 15 minutes long planned downtime starting at midnight on the 4th of July; * SLA weekly report calculation will be on; * the minimum acceptable SLO will be 99.9995%.
ca	#### Creació d'un SLA  Cal crear una entrada d'SLA: * per fer un seguiment de la disponibilitat de serveis relacionats amb el motor SQL; * amb horari personalitzat tots els dies de la setmana excepte la darrera hora de dissabte; * amb data efectiva el darrer dia de l'any 2022; * amb 1 hora i 15 minuts d'inactivitat programada a partir de la mitjanit del 4 de juliol; * S'habilitarà el càlcul setmanal d'informes de SLA; * SLO mínim acceptable serà del 99,9995%.

en-us	 ##### Creating application  1\. Log into your account at [Microsoft Azure](https://portal.azure.com). For testing purposes, you may create a free trial account in Microsoft Azure.  2\. From the main menu (see top left of the screen) select *Azure Active Directory*.  3\. Select *Enterprise applications* -> *Add new application* -> *Create your own application*.  4\. Add the name of your app and select the *Integrate any other application...* option. After that, click on *Create*.  ![](../../../../assets/en/manual/appendix/install/azure_create_app.png){width="600"}
ca	 ##### Crear aplicació  1\. Inicieu sessió al vostre compte de [Microsoft Azure](https://portal.azure.com). Amb finalitats de prova, podeu crear un compte de prova de franc a Microsoft Azure.  2\. Al menú principal (veieu la part superior esquerra de la pantalla) trieu *Azure Active Directory*.  3\. Trieu *Aplicacions empresarials* -> *Afegir una aplicació nova* -> *Creeu la vostra pròpia aplicació*.  4\. Afegiu el nom de la vostra aplicació i trieu l'opció *Integra qualsevol altra aplicació...*. Després d'això, feu clic a *Crear*.  ![](../../../../assets/en/manual/appendix/install/azure_create_app.png){width="600"}

en-us	 ##### Creating application  1\. Log into your account at OneLogin. For testing purposes, you may create a free developer account in OneLogin.  2\. In the OneLogin web interface navigate to *Applications → Applications*.  3\. Click on "Add App" and search for the appropriate app. The guidelines in this page are based on the *SCIM Provisioner with SAML (SCIM v2 Enterprise, full SAML)* app example.  4\. To begin with, you may want to customize the display name of your app. You may also want to add the icon and app details. After that, click on *Save*.
ca	 ##### Crear una aplicació  1\. Inicieu sessió al vostre compte a OneLogin. Amb finalitats de prova, podeu crear un compte de desenvolupador gratuït a OneLogin.  2\. A la interfície web de OneLogin, navegueu a *Aplicacions → Aplicacions*.  3\. Feu clic a "Afegir aplicació" i cerqueu l'aplicació adequada. Les directrius d'aquesta pàgina es basen en l'exemple de l'aplicació *SCIM Provisioner amb SAML (SCIM v2 Enterprise, SAML complet)*.  4\. Per començar, és possible que vulgueu personalitzar el nom de visualització de la vostra aplicació. També podeu afegir la icona i els detalls de l'aplicació. Després d'això, feu clic a *Desar*.

en-us	#### Creating a proxy and adding it to a proxy group  Create an active proxy "Active proxy" and add it to proxy group with ID "1".  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "name": "Active proxy",         "proxy_groupid": "1",         "operating_mode": "0"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "5"         ]     },     "id": 1 } ```
ca	#### Crear un proxy i afegir-lo a un grup de proxys  Crear un proxy actiu "Proxy actiu" i afegir-lo al grup de proxys amb ID "1".  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "proxy.create",     "params": {         "name": "Proxy actiu",         "proxy_groupid": "1",         "operating_mode": "0"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "proxyids": [             "5"         ]     },     "id": 1 } ```