en-us	##### Adding proxies  To configure a proxy in Zabbix frontend:  -   Go to: *Administration → Proxies* -   Click on *Create proxy*  ![](../../../assets/en/manual/distributed_monitoring/proxy.png){width="600"}  |Parameter|<|Description| |-|----------|----------------------------------------| |*Proxy name*|<|Enter the proxy name. It must be the same name as in the *Hostname* parameter in the proxy configuration file.| |*Proxy group*|<|Select the proxy group for proxy [load balancing/high availability](/manual/distributed_monitoring/proxies/ha).<br>Only one group can be selected.| |*Address for active agents*|<|Enter address the monitored active agents or senders must connect to. Supported **only** for Zabbix 7.0 agents or later.<br>This address is used to connect to both active and passive proxies. This field is only available if a proxy group is selected in the *Proxy group* field.| | |*Address*|IP address/DNS name to connect to.| |^|*Port*|TCP port number (10051 by default) to connect to. User macros are supported.| |*Proxy mode*|<|Select the proxy mode.<br>**Active** - the proxy will connect to the Zabbix server and request configuration data<br>**Passive** - Zabbix server connects to the proxy<br>*Note* that without encrypted communications (sensitive) proxy configuration data may become available to parties having access to the Zabbix server trapper port when using an active proxy. This is possible because anyone may pretend to be an active proxy and request configuration data if authentication does not take place or proxy addresses are not limited in the *Proxy address* field.| |*Proxy address*|<|If specified then active proxy requests are only accepted from this list of comma-delimited IP addresses, optionally in CIDR notation, or DNS names of active Zabbix proxy.<br>This field is only available if an active proxy is selected in the *Proxy mode* field. Macros are not supported.| |*Interface*|<|Enter interface details for a passive proxy.<br>This field is only available if a passive proxy is selected in the Proxy mode field.| | |*Address*|IP address/DNS name of the passive proxy.| |^|*Port*|TCP port number of the passive proxy (10051 by default). User macros are supported.| |*Description*|<|Enter the proxy description.|  The **Encryption** tab allows you to require encrypted connections with the proxy.  |Parameter|Description| |--|--------| |*Connections to proxy*|How the server connects to the passive proxy: no encryption (default), using PSK (pre-shared key) or certificate.| |*Connections from proxy*|Select what type of connections are allowed from the active proxy. Several connection types can be selected at the same time (useful for testing and switching to other connection type). Default is "No encryption".| |*Issuer*|Allowed issuer of certificate. Certificate is first validated with CA (certificate authority). If it is valid, signed by the CA, then the *Issuer* field can be used to further restrict allowed CA. This field is optional, intended to use if your Zabbix installation uses certificates from multiple CAs.| |*Subject*|Allowed subject of certificate. Certificate is first validated with CA. If it is valid, signed by the CA, then the *Subject* field can be used to allow only one value of *Subject* string. If this field is empty then any valid certificate signed by the configured CA is accepted.| |*PSK identity*|Pre-shared key identity string.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |*PSK*|Pre-shared key (hex-string). Maximum length: 512 hex-digits (256-byte PSK) if Zabbix uses GnuTLS or OpenSSL library, 64 hex-digits (32-byte PSK) if Zabbix uses mbed TLS (PolarSSL) library. Example: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952|  The **Timeouts** tab allows you to override [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts for item types that support it.  ![](../../../assets/en/manual/distributed_monitoring/proxy_timeout.png){width="600"}  |Parameter|Description| |--|--------| |*Timeouts for item types*|Select the timeout option:<br>**Global** - global timeout is used (displayed in the grayed out *Timeout* field for each item type);<br>**Override** - custom timeout is used (set in the *Timeout* field for each item type). Allowed range: 1 - 600s (default: inherited from [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts). [Time suffixes](/manual/appendix/suffixes#time-suffixes), e.g. 30s, 1m, and [user macros](/manual/config/macros/user_macros) are supported.<br><br>Clicking the *Global timeouts* link allows you to configure [global](/manual/web_interface/frontend_sections/administration/general#timeouts) timeouts. Note that the *Global timeouts* link is visible only to users of *Super admin* type with permissions to the *Administration* → [*General*](/manual/web_interface/frontend_sections/administration/general) frontend section.<br><br>Supported item types:<br>- [Zabbix agent](/manual/config/items/itemtypes/zabbix_agent) (both passive and active checks)<br>- [Simple check](/manual/config/items/itemtypes/simple_checks) (except `icmpping*`, `vmware.*` items)<br>- [SNMP agent](/manual/config/items/itemtypes/snmp) (only for SNMP `walk[OID]` and `get[OID]` items)<br>- [External check](/manual/config/items/itemtypes/external)<br>- [Database monitor](/manual/config/items/itemtypes/odbc_checks)<br>- [HTTP agent](/manual/config/items/itemtypes/http)<br>- [SSH agent](/manual/config/items/itemtypes/ssh_checks)<br>- [TELNET agent](/manual/config/items/itemtypes/telnet_checks)<br>- [Script](/manual/config/items/itemtypes/script)<br>- [Browser](/manual/config/items/itemtypes/browser)<br><br>Note that the timeouts set under **Override** will prevail over the global ones but will be overridden by individual item timeouts if those are set under [item configuration](/manual/config/items/item#configuration).|  ::: noteclassic If proxy major version does not match server major version, ![](../../../assets/en/manual/distributed_monitoring/info_yellow.png){class="nozoom"} icon will be displayed next to *Timeouts for item types*, with the hover message "Timeouts disabled because the proxy and server versions do not match". In such cases, the proxy will use the [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) parameter from the proxy configuration file. :::  The editing form of an existing proxy has the following additional buttons:  -    *Refresh configuration* - refresh configuration of the proxy -    *Clone* - create a new proxy based on the properties of the existing proxy -    *Delete* - delete the proxy
ca	##### Afegir proxys  Per configurar un proxy a la interfície de Zabbix:  - Aneu a: *Administració → Proxys* - Feu clic a *Crear un proxy*  ![](../../../assets/en/manual/distributed_monitoring/proxy.png){width="600"}  |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom del proxy*|<|Introduïu el nom del proxy. Aquest ha d'ésser el mateix nom que al paràmetre *Hostname* del fitxer de configuració del proxy.| |*Grup de proxys*|<|Trieu el [grup de proxys](/manual/distributed_monitoring/proxies/ha) per balanceig de càrrega / alta disponibilitat.<br>Només es pot triar un grup.| |*Adreça dels agents actius*|<|Introduïu l'adreça a la que s'han de connectar els agents actius monitorats o els remitents. Admès **només** per a agents Zabbix 7.0 o posterior.<br>Aquesta adreça s'empra per connectar als proxys actius i passius. Aquest camp només és disponible si es tria un grup de proxys al camp *Grup de proys*.| | |*Adreça*|Adreça IP/nom DNS on connectar.| |^|*Port*|Nombre de port TCP (10051 per defecte) per connectar. Les macros d'usuari són compatibles.| |*Mode proxy*|<|Trieu el mode proxy.<br>**Actiu** - el proxy es connectarà al servidor Zabbix i demanarà dades de configuració<br>**Passiu** - el servidor Zabbix es connectarà al proxy<br>*Tingueu en compte* que sense comunicacions xifrades (sensibles), les dades de configuració del proxy poden estar disponibles per a les persones amb accés al port de captura del servidor Zabbix quan s'empra un proxy actiu. Això és possible perquè qualsevol persona pot simular ésser un proxy actiu i demanar dades de configuració si l'autenticació no es fa o si les adreces del proxy no són restringides al camp *Adreça del proxy*.| |*Adreça del proxy*|<|Si s'especifica, les peticions de proxy actiu només s'accepten d'aquesta llista d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de proxy actiu de Zabbix.<br>Aquest camp només és disponible si hi ha un proxy actiu, triatal camp *Mode proxy*. Les macros no són compatibles.| |*Interfície*|<|Introduïu els detalls de la interfície per al proxy passiu.<br>Aquest camp només és disponible si es tria un proxy passiu al camp de Mode de proxy.| | |*Adreça*|Adreça IP / Nom DNS de proxy passiu.| |^|*Port*|Nombre de port TCP del proxy passiu (10051 per defecte).| |*Descripció*|<|Introduïu la descripció del proxy.|  La pestanya **Xifrat** us permet requerir connexions xifrades amb el proxy.  |Paràmetre|Descripció| |--|---------| |*Connexions cap al proxy*|Com es connecta el servidor al proxy passiu: sense xifrat (per defecte), emprant PSK (clau prèviament compartida) o certificat.| |*Connexions des del proxy*|Trieu el tipus de connexions permeses des del proxy actiu. Es poden triar diversos tipus de connexió al mateix temps (útil per provar i canviar a un altre tipus de connexió). El valor predeterminat és "Sense xifrat".| |*Emès per*|Emissor autoritzat del certificat. El certificat es valida primer amb la CA (Certificate Authority). Si és vàlid, signat per l'AC, el camp *Emissor* es pot emprar per restringir encara més l'AC autoritzada. Aquest camp és opcional i és pensat per ser emprat si la vostra instal·lació de Zabbix empra certificats de diverses CA.| |*Assumpte*|Subjecte autoritzat del certificat. El certificat es valida primer amb CA. Si és vàlid, signat per l'AC, el camp *Assumpte* es pot emprar per permetre només un valor de cadena *Assumpte*. Si aquest camp és en blanc, s'accepta qualsevol certificat vàlid signat per la CA configurada.| |*Identitat PSK*|Cadena d'identitat de clau prèviament compartida.<br>No introduïu informació sensible a la identitat PSK, es transmet sense xifrar per la xarxa per informar al receptor quina PSK ha d'emprar.| |*PSK*|Clau precompartida (cadena hexadecimal). Longitud màxima: 512 dígits hexadecimals (PSK de 256 octets) si Zabbix empra la biblioteca GnuTLS o OpenSSL, 64 dígits hexadecimals (PSK de 32 octets) si Zabbix empra la biblioteca Mbed TLS (PolarSSL). Exemple: 1f87b595725ac58dd977beef14b97461a7c1045b9a1c963065002c5473194952|  La pestanya **Temps d'espera** us permet anul·lar els temps d'espera [global](/manual/web_interface/frontend_sections/administration/general#timeouts) per als tipus d'elements que ho admeten.  ![](../../../assets/en/manual/distributed_monitoring/proxy_timeout.png){width="600"}  |Paràmetre|Descripció| |--|---------| |*Temps d'espera per als tipus d'element*|Trieu l'opció de temps d'espera:<br>**Global** - s'empra el temps d'espera global (es mostra al camp *Temps d'espera* en gris per a cada tipus d'element);<br>**Substituir** - S'empra el temps d'espera personalitzat (establert al camp *Temps d'espera* per a cada tipus d'element). Interval permès: 1 - 600s (per defecte: heretat dels temps d'espera [global](/manual/web_interface/frontend_sections/administration/general#timeouts)). Els [Sufixos de temps](/manual/apèndix/sufixos#sufixos de temps), com ara 30s, 1m i les [macros d'usuari](/manual/config/macros/user_macros) són compatibles.<br><br>Fent clic a l'enllaç *Temps d'espera global* us permet configurar el temps d'espera [global](/manual/web_interface/frontend_sections/ administració/general#timeouts). Tingueu en compte que l'enllaç *Temps d'espera global* només és visible per als usuaris del tipus *Super admin* amb permisos a la secció d'interfície *Administració* → [*General*](/manual/web_interface/frontend_sections/administration/general).<br><br>Tipus d'elements admesos:<br>- [agent Zabbix](/manual/config/items/itemtypes/zabbix_agent) (tant comprovacions passives com actives)<br>- [Comprovació simple](/manual/config/items/ itemtypes/simple_checks) (excepte els elements `icmpping*`, `vmware.*`)<br>- [agent SNMP](/manual/config/items/itemtypes/snmp) (només per a elements SNMP `walk[OID]` i ` get[OID]`)<br>- [Comprovació externa](/manual/config/items/itemtypes/external)<br>- [Monitoratge de la base de dades](/manual/config/items/itemtypes/odbc_checks)<br> - [agent HTTP](/manual/config/items/itemtypes/http)<br>- [agent SSH](/manual/config/items/itemtypes/ssh_checks)<br>- [agent TELNET](/manual/config /items/itemtypes/telnet_checks)<br>- [Script](/manual/config/items/itemtypes/script)<br>- [Navegador](/manual/config/items/itemtypes/browser)<br><br >Tingueu en compte que els temps d'espera establerts a **Anul·lació** prevaldran sobre els globals, però seran anul·lats pels temps d'espera d'elements individuals si s'estableixen a [configuració de l'element](/manual/config/items/item#configuration).|  ::: noteclassic Si la versió principal del proxy no coincideix amb la versió principal del servidor, ![](../../../assets/en/manual/distributed_monitoring/info_yellow.png) Es veurà la icona {class="nozoom"} al costat de *Temps d'espera per als tipus d'elements*, amb el missatge "Els temps d'espera desactivats perquè les versions del proxy i del servidor no coincideixen" en passar el cursor. En aquests casos, el proxy emprarà el paràmetre [`Timeout`](/manual/appendix/config/zabbix_proxy#timeout) del fitxer de configuració del proxy. :::  El formulari d'edició d'un proxy existent té els botons addicionals següents:  -*Actualitzar la configuració* - actualitza la configuració del proxy -*Clonar* - crea un nou proxy basat en les propietats del proxy existent -*Esborrar* - esborra el proxy

en-us	#### Adding shapes  In addition to map elements, it is also possible to add some shapes. Shapes are not map elements; they are just a visual representation. For example, a rectangle shape can be used as a background to group some hosts. Rectangle and ellipse shapes can be added.  To add a shape, click on *Add* next to Shape. The new shape will appear at the top left corner of the map. Drag and drop it wherever you like.  A new shape is added with default colors. By clicking on the shape, a form is displayed and you can customize the way a shape looks, add text, etc.  ![](../../../../../assets/en/manual/config/visualization/map_shape.png){width="600"}  To select shapes, select one and then hold down *Ctrl* to select the others. With several shapes selected, common properties can be mass updated, similarly as with elements.  Text can be added in the shapes. Expression [macros](/manual/appendix/macros/supported_by_location) are supported in the text, but only with `avg`, `last`, `min` and `max` functions, with time as parameter (for example, `{?avg(/host/key,1h)}`).  To display text only, the shape can be made invisible by removing the shape border (select 'None' in the *Border* field). For example, take note of how the {MAP.NAME} macro, visible in the screenshot above, is actually a rectangle shape with text, which can be seen when clicking on the macro:  ![](../../../../../assets/en/manual/config/visualization/map_name_macro.png)  {MAP.NAME} resolves to the configured map name when viewing the map.  If hyperlinks are used in the text, they become clickable when viewing the map.  Line wrapping for text is always "on" within shapes. However, within an ellipse, the lines are wrapped as though the ellipse were a rectangle. Word wrapping is not implemented, so long words (words that do not fit the shape) are not wrapped, but are masked (on map editing page) or clipped (other pages with maps).
ca	#### Afegir formes  A més dels elements del mapa, també és possible afegir formes. Les formes no són elements del mapa; només són una representació visual. Per exemple, una forma rectangular es pot emprar com a fons per agrupar alguns equips. Es poden afegir formes rectangulars i el·lipses.  Per afegir una forma, feu clic a *Afegir* al costat de Forma. La nova forma apareixerà a la cantonada superior esquerra del mapa. Arrossegueu-la i deixeu-la anar allà on vulgueu.  S'afegeix una nova forma amb els colors predeterminats. En fer clic a la forma, es mostra un formulari i es pot personalitzar l'aspecte d'una forma, afegir text, etc.  ![](../../../../../assets/en/manual/config/visualization/map_shape.png){width="600"}  Per triar formes, marqueu-ne una i, a continuació, manteniu premuda la tecla *Ctrl* per triar les altres. Amb diverses formes triades, les propietats comunes es poden actualitzar massivament, de manera similar als elements.  El text es pot afegir en formes. Les [macros](/manual/appendix/macros/supported_by_location) s'admeten al text, però només amb les funcions `avg`, `last`, `min` i `max`, amb el temps com a paràmetre (p. ex., `{?avg (/host/key,1h)}`).  Per veure només text, la forma es pot fer invisible traient la vora de la forma (Trieu 'Cap' al camp *Marge*). Per exemple, tingueu en compte que la macro {MAP.NAME}, visible a la captura de pantalla anterior, és en realitat una forma rectangular amb text, que es pot veure fent clic a la macro:  ![](../../../../../assets/en/manual/config/visualization/map_name_macro.png)  {MAP.NAME} es resol amb el nom del mapa configurat quan es mostra el mapa.  Si s'empren hiperenllaços al text, es pot fer clic quan es visualitza el mapa.  L'ajustament de paraules per al text sempre és "activat" a les formes. Tanmateix, en una el·lipse, les línies s'emboliquen com si l'el·lipse fos un rectangle. No s'implementa l'ajustament de paraules, de manera que les paraules llargues (paraules que no coincideixen amb la forma) no s'emboliquen, sinó que s'emmascaren (generador de pàgines) o es trunquen (altres pàgines amb mapes).

en-us	#### Adding templates to template groups  Add two templates to template groups with IDs 12 and 13.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "templategroup.massadd",     "params": {         "groups": [             {                 "groupid": "12"             },             {                 "groupid": "13"             }         ],         "templates": [             {                 "templateid": "10486"             },             {                 "templateid": "10487"             }         ]     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "groupids": [             "12",             "13"         ]     },     "id": 1 } ```
ca	#### Afegir plantilles a grups de plantilles  Afegeix les plantilles als grups de plantilles amb IDs 12 i 13.  [Petició](/manual/api#performing-requests):  ```json { "jsonrpc": "2.0", "method": "templategroup.massadd", "params": { "groups": [ { "groupid": "12" }, { "groupid": "13" } ], "templates": [ { "templateid": "10486" }, { "templateid": "10487" } ] }, "id": 1 } ```  Resposta:  ```json { "jsonrpc": "2.0", "result": { "groupids": [ "12", "13" ] }, "id": 1 } ```

en-us	#### Adding template  To start working with templates, we must first create one. To do that, in *Data collection* → *Templates* click on *Create template*. This will present us with a template configuration form.  ![](../../../assets/en/manual/quickstart/new_template.png){width="600"}  All mandatory input fields are marked with a red asterisk.  The required parameters to enter here are:  ***Template name***  -   Enter a template name. Alpha-numericals, spaces and underscores are     allowed.  ***Template groups***  -   Select one or several groups by clicking *Select* button. The     template must belong to a group.  ::: noteclassic Access permissions to template groups are assigned in the [user group](/manual/quickstart/login#adding-permissions) configuration on the **Template permissions** tab in the same way as host permissions. All access permissions are assigned to groups, not individual templates, that's why including the template into at least one group is mandatory.  :::   When done, click *Add*. Your new template should be visible in the list of templates. You can also use the [filter](/manual/web_interface/frontend_sections/data_collection/templates#using-filter) to find your template.  ![](../../../assets/en/manual/quickstart/template_list.png){width="600"}  As you may see, the template is there, but it holds nothing in it - no items, triggers or other entities.
ca	 #### Afegir una plantilla  Per començar a treballar amb plantilles, primer hem de crear-ne una. Per fer-ho, a *Recull de dades→ Plantilles* feu clic a *Crear una plantilla*. Això presentarà un formulari de configuració de plantilla.\  ![](../../../assets/en/manual/quickstart/new_template.png){width="600"}  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Els paràmetres necessaris per introduir aquí són:  ***Nom de la plantilla***  - Introduïu el nom de la plantilla. Es permeten caràcters alfanumèrics, espais i guions baixos.  ***Grups de plantilles***  - Trieu un o més grups fent clic al botó *Triar*. El model ha de pertànyer a un grup.  ::: noteclassic Els permisos d'accés als grups de plantilles s'assignen a la configuració [grup d'usuaris](/manual/quickstart/login#adding-permissions) a la pestanya **Permisos de plantilla** de la mateixa manera que els permisos de l'equip. Tots els permisos d'accés s'assignen als grups, no plantilles individuals, per això és obligatori incloure la plantilla en almenys un grup.  :::  Quan hagueu acabat, fes clic a *Afegir*. La vostra nova plantilla hauria de ser visible al llistat de plantilles. També podeu emprar el [filtre](/manual/web_interface/frontend_sections/data_collection/templates#using-filter) per trobar la teva plantilla.   ![](../../../assets/en/manual/quickstart/template_list.png){width="600"}  Com podeu veure, el model hi és, però no conté res, ni elements, triggers ni altres entitats.

en-us	#### Adding trigger  To configure a trigger for our item, go to *Data collection → Hosts*, find 'New host' and click on *Triggers* next to it and then on *Create trigger*. This presents us with a trigger definition form.\ ![](../../../assets/en/manual/quickstart/new_trigger.png){width="600"}  For our trigger, the essential information to enter here is:  *Name*  -   Enter *CPU load too high on 'New host' for 3 minutes* as the value.     This will be the trigger name displayed in lists and elsewhere.  *Expression*  -   Enter: avg(/New host/system.cpu.load,3m)>2  This is the trigger expression. Make sure that the expression is entered right, down to the last symbol. The item key here (system.cpu.load) is used to refer to the item. This particular expression basically says that the problem threshold is exceeded when the CPU load average value for 3 minutes is over 2. You can learn more about the [syntax of trigger expressions](/manual/config/triggers/expression).  When done, click *Add*. The new trigger should appear in the trigger list.
ca	#### Afegir un trigger  Per configurar un trigger al nostre element, aneu a *Recull de dades→ Equips*, cerqueu 'Equip nou' i feu clic a *Triggers* a la mateixa línia i després a *Creat trigger*. Això ens presenta una forma de definició de trigger.\ ![](../../../assets/en/manual/quickstart/new_trigger.png){width="600"}  Per al nostre trigger, la informació essencial a proporcionar és:  *Nom*  - Introduïu: *Càrrega de CPU massa alta a 'Nou equi'" durant 3 minuts* com a valor. Aquest serà el nom del trigger que es veu a les llistes i aqualsevol altre lloc.  *Expressió*  - Introduïu: avg(/New host/system.cpu.load,3m)>2  Aquesta és l'expressió trigger. Assegureu-vos que l'expressió s'emplena correctament, fins al darrer símbol. La clau d'element aquí (system.cpu.load) s'empra per fer referència a l'element. Aquesta expressió en particular indica bàsicament que es supera el llindar del problema quan el valor mitjà de càrrega de la CPU durant 3 minuts és superior a 2. Podeu obtindre més informació sobre la [sintaxi de les expressions trigger](/manual/config/triggers/expression).  Quan hàgiu acabat, feu clic a *Afegir*. El nou trigger hauria d'aparèixer al llistat de triggers.

en-us	#### Adding user  To view information about users, go to *Users → Users*.  ![](../../../assets/en/manual/quickstart/userlist.png){width="600"}  To add a new user, click on *Create user*.  In the new user form, make sure to add your user to one of the existing [user groups](/manual/config/users_and_usergroups/usergroup), for example 'Zabbix administrators'.  ![](../../../assets/en/manual/quickstart/new_user.png)  All mandatory input fields are marked with a red asterisk.  By default, new users have no media (notification delivery methods) defined for them. To create one, go to the 'Media' tab and click on *Add*.  ![](../../../assets/en/manual/quickstart/new_media.png)  In this pop-up, enter an email address for the user.  You can specify a time period when the medium will be active (see [Time period specification](/manual/appendix/time_period) page for a description of the format), by default a medium is always active. You can also customize [trigger severity](/manual/config/triggers/severity) levels for which the medium will be active, but leave all of them enabled for now.  Click on *Add* to save the medium, then go to the Permissions tab.  Permissions tab has a mandatory field *Role*. The role determines which frontend elements the user can view and which actions he is allowed to perform. Press Select and select one of the roles from the list. For example, select *Admin role* to allow access to all Zabbix frontend sections, except Administration. Later on, you can modify permissions or create more user roles. Upon selecting a role, permissions will appear in the same tab:  ![user\_permissions.png](../../../assets/en/manual/config/user_permissions.png){width="600"}   Click *Add* in the user properties form to save the user. The new user appears in the userlist.  ![](../../../assets/en/manual/quickstart/userlist2.png){width="600"}
ca	#### Afegir un usuari  Per veure informació sobre usuaris, aneu a *Usuaris → Usuaris*.  ![](../../../assets/en/manual/quickstart/userlist.png){width="600"}  Per afegir un usuari nou, feu clic a *Crear usuari*.  Al formulari d'usuari nou, assegureu-vos d'afegir el vostre usuari en un dels [grups d'usuaris](/manual/config/users_and_usergroups/usergroup) existents, per exemple, administradors Zabbix'.  ![](../../../assets/en/manual/quickstart/new_user.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  De manera predeterminada, els usuaris nous no tenen cap suport (mètodes de lliurament de notificacions) definit per a ells. Per crear-ne un, aneu a la pestanya 'Suports' i feu clic a *Afegir*.  ![](../../../assets/en/manual/quickstart/new_media.png)  En aquesta finestra, introduïu una adreça de correu electrònic per a aquest usuari.  Podeu especificar un període durant el qual el suport serà actiu (veieu la pàgina [Especificació de period](/manual/appendix/time_period) per a la descripció del format), per defecte un suport sempre és actiu. També podeu personalitzar els nivells de [gravetat del trigger](/manual/config/triggers/severity) per als quals el suport serà actiu, però deixeu-los tots activats de moment.  Feu clic a *Afegir* per desar el suport i, a continuació, aneu a la pestanya Permisos.  La pestanya Permisos té un camp *Rol* obligatori. El rol determina quines interfícies pot veure l'usuari i quines accions té permesese. Premeu Triar i trieu un dels rols de la llista. Per exemple, trieu *Rol d'administrador* per permetre l'accés a totes les seccions de la interfície Zabbix excepte l'administració. Més endavant podeu canviar els permisos o crear més rols d'usuari. En triar un rol, els permisos apareixeran a la mateixa pestanya:  ![usuari\_permissions.png](../../../assets/en/manual/quickstart/user_permissions.png){width="600"}  Feu clic a *Afegir* al formulari de propietats de l'usuari per desar l'usuari. El nou usuari apareix a la llista d'usuaris.  ![](../../../assets/en/manual/quickstart/userlist2.png){width="600"}

