en-us	#### Configuring certificate-based encryption for Zabbix agent  1\. Prepare files with top-level CA certificates, agent certificate (chain) and private key as described in [Configuring certificate on Zabbix server](/manual/encryption/using_certificates#configuring_certificate_on_zabbix_server). Edit parameters `TLSCAFile`, `TLSCertFile`, `TLSKeyFile` in agent configuration accordingly.  2\. For active checks edit `TLSConnect` parameter:      TLSConnect=cert  For passive checks edit `TLSAccept` parameter:      TLSAccept=cert  3\. Now you have a minimal certificate-based agent configuration. You may prefer to improve agent security by setting `TLSServerCertIssuer` and `TLSServerCertSubject` parameters. (see [Restricting allowed certificate Issuer and Subject](/manual/encryption/using_certificates#restricting_allowed_certificate_issuer_and_subject)).  4\. In final agent configuration file TLS parameters may look like:      TLSConnect=cert     TLSAccept=cert     TLSCAFile=/home/zabbix/zabbix_ca_file     TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     TLSServerCertSubject=CN=Zabbix proxy,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     TLSCertFile=/home/zabbix/zabbix_agentd.crt     TLSKeyFile=/home/zabbix/zabbix_agentd.key  (Example assumes that host is monitored via proxy, hence proxy certificate Subject.)  5\. Configure encryption for this agent in Zabbix frontend:  -   Go to: *Data collection → Hosts* -   Select host and click on **Encryption** tab  In example below Issuer and Subject fields are filled in - see [Restricting allowed certificate Issuer and Subject](/manual/encryption/using_certificates#restricting_allowed_certificate_issuer_and_subject) why and how to use these fields.  ![agent\_config.png](../../../assets/en/manual/encryption/agent_config.png)
ca	#### Configuració del xifrat del certificat per a l'agent Zabbix  1\. Prepareu fitxers amb certificats de CA de nivell superior, certificat d'agent (cadena) i clau privada tal com es descriu a la [configuració del certificat al servidor Zabbix](/manual/encryption/using_certificates#configuring_certificate_on_zabbix_server). Modifiqueu els paràmetres `TLSCAFile`, `TLSCertFile`, `TLSKeyFile` a la configuració de l'agent en conseqüència.  2\. Per al monitoratge actiu, modifiqueu el paràmetre `TLSConnect`:       TLSConnect=cert  Per al monitoratge passiu, modifiqueu el paràmetre `TLSAccept`:       TLSAccept=cert  3\. Ara teniu una configuració mínima d'agent basada en certificats. Opcionalment, podeu millorar la seguretat de l'agent configurant els paràmetres `TLSServerCertIssuer' i `TLSServerCertSubject` (veieu [Restricció de l'emissor i del assumpte permesos](/manual/encryption/using_certificates#restriting_allowed_certificate_issuer_and_subject)).  4\. Al fitxer de configuració de l'agent final, la configuració de TLS podria assemblar-se a:       TLSConnect=cert      TLSAccept=cert      TLSCAFile=/home/zabbix/zabbix_ca_file      TLSServerCertIssuer=CN=Signing CA,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com      TLSServerCertSubject=CN=Proxy Zabbix,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com      TLSCertFile=/home/zabbix/zabbix_agentd.crt      TLSKeyFile=/home/zabbix/zabbix_agentd.key  (L'exemple suposa que l'equip s'és monitorant a través d'un proxy, per tant, el CN ​​"subjecte" del certificat s'estableix com a proxy Zabbix).  5\. Configureu el xifrat per a aquest agent a la interfície Zabbix:  - Aneu a: *Recull de dades → Equips* - Trieu l'equip i feu clic a la pestanya **Xifrat**  A l'exemple següent, s'emplenen els camps Emissor i Assumpte; veieu a [restricció de l'emissor i l'assumpte permesos](/manual/encryption/using_certificates#restriting_allowed_certificate_issuer_and_subject) per què i com emprar aquests camps.  ![agent\_config.png](../../../assets/en/manual/encryption/agent_config.png)

en-us	#### Configuring certificate-based encryption for Zabbix proxy  1\. Prepare files with top-level CA certificates, proxy certificate (chain) and private key as described in [Configuring certificate on Zabbix server](/manual/encryption/using_certificates#configuring_certificate_on_zabbix_server). Edit parameters `TLSCAFile`, `TLSCertFile`, `TLSKeyFile` in proxy configuration accordingly.  2\. For active proxy edit `TLSConnect` parameter:      TLSConnect=cert  For passive proxy edit `TLSAccept` parameter:      TLSAccept=cert  3\. Now you have a minimal certificate-based proxy configuration. You may prefer to improve proxy security by setting `TLSServerCertIssuer` and `TLSServerCertSubject` parameters (see [Restricting allowed certificate Issuer and Subject](/manual/encryption/using_certificates#restricting_allowed_certificate_issuer_and_subject)).  4\. In final proxy configuration file TLS parameters may look like:      TLSConnect=cert     TLSAccept=cert     TLSCAFile=/home/zabbix/zabbix_ca_file     TLSServerCertIssuer=CN=Signing CA,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     TLSServerCertSubject=CN=Zabbix server,OU=Development group,O=Zabbix SIA,DC=zabbix,DC=com     TLSCertFile=/home/zabbix/zabbix_proxy.crt     TLSKeyFile=/home/zabbix/zabbix_proxy.key  5\. Configure encryption for this proxy in Zabbix frontend:  -   Go to: *Administration → Proxies* -   Select proxy and click on **Encryption** tab  In examples below Issuer and Subject fields are filled in - see [Restricting allowed certificate Issuer and Subject](/manual/encryption/using_certificates#restricting_allowed_certificate_issuer_and_subject) why and how to use these fields.  For active proxy  ![proxy\_active\_cert.png](../../../assets/en/manual/encryption/proxy_active_cert.png)  For passive proxy  ![proxy\_passive\_cert.png](../../../assets/en/manual/encryption/proxy_passive_cert.png)
ca	#### Configuració del xifrat per certificat per al proxy Zabbix  1\. Prepareu fitxers amb certificats de CA de primer nivell, certificat de proxy (cadena) i clau privada tal com es descriu a [Configuració del certificat al servidor Zabbix](/manual/encryption/using_certificates#configuring_certificate_on_zabbix_server). Modifiqueu els paràmetres `TLSCAFile`, `TLSCertFile`, `TLSKeyFile` a la configuració del proxy en conseqüència.  2\. Per a un proxy actiu, modifiqueu el paràmetre `TLSConnect`:       TLSConnect=cert  Per a un proxy passiu, modifiqueu el paràmetre `TLSAccept`:       TLSAccept=cert  3\. Ara teniu una configuració mínima de proxy basada en certificats. Opcionalment, podeu millorar la seguretat del proxy configurant els paràmetres `TLSServerCertIssuer` i `TLSServerCertSubject` (veieu [restriccions de l'emissor i del subjecte permesos](/manual/encryption/using_certificates#restriting_allowed_certificate_issuer_and_subject)).  4\. Al fitxer de configuració del proxy final, la configuració de TLS podria semblar així:       TLSConnect=cert      TLSAccept=cert      TLSCAFile=/home/zabbix/zabbix_ca_file      TLSServerCertIssuer=CN=Signing CA,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com      TLSServerCertSubject=CN=Servidor Zabbix,OU=Grup de desenvolupament,O=Zabbix SIA,DC=zabbix,DC=com      TLSCertFile=/home/zabbix/zabbix_proxy.crt      TLSKeyFile=/home/zabbix/zabbix_proxy.key  5\. Configureu el xifrat per a aquest proxy a la interfície Zabbix:  - Aneu a: *Administració → Proxys* - Trieu un proxy i feu clic a la pestanya **Xifrat**  En els exemples següents, s'emplenen els camps Emissor i Assumpte; veieu a [restricció d'emissor i subjecte permesos](/manual/encryption/using_certificates#restriting_allowed_certificate_issuer_and_subject) per què i com emprar aquests camps.  Per a un proxy actiu  ![proxy\_active\_cert.png](../../../assets/en/manual/encryption/proxy_active_cert.png)  Per a un proxy passiu  ![proxy\_passive\_cert.png](../../../assets/en/manual/encryption/proxy_passive_cert.png)

en-us	#### Configuring certificate on Zabbix server  1\. In order to verify peer certificates, Zabbix server must have access to file with their top-level self-signed root CA certificates. For example, if we expect certificates from two independent root CAs, we can put their certificates into file `/home/zabbix/zabbix_ca_file` like this:      Certificate:         Data:             Version: 3 (0x2)             Serial Number: 1 (0x1)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA                 ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                 ...             X509v3 extensions:                 X509v3 Key Usage: critical                     Certificate Sign, CRL Sign                 X509v3 Basic Constraints: critical                     CA:TRUE                 ...     -----BEGIN CERTIFICATE-----     MIID2jCCAsKgAwIBAgIBATANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB     ....     9wEzdN8uTrqoyU78gi12npLj08LegRKjb5hFTVmO     -----END CERTIFICATE-----     Certificate:         Data:             Version: 3 (0x2)             Serial Number: 1 (0x1)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA                 ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                 ....             X509v3 extensions:                 X509v3 Key Usage: critical                     Certificate Sign, CRL Sign                 X509v3 Basic Constraints: critical                     CA:TRUE                 ....            -----BEGIN CERTIFICATE-----     MIID3DCCAsSgAwIBAgIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQB     ...     vdGNYoSfvu41GQAR5Vj5FnRJRzv5XQOZ3B6894GY1zY=     -----END CERTIFICATE-----  2\. Put Zabbix server certificate chain into file, for example, `/home/zabbix/zabbix_server.crt`:      Certificate:         Data:             Version: 3 (0x2)             Serial Number: 1 (0x1)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA             ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix server             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                     ...             X509v3 extensions:                 X509v3 Key Usage: critical                     Digital Signature, Key Encipherment                 X509v3 Basic Constraints:                      CA:FALSE                 ...     -----BEGIN CERTIFICATE-----     MIIECDCCAvCgAwIBAgIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixk     ...     h02u1GHiy46GI+xfR3LsPwFKlkTaaLaL/6aaoQ==     -----END CERTIFICATE-----     Certificate:         Data:             Version: 3 (0x2)             Serial Number: 2 (0x2)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA             ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                 ...             X509v3 extensions:                 X509v3 Key Usage: critical                     Certificate Sign, CRL Sign                 X509v3 Basic Constraints: critical                     CA:TRUE, pathlen:0             ...     -----BEGIN CERTIFICATE-----     MIID4TCCAsmgAwIBAgIBAjANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB     ...     dyCeWnvL7u5sd6ffo8iRny0QzbHKmQt/wUtcVIvWXdMIFJM0Hw==     -----END CERTIFICATE-----  Here the first is Zabbix server certificate, followed by intermediate CA certificate.  :::noteclassic Use of any attributes except of the ones mentioned above is discouraged for both client and server certificates, because it may affect certificate verification process. For example, OpenSSL might fail to establish encrypted connection if *X509v3 Extended Key Usage* or *Netscape Cert Type* are set. See also: [Limitations on using X.509 v3 certificate extensions](/manual/encryption/using_certificates#limitations_on_using_x509_v3_certificate_extensions). :::  3\. Put Zabbix server private key into file, for example, `/home/zabbix/zabbix_server.key`:      -----BEGIN PRIVATE KEY-----     MIIEwAIBADANBgkqhkiG9w0BAQEFAASCBKowggSmAgEAAoIBAQC9tIXIJoVnNXDl     ...     IJLkhbybBYEf47MLhffWa7XvZTY=     -----END PRIVATE KEY-----  4\. Edit TLS parameters in Zabbix server configuration file like this:      TLSCAFile=/home/zabbix/zabbix_ca_file     TLSCertFile=/home/zabbix/zabbix_server.crt     TLSKeyFile=/home/zabbix/zabbix_server.key
ca	#### Configurant un certificat al servidor Zabbix  1\. Per tal de verificar els certificats dels parells, el servidor Zabbix ha de tindre accés al fitxer amb els seus certificats de CA arrel autosignats de primer nivell. Per exemple, si esperem certificats de dues CA arrel independents, podem posar els seus certificats al fitxer `/home/zabbix/zabbix_ca_file`:      Certificate:         Data:             Version: 3 (0x2)             Serial Number: 1 (0x1)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA                 ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                 ...             X509v3 extensions:                 X509v3 Key Usage: critical                     Certificate Sign, CRL Sign                 X509v3 Basic Constraints: critical                     CA:TRUE                 ...     -----BEGIN CERTIFICATE-----     MIID2jCCAsKgAwIBAgIBATANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB     ....     9wEzdN8uTrqoyU78gi12npLj08LegRKjb5hFTVmO     -----END CERTIFICATE-----     Certificate:         Data:             Version: 3 (0x2)             Serial Number: 1 (0x1)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA                 ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root2 CA             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                 ....             X509v3 extensions:                 X509v3 Key Usage: critical                     Certificate Sign, CRL Sign                 X509v3 Basic Constraints: critical                     CA:TRUE                 ....            -----BEGIN CERTIFICATE-----     MIID3DCCAsSgAwIBAgIBATANBgkqhkiG9w0BAQUFADB/MRMwEQYKCZImiZPyLGQB     ...     vdGNYoSfvu41GQAR5Vj5FnRJRzv5XQOZ3B6894GY1zY=     -----END CERTIFICATE-----  2\. Poseu la cadena de certificats del servidor Zabbix a un arxiu, com ara `/home/zabbix/zabbix_server.crt`:      Certificate:         Data:             Version: 3 (0x2)             Serial Number: 1 (0x1)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA             ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Zabbix server             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                     ...             X509v3 extensions:                 X509v3 Key Usage: critical                     Digital Signature, Key Encipherment                 X509v3 Basic Constraints:                      CA:FALSE                 ...     -----BEGIN CERTIFICATE-----     MIIECDCCAvCgAwIBAgIBATANBgkqhkiG9w0BAQUFADCBgTETMBEGCgmSJomT8ixk     ...     h02u1GHiy46GI+xfR3LsPwFKlkTaaLaL/6aaoQ==     -----END CERTIFICATE-----     Certificate:         Data:             Version: 3 (0x2)             Serial Number: 2 (0x2)         Signature Algorithm: sha1WithRSAEncryption             Issuer: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Root1 CA             ...             Subject: DC=com, DC=zabbix, O=Zabbix SIA, OU=Development group, CN=Signing CA             Subject Public Key Info:                 Public Key Algorithm: rsaEncryption                     Public-Key: (2048 bit)                 ...             X509v3 extensions:                 X509v3 Key Usage: critical                     Certificate Sign, CRL Sign                 X509v3 Basic Constraints: critical                     CA:TRUE, pathlen:0             ...     -----BEGIN CERTIFICATE-----     MIID4TCCAsmgAwIBAgIBAjANBgkqhkiG9w0BAQUFADB+MRMwEQYKCZImiZPyLGQB     ...     dyCeWnvL7u5sd6ffo8iRny0QzbHKmQt/wUtcVIvWXdMIFJM0Hw==     -----END CERTIFICATE-----  Aquí el primer és el certificat del servidor Zabbix, seguit del certificat de la CA intermitja.  :::noteclassic Es desaconsella l'ús de qualsevol atribut, excepte els esmentats anteriorment, tant per als certificats de client com de servidor, perquè pot afectar el procés de verificació del certificat. Per exemple, l'OpenSSL pot no establir una connexió xifrada si s'estableix *X509v3 Extended Key Usage* o *Netscape Cert Type*. Veieu també: [Limitacions en l'ús de les extensions de certificat X.509 v3](/manual/encryption/using_certificates#limitations_on_using_x509_v3_certificate_extensions). :::  3\. Poseu la clau privada del servidor Zabbix a un arxiu, com ara `/home/zabbix/zabbix_server.key`:      -----BEGIN PRIVATE KEY-----     MIIEwAIBADANBgkqhkiG9w0BAQEFAASCBKowggSmAgEAAoIBAQC9tIXIJoVnNXDl     ...     IJLkhbybBYEf47MLhffWa7XvZTY=     -----END PRIVATE KEY-----  4\. Editeu els paràmetres TLS a l'arxiu de configuració del servidor Zabbix, amb aquest valors:      TLSCAFile=/home/zabbix/zabbix_ca_file     TLSCertFile=/home/zabbix/zabbix_server.crt     TLSKeyFile=/home/zabbix/zabbix_server.key