en-us	#### Adding web scenarios  To add web scenarios to a template in *Data collection* → *Templates*, do the following:  1. Click on *Web* in the row of the template. 2. Configure a web scenario following the usual method of [configuring web scenarios](/manual/web_monitoring#configuring_a_web_scenario).
ca	#### Afegir escenaris Web  Per afegir escenaris web a una plantilla a *Recollida de dades* → *Plantilles*, feu el següent:  1. Feu clic a *Web* a la filera de la plantilla. 2. Configureu un escenari web seguint el mètode habitual de [configuració d'escenaris web](/manual/web_monitoring#configuring_a_web_scenario).

en-us	#### Adding widgets  To add a widget to a dashboard:  -   Click on the     ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_add_button.png)     button or the *Add widget* option in the action menu that can be     opened by clicking on the arrow. Fill the widget configuration form.     The widget will be created in its default size and placed after the     existing widgets (if any);  Or  -   Move your mouse to the desired empty spot for the new widget. Notice     how a placeholder appears, on mouseover, on any empty slot on the     dashboard. Then click to open the widget configuration form. After     filling the form the widget will be created in its default size or,     if its default size is bigger than is available, take up the     available space. Alternatively, you may click and drag the     placeholder to the desired widget size, then release, and then fill     the widget configuration form. (Note that when there is a widget     copied onto the clipboard, you will be first prompted to select     between *Add widget* and *Paste widget* options to create a widget.)  ![](../../../../assets/en/manual/web_interface/dashboard_click.png)  ![](../../../../assets/en/manual/web_interface/dashboard_select.png)  In the widget configuration form:  -   Select the *Type* of widget -   Enter widget parameters -   Click on *Add*  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_add.png)  #### Widgets  A wide variety of [widgets](/manual/web_interface/frontend_sections/dashboards/widgets) (e.g. [Clock](/manual/web_interface/frontend_sections/dashboards/widgets/clock), [Host availability](/manual/web_interface/frontend_sections/dashboards/widgets/host_availability) or [Trigger overview](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview)) can be added to a dashboard: these can be resized and moved around the dashboard in dashboard editing mode by clicking on the widget title bar and dragging it to a new location. Also, you can click on the following buttons in the top-right corner of the widget to:  -   ![](../../../../assets/en/manual/web_interface/widget_edit.png) -     edit a widget; -   ![](../../../../assets/en/manual/web_interface/button_widget_menu.png) -     access the [widget menu](#widget_menu)  Click on *Save changes* for the dashboard to make any changes to the widgets permanent.
ca	#### Afegint ginys  Per afegir un giny a un tauler:  - Feu clic al botó ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/dashboard_add_button.png) o a l'opció *Afegir un giny* al menú d'acció que s'obrirà fent clic a la fletxa. Ompliu el formulari de configuració del giny. El giny es crearà amb la seva mida predeterminada i es posarà després dels ginys existents (si n'hi ha);  O  - Moveu el ratolí al lloc buit desitjat per al nou giny. Observeu com apareix un marcador de posició, al passar el ratolí, a qualsevol escletxa buida del tauler. A continuació, feu clic per obrir el formulari de configuració del giny. Després d'omplir el formulari, el giny es crearà amb la seva mida predeterminada o, si la seva mida per defecte és més gran que la disponible, ocuparà l'espai disponible. Alternativament, podeu fer clic i arrossegar el marcador de posició fins a la mida desitjada, després deixar anar i omplir el formulari de configuració del giny. (Tingueu en compte que quan hi hagi un giny copiat al porta-retalls, primer se us demanarà que seleccioneu entre les opcions *Afegir un giny* i *Enganxa un giny* per crear un giny.)  ![](../../../../assets/en/manual/web_interface/dashboard_click.png)  ![](../../../../assets/en/manual/web_interface/dashboard_select.png)  Al formulari de configuració del giny:  - Seleccioneu el *Tipus* de giny - Introduïu els paràmetres del giny - Feu clic a *Afegeir*  ![](../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widget_add.png)  #### Ginys  Una àmplia varietat de [ginys](/manual/web_interface/frontend_sections/dashboards/widgets) (p. ex., [Rellotge](/manual/web_interface/frontend_sections/dashboards/widgets/clock), [Disponibilitat de l'equip](/manual/web_interface/frontend_sections /dashboards/widgets/host_availability) o [Vista general de trigger](/manual/web_interface/frontend_sections/dashboards/widgets/trigger_overview)) es poden afegir a un tauler: es poden redimensionar i moure pel tauler en el mode d'edició del tauler fent clic a la barra de títol del giny i arrossegant-lo a una nova ubicació. A més, podeu fer clic als botons següents a l'extrem superior dret del giny per:  - ![](../../../../assets/en/manual/web_interface/widget_edit.png) - edita un giny; - ![](../../../../assets/en/manual/web_interface/button_widget_menu.png) - accediu al [menú del giny](#widget_menu)  Feu clic a *Desar els canvis* per al tauler per fer que els canvis als ginys siguin permanents.

en-us	### Adding Zabbix repository  Install the repository configuration package. This package contains yum (software package manager) configuration files.  SLES 15:      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/15/x86_64/zabbix-release-7.0-1.sles15.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'   SLES 12 (proxy only):      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/12/x86_64/zabbix-release-7.0-1.sles12.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'   Please note that Zabbix web service process, which is used for [scheduled report generation](/manual/web_interface/frontend_sections/reports/scheduled), requires Google Chrome browser. The browser is not included into packages and has to be installed manually.
ca	### Afegir el repositori de Zabbix  Instal·leu el paquet de configuració del repositori. Aquest paquet conté els fitxers de configuració yum (gestor de paquets de programari).  SLES 15 :      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/15/x86_64/zabbix-release-7.0-1.sles15.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'  SLES 12 (només proxy):      rpm -Uvh --nosignature https://repo.zabbix.com/zabbix/7.0/sles/12/x86_64/zabbix-release-7.0-1.sles12.noarch.rpm     zypper --gpg-auto-import-keys refresh 'Zabbix Official Repository'  Tingueu en compte que el procés del servei web de Zabbix, que s'empra per [generar informes programats](/manual/web_interface/frontend_sections/reports/scheduled), requereix el navegador Google Chrome. El navegador no és pas inclòs als paquets i s'ha d'instal·lar a banda.

en-us	#### Additional parameters  **bucket\_rate\_foreach**  A third optional parameter is supported by the *bucket\_rate\_foreach* function:      bucket_rate_foreach(item filter,time period,<parameter number>)  where <parameter number> is the position of the "bucket" value in the item key. For example, if the "bucket" value in myItem\[aaa,0.2\] is '0.2', then its position is 2.  The default value of <parameter number> is '1'.  **count\_foreach**  Third and fourth optional parameters are supported by the *count\_foreach* function:      count_foreach(item filter,time period,<operator>,<pattern>)  Where:  -   **operator** is the conditional operator for item values (must be double-quoted). Supported `operators`:<br>*eq* - equal<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br> -   **pattern** is the required pattern (string arguments must be double-quoted); supported if *operator* is specified in the third parameter.  Comments:  -   Optional parameters *operator* or *pattern* can't be left empty after a comma, only fully omitted. -   With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number_to_compare_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number_to_compare_with*. If the result of "bitwise AND" is equal to *number_to_compare_with*, the value is counted.<br>If *number_to_compare_with* and *mask* are equal, only the *mask* need be specified (without '/'). -   With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.  See [aggregate calculations](/manual/config/items/itemtypes/calculated/aggregate) for more details and examples on using foreach functions.
ca	##### Paràmetres addicionals  **bucket\_rate\_foreach**  Un tercer paràmetre opcional és compatible amb la funció *bucket\_rate\_foreach*:       bucket_rate_foreach(filtre d'elements, període de temps, <nombre de paràmetre>)  on el <nombre de paràmetre> és la posició del valor del "bucket" a la clau de l'element. Per exemple, si el valor del "bucket" a myItem\[aaa,0.2\] és '0,2', aleshores la seva posició és 2.  El valor per defecte del <nombre de paràmetre> és '1'.  **count\_foreach**  El tercer i quart paràmetres opcionals s'admeten amb la funció *count\_foreach*:  count_foreach(item filter,time period,<operator>,<pattern>)  On:  - **operador** és l'operador condicional per als valors d'element (ha d'estar entre cometes dobles). "Operadors" admesos:<br>*eq* - igual<br>*ne* - no igual<br>*gt* - major<br>*ge* - major o igual<br>*lt* - menys<br >*le* - menor o igual<br>*com* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp*: coincidència sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br>- **patró** és el patró requerit (els arguments de cadena han d'estar entre cometes); suportat si s'especifica *operador* al tercer paràmetre.  Comentaris:- Els paràmetres opcionals *operador* o *patró* no es poden deixar buits després d'una coma, només s'ometen completament.- Amb *bitand* com a tercer paràmetre, el quart paràmetre `patró` es pot especificar com a dos números, separats per '/': **número_a_comparar_amb/màscara**. count() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *número_per_comparar_amb*. Si el resultat de "AND bit a bit" és igual a *nombre_a_comparar_amb*, es compta el valor.<br>Si *número_a_comparar_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').- Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser una expressió regular ordinària o [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global de les expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemat a la base de dades) i binària (utilitzada pel servidor Zabbix) pot afectar el quart dígit decimal.  Veieu [càlculs agregats](/manual/config/items/itemtypes/calculated/aggregate) per a més detalls i exemples sobre com emprar les funcions foreach.

en-us	### Add JavaScript to the widget  In this section, you will learn how to add a gauge chart - made using JavaScript - that shows if the latest value is normal or too high/too low.  1. Create a *widget.edit.js.php* file in the *views* directory.  JavaScript will be responsible for initializing the color picker in the configuration view.  **ui/modules/lesson_gauge_chart/views/widget.edit.js.php**  ```php <?php  use Modules\LessonGaugeChart\Widget;  ?>  window.widget_lesson_gauge_chart_form = new class {      init({color_palette}) {         this._unit_select = document.getElementById('value_units');         this._unit_value = document.getElementById('value_static_units');          this._unit_select.addEventListener('change', () => this.updateForm());          colorPalette.setThemeColors(color_palette);          for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) {             jQuery(colorpicker).colorpicker();         }          const overlay = overlays_stack.getById('widget_properties');          for (const event of ['overlay.reload', 'overlay.close']) {             overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); });         }          this.updateForm();     }      updateForm() {         this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>;     } }; ```  2. Open *views/widget.edit.php* and add the *widget.edit.js.php* file with the JavaScript to the configuration view. To do this, use the *includeJsFile()* method. To add inline JavaScript, use the *addJavaScript()* method.  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  use Modules\LessonGaugeChart\Includes\WidgetForm;  $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);  (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])             )     )     ->includeJsFile('widget.edit.js.php')     ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([         'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE     ], JSON_THROW_ON_ERROR).');')     ->show(); ```  3. Return to the dashboard, click on the gear icon in the widget to open the widget configuration form. Now, expand the *Advanced configuration* section to see the initialized color picker. Fill in the fields with values and select a color for the gauge chart.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_b.png){width="600"}  4. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard.  5. Open *actions/WidgetView.php* and update the controller.  The **$this->fields_values** property now contains the values of all the *Advanced configuration* fields. Finalize the controller to enable passing the configuration and selected item value to the widget view.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use API,     CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {         $db_items = API::Item()->get([             'output' => ['itemid', 'value_type', 'name', 'units'],             'itemids' => $this->fields_values['itemid'],             'webitems' => true,             'filter' => [                 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT]             ]         ]);          $history_value = null;          if ($db_items) {             $item = $db_items[0];              $history = API::History()->get([                 'output' => API_OUTPUT_EXTEND,                 'itemids' => $item['itemid'],                 'history' => $item['value_type'],                 'sortfield' => 'clock',                 'sortorder' => ZBX_SORT_DOWN,                 'limit' => 1             ]);              if ($history) {                 $history_value = convertUnitsRaw([                     'value' => $history[0]['value'],                     'units' => $item['units']                 ]);             }         }          $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'history' => $history_value,             'fields_values' => $this->fields_values,             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  6. Open and modify *views/widget.view.php*.  You need to create a container for the gauge chart, which you will draw in the next steps, and a container for the description.  To pass values to JavaScript as a JSON object, use the *setVar()* method.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem([         (new CDiv())->addClass('chart'),         $data['fields_values']['description']             ? (new CDiv($data['fields_values']['description']))->addClass('description')             : null     ])     ->setVar('history', $data['history'])     ->setVar('fields_values', $data['fields_values'])     ->show(); ```  7. Create a new directory *assets* in the *lesson_gauge_chart* directory. This directory will be used for storing JavaScript, CSS, and potentially any other assets, such as fonts or images.  8. For widget view JavaScript, create a directory *js* in the *assets* directory.  9. Create a *class.widget.js* file in the *assets/js* directory.  This JavaScript widget class will extend the base JavaScript class of all dashboard widgets - *CWidget*.  The dashboard relies on a correct implementation of a widget and communicates any relevant information to the widget through calling the respective JavaScript methods. The dashboard also expects the widget to generate events when some interaction occurs. Thus, the *CWidget* class contains a set of methods with the default implementation of widget behavior, which can be customized by extending the class.  In this case, some customization is necessary, therefore custom logic will be implemented for the following widget behavior:  -   widget initialization that is responsible for defining the initial state of the widget (see the *onInitialize()* method); -   displaying widget contents (that is, drawing the gauge chart) if the widget update process has been successful and without errors (see the *processUpdateResponse(response)* method and the related *\_resizeChart()* and *\_updatedChart()* methods) -   resizing the widget (see the *onResize()* method and the related *\_resizeChart()* method)  For other aspects of the gauge chart widget, the default implementation for widget behavior will be used. To learn more about the JavaScript methods of the *CWidget* class, see: [JavaScript](/devel/modules/widgets/presentation/javascript).  Since this JavaScript is required for the widget view, it should be loaded with the dashboard page. To enable JavaScript loading, you will need to update the *assets/js* and *js_class* parameters in the ***manifest.json*** file as shown in step 10.  **ui/modules/lesson_gauge_chart/assets/js/class.widget.js**  ```js class WidgetLessonGaugeChart extends CWidget {      static UNIT_AUTO = 0;     static UNIT_STATIC = 1;      onInitialize() {         super.onInitialize();          this._refresh_frame = null;         this._chart_container = null;         this._canvas = null;         this._chart_color = null;         this._min = null;         this._max = null;         this._value = null;         this._last_value = null;         this._units = '';     }      processUpdateResponse(response) {         if (response.history === null) {             this._value = null;             this._units = '';         }         else {             this._value = Number(response.history.value);             this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO                 ? response.history.units                 : response.fields_values.value_static_units;         }          this._chart_color = response.fields_values.chart_color;         this._min = Number(response.fields_values.value_min);         this._max = Number(response.fields_values.value_max);          super.processUpdateResponse(response);     }      setContents(response) {         if (this._canvas === null) {             super.setContents(response);              this._chart_container = this._body.querySelector('.chart');             this._chart_container.style.height =                 `${this._getContentsSize().height - this._body.querySelector('.description').clientHeight}px`;             this._canvas = document.createElement('canvas');              this._chart_container.appendChild(this._canvas);              this._resizeChart();         }          this._updatedChart();     }      onResize() {         super.onResize();          if (this._state === WIDGET_STATE_ACTIVE) {             this._resizeChart();         }     }      _resizeChart() {         const ctx = this._canvas.getContext('2d');         const dpr = window.devicePixelRatio;          this._canvas.style.display = 'none';         const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight);         this._canvas.style.display = '';          this._canvas.width = size * dpr;         this._canvas.height = size * dpr;          ctx.scale(dpr, dpr);          this._canvas.style.width = `${size}px`;         this._canvas.style.height = `${size}px`;          this._refresh_frame = null;          this._updatedChart();     }      _updatedChart() {         if (this._last_value === null) {             this._last_value = this._min;         }          const start_time = Date.now();         const end_time = start_time + 400;          const animate = () => {             const time = Date.now();              if (time <= end_time) {                 const progress = (time - start_time) / (end_time - start_time);                 const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2;                 let value = this._value !== null ? this._value : this._min;                 value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min);                  const ctx = this._canvas.getContext('2d');                 const size = this._canvas.width;                 const char_weight = size / 12;                 const char_shadow = 3;                 const char_x = size / 2;                 const char_y = size / 2;                 const char_radius = (size - char_weight) / 2 - char_shadow;                  const font_ratio = 32 / 100;                  ctx.clearRect(0, 0, size, size);                  ctx.beginPath();                 ctx.shadowBlur = char_shadow;                 ctx.shadowColor = '#bbb';                 ctx.strokeStyle = '#eee';                 ctx.lineWidth = char_weight;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false);                 ctx.stroke();                  ctx.beginPath();                 ctx.strokeStyle = `#${this._chart_color}`;                 ctx.lineWidth = char_weight - 2;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75,                     Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false                     );                 ctx.stroke();                  ctx.shadowBlur = 2;                 ctx.fillStyle = '#1f2c33';                 ctx.font = `${(char_radius * font_ratio)|0}px Arial`;                 ctx.textAlign = 'center';                 ctx.textBaseline = 'middle';                 ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`,                     char_x, char_y, size - char_shadow * 4 - char_weight * 2                 );                  ctx.fillStyle = '#768d99';                 ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`;                 ctx.textBaseline = 'top';                  ctx.textAlign = 'left';                 ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`,                     char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  ctx.textAlign = 'right';                 ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`,                     size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  requestAnimationFrame(animate);             }             else {                 this._last_value = this._value;             }         };          requestAnimationFrame(animate);     } } ```  10. Open *manifest.json* and add:  - file name (*class.widget.js*) to the array in the *assets/js* section; - class name (*WidgetLessonGaugeChart*) to the *js_class* parameter in the *widget* section.  The *WidgetLessonGaugeChart* class will now be automatically loaded with the dashboard.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "js": ["class.widget.js"]     } } ```
ca	### Afegir JavaScript al giny.  En aquesta secció, aprendreu a afegir un gràfic de calibre -fet amb Javascript - que ensenya si el darrer valor és normal o massa alt / massa baix.  1. Creeu un fitxer *widget.edit.js.php* dins del directori *views*.  JavaScript serà responsable d'inicialitzar el selector de colors a la vista de configuració.     **ui/modules/lesson_gauge_chart/views/widget.edit.js.php**  ```php <?php  use Modules\LessonGaugeChart\Widget;  ?>  window.widget_lesson_gauge_chart_form = new class {      init({color_palette}) {         this._unit_select = document.getElementById('value_units');         this._unit_value = document.getElementById('value_static_units');          this._unit_select.addEventListener('change', () => this.updateForm());          colorPalette.setThemeColors(color_palette);          for (const colorpicker of jQuery('.<?= ZBX_STYLE_COLOR_PICKER ?> input')) {             jQuery(colorpicker).colorpicker();         }          const overlay = overlays_stack.getById('widget_properties');          for (const event of ['overlay.reload', 'overlay.close']) {             overlay.$dialogue[0].addEventListener(event, () => { jQuery.colorpicker('hide'); });         }              this.updateForm();     }          updateForm() {         this._unit_value.disabled = this._unit_select.value == <?= Widget::UNIT_AUTO ?>;     } }; ```  2. Obriu *views/widget.edit.php* i afegiu l'arxiu *widget.edit.js.php* amb el JavaScript a la vista de configuració.                              Per fer-ho, empreu el mètode *includeJsFile()*. Per afegir JavaScript en línia, empreu el mètode *addJavaScript()*.      **ui/modules/lesson_gauge_chart/views/widget.edit.php**      ```php <?php      /**  * Visualització del formulari del giny del gràfic de mesura.  *  * @var CView $this  * @var array $data  */      use Modules\LessonGaugeChart\Includes\WidgetForm;      $lefty_units = new CWidgetFieldSelectView($data['fields']['value_units']); $lefty_static_units = (new CWidgetFieldTextBoxView($data['fields']['value_static_units']))     ->setPlaceholder(_('value'))     ->setWidth(ZBX_TEXTAREA_TINY_WIDTH);      (new CWidgetFormView($data))     ->addField(         (new CWidgetFieldMultiSelectItemView($data['fields']['itemid']))             ->setPopupParameter('numeric', true)     )     ->addFieldset(         (new CWidgetFormFieldsetCollapsibleView(_('Advanced configuration')))             ->addField(                 new CWidgetFieldColorView($data['fields']['chart_color'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_min'])             )             ->addField(                 new CWidgetFieldNumericBoxView($data['fields']['value_max'])             )             ->addItem([                 $lefty_units->getLabel(),                 (new CFormField([                     $lefty_units->getView()->addClass(ZBX_STYLE_FORM_INPUT_MARGIN),                     $lefty_static_units->getView()                 ]))             ])             ->addField(                 new CWidgetFieldTextBoxView($data['fields']['description'])          )     ->includeJsFile('widget.edit.js.php')     ->addJavaScript('widget_lesson_gauge_chart_form.init('.json_encode([         'color_palette' => WidgetForm::DEFAULT_COLOR_PALETTE     ], JSON_THROW_ON_ERROR).');')     ->show(); ```    3. Torneu al tauler, premeu la icona d'engranatge al giny per obrir el formulari de configuració del giny. Ara, expandiu la secció de *Configuració avançada* per veure el selector de color inicialitzat. Ompliu els camps amb els valors i trieu el color del gràfic.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_advanced_b.png){width=600} 4. Feu clic a *Aplicar* al formulari de configuració del giny. Tot seguit, premeu *Desar canvis* a la cantonada superior dreta per desar el tauler.                        5. Obriu *actions/WidgetView.php* i actualitzeu el controlador.  La propietat **$this->fields_values** ara conté els valors de tots els camps *Configuració avançada*. Finalitzeu el controlador per permetre passar la configuració i el valor de l'element triat a la vista del giny.                                                                 **ui/modules/lesson_gauge_chart/actions/WidgetView.php**      ```php <?php      namespace Modules\LessonGaugeChart\Actions;      use API,     CControllerDashboardWidgetView,     CControllerResponseData;      class WidgetView extends CControllerDashboardWidgetView {          protected function doAction(): void {         $db_items = API::Item()->get([             'output' => ['itemid', 'value_type', 'name', 'units'],             'itemids' => $this->fields_values['itemid'],             'webitems' => true,             'filter' => [                 'value_type' => [ITEM_VALUE_TYPE_UINT64, ITEM_VALUE_TYPE_FLOAT]             ]         ]);              $history_value = null;              if ($db_items) {             $item = $db_items[0];                  $history = API::History()->get([                 'output' => API_OUTPUT_EXTEND,                 'itemids' => $item['itemid'],                 'history' => $item['value_type'],                 'sortfield' => 'clock',                 'sortorder' => ZBX_SORT_DOWN,                 'limit' => 1             ]);                  if ($history) {                 $history_value = convertUnitsRaw([                     'value' => $history[0]['value'],                     'units' => $item['units']                 ]);             }         }              $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'history' => $history_value,             'fields_values' => $this->fields_values,             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```     6. Obriu i modifiqueu *views/widget.view.php*  Heu de crear un contenidor per al gràfic de mesura, que dibuixareu a les passes següents, i un contenidor per a la descripció.  Per passar valors a JavaScript com a objecte JSON, empreu el mètode *setVar()*.                           **ui/modules/lesson_gauge_chart/views/widget.view.php**      ```php <?php      /**  * Visualització del giny del gràfic de mesura.  *  * @var CView $this  * @var array $data  */      (new CWidgetView($data))     ->addItem([         (new CDiv())->addClass('chart'),         $data['fields_values']['description']             ? (new CDiv($data['fields_values']['description']))->addClass('description')             : null     ])     ->setVar('history', $data['history'])     ->setVar('fields_values', $data['fields_values'])     ->show(); ```      7. Creeu un directori *actius* al *lesson_gauge_chart*. Aquest directori s'emprarà per emmagatzemar Javascript, CSS i, potencialment, qualsevol altre actiu, com fonts o imatges.  8. Per a JavaScript de visualització de ginys, creeu un directori *js* dins del directori *assets*.                                  9. Creeu un fitxer *widget.js* al directori *assets/js*.  Aquesta classe de widget de JavaScript ampliarà la classe de JavaScript base de tots els ginys del tauler - *CWidget*.  El tauler de control es basa en una implementació correcta d'un giny i comunica qualsevol informació rellevant al giny mitjançant la crida als mètodes JavaScript respectius. El tauler també espera que el giny generi esdeveniments quan es produeixi alguna interacció. Així, la classe *CWidget* conté un conjunt de mètodes amb la implementació predeterminada del comportament del giny, que es pot personalitzar ampliant la classe.  En aquest cas, cal una mica de personalització; per tant, s'implementarà una lògica personalitzada per al comportament del giny següent:                                                                   -inicialització del giny que s'encarrega de definir l'estat inicial del giny (veieu el mètode *\_init()*); -mostrar el contingut del giny (és a dir, dibuixar el gràfic de l'indicador) si el procés d'actualització del giny ha estat satisfactori i sense errors (veieu el mètode *\_processUpdateResponse(response)* i els mètodes *\_resizeChart()* i *\_updatedChart()* relacionats) -canviar la mida del giny (veieu el mètode *resize()* i el mètode *\_resizeChart()* relacionat)  Per a altres aspectes del giny del gràfic gauge, s'utilitzarà la implementació predeterminada del comportament del giny. Per obtenir més informació sobre els mètodes JavaScript de la classe *CWidget*, consulteu: [JavaScript](/devel/modules/widgets/presentation/javascript).                            Com que aquest JavaScript és necessari per a la vista del widget, s'hauria de carregar amb la pàgina del tauler.                                                                 Per habilitar la càrrega de JavaScript, haureu d'actualitzar els paràmetres *assets/js* i *js_class* de **manifest.json** tal com es veu a la passa següent.      **ui/modules/lesson_gauge_chart/assets/js/class.widget.js**      ```js class WidgetLessonGaugeChart extends CWidget {          static UNIT_AUTO = 0;     static UNIT_STATIC = 1;          onInitialize() {         super.onInitialize();              this._refresh_frame = null;         this._chart_container = null;         this._canvas = null;         this._chart_color = null;         this._min = null;         this._max = null;         this._value = null;         this._last_value = null;         this._units = '';     }          processUpdateResponse(response) {         if (response.history === null) {             this._value = null;             this._units = '';         }         else {             this._value = Number(response.history.value);             this._units = response.fields_values.value_units == WidgetLessonGaugeChart.UNIT_AUTO                 ? response.history.units                 : response.fields_values.value_static_units;         }              this._chart_color = response.fields_values.chart_color;         this._min = Number(response.fields_values.value_min);         this._max = Number(response.fields_values.value_max);          super.processUpdateResponse(response);     }      setContents(response) {         if (this._canvas === null) {             super.setContents(response);             this._chart_container = this._body.querySelector('.chart');             this._chart_container.style.height =                 `${this._getContentsSize().height - this._body.querySelector('.description').clientHeight}px`;             this._canvas = document.createElement('canvas');              this._chart_container.appendChild(this._canvas);              this._resizeChart();         }          this._updatedChart();     }          onResize() {         super.onResize();          if (this._state === WIDGET_STATE_ACTIVE) {             this._resizeChart();         }     }          _resizeChart() {         const ctx = this._canvas.getContext('2d');         const dpr = window.devicePixelRatio;          this._canvas.style.display = 'none';         const size = Math.min(this._chart_container.offsetWidth, this._chart_container.offsetHeight);         this._canvas.style.display = '';          this._canvas.width = size * dpr;         this._canvas.height = size * dpr;          ctx.scale(dpr, dpr);          this._canvas.style.width = `${size}px`;         this._canvas.style.height = `${size}px`;          this._refresh_frame = null;          this._updatedChart();     }      _updatedChart() {         if (this._last_value === null) {             this._last_value = this._min;         }          const start_time = Date.now();         const end_time = start_time + 400;          const animate = () => {             const time = Date.now();              if (time <= end_time) {                 const progress = (time - start_time) / (end_time - start_time);                 const smooth_progress = 0.5 + Math.sin(Math.PI * (progress - 0.5)) / 2;                 let value = this._value !== null ? this._value : this._min;                 value = (this._last_value + (value - this._last_value) * smooth_progress - this._min) / (this._max - this._min);                  const ctx = this._canvas.getContext('2d');                 const size = this._canvas.width;                 const char_weight = size / 12;                 const char_shadow = 3;                 const char_x = size / 2;                 const char_y = size / 2;                 const char_radius = (size - char_weight) / 2 - char_shadow;                  const font_ratio = 32 / 100;                  ctx.clearRect(0, 0, size, size);                  ctx.beginPath();                 ctx.shadowBlur = char_shadow;                 ctx.shadowColor = '#bbb';                 ctx.strokeStyle = '#eee';                 ctx.lineWidth = char_weight;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.749, Math.PI * 2.251, false);                 ctx.stroke();                  ctx.beginPath();                 ctx.strokeStyle = `#${this._chart_color}`;                 ctx.lineWidth = char_weight - 2;                 ctx.lineCap = 'round';                 ctx.arc(char_x, char_y, char_radius, Math.PI * 0.75,                     Math.PI * (0.75 + (1.5 * Math.min(1, Math.max(0, value)))), false                     );                 ctx.stroke();                      ctx.shadowBlur = 2;                 ctx.fillStyle = '#1f2c33';                 ctx.font = `${(char_radius * font_ratio)|0}px Arial`;                 ctx.textAlign = 'center';                 ctx.textBaseline = 'middle';                 ctx.fillText(`${this._value !== null ? this._value : t('No data')}${this._units}`,                     char_x, char_y, size - char_shadow * 4 - char_weight * 2                 );                  ctx.fillStyle = '#768d99';                 ctx.font = `${(char_radius * font_ratio * .5)|0}px Arial`;                 ctx.textBaseline = 'top';                  ctx.textAlign = 'left';                 ctx.fillText(`${this._min}${this._min != '' ? this._units : ''}`,                     char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  ctx.textAlign = 'right';                 ctx.fillText(`${this._max}${this._max != '' ? this._units : ''}`,                     size - char_weight * .75, size - char_weight * 1.25, size / 2 - char_weight                 );                  requestAnimationFrame(animate);             }             else {                 this._last_value = this._value;             }         };              requestAnimationFrame(animate);     } } ```      10. Obriu *manifest.json* i afegiu:  - nom del fitxer (*class.widget.js*) a la matriu a la secció *assets/js*. - nom de classe (*WidgetLessonGaugeChart*) al paràmetre *js_class* a la secció *widget*.                                              La classe *WidgetLessonGaugeChart* ara es carregarà automàticament amb el tauler.      **ui/modules/lesson_gauge_chart/manifest.json**      ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     },     "widget": {         "js_class": "WidgetLessonGaugeChart"     },     "assets": {         "js": ["class.widget.js"]     } } ```

en-us	### Add settings to a configuration view and use them in a widget view  In this section, you will learn how to add a widget configuration field and show the entered value in the widget view as text.  The widget configuration consists of a form (*Zabbix\\Widgets\\CWidgetForm*) and a widget form view (*widget.edit.php*). To add fields (*Zabbix\\Widgets\\CWidgetField*), you need to create a *WidgetForm* class, which will extend *Zabbix\\Widgets\\CWidgetForm*.  The form contains the set of fields (*Zabbix\\Widgets\\CWidgetField*) of various types, which are used to validate user-entered values. The form field (*Zabbix\\Widgets\\CWidgetField*) for each input element type converts the value into a single format to store it in the database.  :::noteclassic The widget's **form** file should be located in the *includes* directory (for this tutorial, *ui/modules/lesson_gauge_chart/includes/*). If the file has the default name *WidgetForm.php*, you do not need to register it in the *manifest.json* file. If the file has a different name, specify it in the *widget/form_class* section of the [manifest.json](devel/modules/file_structure/manifest) file. :::  1. Create a new directory *includes* in the *lesson_gauge_chart* directory.  2. Create a *WidgetForm.php* file in the *includes* directory.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  class WidgetForm extends CWidgetForm { } ```  3. Add a *Description* field to widget configuration form. This is a regular text field, where a user can enter any character set. You can use the *CWidgetFieldTextBox* class for it.  **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**  ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  use Zabbix\Widgets\Fields\CWidgetFieldTextBox;  class WidgetForm extends CWidgetForm {      public function addFields(): self {         return $this             ->addField(                new CWidgetFieldTextBox('description', _('Description'))             );    } } ```  4. In the *views* directory, create a widget configuration view file *widget.edit.php* and add a view for the new *Description* field. For the *CWidgetFieldTextBox* field class, the view is *CWidgetFieldTextBoxView.*  **ui/modules/lesson_gauge_chart/views/widget.edit.php**  ```php <?php  /**  * Gauge chart widget form view.  *  * @var CView $this  * @var array $data  */  (new CWidgetFormView($data))     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description'])     )     ->show(); ```  5. Go to the dashboard and click on the gear icon in the widget to open the widget configuration form.  6. The widget configuration form now contains a new *Description* text field. Enter any value, for example, *Gauge chart description*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_descr.png){width="600"}  7. Click on *Apply* in the widget configuration form. Then click on *Save changes* in the top right corner to save the dashboard. Note that the new description is not visible anywhere, and the widget still displays "Hello, world!".  For the new description to appear in the widget, the *Description* field value needs to be retrieved from the database and passed to the widget view. For that, you need to create an action class.  8. Create a new directory *actions* in the *lesson_gauge_chart* directory.  9. Create a *WidgetView.php* file in the *actions* directory. The *WidgetView* action class will extend the *CControllerDashboardWidgetView* class.  Values of the widget configuration fields are stored in the **$fields_values** property of the action class.  **ui/modules/lesson_gauge_chart/actions/WidgetView.php**  ```php <?php  namespace Modules\LessonGaugeChart\Actions;  use CControllerDashboardWidgetView,     CControllerResponseData;  class WidgetView extends CControllerDashboardWidgetView {      protected function doAction(): void {         $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'description' => $this->fields_values['description'],             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```  10. Open *manifest.json* and register *WidgetView* as an action class in the *actions/widget.lesson_gauge_chart.view* section.  **ui/modules/lesson_gauge_chart/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "lesson_gauge_chart",     "type": "widget",     "name": "Gauge chart",     "namespace": "LessonGaugeChart",     "version": "1.0",     "author": "Zabbix",     "actions": {         "widget.lesson_gauge_chart.view": {             "class": "WidgetView"         }     } } ```  11. Now you can use the value of the description field, contained in *$data['description']*, in the widget view. Open *views/widget.view.php* and replace the static text "Hello, world!" with *$data['description']*.  **ui/modules/lesson_gauge_chart/views/widget.view.php**  ```php <?php  /**  * Gauge chart widget view.  *  * @var CView $this  * @var array $data  */  (new CWidgetView($data))     ->addItem(         new CTag('h1', true, $data['description'])     )     ->show(); ```  12. Refresh the dashboard page. You should now see the widget description text instead of "Hello, world!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_descr.png){width="600"}
ca	 ### Afegiu paràmetres a una vista de configuració i empreu-los en una vista de giny  En aquesta secció, aprendràs a afegir un camp de configuració del giny i a mostrar el valor introduït a la vista del giny com a text.  La configuració del giny consta d'un formulari (*Zabbix\\Widgets\\CWidgetForm*) i d'una vista de formulari de giny (*widget.edit.php*). Per afegir camps (*Zabbix\\Widgets\\CWidgetField*), heu de crear una classe *WidgetForm*, que ampliarà *Zabbix\\Widgets\\CWidgetForm*.  El formulari conté el conjunt de camps (*Zabbix\\Widgets\\CWidgetField*) de diversos tipus, que s'empren per validar els valors introduïts per l'usuari. El camp de formulari (*Zabbix\\Widgets\\CWidgetField*) per a cada tipus d'element d'entrada converteix el valor en un format únic per emmagatzemar-lo a la base de dades.  :::noteclassic El fitxer **formulari** del giny s'ha d'ubicar al directori *includes* (per a aquest tutorial, *ui/modules/lesson_gauge_chart/includes/*). Si el fitxer té un nom predeterminat *WidgetForm.php*, no cal que el registreu a manifest.json. Si el fitxer té un nom diferent, especifiqueu-lo a la secció *widget/form_class* de [manifest.json](devel/modules/file_structure/manifest). :::  1. Afegiu un directori *includes* al *lesson_gauge_chart*.  2. Creeu el fitxer *WidgetForm.php* dins del directori *includes*.      **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**      ```php <?php      namespace Modules\LessonGaugeChart\Includes;      use Zabbix\Widgets\CWidgetForm;      class WidgetForm extends CWidgetForm { } ```      3. Afegiu un camp *Descripció* al formulari de configuració del giny. Aquest és un camp de text normal, on un usuari pot introduir qualsevol conjunt de caràcters. Podeu utilitzar la classe *CWidgetFieldTextBox* per a això.      **ui/modules/lesson_gauge_chart/includes/WidgetForm.php**      ```php <?php  namespace Modules\LessonGaugeChart\Includes;  use Zabbix\Widgets\CWidgetForm;  use Zabbix\Widgets\Fields\CWidgetFieldTextBox;  class WidgetForm extends CWidgetForm {     public function addFields(): self {       return $this          ->addField(             new CWidgetFieldTextBox('description', _('Description'))          );    } } ```   4. Al directori *views*, creeu un fitxer de visualització de configuració del giny *widget.edit.php* i afegiu una vista per al nou camp Descripció. Per a la classe de camp *CWidgetFieldTextBox*, la vista és *CWidgetFieldTextBoxView.*      **ui/modules/lesson_gauge_chart/views/widget.edit.php**      ```php <?php      /**  * Visualització del formulari del giny del gràfic de mesura.  *  * @var CView $this  * @var array $data  */      (new CWidgetFormView($data))     ->addField(         new CWidgetFieldTextBoxView($data['fields']['description'])     )     ->show(); ```      5. Aneu al Tauler i premeu la icona d'engranatge per obrir la configuració del giny.  6. La configuració del giny ara conté un camp nou de text (*Descripció*). Introduïu qualsevol valor, per exemple, *Descripció del gràfic de calibre*.  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_conf_descr.png){width=850}             7. Premeu Aplica a la configuració del giny. Premeu Desar els canvis per desar el tauler. El text nou no és visible enlloc i el giny encara mostra "Hola, món!".  Per veure-ho al giny, cal recuperar el valor del camp *Descripció* de la base de dades i passar a la vista del giny. Per fer-ho, heu de crear una classe d'acció.  8. Afegiu un directori *actions* al *lesson_gauge_chart*.  9. Creeu un fitxer *WidgetView.php* dins del directori *actions*. La classe d'acció *WidgetView* ampliarà la classe *CControllerDashboardWidgetView*.    Els valors dels camps de configuració del giny s'emmagatzemen a la propietat **$fields_values** de la classe d'acció.      **ui/modules/lesson_gauge_chart/actions/WidgetView.php**      ```php <?php      namespace Modules\LessonGaugeChart\Actions;      use CControllerDashboardWidgetView,     CControllerResponseData;      class WidgetView extends CControllerDashboardWidgetView {          protected function doAction(): void {         $this->setResponse(new CControllerResponseData([             'name' => $this->getInput('name', $this->widget->getName()),             'description' => $this->fields_values['description'],             'user' => [                 'debug_mode' => $this->getDebugMode()             ]         ]));     } } ```      10. Obriu el fitxer *manifest.json* i registreu *WidgetView* com a classe d'acció a la secció *actions/widget.lesson_gauge_chart.view*.  **ui/modules/lesson_gauge_chart/manifest.json**      ```js {      "manifest_version": 2.0,      "id": "lesson_gauge_chart",      "type": "giny",      "name": "Gràfic de mesura",      "namespace": "LessonGaugeChart",      "version": "1.0",      "author": "Zabbix SIA",      "actions": {          "widget.lesson_gauge_chart.view": {              "class": "WidgetView"          }      } } ```      11. Ara podeu emprar el valor del camp de descripció, contingut a *$data['description']*, a la vista del giny. Obriu *views/widget.view.php* i substituïu el text estàtic "Hola, món!" amb *$data['descripció']*.      **ui/modules/lesson_gauge_chart/views/widget.view.php**      ```php <?php      /**   * Visualització del giny del gràfic de mesura.   *   * @var CView $this   * @var array $data   */      (nou CWidgetView($data))      ->addItem(          new CTag('h1', true, $data['description'])      )      ->show(); ```      12. Actualitzeu la pàgina Tauler. Hauríeu de veure el text de descripció del giny en lloc de "Hola, món!".  ![](../../../../assets/en/devel/modules/tutorials/widget/widget_view_descr.png){width=850}

en-us	## Administration  With the Zabbix API you can change administration settings of your monitoring system.
ca	## Administració  Amb l'API Zabbix, podem modificar els paràmetres d'administració del nostre sistema de monitoratge.

en-us	#### Advanced configuration  Advanced configuration options are available in a collapsible *Advanced configuration* section:  ![](../../../../../assets/en/manual/web_interface/script_advanced.png){width="600"}  |Parameter|Description| |----------|----------------------------------------| |*Enable user input*|Mark the checkbox to enable manual user input before executing the script.<br>Manual user input will replace the {MANUALINPUT} macro value in the script.<br>See also: [Manual user input](#manual-user-input).| |*Input prompt*|Enter custom text prompting for custom user input. This text will be displayed above the input field in the *Manual input* popup.<br>To see a preview of the *Manual input* popup, click on *Test user input*. The preview also allows to test if the input string complies with the input validation rule (see parameters below).<br>Macro and user macro support depends on the scope of the script (see *Scope* in general script configuration parameters).| |*Input type*|Select the manual input type:<br>**String** - single string;<br>**Dropdown** - value is selected from multiple dropdown options.| |*Dropdown options*|Enter unique values for the user input dropdown in a comma-delimited list.<br>To include an empty option in the dropdown, add an extra comma at the beginning, middle, or end of the list.<br>This field is displayed only if 'Dropdown' is selected as *Input type*.| |*Default input string*|Enter the default string for user input (or none).<br>This field will be validated against the regular expression provided in the *Input validation rule* field.<br>The value entered here will be displayed by default in the *Manual input* popup.<br>This field is displayed only if 'String' is selected as *Input type*.| |*Input validation rule*|Enter a regular expression to validate the user input string.<br>Global regular expressions are supported.<br>This field is displayed only if 'String' is selected as *Input type*.| |*Enable confirmation*|Mark the checkbox to display a confirmation message before executing the script. This feature might be especially useful with potentially dangerous operations (like a reboot script) or ones that might take a long time.| |*Confirmation text*|Enter custom confirmation text for the confirmation popup enabled with the checkbox above (for example, *Remote system will be rebooted. Are you sure?*). To see how the text will look like, click on *Test confirmation* next to the field.<br>[Macros](/manual/appendix/macros/supported_by_location) and custom [user macros](/manual/config/macros/user_macros) are supported.<br>*Note:* the macros will not be expanded when testing the confirmation message.|  If both manual user input and a confirmation message are configured, they will be displayed in consecutive popup windows.
ca	#### Configuració avançada  Les opcions de configuració avançades són disponibles a una secció plegable *Configuració avançada*:  ![](../../../../../assets/en/manual/web_interface/script_advanced.png){width="600"}  |Paràmetre|Descripció| |-----------|--------------------------------------- --| |*Activar l'entrada de l'usuari*|Marqueu la casella de selecció per habilitar l'entrada manual de l'usuari abans d'executar l'script.<br>L'entrada manual de l'usuari substituirà el valor de la macro {MANUALINPUT} a l'script.<br>Veieu també: [Entrada manual de l'usuari](#manual-user-input).| |*Introducció de petició*|Introduïu una petició de text personalitzada per a l'entrada personalitzada de l'usuari. Aquest text es mostrarà a sobre del camp d'entrada a la finestra emergent *Entrada manual*.<br>Per veure una vista prèvia de la finestra emergent *Entrada manual*, feu clic a *Prova l'entrada de l'usuari*. La previsualització també permet provar si la cadena d'entrada compleix la regla de validació d'entrada (veieu els paràmetres a continuació).<br>El suport de macros i macros d'usuari depèn de l'abast de l'script (veieu *Àmbit* als paràmetres de configuració generals de l'script).| |*Tipus d'entrada*|Trieu el tipus d'entrada manual:<br>**Cadena** - cadena única;<br>**Dropdown** - el valor es selecciona entre diverses opcions desplegables.| |*Opcions desplegables*|Introduïu valors únics per al menú desplegable d'entrada de l'usuari en una llista delimitada per comes.<br>Per incloure una opció buida al menú desplegable, afegiu una coma addicional al principi, al mig o al final de la llista.< br>Aquest camp només es mostra si s'ha escollit 'Menú desplegable' com a *Tipus d'entrada*.| |*Cadena d'entrada predeterminada*|Introduïu la cadena per defecte per a l'entrada de l'usuari (o cap).<br>Aquest camp es validarà amb l'expressió regular proporcionada al camp *Regla de validació d'entrada*.<br>El valor introduït aquí serà es mostra per defecte a la finestra emergent *Entrada manual*.<br>Aquest camp només es mostra si s'ha triat 'Cadena' com a *Tipus d'entrada*.| |*Regla de validació d'entrada*|Introduïu una expressió regular per validar la cadena d'entrada de l'usuari.<br>S'admeten expressions regulars globals.<br>Aquest camp només es mostra si s'ha escollit 'Cadena' com a *Tipus d'entrada*.| |*Activar la confirmació*|Marqueu la casella de selecció per mostrar un missatge de confirmació abans d'executar l'script. Aquesta característica pot ser especialment útil amb operacions potencialment perilloses (com ara un script de reinici) o les que poden trigar molt de temps.| |*Text de confirmació*|Introduïu un text de confirmació personalitzat per a la finestra emergent de confirmació activada amb la casella de selecció de dalt (per exemple, *El sistema remot es reiniciarà. Voleu fer-ho?*). Per veure com quedarà el text, feu clic a *Confirmació de la prova* al costat del camp.<br>[Macros](/manual/appendix/macros/supported_by_location) i [macros d'usuari](/manual/config/macros/) personalitzades. Les macros d'usuari són compatibles.<br>*Nota:* les macros no s'ampliaran en provar el missatge de confirmació.|  Si es configuren tant l'entrada manual de l'usuari com un missatge de confirmació, es mostraran en finestres emergents consecutives.

en-us	##### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section and only for elements selected in the *Show* field (see above) and the background color or thresholds for honeycomb cells.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb_advanced_configuration.png){width="600"}  |   |   | |--|--------| |***Primary/Secondary label***|<| |*Type*|Select the label type:<br>**Text** - the label will display the text specified in the *Text* parameter;<br>**Value** - the label will display the item value with decimal places as specified in the *Decimal places* parameter.| |*Text*|Enter the label text. This text may override the default item name.<br>Multiline text is supported. A combination of text and [supported macros](/manual/appendix/macros/supported_by_location) is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, and [user macros](/manual/appendix/macros/supported_by_location_user#other-locations) are supported.<br>Honeycomb cells are ordered alphabetically by host name, and, within each host, by item name.<br>This parameter is available if *Type* is set to "Text".| |*Decimal places*|Enter the number of decimal places to display with the value.<br>This parameter is available if *Type* is set to "Value", and affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |*Size*|Select the label size:<br>**Auto** - use automatically adjusted label size;<br>**Custom** - enter a custom label size (in percent, relative to the honeycomb cell size).<br>Note that labels that do not fit the honeycomb cell size are truncated.| |*Bold*|Mark the checkbox to display item units in bold.| |*Color*|Select the item units color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Units***|<| |*Units*|Mark the checkbox to display units with the item value.<br>If you enter a unit name, it will override the units set in the [item configuration](/manual/config/items/item#configuration).<br>This parameter is available if *Type* is set to "Text".| |*Position*|Select the position of the item units (before or after the item value).<br>This parameter is ignored for the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.<br>This parameter is available if *Type* is set to "Text".| |***Background color***|<| |*Background color*|Select the honeycomb cells background color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Thresholds***|<| |*Color interpolation*|Mark the checkbox to enable smooth transitioning between threshold colors for honeycomb cells.<br>This parameter is available if two or more thresholds are set.| |*Threshold*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>Note that the colors configured as thresholds will be displayed correctly only for numeric items.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.|
ca	##### Configuració avançada  Les opcions de configuració avançades són disponibles a la secció desplegable *Configuració avançada* i només per als elements seleccionats al camp *Veure* (veieu més amunt) i el color de fons o els llindars de les cel·les de la bresca.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb_advanced_configuration.png){width="600"}  |   |   | |--|---------| |***Etiqueta primària/secundària***|<| |*Tipus*|Trieu el tipus d'etiqueta:<br>**Text** - l'etiqueta mostrarà el text especificat al paràmetre *Text*;<br>**Valor** - l'etiqueta mostrarà el valor de l'element amb posicions decimals tal com s'especifica al paràmetre *Cimes decimals*.| |*Text*|Introduïu el text de l'etiqueta. Aquest text pot substituir el nom de l'element predeterminat.<br>S'admet el text multilínia. És possible una combinació de text i [macros admeses](/manual/appendix/macros/supported_by_location).<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} i [macros d'usuari](/manual/appendix/macros/supported_by_location_user#other-locations) són compatibles.<br>Les cel·les de niu d'abella s'ordenen alfabèticament per nom d'amfitrió i, dins de cada amfitrió, per nom d'element.<br>Aquest paràmetre és disponible si *Tipus * s'estableix en "Text".| |*Llocs decimals*|Introduïu el nombre de decimals per mostrar amb el valor.<br>Aquest paràmetre és disponible si *Tipus* s'estableix en "Valor" i només afecta els elements que retornen dades [numèriques (flotant)](/manual/config/items/item#configuration).| |*Mida*|Trieu la mida de l'etiqueta:<br>**Auto** - empra la mida de l'etiqueta ajustada automàticament;<br>**Personalitzada** - introduïu una mida d'etiqueta personalitzada (en percentatge, en relació amb la mida de la cel·la de la bresca).<br>Tingueu en compte que les etiquetes que no s'ajusten a la mida de la cel·la de la bresca es retallen.| |*Negreta*|Marqueu la casella de selecció per mostrar les unitats d'elements en negreta.| |*Color*|Trieu el color de les unitats de l'element al selector de colors.<br>"D" significa el color predeterminat, que depèn del tema de la interfície. Per tornar al color predeterminat, feu clic al botó *Emprar per defecte* al selector de colors.| |***Unitats***|<| |*Unitats*|Marqueu la casella de selecció per mostrar les unitats amb el valor de l'element.<br>Si introduïu un nom d'unitat, anul·larà les unitats establertes a la [configuració de l'element](/manual/config/items/item#configuration).<br>Aquest paràmetre és disponible si *Type* s'estableix a "Text".| |*Posició*|Trieu la posició de les unitats de l'element (abans o després del valor de l'element).<br>Aquest paràmetre s'ignora per a les [unitats relacionades amb el temps](/manual/config/items/item#configuration): unixtime, uptime.<br>Aquest paràmetre és disponible si *Type* s'estableix a "Text".| |***Color de fons***|<| |*Color de fons*|Trieu el color de fons de les cel·les de la bresca des del selector de colors.<br>"D" significa el color predeterminat, que depèn del tema de la interfície. Per tornar al color predeterminat, feu clic al botó *Usa predeterminat* al selector de colors.| |***Llindars***|<| |*Interpolació de colors*|Marqueu la casella de selecció per activar una transició suau entre els colors del llindar per a les cel·les de la bresca.<br>Aquest paràmetre és disponible si s'estableixen dos o més llindars.| |*Llindar*|Feu clic a *Afegir* per afegir un llindar, trieu un color de llindar del selector de color i especifiqueu un valor numèric.<br>La llista de llindars s'ordenarà en ordre ascendent quan es desi.<br>Tingueu en compte que els colors configurats com a llindars només es mostraran correctament per als elements numèrics.<br>S'admeten [Sufixos](/manual/appendix/sufixos) (per exemple, "1d", "2w", "4K", "8G"). [Els mapatges de valors](/manual/config/items/mapping) són compatibles.|