en-us	#### Configuring custom graphs  To create a custom graph, do the following:  -   Go to *Data collection → Hosts (or Templates)* -   Click on *Graphs* in the row next to the desired host or template -   In the Graphs screen click on *Create graph* -   Edit graph attributes  ![](../../../../../assets/en/manual/config/visualization/graph2.png){width="600"}  All mandatory input fields are marked with a red asterisk.  Graph attributes:  |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Unique graph name.<br>Expression [macros](/manual/appendix/macros/supported_by_location) are supported in this field, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).<br>{HOST.HOST<1-9>} macros are supported for the use within this macro, referencing the first, second, third, etc. host in the graph, for example `{?avg(/{HOST.HOST2}/key,1h)}`. Note that referencing the first host with this macro is redundant, as the first host can be referenced implicitly, for example `{?avg(//key,1h)}`.| |*Width*|<|Graph width in pixels (for preview and pie/exploded graphs only).| |*Height*|<|Graph height in pixels.| |*Graph type*|<|Graph type:<br>**Normal** - normal graph, values displayed as lines<br>**Stacked** - stacked graph, filled areas displayed<br>**Pie** - pie graph<br>**Exploded** - "exploded" pie graph, portions displayed as "cut out" of the pie| |*Show legend*|<|Checking this box will set to display the graph legend.| |*Show working time*|<|If selected, non-working hours will be shown with a gray background. This parameter is not available for pie and exploded pie graphs.| |*Show triggers*|<|If selected, simple triggers will be displayed as lines with black dashes over trigger severity color. This parameter is not available for pie and exploded pie graphs.| |*Percentile line (left)*|<|Display percentile for left Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright green line. Only available for normal graphs.| |*Percentile line (right)*|<|Display percentile for right Y-axis. If, for example, 95% percentile is set, then the percentile line will be at the level where 95 percent of the values fall under. Displayed as a bright red line. Only available for normal graphs.| |*Y axis MIN value*|<|Minimum value of Y-axis:<br>**Calculated** - Y axis minimum value will be automatically calculated.<br>**Fixed** - fixed minimum value for Y-axis. <br>**Item** - last value of the selected item will be the minimum value.<br><br> This parameter is not available for pie and exploded pie graphs.| |*Y axis MAX value*|<|Maximum value of Y-axis:<br>**Calculated** - Y axis maximum value will be automatically calculated.<br>**Fixed** - fixed maximum value for Y-axis. <br>**Item** - last value of the selected item will be the maximum value<br><br> This parameter is not available for pie and exploded pie graphs.| |*3D view*|<|Enable 3D style. For pie and exploded pie graphs only.| |*Items*|<|Items, data of which are to be displayed in this graph. Click on *Add* to select items. You can also select various displaying options (function, draw style, left/right axis display, color).| |<|*Sort order (0→100)*|Draw order. 0 will be processed first. Can be used to draw lines or regions behind (or in front of) another.<br>You can drag and drop items using the icon at the beginning of a line to set the sort order or which item is displayed in front of the other.| |^|*Name*|Name of the selected item is displayed as a link. Clicking on the link opens the list of other available items.| |^|*Type*|Type (only available for pie and exploded pie graphs):<br>**Simple** - the value of the item is represented proportionally on the pie<br>**Graph sum** - the value of the item represents the whole pie<br>Note that coloring of the "graph sum" item will only be visible to the extent that it is not taken up by "proportional" items.| |^|*Function*|Select what values will be displayed when more than one value exists per vertical graph pixel for an item:<br>**all** - display all possible values (minimum, maximum, average) in the graph. Note that for shorter periods this setting has no effect; only for longer periods, when data congestion in a vertical graph pixel increases, 'all' starts displaying minimum, maximum, and average values. This function is only available for *Normal* graph type. See also: Generating graphs [from history/trends](/manual/config/visualization/graphs/simple#generating_from_historytrends).<br>**avg** - display the average values<br>**last** - display the latest values. This function is only available if either *Pie/Exploded pie* is selected as graph type.<br>**max** - display the maximum values<br>**min** - display the minimum values| |^|*Draw style*|Select the draw style (only available for normal graphs; for stacked graphs filled region is always used) to apply to the item data - *Line*, *Bold line*, *Filled region*, *Dot*, *Dashed line*, *Gradient line*.| |^|*Y axis side*|Select the Y axis side to show the item data - *Left*, *Right*.| |^|*Color*|Select the color to apply to the item data.|
ca	#### Configuració dels gràfics personalitzats  Per crear un gràfic personalitzat, seguiu aquestes passes:  - Aneu a *Recollida de dades → Equips (o plantilles)* - Feu clic a *Gràfics* a la filera al costat de l'equip o model desitjat - A la pantalla Gràfics, feu clic a *Crear un gràfic* - Canviar els atributs del gràfic  ![](../../../../../assets/en/manual/config/visualization/graph2.png){width="600"}  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Atributs del gràfic:  |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom*|<|Nom únic del gràfic.<br>Les expressions [macros](/manual/appendix/macros/supported_by_location) s'admeten en aquest camp, però només amb `avg`, `last`, `min` i ` max`, amb el temps com a paràmetre (p. ex., `{?avg(/host/key,1h)}`).<br>S'admeten macros {HOST.HOST<1-9>} per emprar-les en aquesta macro, referint-se al primer, segon, tercer, etc. equip al gràfic, per exemple `{?avg(/{HOST.HOST2}/key,1h)}`. Tingueu en compte que fer referència al primer equip amb aquesta macro és redundant, ja que el primer equip es pot referenciar implícitament, per exemple, `{?avg(//key,1h)}`.| |*Amplada*|<|L'amplada del gràfic en píxels (només per a la vista prèvia i gràfics circulars/explotats).| |*Alçada*|<|Alçada del gràfic en píxels.| |*Tipus de gràfic*|<|Tipus de gràfic:<br>**Normal** - gràfic normal, els valors es mostren com a línies<br>**Apilat** - gràfic apilat, es mostren àrees plenes<br>**Pastís** - gràfic de sectors<br>**Explotat** - gràfic de sectors "explotat", que mostra les parts com a "retallades" del gràfic | |*Mostra la llegenda*|<|Marcar aquesta casella habilitarà la visualització de la llegenda del gràfic.| |*Mostra l'horari laboral*|<|Si es tria, les hores no laborals es mostraran sobre un fons gris. No disponible per a gràfics de sectors i gràfics de sectors explotats.| |*Mostra els triggers*|<|Si es tria, els triggers simples es mostraran com a línies amb guions negres al color de gravetat del trigger. No disponible per a gràfics de sectors i gràfics de sectors explotats.| |*Línia percentil (esquerra)*|<|Mostra el percentil de l'eix Y esquerre. Si, per exemple, s'estableix un percentil del 95%, la línia del percentil serà al nivell on el 95% dels valors caiguin per sota. Apareix com una línia verda brillant. Només disponible per a gràfics normals.| |*Línia percentil (dreta)*|<|Mostra el percentil de l'eix Y dret. Si, per exemple, s'estableix un percentil del 95%, la línia del percentil serà al nivell on el 95% dels valors caiguin per sota. Apareix com una línia vermella brillant. Només disponible per a gràfics normals.| |*Valor MIN de l'eix Y*|<|Valor mínim de l'eix Y:<br>**Calculat** - el valor mínim de l'eix Y es calcularà automàticament<br>**Fixat** - valor mínim fix per a Y eix. No disponible per als gràfics de sectors i els gràfics de sectors explotats.<br>**Element** - el darrer valor de l'element triat serà el valor mínim | |*Valor màxim de l'eix Y*|<|Valor màxim de l'eix Y:<br>**Calculat** - el valor màxim de l'eix Y es calcularà automàticament<br>**Fixat** - valor màxim fix per a l'eix Y eix. No disponible per a gràfics de sectors i gràfics de sectors explotats.<br>**Item** - el darrer valor de l'element triat serà el valor màxim | |*Vista 3D*|<|Activa l'estil 3D. Només per a gràfics de sectors i gràfics de sectors explotats.| |*Elements*|<|Els elements les dades dels quals s'han de mostrar en aquest gràfic. Feu clic a *Afegir* per triar elements. També podeu triar diferents opcions de visualització (funció, estil de dibuix, visualització de l'eix esquerre/dret, color).| |<|*Ordre d'ordenació (0→100)*|Ordre de dibuix. 0 es processarà primer. Es pot emprar per dibuixar línies o regions darrere (o davant) d'una altra.<br> Podeu arrossegar i deixar anar elements amb la fletxa a l'inici d'una línia per definir l'ordre d'ordenació o quin element es mostra davant de l'altre.| |^|*Nom*|El nom de l'element triat es mostra com a enllaç. En fer clic a l'enllaç s'obre la llista d'altres articles disponibles.| |^|*Tipus*|Tipus (només disponible per a gràfics de sectors i gràfics de sectors explotats):<br>**Simple** - el valor de l'element es representa proporcionalment al gràfic de sectors<br>**Suma del gràfic** - el valor de l'element representa tot el sector<br>Tingueu en compte que la coloració de l'element "suma gràfica" només serà visible en la mesura que no sigui ocupada per elements "proporcionals".| |^|*Funció*|Trieu els valors que es mostraran quan hi hagi més d'un valor per píxel de gràfic vertical per a un element:<br>**Tot** - mostra tots els valors possibles (mínim, màxim, mitjana) al gràfic. Tingueu en compte que durant períodes més llargs, aquest paràmetre no té cap efecte; només durant períodes de temps més llargs, quan augmenta la congestió de dades en un píxel de gràfic vertical, "tot" comença a mostrar valors mínims, màxims i mitjans. Aquesta funció només és disponible per al tipus de gràfic *Normal*. Veieu també: Generació de gràfics [a partir de l'historial/tendències](/manual/config/visualization/graphs/simple#generating_from_historytrends).<br>**mitjana** - mostra els valors mitjans<br>**darrer** - mostra els darrers valors. Aquesta funció només és disponible si se selecciona *Pastís/Explosió* com a tipus de gràfic.<br>**max** - mostra els valors màxims<br>**min** - mostra els valors mínims| |^|*Estil de dibuix*|Seleccioneu l'estil de dibuix (només disponible per a gràfics normals; per a gràfics apilats sempre s'empra l'àrea emplenada) per aplicar-lo a les dades de l'element: *Línia*, *Línia gruixuda*, *Regió completa*, *Punt*, *Línia discontínua*, *Línia i degradat*.| |^|*Cot de l'eix Y*|Seleccioneu el costat de l'eix Y per mostrar les dades de l'element - *Esquerra*, *Dreta*.| |^|*Color*|Seleccioneu el color que voleu aplicar a les dades de l'element.|

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

en-us	#### Configuring JMX interfaces and items in Zabbix frontend  With Java gateway running, server knowing where to find it and a Java application started with support for remote JMX monitoring, it is time to configure the interfaces and items in Zabbix GUI.
ca	#### Configurant les interfícies i els elements JMX a la interficie de Zabbix  Amb el Java gateway executant-se, el servidor que sap on és el gateway i una aplicació de Java engegada amb suport de monitoratge JMX remot, ara podem configurar les interfícies i els elements des de la interfície web de Zabbix.