en-us	#### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section, and only for those elements that are selected in the *Show* field (see above).  Additionally, advanced configuration allows to change the background  color for the whole widget.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/clock_advanced.png){width=600}  |   |   | |--|--------| |*Background color* |Select the background color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Date**_ || |*Size* |Enter font size height for the date (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display date in bold type. | |*Color* |Select the date color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |_**Time**_ || |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Seconds* |Mark the checkbox to display seconds. Otherwise only hours and minutes will be displayed.| |*Format* |Select to display a 24-hour or 12-hour time. | |_**Time zone**_ || |*Size* |Enter font size height for the time zone (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time zone in bold type. | |*Color* |Select the time zone color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |*Time zone*|Select the time zone.| |*Format* |Select to display time zone in short format (e.g. `New York`) or full format (e.g.`(UTC-04:00) America/New York`). |
ca	#### Configuració avançada  Les opcions de configuració avançada són disponibles si la casella de selecció *Configuració avançada* és marcada (veieu la captura de pantalla) i només per als elements triats al camp *Mostra* (veieu més amunt).  A més, la configuració avançada permet canviar el color de fons de tot el giny.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/clock_advanced.png){width=600}  | | | |--|---------| |*Color de fons* |Seleccioneu el color de fons del selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Empra el valor predeterminat* al selector de colors. | |_**Data**_ || |*Mida* |Introduïu l'alçada de la mida del tipus de lletra per a la data (en percentatge respecte a l'alçada total del giny). | |*Negreta* |Marqueu la casella de selecció per mostrar la data en negreta. | |*Color* |Seleccioneu el color de la data al selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Empreu el valor predeterminat* al selector de colors. | |_**Hora**_ || |*Mida* |Introduïu l'alçada de la mida de la lletra per a l'hora (en percentatge respecte a l'alçada total del giny). | |*Negreta* |Marqueu la casella de selecció per mostrar l'hora en negreta. | |*Color* |Seleccioneu el color de l'hora des del selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |*Segons* |Marqueu la casella de selecció per mostrar els segons. En cas contrari, només es mostraran les hores i els minuts.| |*Format* |Seleccioneu per mostrar una hora de 24 hores o 12 hores. | |_**Fus horari**_ || |*Mida* |Introduïu l'alçada de la mida de la lletra per a la zona horària (en percentatge respecte a l'alçada total del giny). | |*Negreta* |Marqueu la casella de selecció per mostrar la zona horària en negreta. | |*Color* |Seleccioneu el color de la zona horària al selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |*Zona horària*|Seleccioneu la zona horària.| |*Format* |Seleccioneu per mostrar la zona horària en format curt (p. ex., `Nova York`) o en format complet (p. ex., "(UTC-04:00) Amèrica/Nova York"). |

en-us	#### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section, and only for those elements that are selected in the *Show* field (see above).  Additionally, advanced configuration allows to change the background  color (static or dynamic) for the whole widget.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_advanced.png){width="600"}  |   |   | |--|--------| |***Description***|<| |*Description* |Enter the item description. This description may override the default item name. Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported. | |*Horizontal position* |Select horizontal position of the item description - left, right or center. | |*Vertical position* |Select vertical position of the item description - top, bottom or middle. | |*Size* |Enter font size height for the item description (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item description in bold type. | |*Color* |Select the item description color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Value***|<| |*Decimal places* |Select how many decimal places will be displayed with the value. This value will affect only float items. | |*Size* |Enter font size height for the decimal places (in percent relative to total widget height). | |*Horizontal position* |Select horizontal position of the item value - left, right or center. | |*Vertical position* |Select vertical position of the item value - top, bottom or middle. | |*Size* |Enter font size height for the item value (in percent relative to total widget height).<br>Note that the size of item value is prioritized; other elements have to concede space for the value. With the change indicator though, if the value is too large, it will be truncated to show the change indicator. | |*Bold* |Mark the checkbox to display item value in bold type. | |*Color* |Select the item value color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Units***|<| |*Units* |Mark the checkbox to display units with the item value. If you enter a unit name, it will override the unit from item configuration. | |*Position* |Select the item unit position - above, below, before or after the value. | |*Size* |Enter font size height for the item unit (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display item unit in bold type. | |*Color* |Select the item unit color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Time*** *(clock value from item history)*|<| |*Horizontal position* |Select horizontal position of the time - left, right or center. | |*Vertical position* |Select vertical position of the time - top, bottom or middle. | |*Size* |Enter font size height for the time (in percent relative to total widget height). | |*Bold* |Mark the checkbox to display time in bold type. | |*Color* |Select the time color from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Change indicator***|Select the color of change indicators from the color picker. The change indicators are as follows:<br>**↑** - item value is up (for numeric items)<br>**↓** - item value is down (for numeric items)<br>**↕** - item value has changed (for string items and items with value mapping)<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker.<br>Vertical size of the change indicator is equal to the size of the value (integer part of the value for numeric items).<br>Note that up and down indicators are not shown with just one value. | |***Background color***|Select the background color for the whole widget from the color picker.<br>`D` stands for default color (depends on the frontend theme). To return to the default value, click the *Use default* button in the color picker. | |***Thresholds***|Configure the dynamic background color for the whole widget. Click *Add* to add a threshold, select the background color from the color picker, and specify a numeric value. Once the item value equals or is greater than the threshold value, the background color will change.<br>The list will be sorted in ascending order when saved.<br>Note that the dynamic background color will be displayed correctly only for numeric items.| |***Aggregation function***|Specify which aggregation function to use:<br>**min** - display the smallest value;<br>**max** - display the largest value;<br>**avg** - display the average value;<br>**count** - display the count of values;<br>**sum** - display the sum of values;<br>**first** - display the first value;<br>**last** - display the last value;<br>**not used** - display the most recent value (no aggregation).<br><br>Aggregation allows to display an aggregated value for the chosen interval (5 minutes, an hour, a day), instead of the most recent value.<br>Only numeric data can be displayed for *min*, *max*, *avg* and *sum*. For *count*, non-numeric data will be changed to numeric.| |***Time period***|Specify the time period to use for aggregating values:<br>**Dashboard** - use time period of the dashboard;<br>**Widget** - use time period of the specified widget;<br>**Custom** - use a custom time period.<br><This parameter will not be displayed if *Aggregation function* is set to "not used". | |*Widget*|Select the widget.<br>This parameter will only be displayed if *Time period* is set to "Widget".| |*From*|Select the time period from (default value `now-1h`). See [relative time syntax](/manual/web_interface/time_period_selector).<br>This parameter will only be displayed if *Time period* is set to "Custom".| |*To*|Select the time period to (default value `now`). See [relative time syntax](/manual/web_interface/time_period_selector).<br>This parameter will only be displayed if *Time period* is set to "Custom".| |***History data***|Take data from history or trends:<br>**Auto** - automatic selection;<br>**History** - take history data;<br>**Trends** - take trend data.<br><br>This setting applies only to numeric data. Non-numeric data will always be taken from history.|  Note that multiple elements cannot occupy the same space; if they are placed in the same space, an error message will be displayed.
ca	#### Configuració avançada  Les opcions de configuració avançada són disponibles si la casella de selecció *Configuració avançada* és marcada (veieu la captura de pantalla) i només per als elements triats al camp *Mostra* (veieu més amunt).  A més, la configuració avançada permet canviar el color de fons (estàtic o dinàmic) per a tot el giny.  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_advanced.png){width="600"}  | | | |--|---------| |***Descripció***|<| |*Descripció* |Introduïu la descripció de l'element. Aquesta descripció pot substituir el nom de l'element predeterminat. S'admeten descripcions de diverses línies. És possible una combinació de text i macros admeses.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} i macros d'usuari són compatibles. | |*Posició horitzontal* |Trieu la posició horitzontal de la descripció de l'element: esquerra, dreta o centre. | |*Posició vertical* |Trieu la posició vertical de la descripció de l'element: superior, inferior o mig. | |*Mida* |Introduïu l'alçada de la mida de la lletra per a la descripció de l'element (en percentatge respecte a l'alçada total del giny). | |*Negreta* |Marqueu la casella de selecció per mostrar la descripció de l'element en negreta. | |*Color* |Trieu el color de la descripció de l'element al selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |***Valor***|<| |*Nombre de decimals* |Trieu quants decimals es mostraran amb el valor. Aquest valor només afectarà els elements flotants. | |*Mida* |Introduïu l'alçada de la mida del tipus de lletra per als decimals (en percentatge respecte a l'alçada total del giny). | |*Posició horitzontal* |Trieu la posició horitzontal del valor de l'element - esquerra, dreta o centre. | |*Posició vertical* |Trieu la posició vertical del valor de l'element - superior, inferior o mig. | |*Mida* |Introduïu l'alçada de la mida de la lletra per al valor de l'element (en percentatge en relació amb l'alçada total del giny).<br>Tingueu en compte que es prioritza la mida del valor de l'element; altres elements han de concedir espai per al valor. Amb l'indicador de canvi, però, si el valor és massa gran, es truncarà per mostrar l'indicador de canvi. | |*Negreta* |Marqueu la casella de selecció per mostrar el valor de l'element en negreta. | |*Color* |Trieu el color del valor de l'element des del selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |***Unitats***|<| |*Unitats* |Marqueu la casella de selecció per mostrar les unitats amb el valor de l'element. Si introduïu un nom d'unitat, anul·larà la unitat des de la configuració de l'element. | |*Posició* |Trieu la posició de la unitat de l'element: a sobre, a sota, abans o després del valor. | |*Mida* |Introduïu l'alçada de la mida del tipus de lletra per a la unitat d'element (en percentatge respecte a l'alçada total del giny). | |*Negreta* |Marqueu la casella de selecció per mostrar la unitat d'element en negreta. | |*Color* |Trieu el color de la unitat de l'element des del selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |***Hora*** *(Valor del rellotge de l'historial d'elements)*|<| |*Posició horitzontal* |Trieu la posició horitzontal de l'hora - esquerra, dreta o centre. | |*Posició vertical* |Trieu la posició vertical de l'hora: superior, inferior o mitjana. | |*Mida* |Introduïu l'alçada de la mida de la lletra per a l'hora (en percentatge respecte a l'alçada total del giny). | |*Negreta* |Marqueu la casella de selecció per mostrar l'hora en negreta. | |*Color* |Trieu el color de l'hora des del selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |***Indicador de canvi***|Trieu el color dels indicadors de canvi des del selector de color. Els indicadors de canvi són els següents:<br>**↑** - el valor de l'element ha augmentat (per a elements numèrics)<br>**↓** - el valor de l'element ha baixat (per a elements numèrics)<br>**↕* * - el valor de l'element ha canviat (per a elements de cadena i elements amb mapeig de valors)<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors.<br>La mida vertical de l'indicador de canvi és igual a la mida del valor (part entera del valor per als elements numèrics).<br> Tingueu en compte que els indicadors amunt i avall no es mostren amb un sol valor. | |***Color de fons***|Trieu el color de fons per a tot el giny des del selector de colors.<br>`D` significa el color predeterminat (depèn del tema de la interfície). Per tornar al valor predeterminat, feu clic al botó *Emprar el valor predeterminat* al selector de colors. | |***Llindars***|Configura el color de fons dinàmic per a tot el giny. Feu clic a *Afegir* per afegir un llindar, seleccioneu el color de fons del selector de colors i especifiqueu un valor numèric. Quan el valor de l'element sigui igual o superior al valor del llindar, el color de fons canviarà.<br>La llista s'ordenarà en ordre ascendent quan es desi. <br> Tingueu en compte que el color de fons dinàmic es mostrarà correctament només per als elements numèrics.| |***Funció d'agregació***|Especifiqueu quina funció d'agregació emprareu:<br>**min** - mostra el valor més petit;<br>**max** - mostra el valor més gran;<br>** avg** - mostra el valor mig;<br>**count** - mostra el recompte de valors;<br>**sum** - mostra la suma de valors;<br>**primer** - mostra el primer valor;<br>**darrer** - mostra el darrer valor;<br>**no s'empra** - mostra el valor més recent (sense agregació).<br><br>L'agregació permet mostrar un valor agregat per a l'interval escollit (5 minuts, una hora, un dia), en lloc del valor més recent.<br>Només es poden mostrar dades numèriques per a *min*, *max*, *avg* i *sum*. Per a *count*, les dades no numèriques es canviaran a numèriques.| |***Període de temps***|Especifiqueu el període de temps que s'utilitzarà per agregar valors:<br>**Tauler de control** - ús del període de temps del tauler;<br>**Giny** - ús del període de temps del tauler giny especificat;<br>**Personalitzat** - empreu un període de temps personalitzat.<br><Aquest paràmetre no es veurà si la *Funció d'agregació* és establerta com a "no emprat". | |*Giny*|Trieu el giny.<br>Aquest paràmetre només es veurà si *Període de temps* s'estableix a "Giny".| |*Des de*|Trieu el període de temps des de (valor per defecte `ara-1h`). Veieu [sintaxi de temps relatiu](/manual/web_interface/time_period_selector).<br>Aquest paràmetre només es veurà si *Període de temps* és establert a "Personalitzat".| |*Fins a*|Trieu el període de temps fins a (valor per defecte `ara`). Veieu [sintaxi de temps relatiu](/manual/web_interface/time_period_selector).<br>Aquest paràmetre només es mostrarà si *Període de temps* està establert a "Personalitzat".| |***Dades de l'historial***|Treu dades de l'historial o de les tendències:<br>**Auto** - selecció automàtica;<br>**Historial** - agafa dades de l'historial;<br>**Tendències** - prendre dades de tendències.<br><br>Aquesta configuració només s'aplica a les dades numèriques. Les dades no numèriques es prendran sempre de l'historial.|  Tingueu en compte que diversos elements no poden ocupar el mateix espai; si es posen al mateix espai, es mostrarà un missatge d'error.

en-us	##### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_advanced_configuration.png){width="600"}  |   |   | |--|--------| |*Angle*|Select the gauge angle (180° or 270°).| |***Description***|<| |*Description*|Enter the item description. This description may override the default item name.<br>Multiline descriptions are supported. A combination of text and supported macros is possible.<br>{HOST.\*}, {ITEM.\*}, {INVENTORY.\*} and user macros are supported.| |*Size*|Enter the font size height for the item description (in percent, relative to the total widget height).| |*Vertical position*|Select the vertical position of the item description (top or bottom, relative to the gauge arc).| |*Bold*|Mark the checkbox to display the item description in bold.| |*Color*|Select the item description color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Value***|<| |*Decimal places*|Enter the number of decimal places to display with the value.<br>This option affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |*Size*|Enter the font size height for the value (in percent, relative to the gauge arc height).| |*Bold*|Mark the checkbox to display the value in bold.| |*Color*|Select the value color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Units***|<| |*Units*|Mark the checkbox to display units with the item value.<br>If you enter a unit name, it will override the units set in the [item configuration](/manual/config/items/item#configuration).| |*Size*|Enter the font size height for the item units (in percent, relative to the gauge arc height).| |*Bold*|Mark the checkbox to display item units in bold.| |*Position*|Select the position of the item units (above, below, before or after, relative to the item value).<br>This option is ignored for the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|Select the item units color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. To return to the default color, click the *Use default* button in the color picker.| |***Value arc***|<| |*Arc size*|Enter the size height of the gauge value arc (in percent, relative to the gauge arc radius).| |***Needle***|<| |*Color*|Select the gauge needle color from the color picker.<br>"D" stands for the default color, which depends on the frontend theme. If *Thresholds* are set, the default color for the needle depends on the threshold color. To return to the default color, click the *Use default* button in the color picker.| |***Scale***|<| |*Show units*|Mark the checkbox to display units with the minimum and maximum value of the gauge.| |*Size*|Enter the font size height for the minimum and maximum value of the gauge (in percent, relative to the gauge arc height).| |*Decimal places*|Enter the number of decimal places to display with the minimum and maximum value of the gauge.<br>This option affects only items that return [numeric (float)](/manual/config/items/item#configuration) data.| |***Thresholds***|<| |*Thresholds*|Click *Add* to add a threshold, select a threshold color from the color picker, and specify a numeric value.<br>The thresholds list will be sorted in ascending order when saved.<br>Note that the colors configured as thresholds will be displayed correctly only for numeric items.<br>[Suffixes](/manual/appendix/suffixes) (for example, "1d", "2w", "4K", "8G") are supported. [Value mappings](/manual/config/items/mapping) are supported.| |*Show labels*|Mark the checkbox to display threshold values as labels on the gauge scale.| |*Show arc*|Mark the checkbox to display the gauge thresholds arc.| |*Arc size*|Enter the size height of the gauge thresholds arc (in percent, relative to the gauge arc radius).|
ca	##### Configuració avançada  Les opcions de configuració avançades són disponibles a la secció plegable *Configuració avançada*:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/gauge_advanced_configuration.png){width="600"}  |   |   | |--|---------| |*Angle*|Trieu l'angle de calibre (180° o 270°).| |***Descripció***|<| |*Descripció*|Introduïu la descripció de l'element. Aquesta descripció pot substituir el nom de l'element predeterminat.<br>S'admeten descripcions de diverses línies. És possible una combinació de text i macros admeses.<br>S'admeten {HOST.\*}, {ITEM.\*}, {INVENTORY.\*} i les macros d'usuari.| |*Mida*|Introduïu l'alçada de la mida del tipus de lletra per a la descripció de l'element (en percentatge, en relació amb l'alçada total del giny).| |*Posició vertical*|Trieu la posició vertical de la descripció de l'element (superior o inferior, en relació amb l'arc de calibre).| |*Negreta*|Marqueu la casella de selecció per mostrar la descripció de l'element en negreta.| |*Color*|Trieu el color de la descripció de l'element al selector de colors.<br>"D" significa el color predeterminat, que depèn del tema de la interfície. Per tornar al color predeterminat, feu clic al botó *Empra per defecte* al selector de colors.| |***Valor***|<| |*Llocs decimals*|Introduïu el nombre de decimals per mostrar amb el valor.<br>Aquesta opció només afecta els elements que retornen dades [numèric (flotant)](/manual/config/items/item#configuration).| |*Mida*|Introduïu l'alçada de la mida de la lletra per al valor (en percentatge, en relació amb l'alçada de l'arc de calibre).| |*Negreta*|Marqueu la casella de selecció per mostrar el valor en negreta.| |*Color*|Trieu el color del valor del selector de colors.<br>"D" significa el color predeterminat, que depèn del tema de la interfície. Per tornar al color predeterminat, feu clic al botó *Empra per defecte* al selector de colors.| |***Unitats***|<| |*Unitats*|Marqueu la casella de selecció per mostrar les unitats amb el valor de l'element.<br>Si introduïu un nom d'unitat, anul·larà les unitats establertes a la [configuració de l'element](/manual/config/items/item#configuration) .| |*Mida*|Introduïu l'alçada de la mida de la lletra per a les unitats de l'element (en percentatge, en relació amb l'alçada de l'arc de calibre).| |*Negreta*|Marqueu la casella de selecció per mostrar les unitats d'elements en negreta.| |*Posició*|Trieu la posició de les unitats d'element (a sobre, a sota, abans o després, en relació amb el valor de l'element).<br>Aquesta opció s'ignora per a les [unitats relacionades amb el temps](/manual/config/) següents elements/item#configuration): unixtime, uptime, s.| |*Color*|Trieu el color de les unitats de l'element al selector de colors.<br>"D" significa el color predeterminat, que depèn del tema de la interfície. Per tornar al color predeterminat, feu clic al botó *Empra per defecte* al selector de colors.| |***Arc de valor***|<| |*Mida de l'arc*|Introduïu l'alçada de la mida de l'arc del valor del calibre (en percentatge, en relació amb el radi de l'arc del calibre).| |***Agulla***|<| |*Color*|Trieu el color de l'agulla del calibre al selector de colors.<br>"D" significa el color predeterminat, que depèn del tema de la interfície. Si s'estableixen *Llindars*, el color predeterminat de l'agulla depèn del color del llindar. Per tornar al color predeterminat, feu clic al botó *Usa predeterminat* al selector de colors.| |***Escala***|<| |*Mostra unitats*|Marqueu la casella de selecció per mostrar les unitats amb el valor mínim i màxim de l'indicador.| |*Mida*|Introduïu l'alçada de la mida del tipus de lletra per al valor mínim i màxim del calibre (en percentatge, en relació amb l'alçada de l'arc del calibre).| |*Llocs decimals*|Introduïu el nombre de decimals per mostrar amb el valor mínim i màxim de l'indicador.<br>Aquesta opció només afecta els elements que retornen [numeric (float)](/manual/config/items/item# configuració) dades.| |***Llindars***|<| |*Llindars*|Feu clic a *Afegeix* per afegir un llindar, seleccioneu un color de llindar del selector de colors i especifiqueu un valor numèric.<br>La llista de llindars s'ordenarà en ordre ascendent quan es desi.<br>Tingueu en compte que els colors configurats com a llindars només es mostraran correctament per als elements numèrics.<br>S'admeten [Sufixos](/manual/appendix/sufixos) (per exemple, "1d", "2w", "4K", "8G"). [Les mapes de valors](/manual/config/items/mapping) són compatibles.| |*Mostra les etiquetes*|Marqueu la casella de selecció per mostrar els valors de llindar com a etiquetes a l'escala del calibre.| |*Mostra l'arc*|Marqueu la casella de selecció per mostrar l'arc dels llindars de mesura.| |*Mida de l'arc*|Introduïu l'alçada de la mida de l'arc dels llindars de calibre (en percentatge, en relació amb el radi de l'arc de calibre).|

en-us	#### Advanced configuration  Advanced configuration options are available in the collapsible *Advanced configuration* section:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/item_history_advanced_configuration.png)  |   |   | |--|--------| |*New values*|Select where new item values should be added:<br>**Top** - at the top of columns;<br>**Bottom** - at the bottom of columns.| |*Show timestamp*|Mark this checkbox to display the timestamp column (unmarked by default).| |*Show column header*|Select the column header orientation:<br>**Off** - hide the header;<br>**Horizontal** - display the header horizontally;<br>**Vertical** - display the header vertically.| |[*Time period*](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters)|Select the data source for the time period:<br>**Dashboard** - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>**Widget** - set a compatible widget specified in the *Widget* parameter as the data source;<br>**Custom** - set the time period specified in the *From* and *To* parameters as the data source; if set, a clock icon will be displayed in the top right corner of the widget, indicating the set time on mouseover.| |*Widget*|Enter or select a compatible widget (*Graph*, *Graph (classic)*, *Graph prototype*) as the data source for the time period.<br>This parameter is available if *Time period* is set to "Widget".| |*From*|Enter or select the start of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".| |*To*|Enter or select the end of the time period.<br>[Relative time syntax](/manual/web_interface/time_period_selector) (`now`, `now/d`, `now/w-1w`, etc.) is supported.<br>This parameter is available if *Time period* is set to "Custom".|
ca	#### Configuració avançada  Les opcions de configuració avançades són disponibles a la secció plegable *Configuració avançada*:  ![](../../../../../../assets/en/manual/web_interface/frontend_sections/dashboards/widgets/item_history_advanced_configuration.png)  |   |   | |--|---------| |*Valors nous*|Trieu on s'han d'afegir els valors d'elements nous:<br>**A dalt** - a la part superior de les columnes;<br>**A baix** - a la part inferior de les columnes.| |*Veure la marca de temps*|Marqueu aquesta casella de selecció per veure la columna de marca de temps (no marcada per defecte).| |*Veure la capçalera de la columna*|Trieu l'orientació de la capçalera de la columna:<br>**Desactivat** - amaga la capçalera;<br>**Horizontal** - mostra la capçalera horitzontalment;<br>**Vertical** - mostra la capçalera verticalment.| |[*Període de temps*](/manual/web_interface/frontend_sections/dashboards/widgets#dynamic-parameters)|Trieu la font de dades per al període de temps:<br>**Tauler** - establiu el selector [*Període de temps*](/manual/web_interface/time_period_selector) com a font de dades;<br>**Giny** - estableix un widget compatible especificat al paràmetre *Giny* com a font de dades;<br>**Personalitzat** - estableix el període de temps especificat als paràmetres *Des de* i *Fins a* com a font de dades; si s'estableix, s'hi veurà una icona de rellotge a l'extrem superior dret del giny, que indica l'hora establerta en passar el ratolí.| |*Giny*|Introduïu o trieu un giny compatible (*Gràfic*, *Gràfic (clàssic)*, *Prototipus de gràfic*) com a font de dades per al període de temps.<br>Aquest paràmetre és disponible si el *Període de temps* és defineix a "Giny".| |*Des de*|Introduïu o trieu l'inici del període de temps.<br>[Sintaxi de temps relativa](/manual/web_interface/time_period_selector) (`ara`, `ara/d`, `ara/w-1w`, etc.) és compatible.<br>Aquest paràmetre és disponible si *Període de temps* s'estableix a "Personalitzat".| |*Fins a*|Introduïu o trieu el final del període de temps.<br>[Sintaxi de temps relativa](/manual/web_interface/time_period_selector) (`ara`, `ara/d`, `ara/w-1w`, etc.) és compatible.<br>Aquest paràmetre és disponible si *Període de temps* s'estableix a "Personalitzat".|

en-us	 #### Advanced configuration  ![](../../../assets/en/manual/web_interface/service_a.png){width=600}  |Parameter|Description| |--|--------| |_**Additional rules**_|Click on *Add* to configure additional status calculation rules.| |*Set status to*|Set service status to either *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster* in case of a condition match.| |*Condition*|Select the condition for direct child services:<br>**if at least (N) child services have (Status) status or above**<br>**if at least (N%) of child services have (Status) status or above**<br>**if less than (N) child services have (Status) status or below**<br>**if less than (N%) of child services have (Status) status or below**<br>**if weight of child services with (Status) status or above is at least (W)**<br>**if weight of child services with (Status) status or above is at least (N%)**<br>**if weight of child services with (Status) status or below is less than (W)**<br>**if weight of child services with (Status) status or below is less than (N%)** <br><br> If several conditions are specified and the situation matches more than one condition, the highest severity will be set.| |*N (W)*|Set the value of N or W (1-100000), or N% (1-100) in the condition.| |*Status*|Select the value of *Status* in the condition: *OK* (default), *Not classified*, *Information*, *Warning*, *Average*, *High* or *Disaster*.| |_**Status propagation rule**_|Rule for propagating the service status to the parent service:<br>**As is** - the status is propagated without change<br>**Increase by** - you may increase the propagated status by 1 to 5 severities<br>**Decrease by** - you may decrease the propagated status by 1 to 5 severities<br>**Ignore this service** - the status is not propagated to the parent service at all<br>**Fixed status** - the status is propagated statically, i.e. as always the same| |_**Weight**_|Weight of the service (integer in the range from 0 (default) to 1000000).|  :::noteclassic Additional status calculation rules can only be used to increase severity level over the level calculated according to the main *Status calculation rule* parameter. If according to additional rules the status should be Warning, but according to the *Status calculation rule* the status is Disaster - the service will have status Disaster.  :::
ca	#### Configuració avançada  ![](../../../assets/en/manual/web_interface/service_a.png){width=600}  |Paràmetre|Descripció| |--|---------| |_**Regles addicionals**_|Feu clic a *Afegir* per definir regles addicionals de càlcul d'estat.| |*Establir l'estat a*|Estableix l'estat del servei a *D'acord* (per defecte), *Sense classificar*, *Informació*, *Avís*, *Mitjà*, *Alt* o *Desastre* en cas de coincidència de condicions.| |*Condició*|Seleccioneu la condició per als serveis fill directes:<br>**si almenys (N) serveis fill tenen un estat (estat) o superior**<br>**si almenys (N%) dels serveis per als nens tenen l'estat (estat) o superior**<br>**si és inferior a (N) els serveis per a nens tenen l'estat (estat) o inferior**<br>**si són inferiors a (N%) els serveis tenen un estat (estat) o inferior** <br>**si el pes dels serveis fill en estat (estat) o superior és com a mínim (W)**<br>** si el pes dels serveis per als fills en estat (estat) o superior és com a mínim (N%)* *<br>**si el pes dels serveis per als fills en estat (Estat) o inferior és inferior a (W)**<br>**si el pes de serveis per als fills en estat (Estat) o inferior és inferior a (N%)** <br><br> Si s'especifica més d'una condició i la situació correspon a més d'una condició, s'establirà la gravetat més alta. | |*N (W)*|Estableix el valor de N o W (1-100000) o N% (1-100) a la condició.| |*Estat|Seleccioneu el valor d'*Estat* a la condició: *D'acord* (per defecte), *Sense classificar*, *Informació*, *Avís*, *Mitjà*, *Alt* o *Desastre*.| |_**Regla de propagació de l'estat**_|Regla per propagar l'estat del servei al servei principal:<br>**Tal com és** - l'estat es propaga sense canvis<br>**Augmenta des de** - podeu augmentar la propagació estat d'1 a 5 nivells de gravetat<br >**Disminueix** - podeu reduir l'estat propagat d'1 a 5 nivells de gravetat<br>**Ignorar aquest servei** - l'estat no es propaga en absolut al servei principal< br>**Estat fix** - l'estat es propaga estàticament, és a dir, sempre el mateix| |_**Pes**_|Pes del servei (nombre enter entre 0 (per defecte) i 1000000).|  :::noteclassic Les regles addicionals de càlcul d'estat només es poden emprar per pujar el nivell de gravetat a partir del nivell calculat segons la configuració principal *Regla de càlcul de l'estat*. Si segons regles addicionals l'estat hauria de ser Avís, però d'acord amb la *regla de càlcul de l'estat*, l'estat és Desastre, el servei tindrà estat de Desastre. :::

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Gauge* widget.  ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Angle*|0|angle|Possible values: 180 *(default)* or 270.| |***Description***|<|<|<| |*Description*|1|description|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {ITEM.NAME}.| |*Size*|0|desc_size|Possible values range from 1-100.<br><br>Default: 15.| |*Vertical position*|0|desc_v_pos|0 - Top;<br>1 - *(default)* Bottom.| |*Bold*|0|desc_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|desc_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Value***|<|<|<| |*Decimal places*|0|decimal_places|Possible values range from 1-10.<br><br>Default: 2.| |*Size*|0|value_size|Possible values range from 1-100.<br><br>Default: 25.| |*Bold*|0|value_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|value_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Units***|<|<|<| |*Units* (checkbox)|0|units_show|0 - Disabled;<br>1 - *(default)* Enabled.| |*Units* (value)|1|units|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Size*|0|units_size|Possible values range from 1-100.<br><br>Default: 25.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Bold*|0|units_bold|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"| |*Position*|0|units_pos|0 - Before value;<br>1 - Above value;<br>2 - *(default)* After value;<br>3 - Below value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|1|units_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |***Value arc***|<|<|<| |*Arc size*|0|value_arc_size|Possible values range from 1-100.<br><br>Default: 20.| |***Needle***|<|<|<| |*Color*|1|needle_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |***Scale***|<|<|<| |*Show units*|0|scale_show_units|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Units* (checkbox) is set to "Enabled" and either a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |*Size*|0|scale_size|Possible values range from 1-100.<br><br>Default: 15.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |*Decimal places*|0|scale_decimal_places|Possible values range from 1-10.<br><br>Default: 0.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if a dashboard widget field object for *Show* with the value "Value arc" is set, or *Show arc* is set to "Enabled"| |***Thresholds***|<|<|<| |*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.| |*Show labels*|0|th_show_labels|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Thresholds* are set and either a dashboard widget field object for *Show* with the value "Value arc" is set or *Show arc* is set to "Enabled"| |*Show arc*|0|th_show_arc|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Thresholds* are set| |*Arc size*|0|th_arc_size|Possible values range from 1-100.<br><br>Default: 5.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Show arc* is set to "Enabled"|
ca	#### Configuració avançada  Els següents paràmetres de configuració avançada són compatibles amb el giny *Indicador*.  ::: noteclassic El nombre del nom de propietat *Thresholds* (p. ex. thresholds.0.color) fa referència al lloc del llindar en una llista, ordenat en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (p. ex., `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1. llindar": "5"`). :::  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Angle*|0|angle|Valors possibles: 180 *(per defecte)* o 270.| |***Descripció***|<|<|<| |*Descripció*|1|descripció|Qualsevol valor de cadena, incloses les macros.<br>Macros admeses: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros d'usuari.<br>< br>Per defecte: {ITEM.NAME}.| |*Size*|0|desc_size|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 15.| |*Posició vertical*|0|desc_v_pos|0 - a dalt;<br>1 - *(per defecte)* a baix.| |*Negreta*|0|desc_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Color*|1|desc_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buida).| |***Valor***|<|<|<| |*Llocs decimals*|0|Llocs_decimals|Els valors possibles oscil·len entre 1 i 10.<br><br>Per defecte: 2.| |*Mida*|0|mida_valor|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 25.| |*Negreta*|0|value_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Color*|1|color_valor|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buida).| |***Unitats***|<|<|<| |*Unitats* (casilla de selecció)|0|unitats_mostra|0 - Inhabilitat;<br>1 - *(per defecte)* Activat.| |*Unitats* (valor)|1|unitats|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Unitats* (casilla de selecció) és establerta a "Activat"| |*Size*|0|units_size|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 25.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admesa* si *Unitats* (casella de selecció) és establerta a "Habilitada"| |*Negreta*|0|units_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br >- *admesa* si *Unitats* (casella de selecció) és establerta a "Habilitada"| |*Posició*|0|units_pos|0 - Abans del valor;<br>1 - Per sobre del valor;<br>2 - *(per defecte)* Després del valor;<br>3 - Per sota del valor.<br><br>[ Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Unitats* (casella de selecció) és establerta a "Habilitada"<br><br>Aquest paràmetre s'ignora si s'estableix en un de les següents [unitats relacionades amb el temps](/manual/config/items/item#configuration): unixtime, uptime, s.| |*Color*|1|unitats_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buida).| |***Arc de valor***|<|<|<| |*Mida de l'arc*|0|value_arc_size|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 20.| |***Agulla***|<|<|<| |*Color*|1|color_agulla|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buida).<br><br>[Comportament del paràmetre](/manual/api /reference_commentary#parameter-behavior):<br>- *admès* si s'estableix un objecte de camp d'estri del tauler de control per a *Mostra* amb el valor "Arc de valor" o *Veure arc* és establert a "Activat"| |***Escala***|<|<|<| |*Mostra les unitats*|0|scale_show_units|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *admesa* si *Unitats* (casella de selecció) és establerta a "Habilitada" i s'estableix un objecte de camp de giny del tauler de control per a *Mostra* amb el valor "Arc de valor" o bé *Veure arc* és establert a "Activat "| |*Size*|0|scale_size|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 15.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si s'estableix un objecte de camp d'estri del tauler de control per a *Mostra* amb el valor "Arc de valor" o *Veure arc* és establert a "Activat"| |*Llocs decimals*|0|Llocs_decimals_escala|Els valors possibles van d'1 a 10.<br><br>Per defecte: 0.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *admès* si s'estableix un objecte de camp de giny del tauler de control per a *Mostra* amb el valor "Arc de valor" o *Veure arc* és establert a "Activat"| |***Llindars***|<|<|<| |*Color*|1|thresholds.0.color|Codi de color hexadecimal (p. ex., `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Qualsevol valor numèric. [Sufixos](/manual/apèndix/sufixos) (p. ex., "1d", "2w", "4K", "8G") són compatibles.| |*Mostra les etiquetes*|0|th_show_labels|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *admès* si s'estableixen *Llindars* i s'estableix un objecte de camp d'estri del tauler de control per a *Mostra* amb el valor "Arc de valor" o bé *Veure arc* s'estableix a "Activat" | |*Veure arc*|0|th_show_arc|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *admès* si s'estableixen *Llindars*| |*Mida de l'arc*|0|th_arc_size|Els valors possibles oscil·len entre 1-100.<br><br>Per defecte: 5.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si s'estableix *Veure arc* a "Activat"|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Honeycomb* widget.  ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |***Primary label***|<|<|<| |*Type*|0|primary_label_type|0 - *(default)* Text;<br>1 - Value.| |*Text*|1|primary_label|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {HOST.NAME}<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Text"| |*Decimal places*|0|primary_label_decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Size* (type)|0|primary_label_size_type|0 - *(default)* Auto;<br>1 - Custom.| |*Size*|0|primary_label_size|Possible values range from 1-100.<br><br>Default: 20.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Size* (type) is set to "Custom"| |*Bold*|0|primary_label_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |*Color*|1|primary_label_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`1F2C33` for "blue-theme" or "hc-light";<br>`EEEEEE` for "dark-theme" or "hc-dark".| |*Units* (checkbox)|0|primary_label_units_show|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Units* (value)|1|primary_label_units|Any string value.<br><br>`""` (empty)<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"| |*Position*|0|primary_label_units_pos|0 - Before value;<br>1 - *(default)* After value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Secondary label***|<|<|<| |*Type*|0|secondary_label_type|0 - Text;<br>1 - *(default)* Value.| |*Text*|1|secondary_label|Any string value, including macros.<br>Supported macros: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, user macros.<br><br>Default: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Text"| |*Decimal places*|0|secondary_label_decimal_places|Possible values range from 0-6.<br><br>Default: 2.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Size* (type)|0|secondary_label_size_type|0 - *(default)* Auto;<br>1 - Custom.| |*Size*|0|secondary_label_size|Possible values range from 1-100.<br><br>Default: 30.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Size* (type) is set to "Custom"| |*Bold*|0|secondary_label_bold|0 - Disabled;<br>1 - *(default)* Enabled.| |*Color*|1|secondary_label_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`1F2C33` for "blue-theme" or "hc-light";<br>`EEEEEE` for "dark-theme" or "hc-dark".| |*Units* (checkbox)|0|secondary_label_units_show|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value"| |*Units* (value)|1|secondary_label_units|Any string value.<br><br>`""` (empty)<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"| |*Position*|0|secondary_label_position|0 - Before value;<br>1 - *(default)* After value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Type* is set to "Value" and *Units* (checkbox) is set to "Enabled"<br><br>This parameter is ignored if set to one of the following [time-related units](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Background color***|<|<|<| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: based on `theme` of [Settings object](/manual/api/reference/settings/object#settings) and [User object](/manual/api/reference/user/object#user):<br>`D9E7ED` for "blue-theme";<br>`3D5059` for "dark-theme";<br>`AAD7E9` for "hc-light";<br>`335463` for "hc-dark".| |***Thresholds***|<|<|<| |*Color interpolation*|0|interpolation|0 - Disabled;<br>1 - *(default)* Enabled.| |*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |*Threshold*|1|thresholds.0.threshold|Any numeric value. [Suffixes](/manual/appendix/suffixes) (e.g. "1d", "2w", "4K", "8G") are supported.|
ca	#### Configuració avançada  Els següents paràmetres de configuració avançada són compatibles amb el giny *Bresca*.  ::: noteclassic El nombre del nom de propietat *Llindars* (p. ex. thresholds.0.color) fa referència al lloc del llindar en una llista, en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (com ara `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |***Etiqueta principal***|<|<|<| |*Tipus*|0|primary_label_type|0 - *(per defecte)* Text;<br>1 - Valor.| |*Text*|1|primary_label|Qualsevol valor de cadena, incloses les macros.<br>Macros admeses: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros d'usuari.<br><br>Valor predeterminat: {HOST.NAME}<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Tipus* s'estableix a "Text"| |*Nombre de decimals*|0|primary_label_decimal_places|Els valors possibles oscil·len entre 0 i 6.<br><br>Per defecte: 2.<br><br>[Comportament dels paràmetres](/manual/api/reference_commentary#parameter-behavior) :<br>- *admès* si *Tipus* s'estableix a "Valor"| |*Mida* (tipus)|0|tipus_mida_etiqueta_primària|0 - *(per defecte)* Automàtic;<br>1 - Personalitzat.| |*Size*|0|primary_label_size|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 20.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si *Mida* (tipus) és establert a "Personalitzat"| |*Negreta*|0|primary_label_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Color*|1|primary_label_color|Codi de color hexadecimal (per exemple, `FF0000`).<br><br>Per defecte: basat en el `tema` d'[Objecte de configuració](/manual/api/reference/settings/object#settings) i [Objecte d'usuari](/manual/api/reference/user/object#user):<br>`1F2C33` per a "tema blau" o "hc-light";<br>`EEEEEE` per a "fosc tema" o "hc-fosc".| |*Unitats* (casella de selecció)|0|primary_label_units_show|0 - Desactivat;<br>1 - *(per defecte)* Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *admès* si *Tipus* s'estableix a "Valor"| |*Unitats* (valor)|1|primary_label_units|Qualsevol valor de cadena.<br><br>`""` (buida)<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior ):<br>- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Activat"| |*Posició*|0|primary_label_units_pos|0 - Abans del valor;<br>1 - *(per defecte)* Després del valor.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Actiu"<br><br>Aquest paràmetre s'ignora si s'estableix a una de les següents [unitats de temps relatiu](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Etiqueta secundària***|<|<|<| |*Tipus*|0|secondary_label_type|0 - Text;<br>1 - *(per defecte)* Valor.| |*Text*|1|secondary_label|Qualsevol valor de cadena, incloses les macros.<br>Macros admeses: {HOST.\*}, {ITEM.\*}, {INVENTORY.\*}, macros d'usuari.<br><br>Valor per defecte: {{ITEM.LASTVALUE}.fmtnum(2)}<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *Tipus* és establert a "Text"| |*Llocs decimals*|0|secondary_label_decimal_places|Els valors possibles oscil·len entre 0 i 6.<br><br>Per defecte: 2.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *admès* si *Tipus* s'estableix a "Valor"| |*Mida* (tipus)|0|secondary_label_size_type|0 - *(per defecte)* Automàtic;<br>1 - Personalitzat.| |*Size*|0|secondary_label_size|Els valors possibles oscil·len entre 1 i 100.<br><br>Per defecte: 30.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si *Mida* (tipus) és establerta a "Personalitzat"| |*Negreta*|0|secondary_label_bold|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Color*|1|secondary_label_color|Codi de color hexadecimal (per exemple, `FF0000`).<br><br>Per defecte: basat en el `tema` d'[objecte de configuració](/manual/api/reference/settings/object#settings ) i [Objecte d'usuari](/manual/api/reference/user/object#user):<br>`1F2C33` per a "tema blau" o "hc-light";<br>`EEEEEE` per a "fosc tema" o "hc-fosc".| |*Unitats* (casella de selecció)|0|secondary_label_units_show|0 - Desactivat;<br>1 - *(per defecte)* Activat.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *admès* si *Tipus* s'estableix a "Valor"| |*Unitats* (valor)|1|secondary_label_units|Qualsevol valor de cadena.<br><br>`""` (buida)<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior ):<br>- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Activat"| |*Posició*|0|secondary_label_position|0 - Abans del valor;<br>1 - *(per defecte)* Després del valor.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si *Tipus* s'estableix a "Valor" i *Unitats* (casella de selecció) s'estableix a "Actiu"<br><br>Aquest paràmetre s'ignora si s'estableix a una de les següents [unitats relacionades amb el temps](/manual/config/items/item#configuration): unixtime, uptime, s.| |***Color de fons***|<|<|<| |*Color de fons*|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: basat en el `tema` d'[Objecte de configuració](/manual/api/reference/settings/object# settings) i [Objecte d'usuari](/manual/api/reference/user/object#user):<br>`D9E7ED` per a "tema blau";<br>`3D5059` per a "tema fosc";<br >`AAD7E9` per a "hc-light";<br>`335463` per a "hc-dark".| |***Llindars***|<|<|<| |*Interpolació de colors*|0|interpolation|0 - Inhabilitat;<br>1 - *(per defecte)* Activat.| |*Color*|1|thresholds.0.color|Codi de color hexadecimal (p. ex., `FF0000`).| |*Llindar*|1|thresholds.0.threshold|Qualsevol valor numèric. Els [sufixos](/manual/apèndix/sufixos) (p. ex., "1d", "2w", "4K", "8G") són compatibles.|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Item history* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*New values*|<|0|sortorder|0 - *(default)* Top;<br>1 - Bottom.| |*Show timestamp*|<|0|show_timestamp|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show column header*|<|0|show_column_header|0 - Off;<br>1 - Horizontal;<br>2 - *(default)* Vertical.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its *Reference* parameter set to "`ABCDE`") as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set|
ca	#### Configuració avançada  Els següents paràmetres de configuració avançada són compatibles amb el giny *Historial d'elements*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Valors nous*|<|0|sortorder|0 - *(per defecte)* A dalt;<br>1 - A baix.| |*Mostra la marca de temps*|<|0|show_timestamp|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Mostra la capçalera de la columna*|<|0|show_column_header|0 - Desactivat;<br>1 - Horitzontal;<br>2 - *(per defecte)* Vertical.| |*Període de temps*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - estableix la [tria de *Període de temps*](/manual/web_interface/time_period_selector) com a font de dades.<br>`ABCDE._timeperiod` - establiu un giny compatible (*Gràfic*, *Grafic (clàssic)* o *Prototipus de gràfic* amb el seu paràmetre *Referència* definit a "`ABCDE`") com a font de dades.<br><br>Per defecte: `DASHBOARD._timeperiod`<br><br>Alternativament, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.| |<|*Des de*|1|time_period.from|Cadena de temps vàlida en la sintaxi de temps absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) sintaxi temporal (`ara` , `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit| |^|*Fins a*|1|time_period.to|Cadena de temps vàlida en la sintaxi temporal absoluta (`AAAA-MM-DD hh:mm:ss`) o [relativa](/manual/web_interface/time_period_selector) (`ara`) , `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si *El període de temps* no és pas definit|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported for the *Item value* widget.  ::: noteclassic The number in the *Thresholds* property name (e.g. thresholds.0.color) references the threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"thresholds.0.threshold":"5"` → `"thresholds.0.threshold":"1"`; `"thresholds.1.threshold":"1"` → `"thresholds.1.threshold": "5"`). :::  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Background color*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Thresholds*|<|<|<|<| |<|*Color*|1|thresholds.0.color|Hexadecimal color code (e.g. `FF0000`).| |^|*Threshold*|1|thresholds.0.threshold|Any string value.| |*Aggregation function*|<|0|aggregate_function|0 - *(default)* not used;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Time period*|<|1|time_period.\_reference|`DASHBOARD._timeperiod` - set the [*Time period* selector](/manual/web_interface/time_period_selector) as the data source;<br>`ABCDE._timeperiod` - set a [compatible widget](/manual/web_interface/frontend_sections/dashboards/widgets#widget-compatibility) (with its `reference` parameter equal to `ABCDE`) as the data source.<br><br>Default: `DASHBOARD._timeperiod`<br><br>Alternatively, you can set the time period only in the *From* and *To* parameters.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |<|*From*|1|time_period.from|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |^|*To*|1|time_period.to|Valid time string in absolute (`YYYY-MM-DD hh:mm:ss`) or [relative](/manual/web_interface/time_period_selector) time syntax (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if *Time period* is not set and *Aggregation function* is set to "min", "max", "avg", "count", "sum", "first", "last"| |*History data*|<|0|history|0 - *(default)* Auto;<br>1 - History;<br>2 - Trends.|
ca	#### Configuració avançada  Els paràmetres següents s'admeten si la *Configuració avançada* és establerta a "Habilitada".  ::: noteclassic El nombre del nom de propietat *Llindars* (p. ex., thresholds.color.0) fa referència al lloc del llindar en una llista, en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (p. ex., `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold. 1": "5"`). :::  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|--------|-------------------------------| |*Color de fons*|<|1|bg_color|Codi de color hexadecimal (p.e. `FF0000`).<br><br>Per defecte: `""` (buit).| |*Llindars*|<|<|<|<| |<|*Color*|1|thresholds.color.0|Codi de color hexadecimal (p.e. `FF0000`).| |^|*Llindar*|1|thresholds.threshold.0|Qualsevol valor de cadena.| |*Funció d'agregació*|<|0|funció_agregada|0 - *(per defecte)* no emprada;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte; <br>5 - suma;<br>6 - primer;<br>7 - darrer.||*Període de temps*|<|1|time_period._reference|`DASHBOARD._timeperiod` - estableix el selector [*Període de temps*](/manual/web_interface/time_period_selector) com a font de dades.<br>`ABCDE._timeperiod`: estableix un giny compatible (*gràfic*, *Gràfic (clàssic)* o *Prototip de gràfic* amb el seu paràmetre `reference` igual a `ABCDE`) com a font de dades.<br><br>Valor predeterminat: `DASHBOARD._timeperiod`<br><br>Com a alternativa, podeu establir el període de temps només als paràmetres *Des de* i *Fins a*.< br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si la *funció d'agregació* s'estableix en "mín", "màx", "mitjana", "recompte", "suma", "primer", "darrer"||<|*Des de*|1|time_period.from|Cadena de temps vàlida en absolut (`AAAA-MM-DD hh:mm:ss`) o [relatiu](/manual/web_interface/time_period_selector) sintaxi temporal (`ara`, `ara/d`, `ara/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/ reference_commentary#parameter-behavior):<br>- *admès* si no s'estableix *Període de temps* i la *funció d'agregació* s'estableix en "mín", "màx", "mitjana", "recompte", "suma", "primer", "darrer"||^|*To*|1|time_period.to|Cadena de temps vàlida en absolut (`AAAA-MM-DD hh:mm:ss`) o [relatiu](/manual/web_interface/ time_period_selector) sintaxi temporal (`now`, `now/d`, `now/w-1w`, etc.).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior): <br>- *admès* si el *Període de temps* no és pas definit i la *Funció d'agregació* s'estableix en "mín", "màx", "mitjana", "recompte", "suma", "primer", "darrer" ||*Dades de l'historial*|<|0|historial|0 - *(per defecte)* Automàtic;<br>1 - Historial;<br>2 - Tendències.|