en-us	##### Configuring JMX interface  You begin by creating a JMX-type interface on the host of interest.\ ![](../../../../../assets/en/manual/config/items/itemtypes/jmx_interface.png){width="600"}  All mandatory input fields are marked with a red asterisk.
ca	##### Configuració de la interfície JMX  Comencem creant una interfície de tipus JMX a l'equip :\![](../../../../../assets/en/manual/config/items/itemtypes/jmx_interface.png){width="600"}  Tots els camps obligatoris són marcats amb un asterisc vermell.

en-us	#### Configuring low-level discovery rules  See the [low-level discovery](/manual/discovery/low_level_discovery) section of the manual.
ca	#### Configuració de les regles de descoberta de baix nivell  Veieu la secció de [descoberta de baix nivell](/manual/discovery/low_level_discovery) del manual.

en-us	### Configuring low-level discovery  We will illustrate low-level discovery based on an example of file system discovery.  To configure the discovery, do the following:  -   Go to: *Data collection* → *Templates* or *Hosts* -   Click on *Discovery* in the row of an appropriate template/host  ![](../../../assets/en/manual/discovery/low_level_discovery/fs_templates.png)  -   Click on *Create discovery rule* in the upper right corner of the     screen -   Fill in the discovery rule form with the required details
ca	### Configuració de la descoberta de baix nivell  Demostrarem la descoberta de baix nivell mitjançant un exemple de descoberta de sistemes de fitxers.  Per configurar la descoberta, seguiu aquestes passes:  - Aneu a: *Recull de dades* → *Plantilles* o *Equips* - Feu clic a *Descoberta* a la línia d'un model/equip adequat.  ![](../../../assets/en/manual/discovery/low_level_discovery/fs_templates.png)  - Feu clic a *Crear una regla de descoberta* a l'extrem superior dret de la pantalla. - Ompliu el formulari de regla de descoberta amb els detalls requerits

en-us	#### Configuring nested templates  To link templates, you need to take an existing template (or create a new one), and then:  1. Open the [template configuration form](/manual/config/templates/template#creating-a-template). 2. Find the *Templates* field. 3. Click on *Select* to open the *Templates* pop-up window. 4. In the pop-up window, choose the required templates, and then click on *Select* to add the templates to the list. 5. Click on *Add* or *Update* in the template configuration form.  Thus, all entities of the configured template, as well as all entities of linked templates will now appear in the template configuration. This includes items, triggers, graphs, low-level discovery rules, and web scenarios, but excludes dashboards.  However, linked template dashboards will, nevertheless, be inherited by hosts.  To unlink any of the linked templates, click on *Unlink* or *Unlink and clear* in the template configuration form, and then click on *Update*.  The *Unlink* option will simply remove the association with the linked template, while not removing any of its entities (items, triggers, etc.).  The *Unlink and clear* option will remove both the association with the linked template, as well as all its entities (items, triggers, etc.).
ca	#### CSobre la configuració de plantilles niuades  Per enllaçar plantilles, heu d'agafar una plantilla existent (o crear-ne una de nova) i després:  1. Obriu el [formulari de configuració de la plantilla](/manual/config/templates/template#creating-a-template). 2. Cerqueu el camp *Plantilles*. 3. Feu clic a *Triar* per obrir la finestra emergent *Plantilles*. 4. A la finestra emergent, trieu les plantilles necessàries i feu clic a *Triar* per afegir les plantilles a la llista. 5. Feu clic a *Afegir* o *Actualitzar* al formulari de configuració de la plantilla.  D'aquesta manera, otes les entitats de la plantilla configurada, així com totes les entitats de les plantilles enllaçades, apareixeran ara a la configuració de la plantilla. Això inclou elements, triggers, gràfics, regles de descoberta de baix nivell i escenaris web, però exclou els taulers de control. Tanmateix, els taulers de control de plantilles enllaçades seran heretats pels equip.  Per desenllaçar qualsevol de les plantilles enllaçades, feu clic a *Desenllaçar* o *Desenllaçar i esborrar* al formulari de configuració de la plantilla i, a continuació, feu clic a *Actualitzar*.  L'opció *Desenllaçar* simplement esborrarà l'associació amb la plantilla enllaçada, sense esborrar cap de les seves entitats (elements, triggers, etc.).  L'opció *Desenllaçar i esborrar* esborrarà tant l'associació amb la plantilla enllaçada, com totes les seves entitats (elements, triggers, etc.).

en-us	##### Configuring Perl trap receiver  Requirements: Perl, Net-SNMP compiled with --enable-embedded-perl (done by default since Net-SNMP 5.4)  A Perl trap receiver (look for misc/snmptrap/zabbix\_trap\_receiver.pl) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it:  -   add the Perl script to the snmptrapd configuration file     (snmptrapd.conf), e.g.:  ```perl perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; ```  -   configure the receiver, e.g:  ```ini $SNMPTrapperFile = '[TRAP FILE]'; $DateTimeFormat = '[DATE TIME FORMAT]'; ```  ::: notetip If the script name is not quoted, snmptrapd will refuse to start up with messages, similar to these:<br><br>  ```yaml Regexp modifiers "/l" and "/a" are mutually exclusive at (eval 2) line 1, at end of line Regexp modifier "/l" may not appear twice at (eval 2) line 1, at end of line ```  :::
ca	##### Configurant el receptor de traps amb Perl  Requisits: Perl, Net-SNMP compilat amb --enable-embedded-perl (fet per defecte des de Net-SNMP 5.4)  Es pot emprar un receptor de traps Perl (cerqueu misc/snmptrap/zabbix\_trap\_receiver.pl) per passar traps al servidor Zabbix directament des d'snmptrapd. Per configurar-lo:  - afegiu l'script Perl al fitxer de configuració snmptrapd (snmptrapd.conf), per exemple:  ```perl perl do "[FULL PATH TO PERL RECEIVER SCRIPT]"; ```  - configureu el receptor, per exemple:  ```ini $SNMPTrapperFile = '[TRAP FILE]'; $DateTimeFormat = '[DATE TIME FORMAT]'; ```  ::: notetip Si no s'anomena l'script, snmptrapd es negarà a començar amb missatges, semblants a aquests:<br><br>  ```yaml Els modificadors d'expressió regular "/l" i "/a" s'exclouen mútuament a (eval 2) la línia 1, al final de la línia El modificador d'expressió regular "/l" pot no aparèixer dues vegades a (eval 2) la línia 1, al final de la línia ``` :::

en-us	#### Configuring plugins  This section provides common plugin configuration principles and best practices.  All plugins are configured using *Plugins.\** parameter, which can either be part of the Zabbix agent 2 [configuration file](/manual/appendix/config/zabbix_agent2) or a plugin's own [configuration file](/manual/appendix/config/zabbix_agent2_plugins). If a plugin uses a separate configuration file, path to this file should be specified in the Include parameter of Zabbix agent 2 configuration file.  A typical plugin parameter has the following structure:  *Plugins.<PluginName>.<Parameter>=<Value>*  Additionally, there are two specific groups of parameters:   -   *Plugins.<PluginName>.Default.<Parameter>=<Value>* used for defining [default parameter values](#default-values).  -   *Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>* used for defining separate sets of parameters for different monitoring targets via [named sessions](#named-sessions).  All parameter names should adhere to the following requirements:  -   it is recommended to capitalize the names of your plugins; -   the parameter should be capitalized; -   special characters are not allowed; -   nesting isn’t limited by a maximum level; -   the number of parameters is not limited.  For example, to perform [active checks](/manual/concepts/agent2#passive-and-active-checks) that do not have *Scheduling* [update interval](/manual/config/items/item/custom_intervals#scheduling-intervals) immediately after the agent restart only for the Uptime plugin, set `Plugins.Uptime.System.ForceActiveChecksOnStart=1` in the [configuration file](/manual/appendix/config/zabbix_agent2). Similarly, to set custom limit for [concurrent checks](/manual/concepts/agent2#check-concurrency) for the CPU plugin, set the `Plugins.CPU.System.Capacity=N` in the [configuration file](/manual/appendix/config/zabbix_agent2).
ca	#### Configurar plugins  Aquesta secció proporciona principis comuns de configuració de connectors i pràctiques recomanades.  Tots els connectors es configuren mitjançant el paràmetre *Plugins.\**, que pot formar part de l'agent de Zabbix 2 [fitxer de configuració](/manual/appendix/config/zabbix_agent2) o del [fitxer de configuració](/manual/appendix) propi d'un connector /config/zabbix_agent2_plugins). Si un connector empra un fitxer de configuració independent, la ruta d'aquest fitxer s'ha d'especificar al paràmetre Include del fitxer de configuració de l'agent Zabbix 2.  Un paràmetre de connector típic té l'estructura següent:  *Plugins.<PluginName>.<Parameter>=<Value>*  A més, hi ha dos grups específics de paràmetres:  - *Plugins.<PluginName>.Default.<Parameter>=<Value>* emprat per definir [valors dels paràmetres per defecte](#default-values).  - *Plugins.<PluginName>.<SessionName>.<Parameter>=<Value>* s'empra per definir conjunts separats de paràmetres per a diferents objectius de monitoratge mitjançant [sessions nomenades](#named-sessions).  Tots els noms de paràmetre han de complir els requisits següents:  - es recomana posar en majúscula els noms dels vostres connectors; - el paràmetre s'ha de posar en majúscula; - No es permeten caràcters especials; - la nidificació no és limitada per un nivell màxim; - el nombre de paràmetres no és limitat.  Per exemple, per fer [comprovacions actives](/manual/concepts/agent2#passive-and-active-checks) que no tinguin *Programació* [interval d'actualització](/manual/config/items/item/custom_intervals#scheduling- intervals) just després de reiniciar l'agent només per al connector Uptime, establiu `Plugins.Uptime.System.ForceActiveChecksOnStart=1` al [fitxer de configuració](/manual/appendix/config/zabbix_agent2). De la mateixa manera, per establir un límit personalitzat per a [comprovacions concurrents](/manual/concepts/agent2#check-concurrency) per al connector de la CPU, establiu `Plugins.CPU.System.Capacity=N` al [fitxer de configuració](/manual/appendix/config/zabbix_agent2).

en-us	#### Configuring PSK for server - active proxy communication (example)  On the proxy, write the PSK value into a file, for example, `/home/zabbix/zabbix_proxy.psk`. The file must contain PSK in the first text string, for example:      e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9  Set access rights to PSK file - it must be readable only by Zabbix user.  Edit TLS parameters in proxy configuration file `zabbix_proxy.conf`, for example, set:      TLSConnect=psk     TLSPSKFile=/home/zabbix/zabbix_proxy.psk     TLSPSKIdentity=PSK 002  The proxy will connect to server using PSK. PSK identity will be "PSK 002".  (To minimize downtime see how to change connection type in [Connection encryption management](/manual/encryption#connection_encryption_management)).  Configure PSK for this proxy in Zabbix frontend. Go to *Administration→Proxies*, select the proxy, go to "Encryption" tab. In "Connections from proxy" mark `PSK`. Paste into "PSK identity" field "PSK 002" and "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9" into "PSK" field. Click "Update".  Restart proxy. It will start using PSK-based encrypted connections to server. Check server and proxy logfiles for error messages.  For a passive proxy the procedure is very similar. The only difference - set `TLSAccept=psk` in proxy configuration file and set "Connections to proxy" in Zabbix frontend to `PSK`.
ca	#### Configuració de PSK per al servidor: comunicació d'un proxy actiu (exemple)  Al proxy, escriviu el valor PSK en un fitxer, per exemple, `/home/zabbix/zabbix_proxy.psk`. El fitxer ha de contindre el PSK a la primera cadena de text, per exemple:    e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9  Establiu els drets d'accés al fitxer PSK: només hauria de ser llegible per l'usuari de Zabbix.  Modifiqueu la configuració de TLS al fitxer de configuració del proxy `zabbix_proxy.conf`, per exemple, configureu:    TLSConnect=psk   TLSPSKFile=/home/zabbix/zabbix_proxy.psk   TLSPSKIidentity=PSK 002  El proxy es connecta al servidor mitjançant PSK. La identitat PSK serà "PSK 002".  (Per minimitzar el temps d'inactivitat, canvieu el tipus de connexió tal com es descriu a [Gestió de xifrat de connexió](/manual/encryption#connection_encryption_management)).  Configureu PSK per a aquest proxy a la interfície Zabbix. Aneu a *Administració → Proxys*, trieu el proxy i aneu a la pestanya "Xifrat". A "Connexions proxy", marqueu `PSK`. Enganxeu el camp "PSK Identitat" "PSK 002" i "e560cb0d918d26d31b4f642181f5f570ad89a390931102e5391d08327ba434e9" al camp "PSK". Feu clic a "Actualitzar".  Reinicieu el proxy. Començarà a emprar connexions de servidor xifrades basades en PSK. Comproveu els fitxers de registre del servidor i del proxy per trobar missatges d'error.  Per a un proxy passiu, el procediment és similar. L'única diferència és: establiu `TLSAccept=psk` al fitxer de configuració del proxy i configureu "Connexions proxy" a la interfície Zabbix a `PSK`.

en-us	#### Configuring PSK for server-agent communication (example)  On the agent host, write the PSK value into a file, for example, `/home/zabbix/zabbix_agentd.psk`. The file must contain PSK in the first text string, for example:      1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952  Set access rights to PSK file - it must be readable only by Zabbix user.  Edit TLS parameters in agent configuration file `zabbix_agentd.conf`, for example, set:      TLSConnect=psk     TLSAccept=psk     TLSPSKFile=/home/zabbix/zabbix_agentd.psk     TLSPSKIdentity=PSK 001  The agent will connect to server (active checks) and accept from server and `zabbix_get` only connections using PSK. PSK identity will be "PSK 001".  Restart the agent. Now you can test the connection using `zabbix_get`, for example:      $ zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" --tls-connect=psk \                 --tls-psk-identity="PSK 001" --tls-psk-file=/home/zabbix/zabbix_agentd.psk  (To minimize downtime see how to change connection type in [Connection encryption management](/manual/encryption?&#connection_encryption_management)).  Configure PSK encryption for this agent in Zabbix frontend:  -   Go to: *Data collection → Hosts* -   Select host and click on **Encryption** tab  Example:  ![psk\_config.png](../../../assets/en/manual/encryption/psk_config.png)  All mandatory input fields are marked with a red asterisk.  When configuration cache is synchronized with database the new connections will use PSK. Check server and agent logfiles for error messages.
ca	#### Configuració de PSK per a la comunicació servidor-agent (exemple)  A l'equip de l'agent, escriviu el valor PSK en un fitxer, per exemple, `/home/zabbix/zabbix_agentd.psk`. El fitxer ha de contindre un PSK a la primera cadena de text, per exemple:    1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952  Estableix els drets d'accés al fitxer PSK: només hauria de ser llegible per l'usuari de Zabbix.  Modifiqueu la configuració de TLS al fitxer de configuració de l'agent `zabbix_agentd.conf`, per exemple, establiu:    TLSConnect=psk   TLSAccept=psk   TLSPSKFile=/home/zabbix/zabbix_agentd.psk   TLSPSKIdentity=PSK 001  L'agent es connecta al servidor (comprovacions actives) i accepta des del servidor i l'ordre `zabbix_get` només connexions amb PSK. La identitat PSK serà "PSK 001".  Reinicieu l'agent. Ara podeu provar la connexió amb l'ordre `zabbix_get`, per exemple:    $ zabbix_get -s 127.0.0.1 -k "system.cpu.load[all,avg1]" --tls-connect=psk\   --tls-psk-identity="PSK 001" --tls-psk-file=/home/zabbix/zabbix_agentd.psk  (Per minimitzar el temps d'inactivitat, canvieu el tipus de connexió tal com es descriu a [Gestió de xifrat de connexió](/manual/encryption?&#connection_encryption_management)).  Configureu el xifrat PSK per a aquest agent a la interfície Zabbix:  - Vés a: *Recull de dades → Equips* - Seleccioneu l'equip i feu clic a la pestanya **Xifrat**  Exemple:  ![psk\_config.png](../../../assets/en/manual/encryption/psk_config.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Un cop la memòria cau de configuració sigui sincronitzada amb la base de dades, les connexions noves empren PSK. Comproveu els fitxers de registre del servidor i de l'agent per si hi ha missatges d'error.

en-us	#### Configuring server for use with Java gateway  With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead.      JavaGateway=192.168.3.14     JavaGatewayPort=10052  By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers.      StartJavaPollers=5  Do not forget to restart server or proxy, once you are done with configuring them.
ca	#### Configuració del servidor per emprar la passarel·la Java  Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor.      JavaGateway=192.168.3.14     JavaGatewayPort=10052  Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers.      StartJavaPollers=5  No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les.

en-us	#### Configuring server for use with Java gateway  With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead.      JavaGateway=192.168.3.14     JavaGatewayPort=10052  By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers.      StartJavaPollers=5  Do not forget to restart server or proxy, once you are done with configuring them.
ca	#### Configuració del servidor per emprar la passarel·la Java  Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor.      JavaGateway=192.168.3.14     JavaGatewayPort=10052  Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers.      StartJavaPollers=5  No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les.