en-us	#### Advanced configuration  The following advanced configuration parameters are supported if *Clock type* is set to "Digital".  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Background color*|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).|
ca	#### Configuració avançada  Els paràmetres següents de configuració avançada s'admeten si el *Tipus de rellotge* és establert a "Digital".  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Color de fons*|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).|

en-us	#### Advanced extensions
ca	#### Extensions avançades

en-us	#### Advanced host interface configuration  The `vmware.vm.discovery[{$VMWARE.URL}]` item key, configured in the [*Create a low-level discovery rule*](#create-a-low-level-discovery-rule) section, returns network interfaces data in the ["net_if" field](/manual/vm_monitoring/discovery_fields):  ```json "net_if": [       {         "ifname": "5000",         "ifdesc": "Network adapter 1",         "ifmac": "00:11:22:33:44:55",         "ifconnected": true,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": [           "127.0.0.1",           "::1"         ]       },       {         "ifname": "5001",         "ifdesc": "Network adapter 2",         "ifmac": "00:11:22:33:44:55",         "ifconnected": false,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab2)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": []       }     ] ```  This data can be used to configure a custom host interface.  1\. When [creating a low-level discovery rule](#create-a-low-level-discovery-rule), additionally configure a [low-level discovery macro](/manual/config/macros/lld_macros). In the *LLD macros* tab, create a custom LLD macro with a [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality) value. For example:  - {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()`  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro.png){width="600"}  2\. When [creating a host prototype](#create-a-host-prototype), add a custom host interface and enter the LLD macro in the *DNS name* or *IP address* field.  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro_host_prototype.png){width="600"}
ca	#### Configuració avançada de la interfície de l'amfitrió  La clau d'element `vmware.vm.discovery[{$VMWARE.URL}]`, configurada a la secció [*Crea una regla de descoberta de baix nivell*](#create-a-low-level-discovery-rule), retorna dades de les interfícies de xarxa al [camp "net_if"](/manual/vm_monitoring/discovery_fields):  ```json "net_if": [       {         "ifname": "5000",         "ifdesc": "Network adapter 1",         "ifmac": "00:11:22:33:44:55",         "ifconnected": true,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": [           "127.0.0.1",           "::1"         ]       },       {         "ifname": "5001",         "ifdesc": "Network adapter 2",         "ifmac": "00:11:22:33:44:55",         "ifconnected": false,         "iftype": "VirtualVmxnet3",         "ifbackingdevice": "VLAN(myLab2)",         "ifdvswitch_uuid": "",         "ifdvswitch_portgroup": "",         "ifdvswitch_port": "",         "ifip": []       }     ] ```  Aquestes dades es poden emprar per configurar una interfície d'equip personalitzada.  1\. Quan [creeu una regla de descoberta de baix nivell](#create-a-low-level-discovery-rule), configureu, a més, una [macro de descoberta de baix nivell](/manual/config/macros/lld_macros). A la pestanya *Macros LLD*, creeu una macro LLD personalitzada amb un valor [JSONPath](/manual/config/items/preprocessing/jsonpath_functionality). Per exemple:  - {#MYLAB.NET.IF} - `$.net_if[?(@.ifbackingdevice=="VLAN(myLab)")].ifip[0].first()`  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro.png){width="600"}  2\. Quan [creeu un prototip d'equip] (#create-a-host-prototype), afegiu una interfície d'equip personalitzada i introduïu la macro LLD al camp *nom DNS* o *adreça IP*.  ![](../../../assets/en/manual/vm_monitoring/vmware_lld_macro_host_prototype.png){width="600"}

en-us	 #### Advanced root-cause handling for unsupported item state  Error handling in case of a failure to retrieve an item value (and thus it becoming unsupported) previously lacked the ability to distinguish the reason or runtime stage where the process failed. All errors had to be handled using one and the same option for error handling - either to discard the value, set a specified value or set a specified error message.  It is now possible to match the error message to a regular expression. If the error matches (or does not match) it is possible to specify how the error case should be processed. For example, a specific error message can be "mapped" to a more general case to be matched for and handled by a further preprocessing step, or some intermittent (e.g., network connectivity) issue can be handled differently to a definite failure to acquire the item value.  Multiple *Check for not supported value* preprocessing steps can now be added. Note that there can be only one "any error" matching step at the end of the pipeline probing for unsupported state of the item. If present, it is activated if none of the specific checks (mis)matched the according pattern, or a (modified) error message was carried over - i.e., no "Discard value" or "Set value to" override came into effect.  ![](../../../assets/en/manual/config/items/check_unsupported_format_error.png){width="600"}  See also: [Check for not supported value](/manual/config/items/preprocessing#checkunsupported)
ca	 #### Gestió avançada de causes arrel per a l'estat de l'element no compatible  La gestió d'errors en cas de fallada per recuperar el valor d'un element (i, per tant, no s'admetia) anteriorment no tenia la capacitat de distingir el motiu o l'etapa d'execució on el procés fallava. Tots els errors s'havien de gestionar mitjançant una mateixa opció per a la gestió d'errors, ja sigui per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.  Ara és possible fer coincidir el missatge d'error amb una expressió regular. Si l'error coincideix (o no coincideix), és possible especificar com s'ha de processar el cas d'error. Per exemple, un missatge d'error específic es pot "assignar" a un cas més general per fer-lo coincidir i tractar-lo mitjançant un pas de preprocessament addicional, o algun problema intermitent (per exemple, la connectivitat de la xarxa) es pot gestionar de manera diferent a un error definitiu per adquirir el valor de l'article.  Ara es poden afegir diversos passos de preprocessament *Comprovar si no és compatible*. Tingueu en compte que només hi pot haver un pas de coincidència de "qualsevol error" al final de la investigació de la canalització de l'estat no compatible de l'element. Si és present, s'activa si cap de les comprovacions específiques (mal) coincideix amb el patró corresponent, o si s'ha transmès un missatge d'error (modificat), és a dir, no ha tingut efecte cap anul·lació de "Descartar valor" o "Establir valor a".  ![](../../../assets/en/manual/config/items/check_unsupported_format_error.png){width="600"}  Vegeu també: [Comproveu el valor no admès](/manual/config/items/preprocessing#checkunsupported)

en-us	 ##### Advanced settings  Additional SAML parameters can be configured in the Zabbix frontend configuration file (*zabbix.conf.php*):  -   $SSO\['SP\_KEY'\] = '<path to the SP private key file>'; -   $SSO\['SP\_CERT'\] = '<path to the SP cert file>'; -   $SSO\['IDP\_CERT'\] = '<path to the IDP cert file>'; -   $SSO\['SETTINGS'\]  ::: noteclassic  Zabbix uses [OneLogin's SAML PHP Toolkit](https://github.com/onelogin/php-saml/tree/3.4.1) library (version 3.4.1). The structure of $SSO\['SETTINGS'\] section should be similar to the structure used by the library. For the description of configuration options, see official library [documentation](https://github.com/onelogin/php-saml/tree/3.4.1/#user-content-settings).  :::  Only the following options can be set as part of $SSO\['SETTINGS'\]:  -   *strict* -   *baseurl* -   *compress* -   *contactPerson* -   *organization* -   *sp* (only options specified in this list)     -   *attributeConsumingService*     -   *x509certNew* -   *idp* (only options specified in this list)     -   *singleLogoutService* (only one option)         -   *responseUrl*     -   *certFingerprint*     -   *certFingerprintAlgorithm*     -   *x509certMulti* -   *security* (only options specified in this list)     -   *signMetadata*     -   *wantNameId*     -   *requestedAuthnContext*     -   *requestedAuthnContextComparison*     -   *wantXMLValidation*     -   *relaxDestinationValidation*     -   *destinationStrictlyMatches*     -   *rejectUnsolicitedResponsesWithInResponseTo*     -   *signatureAlgorithm*     -   *digestAlgorithm*     -   *lowercaseUrlencoding*  All other options will be taken from the database and cannot be overridden. The *debug* option will be ignored.  In addition, if Zabbix UI is behind a proxy or a load balancer, the custom *use\_proxy\_headers* option can be used:  -   *false* (default) - ignore the option; -   *true* - use X-Forwarded-\* HTTP headers for building the base URL.    If using a load balancer to connect to Zabbix instance, where the load balancer uses TLS/SSL and Zabbix does not, you must indicate 'baseurl', 'strict' and 'use_proxy_headers' parameters as follows:      $SSO['SETTINGS']=['strict' => false, 'baseurl' => "https://zabbix.example.com/zabbix/", 'use_proxy_headers' => true]   **Configuration example:**      $SSO['SETTINGS'] = [         'security' => [             'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384'             'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384',             // ...         ],         // ...     ];
ca	 ##### Configuració avançada  Es poden configurar paràmetres SAML addicionals al fitxer de configuració de la interfície de Zabbix (*zabbix.conf.php*):  - $SSO\['SP\_KEY'\] = '<camí al fitxer de clau privada SP>'; - $SSO\['SP\_CERT'\] = '<camí al fitxer de certificat SP>'; - $SSO\['IDP\_CERT'\] = '<camí al fitxer de certificat IDP>'; - $SSO\['SETTINGS'\]  ::: noteclassic   Zabbix empra la biblioteca [kit d'eines SAML PHP de OneLogin](https://github.com/onelogin/php-saml/tree/3.4.1) (versió 3.4.1). L'estructura de la secció $SSO\['SETTINGS'\] hauria de ser similar a l'estructura emprada per la biblioteca. Per a la descripció de les opcions de configuració, veieu la [documentació](https://github.com/onelogin/php-saml/tree/3.4.1/#user-content-settings) de la biblioteca oficial.  :::  Només es poden definir les opcions següents com a part de $SSO\['SETTINGS'\]:  -   *strict* -   *baseurl* -   *compress* -   *contactPerson* -   *organization* - *sp* (només les opcions especificades en aquesta llista)      - *attributeConsumingService*      - *x509certNew* - *idp* (només les opcions especificades en aquesta llista)      - *singleLogoutService* (només una opció)         -   *responseUrl*     -   *certFingerprint*     -   *certFingerprintAlgorithm*     -   *x509certMulti* - *security* (només les opcions especificades en aquesta llista)     -   *signMetadata*     -   *wantNameId*     -   *requestedAuthnContext*     -   *requestedAuthnContextComparison*     -   *wantXMLValidation*     -   *relaxDestinationValidation*     -   *destinationStrictlyMatches*     -   *rejectUnsolicitedResponsesWithInResponseTo*     -   *signatureAlgorithm*     -   *digestAlgorithm*     -   *lowercaseUrlencoding*  Totes les altres opcions seran extretes de la base de dades i no es poden anul·lar. L'opció *debug* serà ignorada.  A més, si la interfície d'usuari de Zabbix és darrere d'un proxy o d'un equilibrador de càrrega, es pot emprar l'opció personalitzada *use\_proxy\_headers*:  - *fals* (per defecte) - ignora l'opció; - *cert* - empreu les capçaleres HTTP X-Forwarded-\* per crear l'URL base.    Si empreu un equilibrador de càrrega per connectar-vos a la instància de Zabbix, on l'equilibrador de càrrega empra TLS/SSL i Zabbix no, heu d'indicar els paràmetres "baseurl", "strict" i "use_proxy_headers" de la manera següent:       $SSO_SETTINGS=['strict' => false, 'baseurl' => "https://zabbix.example.com/zabbix/", 'use_proxy_headers' => true]   **Exemple de configuració:**      $SSO['SETTINGS'] = [         'security' => [             'signatureAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#rsa-sha384'             'digestAlgorithm' => 'http://www.w3.org/2001/04/xmldsig-more#sha384',             // ...         ],         // ...     ];

en-us	After receiving a list of active checks the agent marks obsolete persistent files for removal. A persistent file becomes obsolete if: 1) the corresponding log item is no longer monitored, 2) a log item is reconfigured with a different **persistent\_dir** location than before.  Removing is done with delay 24 hours because log files in NOTSUPPORTED state are not included in the list of active checks but they may become SUPPORTED later and their persistent files will be useful.  If the agent is stopped before 24 hours expire, then the obsolete files will not be deleted as Zabbix agent is not getting info about their location from Zabbix server anymore.  ::: notewarning Reconfiguring a log item's **persistent\_dir** back to the old **persistent\_dir** location while the agent is stopped, without deleting the old persistent file by user - will cause restoring the agent state from the old persistent file resulting in missed messages or false alerts. :::
ca	Després de rebre una llista de comprovacions actives, l'agent marca els fitxers persistents obsolets per esborrar-los. Un fitxer persistent queda obsolet si: 1) l'element de registre corresponent ja no es monitora, 2) un element de registre es torna a configurar amb una ubicació **persistent\_dir** diferent a la d'abans.  L'esborrat es fa amb un retard de 24 hores perquè els fitxers de registre en estat NO ADMÈS no s'inclouen a la llista de comprovacions actives, però poden ser ADMESOS més tard i els seus fitxers persistents seran útils.  Si l'agent s'atura abans de la caducitat de les 24 hores, els fitxers obsolets no s'esborraran pas perquè l'agent Zabbix ja no rep informació sobre la seva ubicació del servidor Zabbix.  ::: notewarning Torneu a configurar el **persistent\_dir** d'un element de registre a l'antiga ubicació **persistent\_dir** mentre l'agent és inactiu, sense esborrar l'antic fitxer persistent per part de l'usuari; missatges perduts o alertes falses. :::

en-us	 #### Agent 2 configuration  **Buffer size**  The default value of the [BufferSize](/manual/appendix/config/zabbix_agent2) configuration parameter for Zabbix agent 2 has been increased from 100 to 1000.  **Empty values allowed**  Empty values are now allowed in plugin-related configuration parameters on Zabbix agent 2.
ca	 #### Configuració de l'agent 2  **Mida del buffer**  El valor predeterminat del paràmetre de configuració [BufferSize](/manual/appendix/config/zabbix_agent2) per a l'agent Zabbix 2 s'ha augmentat de 100 a 1000.  **Valors buits permesos**  Els valors buits ara es permeten als paràmetres de configuració relacionats amb els connectors a l'agent Zabbix 2.

en-us	##### Agent 2  |Requirement|Mandatory status|Description| |--|-|-------| |*libpcre/libpcre2*|One of|PCRE/PCRE2 library is required for [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) support.<br>The naming may differ depending on the GNU/Linux distribution, for example 'libpcre3' or 'libpcre1'. PCRE v8.x and PCRE2 v10.x are supported.<br>Required for log monitoring. Also required on Windows.| |*libopenssl*|No|Required when using encryption.<br>OpenSSL 1.0.1 or later is required on UNIX platforms.<br>The OpenSSL library must have PSK support enabled. LibreSSL is not supported.<br>On Microsoft Windows systems OpenSSL 1.1.1 or later is required.|  **Go libraries**  |Requirement|Mandatory status|Minimum version|Description| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support)|Yes|1.X.X|Zabbix own support library. Mostly for plugins. | |[github.com/BurntSushi/locker](https://github.com/BurntSushi/locker)|^|0.0.0|Named read/write locks, access sync. | |[github.com/chromedp/cdproto](https://github.com/chromedp/cdproto)|^|0.0.0|Generated commands, types, and events for the Chrome DevTools Protocol domains. | |[github.com/chromedp/chromedp](https://github.com/chromedp/chromedp)|^|0.6.0|Chrome DevTools Protocol support (report generation). | |[github.com/dustin/gomemcached](https://github.com/dustin/gomemcached)|^|0.0.0|A memcached binary protocol toolkit for go. | |[github.com/eclipse/paho.mqtt.golang](https://github.com/eclipse/paho.mqtt.golang)|^|1.2.0|A library to handle MQTT connections. | |[github.com/fsnotify/fsnotify](https://github.com/fsnotify/fsnotify)|^|1.4.9|Cross-platform file system notifications for Go. | |[github.com/go-ldap/ldap](https://github.com/go-ldap/ldap)|^|3.0.3|Basic LDAP v3 functionality for the Go programming language. | |[github.com/go-ole/go-ole](https://github.com/go-ole/go-ole)|^|1.2.4|Win32 ole implementation for Go. | |[github.com/godbus/dbus](https://github.com/godbus/dbus)|^|4.1.0|Native Go bindings for D-Bus. | |[github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql)|^|1.5.0|MySQL driver. | |[github.com/godror/godror](https://github.com/godror/godror)|^|0.20.1|Oracle DB driver. | |[github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3)|^|2.0.3|Sqlite3 driver. | |[github.com/mediocregopher/radix/v3](https://github.com/mediocregopher/radix)|^|3.5.0|Redis client. | |[github.com/memcachier/mc/v3](https://github.com/memcachier/mc)|^|3.0.1|Binary Memcached client. | |[github.com/miekg/dns](https://github.com/miekg/dns)|^|1.1.43|DNS library. | |[github.com/omeid/go-yarn](https://github.com/omeid/go-yarn)|^|0.0.1|Embeddable filesystem mapped key-string store. | |[github.com/goburrow/modbus](https://github.com/goburrow/modbus)|^|0.1.0|Fault-tolerant implementation of Modbus. | |[golang.org/x/sys](https://pkg.go.dev/golang.org/x/sys)|^|0.0.0|Go packages for low-level interactions with the operating system.<br>Also used in plugin support lib. Used in MongoDB and PostgreSQL plugins. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|On Windows.<br>Yes, indirect^**1**^|0.6.0|Windows named pipe implementation.<br>Also used in plugin support lib. Used in MongoDB and PostgreSQL plugins. | |[github.com/goburrow/serial](https://github.com/goburrow/serial)|Yes, indirect^**1**^|0.1.0|Serial library for Modbus. | |[golang.org/x/xerrors](https://pkg.go.dev/golang.org/x/xerrors)|^|0.0.0|Functions to manipulate errors. | |[gopkg.in/asn1-ber.v1](https://gopkg.in/asn1-ber.v1)|^|1.0.0|Encoding/decoding library for ASN1 BER. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|No, indirect^**1**^|1.8.0| | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1| | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6| | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0| | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2| | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2| | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0| |  ^**1**^ "Indirect" means that it is used in one of the libraries that the agent uses. It's required since Zabbix uses the library that uses the package.  See also dependencies for loadable plugins:  -   [PostgreSQL](/manual/installation/requirements/postgresql) -   [MongoDB](/manual/installation/requirements/mongodb)
ca	##### Agent 2  |Requisit|Estat obligatori|Descripció| |--|-|-------| |*libpcre/libpcre2*|Cal una de les biblioteques PCRE/PCRE2 per al suport d'[expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>El nom pot ser diferent. depenent de la distribució GNU/Linux, per exemple 'libpcre3' o 'libpcre1'. S'admeten PCRE v8.x i PCRE2 v10.x.<br>Cal per al monitoratge del registre. També cal a Windows.| |*libopenssl*|No|Cal quan s'empra el xifrat.<br>OpenSSL 1.0.1 o posterior és necessari a les plataformes UNIX.<br>La biblioteca OpenSSL ha de tindre el suport PSK activat. LibreSSL no és compatible.<br>Als sistemes Microsoft Windows cal OpenSSL 1.1.1 o posterior.|  **Biblioteques Go**  |Requisit|Estat obligatori|Versió mínima|Descripció| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support)|Sí|1.X.X|Biblioteca d'assistència pròpia de Zabbix. Principalment per a connectors. | |[github.com/BurntSushi/locker](https://github.com/BurntSushi/locker)|^|0.0.0|Bloquejos de lectura/escriptura amb nom, sincronització d'accés. | |[github.com/chromedp/cdproto](https://github.com/chromedp/cdproto)|^|0.0.0|Ordres, tipus i esdeveniments generats per als dominis del protocol Chrome DevTools. | |[github.com/chromedp/chromedp](https://github.com/chromedp/chromedp)|^|0.6.0|Compatibilitat amb el protocol Chrome DevTools (generació d'informes). | |[github.com/dustin/gomemcached](https://github.com/dustin/gomemcached)|^|0.0.0|Un conjunt d'eines de protocol binari de memcached per a go. | |[github.com/eclipse/paho.mqtt.golang](https://github.com/eclipse/paho.mqtt.golang)|^|1.2.0|Una biblioteca per gestionar connexions MQTT. | |[github.com/fsnotify/fsnotify](https://github.com/fsnotify/fsnotify)|^|1.4.9|Notificacions del sistema de fitxers multiplataforma per a Go. | |[github.com/go-ldap/ldap](https://github.com/go-ldap/ldap)|^|3.0.3|Funcionalitat bàsica de LDAP v3 per al llenguatge de programació Go. | |[github.com/go-ole/go-ole](https://github.com/go-ole/go-ole)|^|1.2.4|Implementació Win32 ole per a go. | |[github.com/godbus/dbus](https://github.com/godbus/dbus)|^|4.1.0|Enllaços Native Go per a D-Bus. | |[github.com/go-sql-driver/mysql](https://github.com/go-sql-driver/mysql)|^|1.5.0|Controlador MySQL. | |[github.com/godror/godror](https://github.com/godror/godror)|^|0.20.1|Controlador d'Oracle DB. | ||[github.com/mattn/go-sqlite3](https://github.com/mattn/go-sqlite3)|^|2.0.3|Controlador Sqlite3. | |[github.com/mediocregopher/radix/v3](https://github.com/mediocregopher/radix)|^|3.5.0|Client de Redis. | |[github.com/memcachier/mc/v3](https://github.com/memcachier/mc)|^|3.0.1|Client de Memcached binari. | |[github.com/miekg/dns](https://github.com/miekg/dns)|^|1.1.43|Biblioteca DNS. | |[github.com/omeid/go-yarn](https://github.com/omeid/go-yarn)|^|0.0.1|Magatzem de cadenes de claus amb un sistema de fitxers incrustable. | |[github.com/goburrow/modbus](https://github.com/goburrow/modbus)|^|0.1.0|Implementació de Modbus tolerant a errors. | |[golang.org/x/sys](https://pkg.go.dev/x/sys)|^|0.0.0|Paquets Go per a interaccions de baix nivell amb el sistema operatiu.<br>També s'empra en suport de connectors lib. S'empra als plugins de MongoDB i PostgreSQL. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|A Windows.<br>Sí, indirecte**1**|0.6.0|Windows named pipe implementació.<br>També s'empra al suport del complement lib. S'empra al connector MongoDB. | |[github.com/goburrow/serial](https://github.com/goburrow/serial)|Sí, indirecte^**1**^|0.1.0|Biblioteca sèrie per a Modbus. | |[golang.org/x/xerrors](https://pkg.go.dev/x/xerrors)|^|0.0.0|Funcions per manipular errors. | |[gopkg.in/asn1-ber.v1](https://gopkg.in/asn1-ber.v1)|^|1.0.0|Biblioteca de codificació/descodificació per a ASN1 BER. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|No, indirecte^**1**^|1.8.0| | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1| | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6| | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0| | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2| | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2| | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0| |  ^**1**^ "Indirecte" vol dir que s'empra a una de les biblioteques que fa ús de l'agent. Cal, ja que Zabbix empra la biblioteca que empra el paquet.  Veieu també dependències per a connectors carregables:  -[PostgreSQL](/manual/installation/requirements/plugins/postgresql) -[MongoDB](/manual/installation/requirements/plugins/mongodb)

en-us	**Agent configuration**  Add the next line to the agent configuration file:      HostMetadata=Linux    21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae  where "Linux" is a platform, and the rest of the string is the hard-to-guess secret text.  Do not forget to restart the agent after making any changes to the configuration file.  ***Step 2***  It is possible to add additional monitoring for an already registered host.
ca	**Configuració de l'agent**  Afegiu la línia següent al fitxer de configuració de l'agent:  HostMetadata=Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae  on "Linux" és una plataforma i la resta de la cadena és un text secret difícil d'endevinar.  Recordeu reiniciar l'agent després de fer canvis al fitxer de configuració.  ***2a passa***  Es pot afegir monitoratge addicional per a un equip ja registrat.

en-us	##### Agent configuration  HA cluster nodes (servers) must be listed in the configuration of  Zabbix agent or Zabbix agent 2.  ![](../../../../assets/en/manual/config/zabbix_ha_agent.png)  To enable passive checks, the node names must be listed in the Server [parameter](/manual/appendix/config/zabbix_agentd), separated by a **comma**.  ``` Server=zabbix-node-01,zabbix-node-02 ```  To enable active checks, the node names must be listed in the ServerActive [parameter](/manual/appendix/config/zabbix_agentd). Note that for  active checks the nodes must be separated by a comma from any other  servers, while the nodes themselves must be separated by a **semicolon**, e.g.:  ``` ServerActive=zabbix-node-01;zabbix-node-02 ```
ca	##### Configuració de l'agent  Els nodes de clúster HA (servidors) s'han d'enumerar a la configuració de l'agent Zabbix o de l'agent Zabbix 2.  ![](../../../../assets/en/manual/config/zabbix_ha_agent.png)  Per activar les comprovacions passives, els noms dels nodes han d'ésser llistats al [paràmetre](/manual/appendix/config/zabbix_agentd) del servidor, separats per una **coma**.  ``` Servidor=zabbix-node-01,zabbix-node-02 ```  Per activar les comprovacions actives, els noms dels nodes han d'ésser llistats al [paràmetre](/manual/appendix/config/zabbix_agentd) ServerActive. Tingueu en compte que per a les comprovacions actives, els nodes s'han de separar per comes de qualsevol altre servidor, mentre que els nodes s'han de separar amb un **punt i coma**, per exemple:  ``` ActiveServer=zabbix-node-01;zabbix-node-02 ```