en-us	#### Configuring server for use with Java gateway  With Java gateway up and running, you have to tell Zabbix server where to find Zabbix Java gateway. This is done by specifying JavaGateway and JavaGatewayPort parameters in the [server configuration file](/manual/appendix/config/zabbix_server). If the host on which JMX application is running is monitored by Zabbix proxy, then you specify the connection parameters in the [proxy configuration file](/manual/appendix/config/zabbix_proxy) instead.      JavaGateway=192.168.3.14     JavaGatewayPort=10052  By default, server does not start any processes related to JMX monitoring. If you wish to use it, however, you have to specify the number of pre-forked instances of Java pollers. You do this in the same way you specify regular pollers and trappers.      StartJavaPollers=5  Do not forget to restart server or proxy, once you are done with configuring them.
ca	#### Configuració del servidor per emprar la passarel·la Java  Amb la passarel·la Java operacional, haureu de dir-li al servidor Zabbix on trobar la passarel·la Java Zabbix. Per fer-ho, indiqueu els paràmatres JavaGateway i JavaGatewayPort a l'[arxiu de configuració del servidor](/manual/appendix/config/zabbix_server). Si l'equip on s'executa l'aplicació JMX és monitorada per el proxy Zabbix, especifiqueu els paràmetres de connexió a l'[arxiu de configuració del proxy](/manual/appendix/config/zabbix_proxy) enlloc del servidor.      JavaGateway=192.168.3.14     JavaGatewayPort=10052  Per defecte, el servidor no engega cap procés vinculat al monitoratge JMX. De tota manera, si us cal emprar-lo, haureu d'especificar el nombre d'instàncies definides de pollers Java. Feu-ho de la mateixa manera que especifiqueu els pollers i els trappers.      StartJavaPollers=5  No us oblideu pas de reiniciar el servidor o el proxy, un cop que hagueu acabat de configurar-les.

en-us	#### Configuring SNMP monitoring  To start monitoring a device through SNMP, the following steps have to be performed:
ca	#### configuració del monitoratge SNMP  Per engegar el monitoratge d'un dispositiu via SNMP, s'han de seguir les passes següents:

en-us	#### Configuring SNMP traps  Configuring the following fields in the frontend is specific for this item type:  -   Your host must have an SNMP interface  In *Data collection → Hosts*, in the **Host interface** field set an SNMP interface with the correct IP or DNS address. The address from each received trap is compared to the IP and DNS addresses of all SNMP interfaces to find the corresponding hosts.  -   Configure the item  In the **Key** field use one of the SNMP trap keys:  |Key|<|<| |--|--|------| |Description|Return value|Comments| |**snmptrap**\[regexp\]|<|<| |Catches all SNMP traps that match the [regular expression](/manual/regular_expressions) specified in **regexp**. If regexp is unspecified, catches any trap.|SNMP trap|This item can be set only for SNMP interfaces.<br>User macros and global regular expressions are supported in the parameter of this item key.| |**snmptrap.fallback**|<|<| |Catches all SNMP traps that were not caught by any of the snmptrap\[\] items for that interface.|SNMP trap|This item can be set only for SNMP interfaces.|  ::: noteclassic Multiline regular expression matching is not supported at this time. :::  Set the **Type of information** to 'Log' for the timestamps to be parsed. Note that other formats such as 'Numeric' are also acceptable but might require a custom trap handler.  ::: notetip For SNMP trap monitoring to work, it must first be set up  correctly (see below). :::
ca	#### Configuració de traps SNMP  La configuració dels camps següents a la interfície web és específica d'aquest tipus d'elements:  - El vostre equip ha de tindre una interfície SNMP  A *Recull de dades → Equips*, al camp **Interfície d'equip**, definiu una interfície SNMP amb l'adreça IP correcta o el DNS correcte. L'adreça de cada trap rebuda es compara amb les adreces IP i DNS de totes les interfícies SNMP per trobar els equips corresponents.  - Configurar l'element  Al camp **Clau**, empreu una de les claus de captura SNMP:  |Clau|<|<| |--|--|------| |Descripció|Valor de retorn|Comentaris| |**snmptrap**\[regexp\]|<|<| |Atrapa tots els traps SNMP que coincideixin amb l'[expressió regular](/manual/expressions_regulars) especificada a **regexp**. Si no s'especifica l'expressió regular, captura qualsevol trap.|Trap SNMP|Aquest element només es pot configurar per a interfícies SNMP.<br>Les macros d'usuari i les expressions regulars globals són compatibles amb el paràmetre d'aquesta clau d'element.| |**snmptrap.fallback**|<|<| |Captura tots els traps SNMP que no han estat capturats per cap dels elements snmptrap\[\] d'aquesta interfície.|Trap SNMP|Aquest element només es pot configurar per a interfícies SNMP.|  :::noteclassic La concordança d'expressions regulars de diverses línies no s'admet en aquest moment. :::  Estableix el **Tipus d'informació** a 'Registre perquè les marques de temps s'analitzin. Tingueu en compte que altres formats com ara `'Numèric' també són acceptables, però poden requerir un gestor d'interrupcions personalitzat.  ::: notetip Perquè el monitoratge de traps SNMP funcioni, primer s'ha de configurar correctament (vegeu més avall). :::

en-us	##### Configuring SNMPTT  At first, snmptrapd should be configured to use SNMPTT.  ::: notetip For the best performance, SNMPTT should be configured as a daemon using **snmptthandler-embedded** to pass the traps to it. See instructions for [configuring SNMPTT](http://snmptt.sourceforge.net/docs/snmptt.shtml). :::  When SNMPTT is configured to receive the traps, configure `snmptt.ini`:  1.  enable the use of the Perl module from the NET-SNMP package:  ```ini net_snmp_perl_enable = 1 ```  2.  log traps to the trap file which will be read by Zabbix:  ```ini log_enable = 1 log_file = [TRAP FILE] ```      3.  set the date-time format:  ```ini date_time_format = %H:%M:%S %Y/%m/%d ```  ::: notewarning The "net-snmp-perl" package has been removed in RHEL 8.0-8.2;  re-added in RHEL 8.3. For more information, see the [known issues](/manual/installation/known_issues#snmp_traps). :::  Now format the traps for Zabbix to recognize them (edit snmptt.conf):  1.  Each FORMAT statement should start with "ZBXTRAP \[address\]", where     \[address\] will be compared to IP and DNS addresses of SNMP     interfaces on Zabbix. E.g.:  ```ini EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) ```  2.  See more about SNMP trap format below.  ::: noteimportant Do not use unknown traps - Zabbix will not be able to recognize them.  Unknown traps can be handled by defining a general event in snmptt.conf:<br><br>  ```ini EVENT general .* "General event" Normal ```  :::
ca	##### Configurant SNMPTT  Al principi, snmptrapd s'hauria de configurar per emprar SNMPTT.  ::: notetip Per obtindre un millor rendiment, SNMPTT s'ha de configurar com a dimoni que empra **snmptthandler-embedded** per passar-hi els traps. Veieu les instruccions per [configurar SNMPTT](http://snmptt.sourceforge.net/docs/snmptt.shtml). :::  Quan SNMPTT sigui configurat per rebre els traps, configureu `snmptt.ini`:  1. habiliteu l'ús del mòdul Perl del paquet NET-SNMP:  ```ini net_snmp_perl_enable = 1 ```  2. registreu els traps al fitxer trap que llegirà Zabbix:  ```ini log_enable = 1 log_file = [TRAP FILE] ```      3. establiu el format de data i hora:  ```ini date_time_format = %H:%M:%S %Y/%m/%d ```  ::: notewarning El paquet "net-snmp-perl" s'ha esborrat a RHEL 8.0-8.2; i afegit de nou a RHEL 8.3. Per obtindre més informació, veieu els [problemes coneguts](/manual/installation/known_issues#snmp_traps). :::  Ara formateu els traps perquè Zabbix els reconegui (editeu snmptt.conf):  1. Cada instrucció FORMAT hauria de començar amb "ZBXTRAP \[adreça\]", on      \[adreça\] es compararà amb les adreces IP i DNS de SNMP      interfícies a Zabbix. Per exemple:  ```ini EVENT coldStart .1.3.6.1.6.3.1.1.5.1 "Status Events" Normal FORMAT ZBXTRAP $aA Device reinitialized (coldStart) ```  2. Veieu tot seguit més informació sobre el format de traps SNMP.  ::: noteimportant No empreu traps desconeguts: Zabbix no els podrà pas reconèixer. Els traps desconeguts es poden gestionar definint un esdeveniment general a snmptt.conf:<br><br>  ```ini EVENT general .* "General event" Normal ```  :::

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  ODBC configuration is done by editing the **odbcinst.ini** and **odbc.ini** files. To verify the configuration file location, type:      odbcinst -j  **odbcinst.ini** is used to list the installed ODBC database drivers:      [mysql]     Description = ODBC for MySQL     Driver      = /usr/lib/libmyodbc5.so  Parameter details:  |Attribute|Description| |--|--------| |*mysql*|Database driver name.| |*Description*|Database driver description.| |*Driver*|Database driver library location.|  **odbc.ini** is used to define data sources:      [test]     Description = MySQL test database     Driver      = mysql     Server      = 127.0.0.1     User        = root     Password    =     Port        = 3306     Database    = zabbix  Parameter details:  |Attribute|Description| |--|--------| |*test*|Data source name (DSN).| |*Description*|Data source description.| |*Driver*|Database driver name - as specified in odbcinst.ini| |*Server*|Database server IP/DNS.| |*User*|Database user for connection.| |*Password*|Database user password.| |*Port*|Database connection port.| |*Database*|Database name.|  To verify if ODBC connection is working successfully, a connection to database should be tested. That can be done with the **isql** utility (included in the unixODBC package):      isql test     +---------------------------------------+     | Connected!                            |     |                                       |     | sql-statement                         |     | help [tablename]                      |     | quit                                  |     |                                       |     +---------------------------------------+
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:       shell > odbcinst -j  **odbcinst.ini** s'empra per llistar els controladors de bases de dades ODBC instal·lats:      [mysql]     Description = ODBC for MySQL     Driver      = /usr/lib/libmyodbc5.so  Detalls dels paràmetres:  |Atribut|Descripció| |--|--------| |*mysql*|Nom del controlador de base de dades.| |*Description*|Descripció del controlador de la base de dades.| |*Driver*|Ubicació de la biblioteca de controladors de base de dades.|  **odbc.ini** s'empra per definir fonts de dades:      [test]     Description = MySQL test database     Driver      = mysql     Server      = 127.0.0.1     User        = root     Password    =     Port        = 3306     Database    = zabbix  Detalls dels paràmetres:  |Atribut|Descripció| |--|--------| |*test*|Nom de la font de dades (DSN).| |*Description*|Descripció de la font de dades.| |*Driver*|Nom del controlador de base de dades, tal com s'especifica a odbcinst.ini| |*Server*|IP/DNS del servidor de base de dades.| |*User*|Usuari de la base de dades per la connexió.| |*Password*|Mot de pas de l'usuari de la base de dades.| |*Port*|Port de connexió a la base de dades.| |*Database*|Nom de la base de dades.|  Per comprovar si la connexió ODBC funciona correctament, s'ha de provar una connexió de base de dades. Això es pot fer amb la utilitat **isql** (inclosa al paquet unixODBC):      shell> isql test     +---------------------------------------+     | Connected!                            |     |                                       |     | sql-statement                         |     | help [tablename]                      |     | quit                                  |     |                                       |     +---------------------------------------+     SQL>

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/6.4/Dockerfiles/snmptraps/alpine/conf/usr/sbin/zabbix_trap_handler.sh) can be used to pass traps to Zabbix server directly from snmptrapd. To configure it, add the `traphandle` option to snmptrapd configuration file (`snmptrapd.conf`), see [example](https://raw.githubusercontent.com/zabbix/zabbix-docker/6.4/Dockerfiles/snmptraps/alpine/conf/etc/snmp/snmptrapd.conf).
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/6.4/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).

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 options for Oracle plugin  The Oracle plugin, supported for Zabbix agent 2, now allows to specify `as sysdba`, `as sysoper`, or `as sysasm` login option. The option can be appended either to the user item key parameter or to the plugin configuration parameter Plugins.Oracle.Sessions.<SessionName>.User in the format `user as sysdba` (login option is case-insensitive; must not contain a trailing space).
ca	### Opcions de connexió per al connector Oracle  El connector d'Oracle, compatible amb l'agent Zabbix 2, permet especificar l'opció de connexió "com a sysdba", "com a sysoper" o "com a sysasm". L'opció es pot afegir al paràmetre clau de l'element d'usuari o al paràmetre de configuració del connector Plugins.Oracle.Sessions.<Nom de la sessió>.Usuari en el format `usuari com a sysdba` (l'opció d'inici de sessió no és sensible a les majúscules i minúscules; no ha de contindre espais).