en-us	**Agent configuration**  Now you need to configure the agents. Add the next line to the agent configuration files:      HostMetadataItem=system.uname  This way you make sure host metadata will contain "Linux" or "Windows" depending on the host an agent is running on. An example of host metadata in this case:      Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux     Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32  Do not forget to restart the agent after making any changes to the configuration file.
ca	##### Configuració de l'agent  Ara heu de configurar els agents. Afegiu la línia següent als fitxers de configuració de l'agent:  HostMetadataItem=system.uname  Això garanteix que les metadades de l'equip contindran "Linux" o "Windows" en funció de l'equip on s'executa l'agent. Un exemple de metadades de l'equip en aquest cas:  Linux: Linux server3 3.2.0-4-686-pae #1 SMP Debian 3.2.41-2 i686 GNU/Linux Windows: Windows WIN-0PXGGSTYNHO 6.0.6001 Windows Server 2008 Service Pack 1 Intel IA-32  Recordeu reiniciar l'agent després de fer canvis al fitxer de configuració.

en-us	**Agent configuration**  Update the next line in the agent configuration file:      HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae  Do not forget to restart the agent after making any changes to the configuration file.
ca	**Configuració de l'agent**  Actualitzeu la següent línia a l'arxiu de configuració de l'agent:      HostMetadata=MySQL on Linux 21df83bf21bf0be663090bb8d4128558ab9b95fba66a6dbf834f8b91ae5e08ae  No oblideu pas reiniciar l'agent després de fer canvis a l'arxiu de configuració.

en-us	 ##### agent.hostmetadata {#agent.hostmetadata}  <br> The agent host metadata.<br> Return value: *String*.<br> See [supported platforms](#supported-platforms).  Returns the value of [HostMetadata](/manual/appendix/config/zabbix_agentd#hostmetadata) or [HostMetadataItem](/manual/appendix/config/zabbix_agentd#hostmetadataitem) parameters, or empty string if none are defined.
ca	 ##### agent.hostmetadata {#agent.hostmetadata}  <br> Metadades de l'equip de l'agent.<br> Valor de retorn: *Cadena*.<br> Veieu [plataformes compatibles](#supported-platforms).  Retorna el valor dels paràmetres [HostMetadata](/manual/appendix/config/zabbix_agentd#hostmetadata) o [HostMetadataItem](/manual/appendix/config/zabbix_agentd#hostmetadataitem), o una cadena buida si no n'hi ha cap definit.

en-us	 ##### agent.hostname {#agent.hostname}  <br> The agent host name.<br> Return value: *String*.<br> See [supported platforms](#supported-platforms).  Returns:  -   As passive check - the name of the first host listed in the [Hostname](/manual/appendix/config/zabbix_agentd#hostname) parameter of the agent configuration file; -   As active check - the name of the current hostname.
ca	 ##### agent.hostname {#agent.hostname}  <br> Nom d'equip de l'agent.<br> Valor de retorn: *Cadena*.<br> Veieu [plataformes compatibles](#supported-platforms).  Devolucions:  - Com a comprovació passiva: el nom del primer equip que apareix al paràmetre [Hostname](/manual/appendix/config/zabbix_agentd#hostname) del fitxer de configuració de l'agent; - Com a verificació activa - el nom del nom d'equip actual.

en-us	#### Agent on UNIX-like systems  Zabbix agent on UNIX-like systems is run on the host being monitored.
ca	#### Agent a sistemes Unix  L’agent Zabbix a sistemes Unix s'executa a un equip monitorat.

en-us	#### Agent on Windows systems  Zabbix agent on Windows runs as a Windows service.
ca	#### Agent als sistemes Windows  L'agent Zabbix sota Windows s'executa com a servei de Windows.

en-us	##### Agent operation with persistent file  On startup Zabbix agent knows nothing about persistent files. Only after receiving a list of active checks from Zabbix server \(proxy\) the agent sees that some log items should be backed by persistent files under specified directories.  During agent operation the persistent files are opened for writing (with fopen(filename, "w")) and overwritten with the latest data.  The chance of losing persistent file data if the overwriting and file system mirror split happen at the same time is very small, no special handling for it.  Writing into persistent file is NOT followed by enforced synchronization to storage media \(fsync\(\) is not called\).  Overwriting with the latest data is done after successful reporting of matching log file record or metadata \(processed log size and modification time\) to Zabbix server. That may happen as often as every item check if log file keeps changing.  No special actions during agent shutdown.
ca	##### Funcionament de l'agent amb fitxer persistent  A l'inici, l'agent Zabbix no sap res dels fitxers persistents. Només després de rebre una llista de comprovacions actives del \(proxy\) o servidor Zabbix, l'agent entén que alguns elements de registre han de fer una còpia de seguretat mitjançant fitxers persistents als directoris especificats.  Mentre l'agent s'executa, els fitxers persistents s'obren per escriure (amb fopen(nom de fitxer, "w")) i es sobreescriuen amb les dades més recents. El risc de perdre dades de fitxers persistents si la rèplica del sistema de fitxers sobreescriu i es divideix al mateix temps és molt baix, no cal cap tractament especial. L'escriptura en un fitxer persistent NO és seguida d'una sincronització forçada amb el suport d'emmagatzematge \(fsync\(\) no s'anomena\).  La sobreescriptura amb les dades més recents es fa després d'informar amb èxit del registre o metadades del fitxer de registre corresponent (mida del registre processat i temps de modificació) al servidor Zabbix. Això pot passar tan sovint com cada element comprova si el fitxer de registre continua canviant.  No cal pas cap acció especial en aturar l'agent.

en-us	 ##### agent.ping {#agent.ping}  <br> The agent availability check.<br> Return value: Nothing - unavailable; 1 - available.<br> See [supported platforms](#supported-platforms).  Use the **nodata()** trigger function to check for host unavailability.
ca	 ##### agent.ping {#agent.ping}  <br> Comprovació de la disponibilitat de l'agent.<br> Valor de retorn: Res - no disponible; 1 - disponible.<br> Veieu [plataformes compatibles](#supported-platforms).  Empreu la funció trigger **nodata()** per comprovar la indisponibilitat de l'equip.

en-us	#### Agent process types  -   `active checks` - process for performing active checks -   `collector` - process for data collection -   `listener` - process for listening to passive checks  The agent log file can be used to observe these process types.
ca	#### Tipus de processos Agent  -   `​active checks`​ - processos que fan verificacions actives -   `​collector`​ - processos per recollir dades -   `​listener`​ - processos que escolten les verificacions passives  L'arxiu de registre de l'agent es pot emprar per observar aquests tipus de processos.

en-us	##### Agent  |Requirement|Mandatory status|Description| |--|-|-------| |*libpcre/libpcre2*|One of|PCRE/PCRE2 library is required for [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) support.<br>The naming may differ depending on the GNU/Linux distribution, for example 'libpcre3' or 'libpcre1'. PCRE v8.x and PCRE2 v10.x are supported.<br>Required for log monitoring. Also required on Windows.| |*libpthread*|Yes|Required for mutex and read-write lock support (could be part of libc). Not required on Windows.| |*libresolv*|^|Required for DNS resolution (could be part of libc). Not required on Windows.| |*libiconv*|^|Required for text encoding/format conversion to UTF-8 in log items, file content, file regex and regmatch items (could be part of libc). Not required on Windows.| |*libgnutls* or *libopenssl*|No|Required if using [encryption](/manual/encryption#compiling_zabbix_with_encryption_support).<br>Minimum versions: *libgnutls* - 3.1.18, *libopenssl* - 1.0.1<br>On Microsoft Windows OpenSSL 1.1.1 or later is required.| |*libldap*|^|Required if LDAP is used. Not supported on Windows.| |*libcurl*|^|Required for `web.page.*` Zabbix agent [items](/manual/config/items/itemtypes/zabbix_agent). Not supported on Windows.<br>Version 7.19.1 or higher is required (7.28.0 or higher is recommended).<br>To make use of upgraded cURL features, restart Zabbix agent.| |*libmodbus*|^|Only required if Modbus monitoring is used.<br>Version 3.0 or higher.|
ca	##### Agent  |Requisits previs|Obligació|Descripció| |--|-|-------| |*libpcre/libpcre2*|Una de les biblioteques |PCRE/PCRE2 és necessària per al suport d'[expressions regular compatibles amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE).<br>El nom pot ser difereixen segons la distribució GNU/Linux, per exemple 'libpcre3' o 'libpcre1'. S'admeten PCRE v8.x i PCRE2 v10.x.<br>Cal per al monitoratge del registre. També es requereix a Windows.| |*libpthread*|Sí|Cal per al suport de blocatge de mutex i lectura-escriptura (pot ser part de libc). No cal a Windows.| |*libresolv*|^|Cal per a la resolució DNS (pot ser part de libc). No cal a Windows.| |*libiconv*|^|Cal per a la codificació de text/conversió de format a UTF-8 en elements de registre, contingut del fitxer, expressió regular del fitxer i elements de concordança de regles (pot ser part de la libc). No cal a Windows.| |*libgnutls* o *libopenssl*|No|Cal si utilitzeu [encryption](/manual/encryption#compiling_zabbix_with_encryption_support).<br>Versions mínimes: *libgnutls* - 3.1.18, *libopenssl* - 1.0.1 <br >A Microsoft Windows, cal OpenSSL 1.1.1 o posterior.| |*libldap*|^|Cal si s'empra LDAP. No és compatible amb Windows.| |*libcurl*|^|Cal per als [elements](/manual/config/items/itemtypes/zabbix_agent) l'agent Zabbix `web.page.*`. No és compatible amb Windows.<br>Cal la versió 7.19.1 o superior (es recomana la versió 7.28.0 o superior).Per fer ús de les característiques actualitzades de cURL, reinicieu l'agent de Zabbix.| |*libmodbus*|^|Només cal si s'empra el monitoratge de modbus.<br>Versió 3.0 o superior.|

en-us	#### Agent upgrade process  ::: noteimportant Upgrading agents is not mandatory. You only need to upgrade agents if it is required to access the new functionality. :::  The upgrade procedure described in this section may be used for upgrading both the Zabbix agent and the Zabbix agent 2.
ca	#### Procés d'actualització de l'agent  ::: noteimportant L'actualització dels agents no és pas obligatòria. Només els hauríeu d'actualitzar si cal per accedir a la nova funcionalitat. :::  El procediment d'actualització descrit en aquesta secció es pot emprar per actualitzar tant l'agent Zabbix com l'agent Zabbix 2.

en-us	 ##### agent.variant {#agent.variant}  <br> The variant of Zabbix agent (Zabbix agent or Zabbix agent 2).<br> Return value: 1 - Zabbix agent; 2 - Zabbix agent 2.<br> See [supported platforms](#supported-platforms).
ca	 ##### agent.variant {#agent.variant}  <br> Variant de l'agent Zabbix (agent Zabbix o agent Zabbix 2).<br> Valor de retorn: 1 - agent Zabbix; 2 - Agent Zabbix 2.<br> Veieu [plataformes compatibles](#supported-platforms).

en-us	 ##### agent.version {#agent.version}  <br> The version of Zabbix agent.<br> Return value: *String*.<br> See [supported platforms](#supported-platforms).  Example of returned value:       6.0.3
ca	 ##### agent.version {#agent.version}  <br> Versió de l'agent Zabbix.<br> Valor de retorn: *String*.<br> Veieu [plataformes compatibles](#supported-platforms).  Exemple de valor retornat:      6.0.3

en-us	##### Agent  Zabbix agents are deployed on monitoring targets to actively monitor local resources and applications and report the gathered data to Zabbix server. Since Zabbix 4.4, there are two types of agents available: the [Zabbix agent](/manual/concepts/agent) (lightweight, supported on many platforms, written in C) and the [Zabbix agent 2](/manual/concepts/agent2) (extra-flexible, easily extendable with plugins, written in Go).
ca	##### Agent  Els Agents Zabbix es despleguen en objectius de monitoratge per monitorar activament els recursos i aplicacions locals i enviar les dades recollides al servidor Zabbix. Des de Zabbix 4.4, hi ha dos tipus d'agents disponibles: [Zabbix Agent](/manual/concepts/agent) (lleuger, compatible amb moltes plataformes, escrit en C) i [Zabbix Agent 2](/manual/concepts/agent2) (extra-flexible, fàcilment ampliable amb complements, escrit en Go).

en-us	#### Aggregate calculations  Several aggregate functions have been updated. Now:  -   Aggregate functions now also support non-numeric types for calculation. This may be useful, for example, with the [count](/manual/appendix/functions/aggregate#count) and [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters) functions. -   The [count](/manual/appendix/functions/aggregate#count) and [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters) aggregate functions support optional parameters *operator* and *pattern*, which can be used to fine-tune item filtering and only count values that match given criteria. -   All [foreach functions](/appendix/functions/aggregate/foreach) no longer include unsupported items in the count. -   The function **[last_foreach](/appendix/functions/aggregate/foreach#time-period)**, previously configured to ignore the time period argument, accepts it as an optional parameter.
ca	#### Càlculs agregats  S'han actualitzat diverses funcions agregades. Ara:  - Les funcions agregades ara també admeten tipus no numèrics per al càlcul. Això pot ser útil, per exemple, amb les funcions [recompte](/manual/appendix/functions/aggregate#count) i [recompte per cada](/manual/appendix/functions/aggregate/foreach#additional-parameters). - Les funcions agregades [recompte](/manual/appendix/functions/aggregate#count) i [count_foreach](/manual/appendix/functions/aggregate/foreach#additional-parameters) admeten paràmetres opcionals *operador* i *patró*, que es pot utilitzar per ajustar el filtratge d'elements i només comptar els valors que coincideixen amb uns criteris determinats. - Totes les [funcions foreach](/appendix/functions/aggregate/foreach) ja no inclouen elements no admesos al recompte. - La funció **[last_foreach](/appendix/functions/aggregate/foreach#time-period)**, prèviament configurada per ignorar l'argument del període de temps, l'accepta com a paràmetre opcional.

en-us	 #### AGPL-3.0 license  Zabbix software is now is written and distributed under the AGPL-3.0 license (previously GPL v2.0 license).
ca	 #### Llicència AGPL-3.0  El programari Zabbix ara és escrit i distribuït sota la llicència AGPL-3.0 (anteriorment sota llicència GPL v2.0).

en-us	#### AIX  See values supported for 'memtype' parameter on AIX in the table.  |Supported value|Description|Source in procentry64 structure|Tries to be compatible with| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Virtual memory size|pi\_size| | |pmem|Percentage of real memory|pi\_prm|ps -o pmem| |rss|Resident set size|pi\_trss + pi\_drss|ps -o rssize| |size|Size of process (code + data)|pi\_dvm|"ps gvw" SIZE column| |dsize|Data size|pi\_dsize|<| |tsize|Text (code) size|pi\_tsize|"ps gvw" TSIZ column| |sdsize|Data size from shared library|pi\_sdsize|<| |drss|Data resident set size|pi\_drss| | |trss|Text resident set size|pi\_trss| |
ca	#### AIX  En aquesta taula hi trobareu els valors admesos per el paràmetre 'memtype' sota AIX.  |Valor admès|Descripció|Font a l'estructura procentry64|Intents per ésser compatible| |--|------|--|--| |vsize ^[1](proc_mem_notes#footnotes)^|Mida de la memòria virtual|pi\_size| | |pmem|Percentatge de memòria real|pi\_prm|ps -o pmem| |rss|Mida del conjunt de residents|pi\_trss + pi\_drss|ps -o rssize| |size|Mida dels processos (codi + dades)|pi\_dvm|"ps gvw" SIZE column| |dsize|Mida de dades|pi\_dsize|<| |tsize|Mida del text (codi)|pi\_tsize|"ps gvw" Colonne TSIZ| |sdsize|Mida de les dades de la biblioteca compartida|pi\_sdsize|<| |drss|Mida del conjunt de residents de dades|pi\_drss| | |trss|Mida del conjunt de residents de text|pi\_trss| |

en-us	#### Alert customization
ca	#### Personalització d'alertes

en-us	#### Alerter process crash in RHEL 7  Instances of a Zabbix server alerter process crash have been encountered in RHEL 7. Please see [ZBX-10461](https://support.zabbix.com/browse/ZBX-10461) for details.
ca	#### Fallida del procés Alerter amb RHEL 7  S'han trobat bloquejos de les instàncies del procés d'alerta del servidor Zabbix a RHEL 7. Consulteu [ZBX-10461](https://support.zabbix.com/browse/ZBX-10461) per obtindre més informació.

en-us	# alert.get
ca	# alert.get

en-us	### Alert  ::: noteclassic Alerts are created by Zabbix server and cannot be modified via the API. :::  The alert object contains information about whether certain action operations have been executed successfully. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |alertid|ID|ID of the alert.| |actionid|ID|ID of the action that generated the alert.| |alerttype|integer|Alert type.<br><br>Possible values:<br>0 - message;<br>1 - remote command.| |clock|timestamp|Time when the alert was generated.| |error|string|Error text if there are problems sending a message or running a command.| |esc\_step|integer|Action escalation step during which the alert was generated.| |eventid|ID|ID of the event that triggered the action.| |mediatypeid|ID|ID of the media type that was used to send the message.| |message|text|Message text.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `alerttype` is set to "message"| |retries|integer|Number of times Zabbix tried to send the message.| |sendto|string|Address, user name or other identifier of the recipient.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `alerttype` is set to "message"| |status|integer|Status indicating whether the action operation has been executed successfully.<br><br>Possible values if `alerttype` is set to "message":<br>0 - message not sent;<br>1 - message sent;<br>2 - failed after a number of retries;<br>3 - new alert is not yet processed by alert manager.<br><br>Possible values if `alerttype` is set to "remote command":<br>0 - command not run;<br>1 - command run;<br>2 - tried to run the command on Zabbix agent, but it was unavailable.| |subject|string|Message subject.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if `alerttype` is set to "message"| |userid|ID|ID of the user that the message was sent to.| |p\_eventid|ID|ID of problem event, which generated the alert.| |acknowledgeid|ID|ID of acknowledgment, which generated the alert.|
ca	### Alerta  ::: noteclassic Les alertes es creen pel servidor de Zabbix i no es poden modificar per mitjà de l'API. :::  L'objecte alerta conté informació sobre en quines condicions certes accions s'han executat correctament. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |alertid|ID|ID de l'alerta.| |actionid|ID|ID de l'acció que ja generat l'alerta.| |alerttype|integer|Tipus d'alerta.<br><br>Valors possibles:<br>0 - missatge;<br>1 - comanda remota.| |clock|timestamp|Moment en que es va generar l'alerta.| |error|string|text d'error si hi ha problemes enviant un missatge o executant una comanda.| |esc\_step|integer|Passa d'escalada de l'acció on es va generar l'alerta.| |eventid|string|ID de l'esdeveniment que ha disparat el trigger de l'acció.| |mediatypeid|string|ID del tipus de mitjà que s'ha emprat per enviar el missatge.| |message|text|Missatge de text.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `alerttype` s'estableix a "missatge"| |retries|integer|Nombre de vegades que el Zabbix ha provat d'enviar el missatge.| |sendto|string|Adreça, nom d'usuari o algun altre identificador del destinatari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `alerttype` s'estableix a "missatge"| |status|integer|Estat que indica si l'operació d'acció s'ha executat correctament..<br><br>Els valors possibles dels missatges d'alerta són:<br>0 - missatge no enviat.<br>1 - missatge enviat.<br>2 - ha fallat després de provar-ho diversos cops.<br>3 - la nova alerta encara no ha estat processada pel gestor d'alertes.<br><br>Valors possibles per les comandes d'alertes:<br>0 - comanda no executada.<br>1 - comanda executada.<br>2 - s'ha provat d'executar la comanda a l'agent de Zabbix, però aquest no era pas disponible.| |subject|string|Assumpte del missatge. <br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si `alerttype` s'estableix a "missatge"| |userid|string|ID de l'usuari on s'ha enviat el missatge.| |p\_eventid|string|ID de l'esdeveniment del problema, qui ha generat l'alerta.| |acknowledgeid|string|ID de reconeixement, qui ha generat l'alerta.|

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

en-us	##### Alert scripts  An [alert script](/manual/config/notifications/media/script) is a Zabbix [media type](/manual/config/notifications/media) that provides an option to create an alternative way (script) to handle Zabbix alerts. Alert scripts are useful if you are not satisfied with the existing media types for sending alerts in Zabbix.
ca	##### Scripts d'alerta  Un [script d'alertes](/manual/config/notifications/media/script) és un [tipus de suport] de Zabbix (/manual/config/notifications/media) que ofereix una opció per crear una manera alternativa (script) de gestionar les alertes de Zabbix. Els scripts d'alertes són útils si no us satisfan els tipus de suport existents per enviar alertes a Zabbix.

en-us	##### AlertScriptsPath The location of custom alert scripts (depends on the *datadir* compile-time installation variable).  Default: `/usr/local/share/zabbix/alertscripts`
ca	##### AlertScriptsPath  Ubicació dels scripts d'alerta personalitzats (depèn de la variable d'instal·lació en temps de compilació *datadir*).  Per defecte: `/usr/local/share/zabbix/alertscripts`

en-us	## Alerts  The Zabbix API allows you to manage the actions and alerts of your monitoring system.
ca	## Alertes  L'API de Zabbix us permet gestionar les accions i alertes del vostre sistema de monitoratge.

en-us	#### Alert  The `Alert` object represents a web page alert, is returned by [`Browser`](#browser) object `getAlert()` method, and cannot be constructed directly.  The `Alert` object contains the `text` property with the alert text (or `null` if there are no alerts).  The following methods are supported with the `Alert` object.  |Method|Description| |--|--------| |`accept()`|Accept the alert.| |`dismiss()`|Dismiss the alert.|
ca	#### Alerta  L'objecte `Alert` representa una alerta de pàgina web, és retornat pel mètode [`Navegador`](#browser) object `getAlert()` i no es pot construir directament.  L'objecte `Alert` conté la propietat `text` amb el text de l'alerta (o `null` si no hi ha alertes).  Els mètodes següents són compatibles amb l'objecte `Alert`.  |Mètode|Descripció| |--|---------| |`accept()`|Accepta l'alerta.| |`dismiss()`|Descarta l'alerta.|

en-us	# Alert  This class is designed to work with alerts.  Object references:  -   [Alert](/manual/api/reference/alert/object#alert)  Available methods:  -   [alert.get](/manual/api/reference/alert/get) - retrieve alerts
ca	# Alertes  Aquesta classe és dissenyada per treballar amb alertes.  Referències d'objecte:  -   [Alert](/manual/api/reference/alert/object#alert)  Mètodes disponibles:  -   [alert.get](/manual/api/reference/alert/get) - recuperar alertes

en-us	#### alert  [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `alert.get`: Added strict validation of the method parameters.\
ca	#### alerta  [ZBXNEXT-6974](https://support.zabbix.com/browse/ZBXNEXT-6974) `alert.get`: Afegida la validació estricta dels paràmetres dels mètodes.\

en-us	##### Alias  Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple *Alias* parameters may be present. Multiple parameters with the same *Alias* key are not allowed.<br> Different *Alias* keys may reference the same item key.<br> Aliases can be used in *HostMetadataItem* but not in *HostnameItem* or *PerfCounter* parameter.  Example 1: Retrieving the paging file usage in percentage from the server.      Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]      Now the shorthand key **pg_usage** may be used to retrieve data.  Example 2: Getting the CPU load with default and custom parameters.      Alias=cpu.load:system.cpu.load     Alias=cpu.load[*]:system.cpu.load[*]  This allows use **cpu.load** key to get the CPU load with default parameters as well as use **cpu.load[percpu,avg15]** to get specific data about the CPU load.  Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items.      Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Now it is possible to set up several discovery rules using **vfs.fs.discovery** with different parameters for each rule, e.g., **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.
ca	##### Àlies  Estableix un àlies per a una clau d'element. Es pot emprar per substituir una clau d'element llarg i complex per una de més curta i senzilla. És possible que hi hagi diversos paràmetres *Àlies* amb la mateixa clau *Àlies*.<br>Les claus *Àlies* diferents poden fer referència a la mateixa clau d'element.<br>Es poden emprar àlies a *HostMetadataItem* però no a *HostnameItem* o * Paràmetres PerfCounter*.  Exemple 1: recuperació de l'ús del fitxer de paginació en percentatge del servidor.       Alias=pg_usage:perf_counter[\Fitxer de paginació(_Total)\% ús]      Ara es pot emprar la clau abreujada **pg_usage** per recuperar dades.  Exemple 2: obtindre la càrrega de la CPU amb paràmetres predeterminats i personalitzats.       Alias=cpu.load:system.cpu.load      Alias=cpu.load[*]:system.cpu.load[*]  Això permet emprar la clau **cpu.load** per obtindre la càrrega de la CPU amb els paràmetres predeterminats, així com emprar **cpu.load[percpu,avg15]** per obtindre dades específiques sobre la càrrega de la CPU.  Exemple 3: execució de diverses regles [descoberta de baix nivell](/manual/discovery/low_level_discovery) que processen els mateixos elements de descoberta.       Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Ara és possible configurar diverses regles de descoberta emprant **vfs.fs.discovery** amb diferents paràmetres per a cada regla, per exemple, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.