en-us	### Connection set up  Zabbix supports two types of connect identifiers (connection methods):  -   Easy Connect -   Net Service Name  Connection configuration parameters for Zabbix server and Zabbix proxy can be set in the configuration files. Important parameters for the server and proxy are *DBHost*, *DBUser*, *DBName* and *DBPassword*. The same parameters are important for the frontend: *$DB\["SERVER"\]*, *$DB\["PORT"\]*, *$DB\["DATABASE"\]*, *$DB\["USER"\]*, *$DB\["PASSWORD"\]*.  Zabbix uses the following connection string syntax:      {DBUser/DBPassword[@<connect_identifier>]}   <connect\_identifier> can be specified either in the form of "Net Service Name" or "Easy Connect".      @[[//]Host[:Port]/<service_name> | <net_service_name>]
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  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|string|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.| |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.| |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|cadena|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 connector objects.  Object references:\  - [Connector](/manual/api/reference/connector/object#connector) - [Connector tag filter](/manual/api/reference/connector/object#tag-filter)  Available methods:\  - [connector.create](/manual/api/reference/connector/create) - creating new connectors - [connector.delete](/manual/api/reference/connector/delete) - deleting connectors - [connector.get](/manual/api/reference/connector/get) - retrieving connectors - [connector.update](/manual/api/reference/connector/update) - updating connectors
ca	# Connector  Aquesta classe és dissenyada per treballar amb objectes connector.  Referències d'objecte:\  - [Connector](/manual/api/reference/connector/object#connector) - [Filtre d'etiqueta de connector](/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-8105](https://support.zabbix.com/browse/ZBXNEXT-8105) Added new Connector API with methods `connector.create`, `connector.update`, `connector.get`, `connector.delete`.\
ca	#### connector  [ZBXNEXT-8105](https://support.zabbix.com/browse/ZBXNEXT-8105) S'ha afegit el nou connector API amb els mètodes `connector.create`, `connector.update`, `connector.get`, `connector.delete`.\

en-us	#### Consistency introduced in sha256 checksums of vfs.file.cksum item  In earlier Zabbix versions, the Zabbix agent item [`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#vfs.file.cksumfilemode) produced different sha256 sums for the same file depending on the platform (processor architecture) – sha256 sums on AIX, HP-UX (Itanium) and Solaris (SPARC) differed from those produced on Intel x86-64 platforms.  The issue has now been fixed; however, after upgrading, monitoring sha256 sums of files on AIX, HP-UX, or Solaris SPARC may result in false positives of files having been modified.
ca	 #### Afegida coherència a les sumes de control sha256 de l'element vfs.file.cksum  En versions anteriors de Zabbix, l'element de l'agent Zabbix [`vfs.file.cksum`](/manual/config/items/itemtypes/zabbix_agent#vfs.file.cksumfilemode) feia diferents sumes sha256 per al mateix fitxer en funció de la plataforma (arquitectura del processador) - les sumes sha256 a AIX, HP-UX (Itanium) i Solaris (SPARC) difereixen de les produïdes a les plataformes Intel x86-64.  El problema s'ha corregit; tanmateix, després de l'actualització, el monitoratge de les sumes sha256 de fitxers a AIX, HP-UX o Solaris SPARC pot donar lloc a falsos positius dels fitxers modificats.

en-us	 #### Content conversion to UTF-8  HTTP agent items, web scenarios, web checks and JavaScript items have been improved to convert to UTF-8 from the character set specified in the HTTP header or HTTP meta tag.
ca	 #### Conversió de contingut a UTF-8  Els elements de l'agent HTTP, els escenaris web, les comprovacions web i els elements JavaScript s'han millorat per convertir-los a UTF-8 a partir del conjunt de caràcters especificat a la capçalera HTTP o metaetiqueta HTTP.

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 grey 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 menu   Context menus for items, hosts, and events have become more functional.
ca	 #### Menú contextual  Els menús contextuals d'elements, equips i esdeveniments s'han tornat més funcionals.

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?at=refs%2Fheads%2Frelease%2F6.4). :::
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?at=refs%2Fheads%2Frelease%2F6.4) 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	#### 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 a GPL license. Use  of Zabbix documentation is subject to the following terms:   You may create a printed copy of this documentation solely for your  own personal use. Conversion to other formats is allowed as long as  the actual content is not altered or edited in any way. You shall  not publish or distribute this documentation in any form or on any  media, except if you distribute the documentation in a manner similar  to how Zabbix disseminates it (that is, electronically for download  on a Zabbix web site) or on a USB or similar medium, provided however  that the documentation is disseminated together with the software on  the same medium. Any other use, such as any dissemination of printed  copies or use of this documentation, in whole or in part, in another  publication, requires the prior written consent from an authorized  representative of Zabbix. Zabbix reserves any and all rights to this  documentation not expressly granted above.
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 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	 ### Copyright notice  Zabbix documentation is NOT distributed under a GPL license. Use  of Zabbix documentation is subject to the following terms:   You may create a printed copy of this documentation solely for your  own personal use. Conversion to other formats is allowed as long as  the actual content is not altered or edited in any way. You shall  not publish or distribute this documentation in any form or on any  media, except if you distribute the documentation in a manner similar  to how Zabbix disseminates it (that is, electronically for download  on a Zabbix web site) or on a USB or similar medium, provided however  that the documentation is disseminated together with the software on  the same medium. Any other use, such as any dissemination of printed  copies or use of this documentation, in whole or in part, in another  publication, requires the prior written consent from an authorized  representative of Zabbix. Zabbix reserves any and all rights to this  documentation not expressly granted above.
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'altera ni s'edita 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	# 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|string|Host group ID.<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| |--|--|------| |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*| |conditions|array|Set of [filter conditions](#correlation-filter-condition) to use for filtering results.<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ó| |--|--|------| |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*| |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*| |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|string|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|cadena|*(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)  Available methods:\  -   [correlation.create](/manual/api/reference/correlation/create) -     creating new correlations -   [correlation.delete](/manual/api/reference/correlation/delete) -     deleting correlations -   [correlation.get](/manual/api/reference/correlation/get) -     retrieving correlations -   [correlation.update](/manual/api/reference/correlation/update) -     updating correlations
ca	# Correlació  Aquesta classe és dissenyada per treballar amb correlacions.  Referències d'objectes:\  -   [Correlació](/manual/api/reference/correlation/object#correlation)  Mètodes disponibles:\  -   [correlation.create](/manual/api/reference/correlation/create) -     crear noves correlacions -   [correlation.delete](/manual/api/reference/correlation/delete) -     esborrar correlacions -   [correlation.get](/manual/api/reference/correlation/get) -     recuperar correlacions -   [correlation.update](/manual/api/reference/correlation/update) -     actualitzar correlacions

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

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	### Cosmos DB monitoring  The template *Azure by HTTP* now also works with Azure Cosmos DB for MongoDB.  You can get this template:  - In *Data collection → Templates* in new installations. - If you are upgrading from previous versions, you can download this template from Zabbix [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.4) or find it in the *zabbix/templates* directory of the downloaded latest Zabbix version. Then, while in *Data collection → Templates* you can import it manually into Zabbix.
ca	### Monitoratge de Cosmos DB  La plantilla *Azure by HTTP* ara també funciona amb Azure Cosmos DB per MongoDB.  Podeu obtindre aquesta plantilla:  - Per a noves instal·lacions, des de *Recull de dades → Plantilles*. - Si sou actualitzant des de versions prèvies, podeu descarregar la plantilla del [repositori Git de Zabbix](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/azure_http?at=refs%2Fheads%2Frelease%2F6.4) o cercar-les al directori *zabbix/templates* de la darrera versió de Zabbix descarregada. Ara, es poden importar manualment des de *Recull de dades → Plantilles*.

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>)) {#count}  The count of values in an array returned by a foreach function.<br> Supported value type: *Integer*.<br> Supported [foreach functions](/manual/appendix/functions/aggregate/foreach): *avg_foreach*, *count_foreach*, *exists_foreach*, *last_foreach*, *max_foreach*, *min_foreach*, *sum_foreach*.  Parameters:   -   **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);<br> -   **time period** - see [time period](/manual/appendix/functions/aggregate/foreach#time_period).  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.  Examples:      count(max_foreach(/*/net.if.in[*],1h)) #the number of net.if.in items that received data in the last hour until now
ca	 ##### count(func_foreach(item filter,<time period>)) {#count}  El recompte de valors d'una matriu retornats per una funció foreach.<br> Tipus de valor compatible: *Enter*.<br> Admet les [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** - veieu [filtre d'elements](/manual/appendix/functions/aggregate/foreach#item_filter);<br> - **període de temps** - veieu [període de temps](/manual/appendix/functions/aggregate/foreach#time_period).  L'ús de **count()** amb una funció de foreach relacionada amb l'historial (max_foreach, avg_foreach, etc.) pot comportar implicacions en el rendiment, mentre que l'ús de **exists_foreach()**, que només funciona amb dades de configuració, no tindrà aquestes implicacions.  Exemples:       count(max_foreach(/*/net.if.in[*],1h)) #el nombre d'elements net.if.in que han rebut dades durant la darrera hora

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; if database is [not upgraded](/manual/appendix/install/db_float_range) the precision is 0.000001. -   *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: *Float*, *Enter*, *String*, *Text*, *Log*.  Paràmetres:  - Veieu [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>*com* (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; si la base de dades no és [actualitzada](/manual/appendix/install/db_float_range) la precisió és 0,000001. - *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 nombres, separats per '/': **nombre_a_comparar_amb/màscara**. count() calcula "I bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre_per_comparar_amb*. Si el resultat de "I bit a bit" és igual a *nombre_a_comparar_amb*, es compta el valor.<br>Si *nombre_a_comparar_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/'). - 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 d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.  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 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; if database is [not upgraded](/manual/appendix/install/db_float_range) the precision is 0.000001. -   *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>,<operator>,<pattern>) {#countunique}  El nombre de valors únics dins del període d'avaluació definit.<br> Tipus de valors admesos: *Flotant*, *Enter*, *Cadena*, *Text*, *Log*.  Paràmetres:  - Veieu [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* - menor<br>*le* - menor o igual<br>*com* (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; si la base de dades no és [actualitzada](/manual/appendix/install/db_float_range) la precisió és 0,000001. - *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 '/': **nombre_a_comparar_amb/màscara**. countunique() calcula "I bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre_per_comparar_amb*. Si el resultat de "I bit a bit" és igual a *nombre_a_comparar_amb*, es compta el valor.<br>Si *nombre_a_comparar_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/'). - 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 d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (utilitzada 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 display a configuration message before running in the frontend.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Reboot server",         "command": "reboot server 1",         "confirmation": "Are you sure you would like to reboot the server?",         "scope": 2,         "type": 0     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "scriptids": [             "4"         ]     },     "id": 1 } ```
ca	#### Crear un script a mida  Crea un script a mida, que reinicia un servidor. L'script necessitarà un accés d'escriptura a l'equip i mostrarà un missatge de configuració abans d'executar-se en pantalla.  [Petició](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "script.create",     "params": {         "name": "Reiniciar servidor",         "command": "reboot server 1",         "confirmation": "Segur que el voleu reiniciar?",         "scope": 2,         "type": 0     },     "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 discovered hosts to template "10001".  [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ó:  ```json {     "jsonrpc": "2.0",     "method": "action.create",     "params": {         "name": "Discovery action",         "eventsource": 1,          "filter": {             "evaltype": 0,             "conditions": [                 {                     "conditiontype": 21,                     "operator": 0,                     "value": "1"                 },                 {                     "conditiontype": 10,                     "operator": 0,                     "value": "2"                 }             ]         },         "operations": [             {                 "operationtype": 6,                 "optemplate": [                     {                         "templateid": "10001"                     }                 ]             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "actionids": [             "18"         ]     },     "id": 1 } ```

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",         "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",         "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 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) and, in the *DNS name* field, enter the macro {#VM.DNS}. Alternatively (based on the configuration of your VMware environment), in the *IP address* field, enter the macro {#VM.IP}. This 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\. [Creeu](/manual/discovery/low_level_discovery/host_prototypes#configuration)  un prototip d'equip. Com que els prototips d'equips són plànols 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 d'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 "Convidat de VMware". Aquesta plantilla conté [articles de VMware](/manual/vm_monitoring/vmware_keys) i regles de descoberta per monitorar l'estat de corrent 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'equips*, introduïu o seleccioneu un grup d'equips (per exemple, "Equips descoberts"). - Al camp *Interfícies*, afegiu una [interfície d'equips] personalitzada (/manual/discovery/low_level_discovery/host_prototypes#host-interfaces) i, al camp *DNS name*, introduïu la macro {#VM.DNS}. Alternativament (segons la configuració del vostre entorn VMware), al camp *adreça IP*, introduïu la macro {#VM.IP}. Això és necessari 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 amfitrions 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": {         "host": "Active proxy",         "status": "5",         "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": {         "host": "Active proxy",         "status": "5",         "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,         "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,         "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": {         "host": "Passive proxy",         "status": "6",         "interface": {             "ip": "127.0.0.1",             "dns": "",             "useip": "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": {         "host": "Passive proxy",         "status": "6",         "interface": {             "ip": "127.0.0.1",             "dns": "",             "useip": "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 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 that for host scope and remains in 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 que, 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": "Script URL",         "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 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": [             {                 "mode":"json"             },             {                 "min": "10"             },             {                 "max": "100"             }         ],         "interfaceid": "1",         "type": 19,         "hostid": "10254",         "delay": "5s",         "key_": "json",         "name": "HTTP agent example JSON",         "value_type": 0,         "output_format": 1,         "preprocessing": [             {                 "type": 12,                 "params": "$.random",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "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": [             {                 "mode": "json"             },             {                 "min": "10"             },             {                 "max": "100"             }         ],         "interfaceid": "1",         "type": 19,         "hostid": "10254",         "delay": "5s",         "key_": "json",         "name": "HTTP agent example JSON",         "value_type": 0,         "output_format": 1,         "preprocessing": [             {                 "type": 12,                 "params": "$.random",                 "error_handler": 0,                 "error_handler_params": ""             }         ]     },     "id": 2 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "23865"         ]     },     "id": 3 } ```

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": [             {                 "min": "10"             },             {                 "max": "100"             }         ],         "headers": {             "X-Source": "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": [             {                 "min": "10"             },             {                 "max": "100"             }         ],         "headers": {             "X-Source": "api"         },         "delay": "35"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "itemids": [             "28305"         ]     },     "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     # Entre 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.tag.0",                                 "value": "service"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "zabbix_server"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": 2             }         ],         "users": [             {                 "userid": "4",                 "permission": 3             }         ]     },     "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": "El meu tauler",         "display_period": 30,         "auto_start": 1,         "pages": [             {                 "widgets": [                     {                         "type": "Problemes",                         "x": 0,                         "y": 0,                         "width": 12,                         "height": 5,                         "view_mode": 0,                         "fields": [                             {                                 "type": 1,                                 "name": "tags.tag.0",                                 "value": "service"                             },                             {                                 "type": 0,                                 "name": "tags.operator.0",                                 "value": 1                             },                             {                                 "type": 1,                                 "name": "tags.value.0",                                 "value": "zabbix_server"                             }                         ]                     }                 ]             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": 2             }         ],         "users": [             {                 "userid": "4",                 "permission": 3             }         ]     },     "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 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 } ```