en-us	##### Alias  Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple *Alias* parameters may be present. Multiple parameters with the same *Alias* key are not allowed.<br> Different *Alias* keys may reference the same item key.<br> Aliases can be used in *HostMetadataItem* but not in *HostnameItem* parameter.  Example 1: Retrieving the ID of user 'zabbix'.      Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]      Now the **zabbix.userid** shorthand key may be used to retrieve data.  Example 2: Getting CPU utilization with default and custom parameters.      Alias=cpu.util:system.cpu.util     Alias=cpu.util[*]:system.cpu.util[*]  This allows use the **cpu.util** key to get CPU utilization percentage with default parameters as well as use **cpu.util[all, idle, avg15]** to get specific data about CPU utilization.  Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items.      Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Now it is possible to set up several discovery rules using **vfs.fs.discovery** with different parameters for each rule, e.g., **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.
ca	##### Àlies  Estableix un àlies per a una clau d'element. Es pot emprar per substituir una clau d'element llarga i complexa per una de més curta i senzilla. És possible que hi hagi diversos paràmetres *Àlies* amb la mateixa clau *Àlies*.<br>És possible que diferents claus *Àlies* facin referència a la mateixa clau d'element.<br>Es poden emprar àlies a *HostMetadataItem* però no als paràmetres *HostnameItem*.  Exemple 1: recuperant l'ID de l'usuari "zabbix".       Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]      Ara es pot emprar la clau d'abreujatura **zabbix.userid** per recuperar dades.  Exemple 2: obtenció de la utilització de la CPU amb paràmetres predeterminats i personalitzats.       Alias=cpu.util:system.cpu.util      Alias=cpu.util[*]:system.cpu.util[*]  Això permet emprar la clau **cpu.util** per obtindre el percentatge d'ús de la CPU amb els paràmetres predeterminats, així com emprar **cpu.util[all, idle, avg15]** per obtindre dades específiques sobre la utilització de la CPU.  Exemple 3: execució de diverses regles [descoberta de baix nivell](/manual/discovery/low_level_discovery) que processen els mateixos elements de descoberta.       Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Ara és possible configurar diverses regles de descoberta emprant **vfs.fs.discovery** amb diferents paràmetres per a cada regla, per exemple, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.

en-us	##### Alias  Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple *Alias* parameters may be present. Multiple parameters with the same *Alias* key are not allowed.<br> Different *Alias* keys may reference the same item key.<br> Aliases can be used in *HostMetadataItem* but not in *HostnameItem* parameter.  Example 1: Retrieving the ID of user 'zabbix'.      Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]      Now the **zabbix.userid** shorthand key may be used to retrieve data.  Example 2: Getting CPU utilization with default and custom parameters.      Alias=cpu.util:system.cpu.util     Alias=cpu.util[*]:system.cpu.util[*]  This allows use the **cpu.util** key to get CPU utilization percentage with default parameters as well as use **cpu.util[all, idle, avg15]** to get specific data about CPU utilization.  Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items.      Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Now it is possible to set up several discovery rules using **vfs.fs.discovery** with different parameters for each rule, e.g., **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.
ca	##### Àlies  Estableix un àlies per a una clau d'element. Es pot emprar per substituir una clau d'element llarga i complexa per una de més curta i senzilla. És possible que hi hagi diversos paràmetres *Àlies* amb la mateixa clau *Àlies*.<br>És possible que diferents claus *Àlies* facin referència a la mateixa clau d'element.<br>Es poden emprar àlies a *HostMetadataItem* però no als paràmetres *HostnameItem*.  Exemple 1: recuperar l'ID de l'usuari "zabbix".       Alias=zabbix.userid:vfs.file.regexp[/etc/passwd,"^zabbix:.:([0-9]+)",,,,\1]      Ara es pot emprar la clau abreujada **zabbix.userid** per recuperar dades.  Exemple 2: obtenció de la utilització de la CPU amb paràmetres predeterminats i personalitzats.       Alias=cpu.util:system.cpu.util      Alias=cpu.util[*]:system.cpu.util[*]  Això permet emprar la clau **cpu.util** per obtindre el percentatge d'ús de la CPU amb els paràmetres predeterminats, així com emprar **cpu.util[all, idle, avg15]** per obtindre dades específiques sobre l'ús de la CPU.  Exemple 3: execució de diverses regles [descoberta de baix nivell](/manual/discovery/low_level_discovery) que processen els mateixos elements de descoberta.       Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Ara és possible configurar diverses regles de descoberta emprant **vfs.fs.discovery** amb diferents paràmetres per a cada regla, per exemple, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.

en-us	##### Alias  Sets an alias for an item key. It can be used to substitute a long and complex item key with a shorter and simpler one.<br> Multiple *Alias* parameters may be present. Multiple parameters with the same *Alias* key are not allowed.<br> Different *Alias* keys may reference the same item key.<br> Aliases can be used in *HostMetadataItem* but not in the *HostnameItem* parameter.  Example 1: Retrieving the paging file usage in percentage from the server.      Alias=pg_usage:perf_counter[\Paging File(_Total)\% Usage]      Now the shorthand key **pg_usage** may be used to retrieve data.  Example 2: Getting the CPU load with default and custom parameters.      Alias=cpu.load:system.cpu.load     Alias=cpu.load[*]:system.cpu.load[*]  This allows use **cpu.load** key to get the CPU load with default parameters as well as use **cpu.load[percpu,avg15]** to get specific data about the CPU load.  Example 3: Running multiple [low-level discovery](/manual/discovery/low_level_discovery) rules processing the same discovery items.      Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Now it is possible to set up several discovery rules using **vfs.fs.discovery** with different parameters for each rule, e.g., **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.
ca	##### Àlies  Estableix un àlies per a una clau d'element. Es pot emprar per substituir una clau d'element llarga i complexa per una de més curta i senzilla. És possible que hi hagi diversos paràmetres *Àlies* amb la mateixa clau *Àlies*.<br>Les claus *Àlies* diferents poden fer referència a la mateixa clau d'element.<br> Es poden emprar àlies a *HostMetadataItem* però no al paràmetre *HostnameItem*.  Exemple 1: recuperació de l'ús del fitxer de paginació en percentatge del servidor.   Alias=pg_usage:perf_counter[\Paging File(_Total)\%Usage]      Ara es pot emprar la clau d'abreujatura **pg_usage** per recuperar dades.  Exemple 2: obtindre la càrrega de la CPU amb paràmetres predeterminats i personalitzats.       Alias=cpu.load:system.cpu.load      Alias=cpu.load[*]:system.cpu.load[*]  Això permet emprar la clau **cpu.load** per obtindre la càrrega de la CPU amb els paràmetres predeterminats, així com emprar **cpu.load[percpu,avg15]** per obtindre dades específiques sobre la càrrega de la CPU.  Exemple 3: execució de diverses regles de [descoberta de baix nivell](/manual/discovery/low_level_discovery) que processen els mateixos elements de descoberta.       Alias=vfs.fs.discovery[*]:vfs.fs.discovery  Ara és possible configurar diverses regles de descoberta emprant **vfs.fs.discovery** amb diferents paràmetres per a cada regla, per exemple, **vfs.fs.discovery[foo]**, **vfs.fs.discovery[bar]**, etc.

en-us	##### Aligning time zones for proxies and agent  Note that Zabbix proxies and agent use their local time zones when processing scheduling intervals.  For this reason, when scheduling intervals are applied to items monitored by Zabbix proxy or agent active items, it is recommended to set the time zone of the respective proxies or agent the same as Zabbix server, otherwise the [queue](/manual/config/items/queue) may report item delays incorrectly.  The time zone for Zabbix proxy or agent can be set using the environment variable `TZ` in the `systemd` unit file:      [Service]     ...     Environment="TZ=Europe/Amsterdam"
ca	##### Alineació de zones horàries per als proxys i l'agent  Tingueu en compte que els proxys de Zabbix i l'agent empren les seves zones horàries locals quan processen els intervals de programació.  Per aquest motiu, quan s'apliquen intervals de programació als elements monitorats pel proxy de Zabbix o els elements actius de l'agent, es recomana establir la zona horària dels proxys respectius o l'agent igual que el servidor Zabbix, en cas contrari, la [cua](/manual/config/items/queue) pot informar erròniament d'endarreriments.  La zona horària per al proxy Zabbix o l'agent es pot establir mitjançant la variable d'entorn `TZ` al fitxer `systemd`:      [Service]     ...     Environment="TZ=Europe/Amsterdam"

en-us	 All of these parameters can be changed in *Administration* → [*Housekeeping*](/manual/web_interface/frontend_sections/administration/housekeeping) after the installation.  ::: notetip You may want to run the timescaledb-tune tool provided by TimescaleDB to optimize PostgreSQL configuration parameters in your `postgresql.conf`. :::
ca	Tots aquests paràmetres es poden modificar des d'*Administració* → [*Neteja*](/manual/web_interface/frontend_sections/administration/housekeeping) després de la instal·lació.  ::: notetip Podeu executar la utilitat timescaledb-tune, proveïda per TimescaleDB, per optimitzar els paràmetres de configuració de PostgreSQL a l'arxiu `postgresql.conf`. :::

en-us	##### AllowedIP A list of comma delimited IP addresses, optionally in CIDR notation, or DNS names of Zabbix servers and Zabbix proxies. Incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then `127.0.0.1`, `::127.0.0.1`, `::ffff:127.0.0.1` are treated equally and `::/0` will allow any IPv4 or IPv6 address. `0.0.0.0/0` can be used to allow any IPv4 address.  Example:       127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.example.com  Mandatory: yes
ca	##### AllowedIP  Un llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms DNS de servidors i proxys Zabbix. Només s'acceptaran connexions entrants dels equips especificats.<br>Si el suport IPv6 és habilitat, `127.0.0.1`, `::127.0.0.1`, `::ffff:127.0.0.1` es tracten de la mateixa manera i `::/0` permetrà qualsevol adreça IPv4 o IPv6. `0.0.0.0/0` es pot emprar per permetre qualsevol adreça IPv4.  Exemple:       127.0.0.1,192.168.1.0/24,::1,2001:db8::/32,zabbix.exemple.cat  Obligatori: sí

en-us	##### AllowKey  Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with DenyKey. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks).
ca	##### AllowKey  Permet l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió comodí que admet el caràcter "\*" perquè coincideixi amb qualsevol nombre de caràcters.<br>Es poden definir diverses regles de concordança de claus en combinació amb DenyKey. Els paràmetres es processen un per un segons el seu ordre d'aparició. Veieu també: [Restricció de comprovacions d'agents](/manual/config/items/restrict_checks).

en-us	##### AllowKey  Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with DenyKey. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks).
ca	##### AllowKey  Permet l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió comodí que admet el caràcter "\*" perquè coincideixi amb qualsevol nombre de caràcters.<br>Es poden definir diverses regles de concordança de claus en combinació amb DenyKey. Els paràmetres es processen un per un segons el seu ordre d'aparició. Veieu també: [Restricció de comprovacions d'agents](/manual/config/items/restrict_checks).

en-us	##### AllowKey  Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with DenyKey. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks).
ca	##### AllowKey  Permet l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió comodí que admet el caràcter "\*" perquè coincideixi amb qualsevol nombre de caràcters.<br>Es poden definir diverses regles de concordança de claus en combinació amb DenyKey. Els paràmetres es processen un per un segons el seu ordre d'aparició. Veieu també: [Restricció de comprovacions d'agents](/manual/config/items/restrict_checks).

en-us	##### AllowKey  Allow the execution of those item keys that match a pattern. The key pattern is a wildcard expression that supports the "\*" character to match any number of any characters.<br>Multiple key matching rules may be defined in combination with DenyKey. The parameters are processed one by one according to their appearance order. See also: [Restricting agent checks](/manual/config/items/restrict_checks).
ca	##### AllowKey  Permet l'execució d'aquelles claus d'element que coincideixen amb un patró. El patró de clau és una expressió comodí que admet el caràcter "\*" perquè coincideixi amb qualsevol nombre de caràcters.<br>Es poden definir diverses regles de concordança de claus en combinació amb DenyKey. Els paràmetres es processen un per un segons el seu ordre d'aparició. Veieu també: [Restricció de comprovacions d'agents](/manual/config/items/restrict_checks).

en-us	##### AllowRoot  Allow the agent to run as 'root'. If disabled and the agent is started by 'root', the agent will try to switch to user 'zabbix' instead. Has no effect if started under a regular user.  Default: `0`<br> Values: 0 - do not allow; 1 - allow
ca	##### AllowRoot  Permet que l'agent s'executi com a 'root'. Si és desactivat i l'agent s'inicia per 'root', l'agent intentarà canviar a l'usuari 'zabbix'. No té cap efecte si s'inicia amb un usuari habitual.  Per defecte: `0`<br> Valors: 0 - no permetre; 1 - permetre

en-us	##### AllowRoot  Allow the proxy to run as 'root'. If disabled and the proxy is started by 'root', the proxy will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user.  Default: `0`<br> Values: 0 - do not allow; 1 - allow
ca	##### AllowRoot  Permet que el proxy s'executi com a 'root'. Si és desactivat i el proxy s'inicia per 'root', el proxy intentarà canviar a l'usuari 'zabbix'. No té cap efecte si s'inicia amb un usuari habitual.  Per defecte: `0`<br> Valors: 0 - no permetre; 1 - permetre

en-us	##### AllowRoot Allow the server to run as 'root'. If disabled and the server is started by 'root', the server will try to switch to the 'zabbix' user instead. Has no effect if started under a regular user.  Default: `0`<br> Values: 0 - do not allow; 1 - allow
ca	##### AllowRoot  Permet que el servidor s'executi com a 'root'. Si és desactivat i el servidor s'inicia per 'root', el servidor intentarà canviar a l'usuari 'zabbix'. No té cap efecte si s'inicia amb un usuari habitual.  Per defecte: `0`<br> Valors: 0 - no permetre; 1 - permetre

en-us	##### AllowSoftwareUpdateCheck Allow Zabbix UI to receive information about software updates from zabbix.com.  Default: `1`<br> Values: 0 - do not allow; 1 - allow
ca	##### AllowSoftwareUpdateCheck Permet que la interfície d'usuari de Zabbix rebi informació sobre les actualitzacions de programari de zabbix.com.  Per defecte: `1`<br> Valors: 0 - no permetre-ho; 1 - permetre

en-us	##### Allow specific check, deny others  -   Whitelist specific checks with AllowKey parameters, deny others with     `DenyKey=*`  For example:      # Allow reading logs:     AllowKey=vfs.file.*[/var/log/*]      # Allow localtime checks     AllowKey=system.localtime[*]      # Deny all other keys     DenyKey=*
ca	##### Permetre una verificació concreta, i refusar totes les altres  - Afegir a la llista blanca de comprovacions específiques amb paràmetres AllowKey, denegar altres amb `DenyKey=*`  Per exemple:       # Permetre llegir registres:      AllowKey=vfs.file.*[/var/log/*]       # Permetre comprovacions de l'hora local      AllowKey=system.localtime[*]        # Denegar totes les altres claus       DenyKey=*

en-us	##### AllowUnsupportedDBVersions  Allow the proxy to work with unsupported database versions.  Default: `0`<br> Values: 0 - do not allow; 1 - allow
ca	##### AllowUnsupportedDBVersions  Permet que el proxy funcioni amb versions de bases de dades no compatibles.  Per defecte: `0`<br> Valors: 0 - no permetre; 1 - permetre

en-us	##### AllowUnsupportedDBVersions Allow the server to work with unsupported database versions.  Default: `0`<br> Values: 0 - do not allow; 1 - allow
ca	##### AllowUnsupportedDBVersions  Permet que el servidor funcioni amb versions de bases de dades no compatibles.  Per defecte: `0`<br> Valors: 0 - no permetre; 1 - permetre

en-us	##### Altering primary key with downtime  1\. Drop the current `auditlog` table primary key and add the new primary key.  ```sql ALTER TABLE auditlog DROP CONSTRAINT auditlog_pkey; ALTER TABLE auditlog ADD PRIMARY KEY (auditid,clock); ```  2\. Rebuild indexes (optional but highly recommended, see [Important notes on rebuilding indexes](#important-notes-on-rebuilding-indexes-1)).  ```sql REINDEX TABLE CONCURRENTLY auditlog; ```
ca	##### Alteració de la clau primària amb temps d'inactivitat  1\. Deixeu anar la clau primària de la taula `auditlog` actual i afegiu la nova clau primària.  ```sql ALTER TABLE auditlog DROP CONSTRAINT auditlog_pkey; ALTER TABLE auditlog ADD PRIMARY KEY (auditid,clock); ```  2\. Reconstruïu índexs (opcional però molt recomanable, vegeu [Notes importants sobre la reconstrucció d'índexs](#important-notes-on-rebuilding-indexes-1)).  ```sql REINDEX TABLE CONCURRENTLY auditlog; ```

en-us	##### Altering primary key with downtime  1\. Drop the current `auditlog` table primary key and add the new primary key.  ```sql ALTER TABLE auditlog DROP PRIMARY KEY, ADD PRIMARY KEY (auditid, clock); ```  2\. Rebuild indexes (optional but highly recommended, see [Important notes on rebuilding indexes](#important-notes-on-rebuilding-indexes)).  ```sql OPTIMIZE TABLE auditlog; ```
ca	##### Alteració de la clau primària amb temps d'inactivitat  1\. Deixeu anar la clau primària de la taula `auditlog` actual i afegiu la nova clau primària.  ```sql ALTER TABLE auditlog DROP PRIMARY KEY, ADD PRIMARY KEY (auditid, clock); ```  2\. Reconstruïu índexs (opcional però molt recomanable, vegeu [Notes importants sobre la reconstrucció d'índexs](#important-notes-on-rebuilding-indexes)).  ```sql OPTIMIZE TABLE auditlog; ```

en-us	##### Altering primary key with downtime  1\. Retrieve the constraint name.  ```sql SELECT CONSTRAINT_NAME FROM all_constraints WHERE TABLE_NAME = 'AUDITLOG' AND CONSTRAINT_TYPE = 'P'; ```  2\. Drop the current `auditlog` table primary key and add the new primary key.  ```sql ALTER TABLE auditlog DROP CONSTRAINT <constraint_name>; ALTER TABLE auditlog ADD CONSTRAINT auditlog_pk PRIMARY KEY (auditid, clock); ```  3\. Rebuild indexes (optional but highly recommended, see [Important notes on rebuilding indexes](#important-notes-on-rebuilding-indexes-2)).  3.1\. Get index names.  ```sql SELECT index_name FROM user_indexes WHERE table_name='AUDITLOG'; ```  3.2\. Rebuild each index.  ```sql ALTER INDEX auditlog_pk REBUILD PARALLEL; ALTER INDEX auditlog_1 REBUILD PARALLEL; ALTER INDEX auditlog_2 REBUILD PARALLEL; ALTER INDEX auditlog_3 REBUILD PARALLEL; ```
ca	##### Alteració de la clau primària amb temps d'inactivitat  1\. Recuperar el nom de la restricció.  ```sql SELECT CONSTRAINT_NAME FROM all_constraints WHERE TABLE_NAME = 'AUDITLOG' AND CONSTRAINT_TYPE = 'P'; ```  2\. Ignorar anar la clau primària de la taula `auditlog` actual i afegiu la nova clau primària.  ```sql ALTER TABLE auditlog DROP CONSTRAINT <constraint_name>; ALTER TABLE auditlog ADD CONSTRAINT auditlog_pk PRIMARY KEY (auditid, clock); ```  3\. Reconstruïr índexs (opcional però molt recomanable, veieu [Notes importants sobre la reconstrucció d'índexs](#important-notes-on-rebuilding-indexes-2)).  3.1\. Recuperar noms d'índex.  ```sql SELECT index_name FROM user_indexes WHERE table_name='AUDITLOG'; ```  3.2\. Reconstruir cada índex.  ```sql ALTER INDEX auditlog_pk REBUILD PARALLEL; ALTER INDEX auditlog_1 REBUILD PARALLEL; ALTER INDEX auditlog_2 REBUILD PARALLEL; ALTER INDEX auditlog_3 REBUILD PARALLEL; ```

en-us	##### Altering primary key without downtime  1\. Create a new table with the new primary key and create indexes.  ```sql CREATE TABLE auditlog_new (   auditid              nvarchar2(25)                             ,   userid               number(20)                                NULL,   username             nvarchar2(100)  DEFAULT ''                ,   clock                number(10)      DEFAULT '0'               NOT NULL,   ip                   nvarchar2(39)   DEFAULT ''                ,   action               number(10)      DEFAULT '0'               NOT NULL,   resourcetype         number(10)      DEFAULT '0'               NOT NULL,   resourceid           number(20)                                NULL,   resource_cuid        nvarchar2(25)                             ,   resourcename         nvarchar2(255)  DEFAULT ''                ,   recordsetid          nvarchar2(25)                             ,   details              nclob           DEFAULT ''                ,   PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ```  2\. Swap tables.  ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ```  3\. Copy data from the old table to the new table.  ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ```  This can be done in chunks (multiple `INSERT INTO` statements with `WHERE clock` clauses as needed) to avoid excessive resource usage.  4\. Drop the old table.  ```sql DROP TABLE auditlog_old; ```
ca	##### Alteració de la clau primària sense temps d'inactivitat  1\. Creeu una taula nova amb la nova clau primària i creeu els índexs.  ```sql CREATE TABLE auditlog_new (   auditid              nvarchar2(25)                             ,   userid               number(20)                                NULL,   username             nvarchar2(100)  DEFAULT ''                ,   clock                number(10)      DEFAULT '0'               NOT NULL,   ip                   nvarchar2(39)   DEFAULT ''                ,   action               number(10)      DEFAULT '0'               NOT NULL,   resourcetype         number(10)      DEFAULT '0'               NOT NULL,   resourceid           number(20)                                NULL,   resource_cuid        nvarchar2(25)                             ,   resourcename         nvarchar2(255)  DEFAULT ''                ,   recordsetid          nvarchar2(25)                             ,   details              nclob           DEFAULT ''                ,   PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ```  2\. Intercanvieu de taules.  ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ```  3\. Copieu les dades de la taula antiga a la taula nova.  ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ```  Això es pot fer en fragments (múltiples sentències `INSERT INTO` amb clàusules `WHERE clock` segons sigui necessari) per evitar un ús excessiu de recursos.  4\. Dropeu caure la taula antiga.  ```sql DROP TABLE auditlog_old; ```

en-us	##### Altering primary key without downtime  Manual method of altering the primary key is described here. Alternatively, the `pg_repack` extension can be considered for creating a new table, copying data, and swapping tables.  1\. Create a new table with the new primary key and create indexes.  ```sql CREATE TABLE auditlog_new (   auditid              varchar(25)                               NOT NULL,   userid               bigint                                    NULL,   username             varchar(100)    DEFAULT ''                NOT NULL,   clock                integer         DEFAULT '0'               NOT NULL,   ip                   varchar(39)     DEFAULT ''                NOT NULL,   action               integer         DEFAULT '0'               NOT NULL,   resourcetype         integer         DEFAULT '0'               NOT NULL,   resourceid           bigint                                    NULL,   resource_cuid        varchar(25)                               NULL,   resourcename         varchar(255)    DEFAULT ''                NOT NULL,   recordsetid          varchar(25)                               NOT NULL,   details              text            DEFAULT ''                NOT NULL,   PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ```  2\. Swap tables.  ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ```  3\. Copy data from the old table to the new table.  ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ```  This can be done in chunks (multiple `INSERT INTO` statements with `WHERE clock` clauses as needed) to avoid excessive resource usage.  4\. Drop the old table.  ```sql DROP TABLE auditlog_old; ```
ca	##### Alteració de la clau primària sense temps d'inactivitat  Aquí es descriu el mètode manual per alterar la clau primària. Alternativament, l'extensió `pg_repack` es pot considerar per crear una taula nova, copiar dades i intercanviar taules.  1\. Creeu una taula nova amb la nova clau primària i creeu índexs.  ```sql CREATE TABLE auditlog_new (   auditid              varchar(25)                               NOT NULL,   userid               bigint                                    NULL,   username             varchar(100)    DEFAULT ''                NOT NULL,   clock                integer         DEFAULT '0'               NOT NULL,   ip                   varchar(39)     DEFAULT ''                NOT NULL,   action               integer         DEFAULT '0'               NOT NULL,   resourcetype         integer         DEFAULT '0'               NOT NULL,   resourceid           bigint                                    NULL,   resource_cuid        varchar(25)                               NULL,   resourcename         varchar(255)    DEFAULT ''                NOT NULL,   recordsetid          varchar(25)                               NOT NULL,   details              text            DEFAULT ''                NOT NULL,   PRIMARY KEY (auditid,clock) ); CREATE INDEX auditlog_new_1 ON auditlog_new (userid,clock); CREATE INDEX auditlog_new_2 ON auditlog_new (clock); CREATE INDEX auditlog_new_3 ON auditlog_new (resourcetype,resourceid); ```  2\. Intercanvieu les taules.  ```sql ALTER TABLE auditlog RENAME TO auditlog_old; ALTER TABLE auditlog_new RENAME TO auditlog; ```  3\. Copieu les dades de la taula antiga a la taula nova.  ```sql INSERT INTO auditlog SELECT * FROM auditlog_old; ```  Això es pot fer en fragments (múltiples sentències `INSERT INTO` amb clàusules `WHERE clock` segons sigui necessari) per evitar un ús excessiu de recursos.  4\. Dropeu caure la taula antiga.  ```sql DROP TABLE auditlog_old; ```