en-us	##### Global messages displayed  As messages arrive, they are displayed in a floating section on the right-hand side. You can freely reposition this section by dragging the section header.  ![global\_messages.png](../../../../assets/en/manual/web_interface/global_messages.png)  For this section, several controls are available:  -   ![](../../../../assets/en/manual/about/message_button_snooze.png) **Snooze** button silences the currently active alarm sound; -   ![](../../../../assets/en/manual/about/message_button_mute.png) **Mute/Unmute** button switches between playing and not playing the alarm sounds at all.
ca	##### Visualització de missatges globals  Quan arriben els missatges, es mostren en una secció flotant al costat dret. Podeu moure'ls lliurement arrossegant la seva capçalera.  ![global\_messages.png](../../../../assets/en/manual/web_interface/global_messages.png)  Per a aquesta secció, hi ha diversos controls disponibles:  - ![](../../../../assets/en/manual/about/message_button_snooze.png) el botó **Informar** silencia el so de l'alarma activa; - ![](../../../../assets/en/manual/about/message_button_mute.png) el botó **Silenciar/Desactivar** alterna entre reproduir i no reproduir els sons de l'alarma.

en-us	#### Global regular expressions  There is an advanced editor for creating and testing complex regular expressions in Zabbix frontend.  Once a regular expression has been created this way, it can be used in several places in the frontend by referring to its name, prefixed with @, for example, *\@mycustomregexp*.  To create a global regular expression:  -   Go to: *Administration → General* -   Select *Regular expressions* from the dropdown -   Click on *New regular expression*  The **Expressions** tab allows to set the regular expression name and add subexpressions.  ![](../../assets/en/manual/regular_expressions/global_regexp.png)  All mandatory input fields are marked with a red asterisk.  |Parameter|<|Description| |-|----------|----------------------------------------| |*Name*|<|Set the regular expression name. Any Unicode characters are allowed.| |*Expressions*|<|Click on *Add* in the Expressions block to add a new subexpression.| | |*Expression type*|Select expression type:<br>**Character string included** - match the substring<br>**Any character string included** - match any substring from a delimited list. The delimited list includes a comma (,), a dot (.) or a forward slash (/).<br>**Character string not included** - match any string except the substring<br>**Result is TRUE** - match the regular expression<br>**Result is FALSE** - do not match the regular expression| |^|*Expression*|Enter substring/regular expression.| |*Delimiter*|<|A comma (,), a dot (.) or a forward slash (/) to separate text strings in a regular expression. This parameter is active only when "*Any character string included*" expression type is selected.| |*Case sensitive*|<|A checkbox to specify whether a regular expression is sensitive to capitalization of letters.|  A forward slash (/) in the expression is treated literally, rather than a delimiter. This way it is possible to save expressions containing a slash, without errors.  ::: noteimportant A custom regular expression name in Zabbix may contain commas, spaces, etc. In those cases where that may lead to misinterpretation when referencing (for example, a comma in the parameter of an item key) the whole reference may be put in quotes like this: *"\@My custom regexp for purpose1, purpose2"*.\ Regular expression names must not be quoted in other locations (for example, in LLD rule properties). :::  In the **Test** tab the regular expression and its subexpressions can be tested by providing a test string.  ![](../../assets/en/manual/regular_expressions/global_regexp_b.png)  Results show the status of each subexpression and total custom expression status.  Total custom expression status is defined as *Combined result*. If several sub expressions are defined Zabbix uses AND logical operator to calculate *Combined result*. It means that if at least one Result is False *Combined result* has also False status.
ca	#### Expressions regulars globals  Hi ha un editor avançat per crear i provar expressions regulars complexes a la interfície Zabbix.  Un cop s'ha creat una expressió regular d'aquesta manera, es pot emprar a diversos llocs de la interfície fent referència al seu nom amb el prefix @, per exemple, *\@mycustomregexp*.  Per crear una expressió regular global:  - Aneu a: *Administració → General* - Seleccioneu *Expressions regulars* al menú desplegable - Feu clic a *Nova expressió regular*  La pestanya **Expressions** us permet definir el nom de l'expressió regular i afegir subexpressions.  ![](../../assets/en/manual/regular_expressions/global_regexp.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  |Paràmetre|<|Descripció| |-|-----------|-------------------------------------- ----| |*Nom*|<|Definiu el nom de l'expressió regular. Es permeten tots els caràcters Unicode.| |*Expressions*|<|Feu clic a *Afegir* al bloc Expressions per afegir una subexpressió nova.| | |*Tipus d'expressió*|Trieu el tipus d'expressió:<br>**Cadena inclosa** - coincideix amb la subcadena<br>**Qualsevol cadena inclosa** - coincideix amb totes les subcadenes d'una llista delimitada. La llista delimitada inclou una coma (,), un punt (.) o una barra inclinada (/).<br>**La cadena no s'inclou** - coincideix amb qualsevol cadena excepte la subcadena<br>**El resultat és CERT** - coincideix amb l'expressió regular <br>**El resultat és FALS** - no coincideix amb l'expressió regular| |^|*Expressió*|Introduïu una subcadena/expressió regular.| |*Delimitador*|<|Una coma (,), punt (.) o barra inclinada (/) per separar cadenes de text en una expressió regular. Aquest paràmetre només és actiu quan es tria el tipus d'expressió "*Qualsevol cadena de caràcters inclosa*".| |*Distingeix entre majúscules i minúscules*|<|Una casella de selecció per especificar si una expressió regular distingeix entre majúscules i minúscules.|  Una barra inclinada (/) a l'expressió es tracta literalment, en lloc d'un delimitador. D'aquesta manera és possible desar expressions que contenen una barra, sense errors.  ::: noteimportant Un nom d'expressió regular personalitzada a Zabbix pot contindre comes, espais, etc. En casos en què això pot provocar una interpretació errònia quan es fa referència (per exemple, una coma al paràmetre d'una clau d'element), la referència sencera es pot citar així: *"\@My regexp personalizada per a propòsit1, propòsit2"*.\ Els noms de les expressions regulars no s'han de citar en altres llocs (per exemple, a les propietats de les regles LLD). :::  A la pestanya **Provar**, l'expressió regular i les seves subexpressions es poden provar proporcionant una cadena de prova.  ![](../../assets/en/manual/regular_expressions/global_regexp_b.png)  Els resultats mostren l'estat de cada subexpressió i l'estat total de l'expressió personalitzada.  L'estat total de l'expressió personalitzada s'estableix a *Resultat combinat*. Si es defineixen diverses subexpressions, Zabbix empra l'operador I lògic per calcular el *resultat combinat*. Això vol dir que si almenys un resultat és Fals, el *Resultat combinat* també té l'estat Fals.

en-us	#### Global scripts  A [global script](/manual/web_interface/frontend_sections/alerts/scripts) is a user-defined set of commands that can be executed on a monitoring target (by shell (/bin/sh) interpreter), depending on the configured scope and user permissions. Global scripts can be configured for the following actions:  -   Action [operation](/manual/config/notifications/action/operation) -   [Manual host action](/manual/web_interface/menu/host_menu#overview) -   [Manual event action](/manual/web_interface/menu/event_menu#content)  Global scripts are useful in many cases. For example, if configured for action operations or manual host actions, you can use global scripts to automatically or manually execute [remote commands](/manual/config/notifications/action/operation/remote_command) such as restarting an application (web server, middleware, CRM, etc.) or freeing disk space (removing older files, cleaning `/tmp`, etc). Or, another example, if configured for manual event actions, you can use global scripts to manage problem tickets in external systems.  Global scripts can be executed by Zabbix server, proxy or agent.
ca	#### Scripts globals  Un [script global](/manual/web_interface/frontend_sections/alerts/scripts) és un conjunt d'ordres definit per l'usuari que es pot executar en un objectiu de monitoratge (per un intèrpret de shell (/bin/sh)), depenent de l'abast configurat i els permisos dels usuaris. Els scripts globals es poden configurar per a les accions següents:  - Acció [operació](/manual/config/notifications/action/operation) - [Acció manual de l'equip](/manual/web_interface/menu/host_menu#overview) - [Acció d'esdeveniment manual](/manual/web_interface/menu/event_menu#content)  Els scripts globals són útils en molts casos. Per exemple, si és configurat per a operacions d'acció o accions manuals d'equip, podeu emprar scripts globals per executar automàticament o manualment [ordres remotes](/manual/config/notifications/action/operation/remote_command), com ara reiniciar una aplicació (servidor web, middleware, CRM, etc.) o alliberar espai al disc (esborrar fitxers antics, netejar `/tmp`, etc.). O, un altre exemple, si és configurat per a accions d'esdeveniments manuals, podeu emprar scripts globals per gestionar les entrades de problemes en sistemes externs.  Els scripts globals es poden executar pel servidor, proxy o agent Zabbix.

en-us	 #### 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/jackc/pgx/v4](https://github.com/jackc/pgx)|^|4.17.2|PostgreSQL driver. | |[github.com/omeid/go-yarn](https://github.com/omeid/go-yarn)|^|0.0.1|Embeddable filesystem mapped key-string store. | |[github.com/jackc/chunkreader](https://github.com/jackc/chunkreader)|Indirect^**1**^|2.0.1| | |[github.com/jackc/pgconn](https://github.com/jackc/pgconn)|^|1.13.0| | |[github.com/jackc/pgio](https://github.com/jackc/pgio)|^|1.0.0| | |[github.com/jackc/pgpassfile](https://github.com/jackc/pgpassfile)|^|1.0.0| | |[github.com/jackc/pgproto3](https://github.com/jackc/pgproto3)|^|2.3.1| | |[github.com/jackc/pgservicefile](https://github.com/jackc/pgservicefile)|^|0.0.0| | |[github.com/jackc/pgtype](https://github.com/jackc/pgtype)|^|1.12.0| | |[github.com/jackc/puddle](https://github.com/jackc/puddle)|^|1.3.0| | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|^|0.6.0| Required package for PostgreSQL plugin on Windows.| |[golang.org/x/crypto](https://pkg.go.dev/golang.org/x/crypto)|^|0.0.0| | |[golang.org/x/sys](https://pkg.go.dev/golang.org/x/sys)|^|0.0.0| | |[golang.org/x/text](https://pkg.go.dev/golang.org/x/text)|^|0.3.7| |  ^**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.
ca	 #### Biblioteques de Go  |Requisit|Estat obligatori|Versió mínima|Descripció| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support/browse)| Sí|1.X.X|Biblioteca de suport pròpia de Zabbix. Principalment per a plugins. | |[github.com/jackc/pgx/v4](https://github.com/jackc/pgx)|^|4.17.2|Controlador PostgreSQL. | |[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/jackc/chunkreader](https://github.com/jackc/chunkreader)|Indirecte^**1**^|2.0.1| | ||[github.com/jackc/pgconn](https://github.com/jackc/pgconn)|^|1.13.0| | ||[github.com/jackc/pgio](https://github.com/jackc/pgio)|^|1.0.0| | |[github.com/jackc/pgpassfile](https://github.com/jackc/pgpassfile)|^|1.0.0| | ||[github.com/jackc/pgproto3](https://github.com/jackc/pgproto3)|^|2.3.1| | |[github.com/jackc/pgservicefile](https://github.com/jackc/pgservicefile)|^|0.0.0| | ||[github.com/jackc/pgtype](https://github.com/jackc/pgtype)|^|1.12.0| | ||[github.com/jackc/puddle](https://github.com/jackc/puddle)|^|1.3.0| | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|^|0.6.0| Paquet necessari per al connector PostgreSQL a Windows.|  |[golang.org/x/crypto](https://pkg.go.dev/x/crypto)|^|0.0.0| | |[golang.org/x/sys](https://pkg.go.dev/x/sys)|^|0.0.0| | |[golang.org/x/text](https://pkg.go.dev/x/text)|^|0.3.7| |  ^**1**^ "Indirecte" significa que s'empra en una de les biblioteques que utilitza l'agent. És necessari ja que Zabbix empra la biblioteca que utilitza el paquet.

en-us	 #### 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. | |[go.mongodb.org/mongo-driver](https://go.mongodb.org/mongo-driver)|^|1.7.6|Named read/write locks, access sync. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|Indirect^**1**^|1.8.0|Required package for MongoDB plugin mongo-driver lib. | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1|Required package for MongoDB plugin mongo-driver lib. | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6|Required package for MongoDB plugin mongo-driver lib. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|^|0.6.0|Required package for MongoDB plugin mongo-driver lib on Windows. | |[github.com/pkg/errors](https://github.com/pkg/errors)|^|0.9.1|Required package for MongoDB plugin mongo-driver lib. | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0|Required package for MongoDB plugin mongo-driver lib. | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2|Required package for MongoDB plugin mongo-driver lib. | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2|Required package for MongoDB plugin mongo-driver lib. | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/crypto](https://pkg.go.dev/golang.org/x/crypto)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/sync](https://pkg.go.dev/golang.org/x/sync)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/sys](https://pkg.go.dev/golang.org/x/sys)|^|0.0.0|Required package for MongoDB plugin mongo-driver lib. | |[golang.org/x/text](https://pkg.go.dev/golang.org/x/text)|^|0.3.7|Required package for MongoDB plugin mongo-driver lib. |  ^**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.
ca	 #### Biblioteques de 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 de suport pròpia de Zabbix. Principalment per a connectors. | |[go.mongodb.org/mongo-driver](https://go.mongodb.org/mongo-driver)|^|1.7.6|Bloquejos de lectura/escriptura amb nom, sincronització d'accés. | |[github.com/go-stack/stack](https://github.com/go-stack/stack)|Indirecte^**1**^|1.8.0|Paquet necessari per al connector MongoDB mongo-driver lib . | |[github.com/golang/snappy](https://github.com/golang/snappy)|^|0.0.1|Paquet necessari per al connector MongoDB mongo-driver lib. | |[github.com/klauspost/compress](https://github.com/klauspost/compress)|^|1.13.6|Paquet necessari per al connector MongoDB mongo-driver lib. | |[github.com/Microsoft/go-winio](https://github.com/microsoft/go-winio)|^|0.6.0|Paquet necessari per al connector MongoDB mongo-driver lib a Windows. | |[github.com/pkg/errors](https://github.com/pkg/errors)|^|0.9.1|Paquet necessari per al connector MongoDB mongo-driver lib. | |[github.com/xdg-go/pbkdf2](https://github.com/xdg-go/pbkdf2)|^|1.0.0|Paquet necessari per al connector MongoDB mongo-driver lib. | |[github.com/xdg-go/scram](https://github.com/xdg-go/scram)|^|1.0.2|Paquet necessari per al connector MongoDB mongo-driver lib. | |[github.com/xdg-go/stringprep](https://github.com/xdg-go/stringprep)|^|1.0.2|Paquet necessari per al connector MongoDB mongo-driver lib. | |[github.com/youmark/pkcs8](https://github.com/youmark/pkcs8)|^|0.0.0|Paquet necessari per al connector MongoDB mongo-driver lib. | |[golang.org/x/crypto](https://pkg.go.dev/x/crypto)|^|0.0.0|Paquet necessari per al connector MongoDB mongo-driver lib. | |[golang.org/x/sync](https://pkg.go.dev/x/sync)|^|0.0.0|Paquet necessari per al connector MongoDB mongo-driver lib. | |[golang.org/x/sys](https://pkg.go.dev/x/sys)|^|0.0.0|Paquet necessari per al connector MongoDB mongo-driver lib. | |[golang.org/x/text](https://pkg.go.dev/x/text)|^|0.3.7|Paquet necessari per al connector MongoDB mongo-driver lib. |  ^**1**^ "Indirecte" vol dir que s'empra a una de les biblioteques que empra l'agent. És necessari ja que Zabbix empri la mateixa biblioteca que el paquet.

en-us	# graph.create
ca	# graph.create

en-us	# graph.delete
ca	# graph.delete

en-us	# graph.get
ca	# graph.get

en-us	# graphitem.get
ca	# graphitem.get

en-us	### Graph item  ::: noteclassic Graph items can only be modified via the `graph` API. :::  The graph item object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |gitemid|ID|ID of the graph item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |color|string|Graph item's draw color as a hexadecimal color code.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |itemid|ID|ID of the item.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |calc\_fnc|integer|Value of the item that will be displayed.<br><br>Possible values:<br>1 - minimum value;<br>2 - *(default)* average value;<br>4 - maximum value;<br>7 - all values;<br>9 - last value, used only by pie and exploded graphs.| |drawtype|integer|Draw style of the graph item.<br><br>Possible values:<br>0 - *(default)* line;<br>1 - filled region;<br>2 - bold line;<br>3 - dot;<br>4 - dashed line;<br>5 - gradient line.| |graphid|ID|ID of the graph that the graph item belongs to.| |sortorder|integer|Position of the item in the graph.<br><br>Default: starts with "0" and increases by one with each entry.| |type|integer|Type of graph item.<br><br>Possible values:<br>0 - *(default)* simple;<br>2 - graph sum, used only by pie and exploded graphs.| |yaxisside|integer|Side of the graph where the graph item's Y scale will be drawn.<br><br>Possible values:<br>0 - *(default)* left side;<br>1 - right side.|
ca	### Element de gràfic  ::: noteclassic Els elements del gràfic només es poden modificar emprant l'API `graph`. :::  L'objecte d'element de gràfic té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |gitemid|ID|ID de l'element del gràfic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |color|string|Traceu el color de l'element del gràfic com a codi de color hexadecimal.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |item)|ID|ID de l'element.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |calc\_fnc|integer|Valor de l'element que es mostrarà.<br><br>Valors possibles:<br>1 - valor mínim;<br>2 - *(per defecte)* valor mitjà;<br> 4 - valor màxim;<br>7 - tots els valors;<br>9 - darrer valor, emprat només pels gràfics circulars i explotats.| |drawtype|integer|Estil de dibuix de l'element del gràfic.<br><br>Valors possibles:<br>0 - línia *(per defecte)*;<br>1 - àrea plena;<br>2 - línia en negreta;< br>3 - punt;<br>4 - línia de punts;<br>5 - línia degradada.| |graphid|ID|ID del gràfic al qual pertany l'element del gràfic.| |sortorder|integer|Posició de l'element al gràfic.<br><br>Per defecte: comença amb 0 i augmenta un amb cada entrada.| |type|integer|Tipus d'element del gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* simple;<br>2 - suma del gràfic, només emprat pels gràfics circulars i explotat.| |yaxisside|integer|Cara del gràfic on es representarà l'escala Y de l'element gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* costat esquerre;<br>1 - costat dret.|

en-us	# Graph item object  The following objects are directly related to the `graphitem` API.
ca	# Objecte gràfic  Els següents objectes són relacionats amb l'API `graphitem`.

en-us	# Graph item  This class is designed to work with graph items.  Object references:  -   [Graph item](/manual/api/reference/graphitem/object#graph_item)  Available methods:  -   [graphitem.get](/manual/api/reference/graphitem/get) - retrieve graph items
ca	# Element de gràfic  Aquesta classe és dissenyada per treballar amb els elements de gràfic.  Referències d'objectes:  -   [Element de gràfic](/manual/api/reference/graphitem/object#graph_item)  Mètodes disponibles:  -   [graphitem.get](/manual/api/reference/graphitem/get) - recuperar els elements de gràfic

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

en-us	##### Graph preview  In the *Preview* tab, a preview of the graph is displayed so you can immediately see what you are creating.  ![](../../../../../assets/en/manual/config/visualization/graph_preview.png){width="600"}  Note that the preview will not show any data for template items.  ![](../../../../../assets/en/manual/config/visualization/graph_preview2.png){width="600"}  In this example, pay attention to the dashed bold line displaying the trigger level and the trigger information displayed in the legend.  ::: noteclassic No more than 3 trigger lines can be displayed. If there are more triggers then the triggers with lower severity are prioritized for display.\ \ If graph height is set as less than 120 pixels, no trigger will be displayed in the legend. :::
ca	##### Previsualització del gràfic  A la pestanya *Vista prèvia*, es mostra una vista prèvia del gràfic perquè pugueu veure immediatament el que esteu creant.  ![](../../../../../assets/en/manual/config/visualization/graph_preview.png){width="600"}  Tingueu en compte que la previsualització no ensenyarà cap dada per als elements del model.  ![](../../../../../assets/en/manual/config/visualization/graph_preview2.png){width="600"}  En aquest exemple, presteu atenció a la línia discontínua en negreta que mostra el nivell de trigger i la informació del trigger que es mostra a la llegenda.  :::noteclassic No es poden mostrar més de 3 línies de trigger. Si hi ha més triggers, primer s'ensenyen els de menor gravetat.\ \ Si l'alçada del gràfic s'estableix a menys de 120 píxels, no es veurà cap trigger a la llegenda. :::

en-us	# graphprototype.create
ca	# graphprototype.create

en-us	# graphprototype.delete
ca	# graphprototype.delete

en-us	# graphprototype.get
ca	# graphprototype.get

en-us	# Graph prototype object  The following objects are directly related to the `graphprototype` API.
ca	# Objecte prototip de gràfic  Els objectes següents són vinculats a l'API `graphprototype`.

en-us	#### Graph prototypes  The following screenshot illustrates how we can use these macros in graph prototypes:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototype_snmp.png){width="600"}  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototypes_snmp.png){width="600"}  A summary of our discovery rule:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rules_snmp.png){width="600"}
ca	#### Prototips de gràfics  La següent captura de pantalla ensenya com podem emprar aquestes macros a prototips de gràfics:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototype_snmp.png){width="600"}  ![](../../../../../assets/en/manual/discovery/low_level_discovery/graph_prototypes_snmp.png){width="600"}  Un resum de la nostra regla de descoberta:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rules_snmp.png){width="600"}

en-us	### Graph prototype  The graph prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|ID|ID of the graph prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |height|integer|Height of the graph prototype in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Name of the graph prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |width|integer|Width of the graph prototype in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |graphtype|integer|Graph prototypes's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show discovered pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the discovered graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|ID|ID of the parent template graph prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|ID|ID of the item that is used as the maximum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymax_type` is set to "calculated".| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|ID|ID of the item that is used as the minimum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymin_type` is set to "calculated".| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |discover|integer|Graph prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new graphs will be discovered;<br>1 - new graphs will not be discovered and existing graphs will be marked as lost.| |uuid|string|Universal unique identifier, used for linking imported graph prototypes to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the graph prototype belongs to a template|
ca	### Prototipus de gràfic  L'objecte prototipus de gràfic té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphid|ID|ID del prototipus de gràfic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |alçada|integer|Alçada del gràfic del prototipus en píxels.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |nom|string|Nom del prototipus de gràfic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |amplada|integer|Amplada del prototipus de gràfic en píxels.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |graphtype|integer|Tipus de disseny del prototipus de gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - apilat;<br>2 - circular;< br>3 - explotat.| |percent\_left|float|Percentil esquerre.<br><br>Per defecte: 0.| |percent\_right|float|Percentil dret.<br><br>Per defecte: 0.| |show\_3d|integer|Indica si s'han de mostrar gràfics circulars i explosius en 3D.<br><br>Valors possibles:<br>0 - *(per defecte)* es mostra en 2D;<br>1 - Mostra en 3D .| |show\_legend|integer|Indica si s'ha de mostrar la llegenda al gràfic descobert.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* mostrar.| |show\_work\_period|integer|Indica si s'ha de mostrar el temps de treball al gràfic descobert.<br><br>Valors possibles:<br>0 - ocultar;<br>1 - *(per defecte) * mostrar.| |templateid|ID|ID de prototipus de gràfic de la plantilla principal.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |yaxismax|float|El valor màxim fix per a l'eix Y.| |yaxismin|float|El valor mínim fix per a l'eix Y.| |ymax\_itemid|ID|Id de l'element emprat com a valor màxim per a l'eix Y.<br><br>Si l'usuari no té accés a l'element especificat, el gràfic es representa com si `ymax_type` fos establert a "calculat".| |ymax\_type|integer|Mètode per calcular el valor màxim de l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |ymin\_itemid|ID|Id de l'element emprat com a valor mínim per a l'eix Y.<br><br>Si l'usuari no té accés a l'element especificat, el gràfic es representa com si `ymin_type` fos establert a "calculat".| |ymin\_type|integer|Mètode per calcular el valor mínim per a l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |descoberta|integer|Estat de descobriment de prototipus de gràfics.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran gràfics nous;<br>1 - no es descobriran gràfics nous i els gràfics existents es marcaran com a perduts.| |uuid|cadena|Identificador únic universal, emprat per enllaçar prototips de gràfics importats amb els existents. S'empra només per a prototips de gràfics de plantilla. Es genera automàticament, si no es proporciona.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si el prototip de gràfic pertany a una plantilla|

en-us	# Graph prototype  This class is designed to work with graph prototypes.  Object references:  -   [Graph prototype](/manual/api/reference/graphprototype/object#graph_prototype)  Available methods:  -   [graphprototype.create](/manual/api/reference/graphprototype/create) - create new graph prototypes -   [graphprototype.delete](/manual/api/reference/graphprototype/delete) - delete graph prototypes -   [graphprototype.get](/manual/api/reference/graphprototype/get) - retrieve graph prototypes -   [graphprototype.update](/manual/api/reference/graphprototype/update) - update graph prototypes
ca	# Prototipus de gràfic  Aquesa classe és dissenyada per treballar amb prototips de gràfics.  Referències d'objectes:  -   [Gràfic prototipus](/manual/api/reference/graphprototype/object#graph_prototype)  Mètodes disponibles:  -   [graphprototype.create](/manual/api/reference/graphprototype/create) -     crear nous prototipus de gràfics -   [graphprototype.delete](/manual/api/reference/graphprototype/delete) -     esborrar prototips de gràfics -   [graphprototype.get](/manual/api/reference/graphprototype/get) -     recuperar prototipus de gràfics -   [graphprototype.update](/manual/api/reference/graphprototype/update) -     actualitzar prototipus de gràfics

en-us	# graphprototype.update
ca	# graphprototype.update

en-us	#### Graphs and history  The *Graph/History* column in the item list offers the following links:  -   **History** - for all textual items, leading to listings (*Values/500 latest values*) displaying the history of previous item values. -   **Graph** - for all numeric items, leading to a [simple graph](/manual/config/visualization/graphs/simple).     Note that when the graph is displayed, a dropdown on the upper right offers a possibility to switch to *Values/500 latest values* as well.  ![](../../../../../assets/en/manual/web_interface/latest_values.png){width="600"}  The values displayed in this list are raw, that is, no postprocessing is applied.  ::: noteclassic The total amount of values displayed is defined by the value of *Limit for search and filter results* parameter, set in *Administration* → *General* → [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui). :::
ca	#### Gràfics i historial  La columna *Gràfic/Historial* de la llista d'elements ofereix els enllaços següents:  - **Historial** - per a tots els elements textuals, que porta a llistes (*Valors/500 darrers valors*) que ensenyen l'historial dels valors dels elements anteriors. - **Gràfic** - per a tots els elements numèrics, que porta a un [gràfic simple](/manual/config/visualization/graphs/simple).     Tingueu en compte que quan es mostra el gràfic, un menú desplegable a la part superior dreta també ofereix la possibilitat de canviar a *Valors/500 darrers valors*.  ![](../../../../../assets/en/manual/web_interface/latest_values.png){width="600"}  Els valors que s'hi veuen en aquesta llista són en brut, és a dir, no s'aplica cap postprocessament.  ::: noteclassic La quantitat total de valors que es veuen es defineix pel valor del paràmetre *Límit per a resultats de cerca i filtres*, establert a *Administració* → *General* → [*GUI*](/manual/web_interface/frontend_sections/administration/general#gui ). :::

en-us	#### Graphs  ##### Daylight Saving Time  Changes to Daylight Saving Time (DST) result in irregularities when displaying X axis labels (date duplication, date missing, etc).  ##### Sum aggregation  When using [sum aggregation](/manual/config/visualization/graphs/aggregate#configuration)  in a graph for period that is less than one hour, graphs display  incorrect (multiplied) values when data come from trends.  ##### Text overlapping  For some frontend languages (e.g., Japanese), local fonts can cause text overlapping in graph legend. To avoid this, use version 2.3.0 (or later) of PHP GD extension.
ca	#### Gràfics  ##### Horari d'estiu  Els canvis a l'horari d'estiu (DST) causen irregularitats en mostrar les etiquetes de l'eix X (data doble, data que manca, etc.).  ##### Suma afegida  Quan s'empra la [suma afegida](/manual/config/visualization/graphs/aggregate#configuration) a un gràfic durant un període inferior a una hora, els gràfics mostren valors incorrectes (multiplicats) quan les dades provenen de tendències.  ##### Text superposat  Per a alguns idiomes d'interfície (per exemple, el japonès), els tipus de lletra locals poden provocar que el text es superposi a la llegenda del gràfic. Per evitar-ho, empreu la versió 2.3.0 (o posterior) de l'extensió PHP GD.

en-us	#### Graphs  Edit graphs or separate graph items for better presentation of the gathered data.  [Graph API](/manual/api/reference/graph) | [Graph item API](/manual/api/reference/graphitem)
ca	#### Gràfics  Modifica els gràfics o els elements de gràfics separats per una millor presentació de les dades recollides.  [API Gràfic](/manual/api/reference/graph) | [API Element de gràfic](/manual/api/reference/graphitem)

en-us	##### Graphs  With the item working for a while, it might be time to see something visual. [Simple graphs](/manual/config/visualization/graphs/simple) are available for any monitored numeric item without any additional configuration. These graphs are generated on runtime.  To view the graph, go to *Monitoring → Latest data* and click on the 'Graph' link next to the item.  ![](../../../assets/en/manual/quickstart/simple_graph.png){width="600"}
ca	##### Gràfics  Amb l'element en funcionament durant una estona, potser és hora de veure quelcom visual. Els [Gràfics simples](/manual/config/visualization/graphs/simple) són disponibles per a qualsevol element digital monitorat sense cap configuració addicional. Aquests gràfics es generen en temps d'execució.  Per veure el gràfic, aneu a *Monitoratge → Dades més recents* i feu clic a l'enllaç "Gràfic" al costat de l'element.  ![](../../../assets/en/manual/quickstart/simple_graph.png){width="600"}

en-us	### Graph  The graph object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |graphid|ID|ID of the graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |height|integer|Height of the graph in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Name of the graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |width|integer|Width of the graph in pixels.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |flags|integer|Origin of the graph.<br><br>Possible values:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |graphtype|integer|Graph's layout type.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - stacked;<br>2 - pie;<br>3 - exploded.| |percent\_left|float|Left percentile.<br><br>Default: 0.| |percent\_right|float|Right percentile.<br><br>Default: 0.| |show\_3d|integer|Whether to show pie and exploded graphs in 3D.<br><br>Possible values:<br>0 - *(default)* show in 2D;<br>1 - show in 3D.| |show\_legend|integer|Whether to show the legend on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_work\_period|integer|Whether to show the working time on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |show\_triggers|integer|Whether to show the trigger line on the graph.<br><br>Possible values:<br>0 - hide;<br>1 - *(default)* show.| |templateid|ID|ID of the parent template graph.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |yaxismax|float|The fixed maximum value for the Y axis.<br><br>Default: 100.| |yaxismin|float|The fixed minimum value for the Y axis.<br><br>Default: 0.| |ymax\_itemid|ID|ID of the item that is used as the maximum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymax_type` is set to "calculated".| |ymax\_type|integer|Maximum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |ymin\_itemid|ID|ID of the item that is used as the minimum value for the Y axis.<br><br>If a user has no access to the specified item, the graph is rendered as if `ymin_type` is set to "calculated".| |ymin\_type|integer|Minimum value calculation method for the Y axis.<br><br>Possible values:<br>0 - *(default)* calculated;<br>1 - fixed;<br>2 - item.| |uuid|string|Universal unique identifier, used for linking imported graphs to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the graph belongs to a template|
ca	### Gràfic  L'objecte gràfic té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphid|ID|ID del gràfic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions d'actualització| |alçada|integer|Alçada del gràfic en píxels.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |nom|string|Nom del gràfic.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |amplada|integer|Amplada del gràfic en píxels.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |flags|integer|Origen del gràfic.<br><br>Els valors possibles són:<br>0 - *(per defecte)* un gràfic simple;<br>4 - un gràfic descobert.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |graphtype|integer|Tipus de disseny del gràfic.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - apilat;<br>2 - circular;<br> 3 - explotat.| |percent\_left|float|Percentil esquerre.<br><br>Per defecte: 0.| |percent\_right|float|Percentil dret.<br><br>Per defecte: 0.| |show\_3d|integer|Indica si s'han de mostrar gràfics circulars i explosius en 3D.<br><br>Valors possibles:<br>0 - *(per defecte)* es mostra en 2D;<br>1 - es mostra en 3D. | |show\_legend|integer|Indica si s'ha de mostrar la llegenda al gràfic.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* mostrar.| |show\_work\_period|integer|Indica si s'ha de mostrar el temps de treball al gràfic.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* visualització.| |show\_triggers|integer|Indica si s'ha de mostrar la línia d'activació al gràfic.<br><br>Valors possibles:<br>0 - amagar;<br>1 - *(per defecte)* mostrar. | |templateid|ID|ID del gràfic de plantilla principal.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |yaxismax|float|El valor màxim fix per a l'eix Y.<br><br>Per defecte: 100.| |yaxismin|float|El valor mínim fix per a l'eix Y.<br><br>Per defecte: 0.| |ymax\_itemid|ID|Id de l'element emprat com a valor màxim per a l'eix Y.<br><br>Des de Zabbix 6.0.7, si l'usuari no té accés a l'element especificat, el gràfic es representa com si ymax\_type fos establert a '0' (calculat).| |ymax\_type|integer|Mètode per calcular el valor màxim de l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |ymin\_itemid|ID|Id de l'element emprat com a valor mínim per a l'eix Y.<br><br>Des de Zabbix 6.0.7, si l'usuari no té accés a l'element especificat, el gràfic es representa com si ymin\_type fos establert a '0' (calculat).| |ymin\_type|integer|Mètode per calcular el valor mínim per a l'eix Y.<br><br>Valors possibles:<br>0 - *(per defecte)* calculat;<br>1 - fix;< br>2 - element.| |uuid|string|Identificador únic universal, emprat per enllaçar els gràfics importats amb els existents. Es genera automàticament, si no es proporciona.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si el gràfic pertany a una plantilla|

en-us	# Graph  This class is designed to work with graphs.  Object references:  -   [Graph](/manual/api/reference/graph/object#graph)  Available methods:  -   [graph.create](/manual/api/reference/graph/create) - create new graphs -   [graph.delete](/manual/api/reference/graph/delete) - delete graphs -   [graph.get](/manual/api/reference/graph/get) - retrieve graphs -   [graph.update](/manual/api/reference/graph/update) - update graphs
ca	# Gràfic  Aquesta classe és dissenyada per treballar amb gràfics.  Referències d'objectes:  -   [Gràfic](/manual/api/reference/graph/object#graph)  Mètodes disponibles:  -   [graph.create](/manual/api/reference/graph/create) - crear nous gràfics -   [graph.delete](/manual/api/reference/graph/delete) - esborrar gràfics -   [graph.get](/manual/api/reference/graph/get) - recuperar gràfics -   [graph.update](/manual/api/reference/graph/update) - actualitzar gràfics

en-us	# graph.update
ca	# graph.update

en-us	#### graph  [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `graph.get`: Method now also supports `status` property if `selectGraphDiscovery` parameter is used.
ca	#### gràfic  [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `graph.get`: El mètode ara admet la propietat `status` si s'empra el paràmetre `selectGraphDiscovery`.

en-us	### Group link  The group link object links a host prototype with a host group. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Enllaç de grup  L'objecte d'enllaç de grup enllaça un prototip d'equips amb un grup d'equips i té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|ID|ID del grup d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### Group prototype  The group prototype object defines a group that will be created for a discovered host. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Name of the group prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Prototip de grup  L'objecte defineix un grup que es crearà per a un equip descobert i té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|cadena|Nom del prototip de grup.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	#### - GUI  This section provides customization of several frontend-related defaults.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_gui.png)  Configuration parameters:  |Parameter|Description| |--|--------| |*Default language*|Default language for users who have not specified a language in their profiles and guest users.<br>For more information, see [Installation of additional frontend languages](/manual/appendix/install/locales).| |*Default time zone*|Default [time zone](/manual/web_interface/time_zone#overview) for users who have not specified a time zone in their profiles and guest users.| |*Default theme*|Default theme for users who have not specified a theme in their profiles and guest users.| |*Limit for search and filter results*|Maximum amount of elements (rows) that will be displayed in a web-interface list, for example, in *Data collection → Hosts*.<br>*Note*: If set to, for example, '50', only the first 50 elements will be displayed in all affected frontend lists. If some list contains more than fifty elements, the indication of that will be the '+' sign in *"Displaying 1 to 50 of **50+** found"*. Also, if filtering is used and still there are more than 50 matches, only the first 50 will be displayed.| |*Max number of columns<br>and rows in overview tables*|Maximum number of columns and rows to display in Data overview and Trigger overview dashboard widgets. The same limit applies to both columns and rows. If more rows and/or columns than shown exist, the system will display a warning at the bottom of the table: "Not all results are displayed. Please provide more specific search criteria."| |*Max count of elements<br>to show inside table cell*|For entries that are displayed in a single table cell, no more than configured here will be shown.| |*Show warning if Zabbix server is down*|This parameter enables a warning message to be displayed in a browser window if the Zabbix server cannot be reached (possibly down). The message remains visible even if the user scrolls down the page. When hovered over, the message is temporarily hidden to reveal the contents underneath it.| |*Working time*|This system-wide parameter defines working hours. In graphs, working time is displayed as a white background and non-working time is displayed as gray.<br>See [Time period specification](/manual/appendix/time_period) page for description of the time format.<br>[User macros](/manual/config/macros/user_macros) are supported.| |*Show technical errors*|If checked, all registered users will be able to see technical errors (PHP/SQL). If unchecked, the information is only available to [Zabbix Super Admins](/manual/web_interface/frontend_sections/users/users#users1) and users belonging to the user groups with enabled [debug mode](/manual/web_interface/debug_mode).| |*Max history display period*|Maximum time period for which to display historical data in *Monitoring* subsections: *Latest data*, *Web*, and in the *Data overview* dashboard widget.<br>Allowed range: 24 hours (default) - 1 week. [Time suffixes](/manual/appendix/suffixes), e.g. 1w (one week), 36h (36 hours), are supported.| |*Time filter default period*|Time period to be used in graphs and dashboards by default. Allowed range: 1 minute - 10 years (default: 1 hour).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 10m (ten minutes), 5w (five weeks), are supported.<br>Note: when a user changes the time period while viewing a graph, this time period is stored as user preference, replacing the global default or a previous user selection.| |*Max period for time selector*|Maximum available time period for graphs and dashboards. Users will not be able to visualize older data. Allowed range: 1 year - 10 years (default: 2 years).<br>[Time suffixes](/manual/appendix/suffixes), e.g. 1y (one year), 365w (365 weeks), are supported.|
ca	#### - GUI  Aquesta secció permet personalitzar diversos valors predeterminats relacionats amb la interfície.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_gui.png)  Paràmetres de configuració:  |Paràmetre|Descripció| |--|---------| |*Idioma predeterminat*|Idioma per defecte per als usuaris que no han especificat cap idioma als seus perfils i usuaris convidats.<br>Per obtindre més informació, veieu [Instal·lació d'idiomes d'interfície addicionals]( /manual/appendix/install/locales).| |*Fus horari predeterminat*|[Zona horària](/manual/web_interface/time_zone#overview) per defecte per als usuaris que no han especificat una zona horària als seus perfils i usuaris convidats.| |*Tema predeterminat*|Tema per defecte per als usuaris que no han especificat cap tema als seus perfils i usuaris convidats.| |*Límit d'elements cercats/filtrats*|Nombre màxim d'elements (fileres) que es veuran en una llista d'interfícies web, per exemple, a *Configuració → Equips*.<br>*Nota*: si s'estableix per exemple a '50', només es veuran els primers 50 elements a totes les llistes d'interfície rellevants. Si una llista conté més de 50 elements, la indicació serà el signe '+' a *"Mostrant de l'1 al 50 de **50+** trobats"*. A més, si s'empra el filtrat i encara hi ha més de 50 coincidències, només es veuran les primeres 50.| |*Nombre màxim de columnes<br>i fileres a les taules de previsualització*|Nombre màxim de columnes i fileres a ensenyar als ginys Previsualització de dades i Previsualització del trigger. El mateix límit s'aplica a columnes i fileres. Si hi ha més fileres i/o columnes de les indicades, el sistema ensenyarà un avís a la part inferior de la taula: "No es mostren tots els resultats. Proporcioneu criteris de cerca més específics."| |*Nombre màxim d'elements<br>mostrats a la cel·la*|Per a les entrades que es mostren en una sola cel·la de taula, no s'ensenyarà més del que és configurat aquí.| |*Mostra l'alerta si el servidor Zabbix és caigut*|Aquesta configuració permet mostrar un missatge d'avís a la finestra del navegador si el servidor Zabbix no és accessible (possiblement sigui caigut). El missatge continua essent visible fins i tot si l'usuari es desplaça cap avall per la pàgina. Quan es passa el cursor, el missatge s'amaga temporalment per revelar el contingut que hi ha a sota.| |*Horari de feina*|Aquesta configuració de tot el sistema defineix l'horari de feina. Als gràfics, les hores de feina es veuen en fons blanc i el temps no laboral es veu en gris.<br>Consulteu la pàgina [Especificació del període](/manual/appendix/time_period) per obtindre una descripció del format de l'hora.<br >[Les macros d'usuari](/manual/config/macros/user_macros) són compatibles.| |*Mostra errors tècnics*|Si és marcat, tots els usuaris registrats podran veure els errors tècnics (PHP/SQL). Si no és marcada, la informació només serà disponible per als [superadministradors de Zabbix](/manual/web_interface/frontend_sections/administration/users#users1) i els usuaris que pertanyen a grups d'usuaris amb [mode de depuració](/manual/web_interface/debug_mode) activat.| |*Període màxim de visualització de l'historial*|Període màxim per mostrar dades històriques a les subseccions *Monitoratge*: *Darreres dades*, *Web* i al giny del tauler de control *Visió general de les dades*.<br>Interval permès: 24 hores (predeterminat) - 1 setmana. S'admeten [sufixos oportuns](/manual/apèndix/sufixos), per exemple 1w (una setmana), 36h (36 hores).| |*Període predeterminat del filtre de temps*|Període que s'emprarà com a predeterminat a gràfics i taulers. Interval permès: 1 minut - 10 anys (predeterminat: 1 hora).<br>S'admeten [sufixos de temps](/manual/appendix/sufixos), p. ex., 10m (deu minuts), 5w (cinc setmanes).<br>Nota: quan un usuari canvia el període de temps mentre visualitza un gràfic, aquest període de temps s'emmagatzema com a preferència de l'usuari, anul·lant el valor predeterminat global o una selecció anterior de l'usuari.| |*Període màxim per al selector de temps*|Període de temps màxim disponible per a gràfics i taulers. Els usuaris no podran veure dades anteriors. Interval permès: 1 any - 10 anys (predeterminat: 2 anys).<br>[Sufixos de temps](/manual/appendix/sufixos), p. ex., 1 any (un any), 365w (365 setmanes) són càrregues compatibles.|

en-us	 #### Handling of regular expression compilation and runtime errors  If a regular expression used in `log[]`, `logrt[]`, `log.count[]` or `logrt.count[]` item cannot be compiled by PCRE or PCRE2 library then the item goes into  NOTSUPPORTED state with an error message. To continue monitoring the log item, the regular expression should be fixed.  If the regular expression compiles successfully, but fails at runtime (on some or on all log records), then the log item remains supported and  monitoring continues. The runtime error is logged in the Zabbix agent log file (without the log file record).   The logging rate is limited to one runtime error per check to allow Zabbix agent to monitor its own log file.  For example, if 10 records are analyzed and 3 records fail with a regexp runtime error, one record is produced in the agent log.   Exception: if MaxLinesPerSecond=1 and update interval=1 (only 1 record is allowed to analyze per check) then regexp runtime errors are not logged.  zabbix_agentd logs the item key in case of a runtime error, zabbix_agent2 logs the item ID to help identify which log item has runtime errors.  It is recommended to redesign the regular expression in case of runtime errors.
ca	 #### Gestió de la compilació d'expressions regulars i els errors d'execució  Si una expressió regular emprada a l'element `log[]`, `logrt[]`, `log.count[]` o `logrt.count[]` no es pot compilar per la biblioteca PCRE o PCRE2, l'element entra a  Estat NO SUPORTAT amb un missatge d'error. Per continuar monitorant l'element de registre, s'hauria de corregir l'expressió regular.  Si l'expressió regular es compila correctament, però falla en temps d'execució (en alguns o en tots els registres de registre), aleshores l'element de registre continua sent compatible i  el seguiment continua. L'error d'execució es registra al fitxer de registre de l'agent Zabbix (sense el registre del fitxer de registre).   La taxa de registre es limita a un error de temps d'execució per comprovació per permetre que l'agent Zabbix controli el seu propi fitxer de registre.  Per exemple, si s'analitzen 10 registres i 3 registres fallen amb un error d'execució de l'expressió regular, es genera un esdeveniment al registre de l'agent.   Excepció: si MaxLinesPerSecond=1 i l'interval d'actualització=1 (només es permet analitzar 1 registre per comprovació), els errors d'execució de l'expressió regular no es registren.  zabbix_agentd registra la clau de l'element en cas d'error d'execució, zabbix_agent2 registra l'ID de l'element per ajudar a identificar quin element de registre té errors d'execució.  Es recomana redissenyar l'expressió regular en cas d'errors d'execució.

en-us	# hanode.get
ca	# hanode.get

en-us	##### HANodeName The high availability cluster node name. When empty the server is working in standalone mode and a node with empty name is created.
ca	##### HANodeName Nom del node del clúster d'alta disponibilitat. Quan és buit, el servidor funciona en mode autònom i es crea un node amb un nom buit.

en-us	 #### Hardening security of Zabbix components  Some functionality can be switched off to harden the security of Zabbix components:  -    global script execution on Zabbix server can be disabled by setting EnableGlobalScripts=0 in server configuration; -    global script execution on Zabbix proxy is disabled by default (can be enabled by setting EnableRemoteCommands=1 in proxy configuration); -    global script execution on Zabbix agents is disabled by default (can be enabled by adding an AllowKey=system.run[<command>,\*] parameter for each allowed command in agent configuration); -    user HTTP authentication can be disabled by setting `$ALLOW_HTTP_AUTH=false` in the frontend configuration file (zabbix.conf.php). Note that reinstalling the frontend (running setup.php) will remove this parameter.
ca	 #### Millora de la seguretat dels components Zabbix  Algunes funcionalitats es poden desactivar per reforçar la seguretat dels components Zabbix:  - L'execució global d'scripts al servidor Zabbix es pot desactivar si estableix EnableGlobalScripts=0 a la configuració del servidor; - L'execució global d'scripts al proxy Zabbix és desactivada per defecte (es pot activar configurant EnableRemoteCommands=1 a la configuració del proxy); - L'execució d'script global als agents Zabbix és desactivada per defecte (es pot activar afegint un paràmetre AllowKey=system.run[<command>,\*] per a cada ordre permesa a la configuració de l'agent); - L'autenticació HTTP de l'usuari es pot desactivar configurant `$ALLOW_HTTP_AUTH=false' al fitxer de configuració de la interfície (zabbix.conf.php). Tingueu en compte que la reinstal·lació de la interfície (executant setup.php) esborrarà aquest paràmetre.

en-us	#### Hardware
ca	#### Maquinari

en-us	 **ha\_remove\_node**\[=*target*\]   Remove the high availability (HA) node specified by its name or ID. Note that active/standby nodes cannot be removed.  **ha\_set\_failover\_delay**\[=*delay*\]   Set high availability (HA) failover delay. Time suffixes are supported, e.g. 10s, 1m.  **proxy\_config\_cache\_reload**\[=*target*\] Reload proxy configuration cache.  **secrets\_reload**   Reload secrets from Vault.  **service\_cache\_reload**   Reload the service manager cache.  **prof\_enable**\[=*target*\]   Enable profiling. Affects all processes if target is not specified. Enabled profiling provides details of all rwlocks/mutexes by function name. Supported since Zabbix 6.0.13.  **prof\_disable**\[=*target*\]   Disable profiling. Affects all processes if target is not specified. Supported since Zabbix 6.0.13.    **log\_level\_increase**\[=*target*\]   Increase log level, affects all processes if target is not specified     **log\_level\_decrease**\[=*target*\]   Decrease log level, affects all processes if target is not specified  [ ]{#lbAG}
ca	**ha\_remove\_node**\[=*target*\] Esborra el node d'alta disponibilitat (HA) especificat pel seu nom o identificador. Tingueu en compte que els nodes actius/en espera no es poden pas esborrar.  **ha\_set\_failover\_delay**\[=*delay*\] Estableix l'endarreriment de la migració per error d'alta disponibilitat (HA). S'admeten sufixos de temps, p. 10 segons, 1 m.  **proxy\_config\_cache\_reload**\[=*target*\] Torneu a carregar la memòria cau de configuració del proxy.  **secrets\reload** Torna a carregar els secrets de Vault.  **service\_cache\_reload** Torneu a carregar la memòria cau del gestor de serveis.  **prof\_enable**\[=*target*\] Desactiva perfils. Afecta tots els processos si no s'especifica l'objectiu. Admès des de Zabbix 6.0.13.  **prof\_disable**\[=*target*\] Desactiva la creació de perfils. Afecta tots els processos si no s'especifica l'objectiu. Admès des de Zabbix 6.0.13.  **log\_level\_increase**\[=*target*\] Augmenta el nivell de registre, afecta tots els processos si no s'especifica l'objectiu     **log\_level\_decrease**\[=*target*\] Disminueix el nivell de registre, afecta tots els processos si no s'especifica l'objectiu  [ ]{#lbAG}

en-us	##### - HDD/flash image (raw)      dd if=./zabbix_appliance_7.0.0.raw of=/dev/sdc bs=4k conv=fdatasync  Replace */dev/sdc* with your Flash/HDD disk device.
ca	##### - Imatge HDD/flash (en brut)      dd if=./zabbix_appliance_7.0.0.raw of=/dev/sdc bs=4k conv=fdatasync  Substituïu */dev/sdc* per el vostre perifèric de disc Flash/HDD.

en-us	#### Header processing  The CSV file header line can be processed in two different ways:  -   If the *With header row* checkbox is marked - header line values are     interpreted as column names. In this case the column names must be     unique and the data row should not contain more columns than the     header row. -   If the *With header row* checkbox is not marked - the header line is     interpreted as data. Column names are generated automatically     (1,2,3,4...).  CSV file example:      Nr,Item name,Key,Qty     1,active agent item,agent.hostname,33     "2","passive agent item","agent.version","44"     3,"active,passive agent items",agent.ping,55  ::: noteclassic A quotation character within a quoted field in the input must be escaped by preceding it with another quotation character. :::  **Processing header line**  JSON output when a header line is expected:  ``` {.json} [    {       "Nr":"1",       "Item name":"active agent item",       "Key":"agent.hostname",       "Qty":"33"    },    {       "Nr":"2",       "Item name":"passive agent item",       "Key":"agent.version",       "Qty":"44"    },    {       "Nr":"3",       "Item name":"active,passive agent items",       "Key":"agent.ping",       "Qty":"55"    } ] ```  **No header line processing**  JSON output when a header line is not expected:  ``` {.json} [    {       "1":"Nr",       "2":"Item name",       "3":"Key"       "4":"Qty"    },    {       "1":"1",       "2":"active agent item",       "3":"agent.hostname"       "4":"33"    },    {       "1":"2",       "2":"passive agent item",       "3":"agent.version"       "4":"44"    },    {       "1":"3",       "2":"active,passive agent items",       "3":"agent.ping"       "4":"55"    } ] ```
ca	#### Processament de la capçalera  #### Procés de la capçalera  La línia de capçalera del fitxer CSV es pot processar de dues maneres diferents:  - Si la casella *Amb filera de capçalera* és marcada, els valors de la filera de capçalera s'interpreten com a noms de columna. En aquest cas, els noms de les columnes han d'ésser únics i la filera de dades no ha de contindre més columnes que la filera de capçalera; - Si la casella *Amb filera de capçalera* no és pas marcada, la filera de capçalera s'interpreta com a dades. Els noms de les columnes es generen automàticament (1,2,3,4...)  Exemple de fitxer CSV:       Nombre, nom de l'element, clau, quantitat      1, element agent actiu, agent.hostname,33      "2","element d'agent passiu","agent.version","44"      3,"elements d'agent actiu i passiu", agent.ping,55  :::noteclassic Les cometes en un camp entre cometes de l'entrada s'han d'escapar precedint-les amb una altra cometa. :::  **Processament de filera de capçalera**  Sortida JSON quan s'espera una filera de capçalera:  ``` {.json} [    {       "Nr":"1",       "Item name":"active agent item",       "Key":"agent.hostname",       "Qty":"33"    },    {       "Nr":"2",       "Item name":"passive agent item",       "Key":"agent.version",       "Qty":"44"    },    {       "Nr":"3",       "Item name":"active,passive agent items",       "Key":"agent.ping",       "Qty":"55"    } ] ```  **No es processa cap filera de capçalera**  Sortida JSON quan no s'espera una filera de capçalera:  ``` {.json} [    {       "1":"Nr",       "2":"Item name",       "3":"Key"       "4":"Qty"    },    {       "1":"1",       "2":"active agent item",       "3":"agent.hostname"       "4":"33"    },    {       "1":"2",       "2":"passive agent item",       "3":"agent.version"       "4":"44"    },    {       "1":"3",       "2":"active,passive agent items",       "3":"agent.ping"       "4":"55"    } ] ```

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
ca	##### HeartbeatFrequency  La freqüència dels missatges de heartbeat en segons. S'empra per monitorar la disponibilitat de comprovacions actives.<br>0: missatges de heartbeat desactivats.  Per defecte: `60`<br> Interval: 0-3600

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
ca	##### HeartbeatFrequency  La freqüència dels missatges de heartbeat en segons. S'empra per monitorar la disponibilitat de comprovacions actives.<br>0: missatges de heartbeat desactivats.  Per defecte: `60`<br> Interval: 0-3600

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
ca	##### HeartbeatFrequency  La freqüència dels missatges de heartbeat en segons. S'empra per monitorar la disponibilitat de comprovacions actives.<br>0: missatges de heartbeat desactivats.  Per defecte: `60`<br> Interval: 0-3600

en-us	##### HeartbeatFrequency  The frequency of heartbeat messages in seconds. Used for monitoring the availability of active checks.<br>0 - heartbeat messages disabled.  Default: `60`<br> Range: 0-3600
ca	##### HeartbeatFrequency  La freqüència dels missatges de heartbeat en segons. S'empra per monitorar la disponibilitat de comprovacions actives.<br>0: missatges de heartbeat desactivats.  Per defecte: `60`<br> Interval: 0-3600

en-us	 ##### Heartbeat message  The heartbeat message is sent by an active agent to Zabbix server/proxy  every HeartbeatFrequency seconds (configured in the [Zabbix agent](/manual/appendix/config/zabbix_agentd)/ [agent 2](/manual/appendix/config/zabbix_agent2) configuration file).  It is used to monitor the availability of active checks.  ```json {   "request": "active check heartbeat",   "host": "Zabbix server",   "heartbeat_freq": 60,   "version": "7.0.0",   "variant": 2 } ```  | Field | Type | Mandatory | Value | |-|-|-|--------| | request | _string_ | yes | `active check heartbeat` | | host | _string_ | yes | The host name. | | heartbeat_freq | _number_ | yes | The agent heartbeat frequency (HeartbeatFrequency configuration parameter). | | version | _string_ | yes | The agent version number. | | variant | _number_ | yes | The agent variant (*1* - Zabbix agent, *2* - Zabbix agent 2). |
ca	 ##### Missatge de Heartbeat  El missatge de heartbeat l'envia un agent actiu al servidor/proxy de Zabbix cada segons de HeartbeatFrequency (configurat a l'arxiu de configuració de l'[agent de Zabbix](/manual/appendix/config/zabbix_agentd)/[agent 2](/manual/appendix/config/zabbix_agent2)).  S'empra per controlar la disponibilitat de controls actius.  ```json {    "request": "active check heartbeat",    "host": "Servidor Zabbix",    "heartbeat_freq": 60,    "version": "7.0.0",    "variant": 2 } ```  | Camp | Tipus | Obligatori | Valor | |-|-|-|--------| | petició | _string_ | sí | `comprovació activa del heartbeat` | | host | _string_ | sí | El nom de l'equip. | | heartbeat_freq | _number_ | sí | Freqüència de heartbeat de l'agent (paràmetre de configuració HeartbeatFrequency). | | versió | _string_ | sí | Nombre de versió de l'agent. | | variant | _number_ | sí | Variant de l'agent (*1* - Zabbix agent, *2* - Zabbix agent 2). |

en-us	 ##### Hexadecimal to decimal {#hexadecimal}  Convert the value from hexadecimal format to decimal.  If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value, or set a specified error message. In case of a failed preprocessing step, the item will not become unsupported if the option to discard the value or set a specified value is selected.
ca	 ##### Hexadecimal a decimal {#hexadecimal}  Converteix el valor de format hexadecimal a decimal.  Si marqueu la casella de selecció *Personalitzar en cas d'error*, és possible especificar opcions personalitzades de gestió d'errors: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat. En el cas d'una passa de preprocessament fallida, l'element no serà pas compatible si es tria l'opció per descartar el valor o establir un valor especificat.

en-us	##### Hidden menu  Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon ![](../../../assets/en/manual/web_interface/burger_icon.png){class="nozoom"}. Note that it reappears over page content; to move page content to the right you have to unhide the menu by clicking on the show sidebar button.
ca	##### Menu amagat  Fins i tot quan el menú és totalment amagat, un menú complet és a només un clic de distància, fent clic a la icona de l'hamburguesa ![](../../../assets/en/manual/web_interface/burger_icon.png){class="nozoom"}. Tingueu en compte que reapareix al contingut de la pàgina; per moure el contingut de la pàgina cap a la dreta, heu de mostrar el menú fent clic al botó Mostra la barra lateral.

en-us	#### Hiding the file with list of common passwords  To increase the complexity of password brute force attacks, limiting access to the `ui/data/top_passwords.txt` file is recommended. This file contains a list of the most common and context-specific passwords and prevents users from setting such passwords (if the *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/users/authentication#internal_authentication)).  To limit access to the `top_passwords.txt` file, modify your web server configuration.  On Apache, file access can be limited using the `.htaccess` file:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```  On NGINX, file access can be limited using the `location` directive:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```
ca	#### Amagar el fitxer amb la llista de mots de pas habituals  Per pujar la complexitat dels atacs de força bruta amb mots de pas, es recomana limitar l'accés al fitxer `ui/data/top_passwords.txt`. Aquest fitxer conté una llista dels mots de pas més comuns i específiques del context i impedeix que els usuaris estableixin aquests mots de pas (si el paràmetre *Evitar mots de pas fàcils d'endevinar* és habilitat a la [política de mots de pas](/manual/web_interface/frontend_sections/ usuaris/autenticació#autenticació_interna)).  Per limitar l'accés al fitxer `top_passwords.txt`, modifiqueu la configuració del vostre servidor web.  A Apache, l'accés al fitxer es pot limitar mitjançant el fitxer `.htaccess`:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```  A NGINX, l'accés als fitxers es pot limitar mitjançant la directiva `location`:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```

en-us	#### High availability cluster  Retrieve a list of server nodes and their status.  [High availability cluster API](/manual/api/reference/hanode)
ca	#### Cluster d'alta disponibilitat  Recupera una llista de nodes de servidors i el seu estat.  [API Cluster d'Alta Disponibilitat](/manual/api/reference/hanode)

en-us	### High availability node  ::: noteclassic Nodes are created by the Zabbix server and cannot be modified via the API. :::  The High availability node object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |ha\_nodeid|ID|ID of the node.| |name|string|Name assigned to the node, using the HANodeName configuration entry of zabbix\_server.conf. Empty for a server running in standalone mode.| |address|string|IP or DNS name where the node connects from.| |port|integer|Port on which the node is running.| |lastaccess|integer|Heartbeat time, that is, time of last update from the node. UTC timestamp.| |status|integer|State of the node.<br><br>Possible values:<br>0 - standby;<br>1 - stopped manually;<br>2 - unavailable;<br>3 - active.|
ca	### Node d'alta disponibilitat  ::: noteclassic Els nodes són creats pel servidor de Zabbix i no pot ésser pas modificat via l'API. :::  L'objecte node d'alta disponibilitat té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |ha\_nodeid|ID|ID del node.| |name|string|Nom assignat al node, emprant la configuració HANodeName a zabbix\_server.conf. Buit per a servidors executant-se de manera autònoma.| |address|string|IP o nom DNS des d'on connecta el node.| |port|integer|Port on el node és funcionant.| |lastaccess|integer|temps de Heartbeat; és a dir: hora de la darrera actualització des del node. En temps UTC.| |status|integer|Estat del node.<br><br>Valors possibles:<br>0 - standby;<br>1 - aturat manualment;<br>2 - no disponible;<br>3 - actiu.|

en-us	# High availability node object  The following object is related to operating a High availability cluster of Zabbix servers.
ca	# Objecte de node d'alta disponibilitat  El següent objecte serveix per operar amb un cluster d'alta disponibilitat de servidors Zabbix.

en-us	#### High availability nodes  If [high availability cluster](/manual/concepts/server/ha) is enabled, then another block of data is displayed with the status of each high availability node.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Displayed data:  |Column|Description| |--|--------| |*Name*|Node name, as defined in server configuration.| |*Address*|Node IP address and port.| |*Last access*|Time of node last access.<br>Hovering over the cell shows the timestamp of last access in long format.| |*Status*|Node status:<br>**Active** - node is up and working<br>**Unavailable** - node hasn't been seen for more than failover delay (you may want to find out why)<br>**Stopped** - node has been stopped or couldn't start (you may want to start it or delete it)<br>**Standby** - node is up and waiting|
ca	#### Nodes d'alta disponibilitat  Si el [clúster HA](/manual/concepts/server/ha) és habilitat, es veu un altre bloc de dades amb l'estat de cada node HA.  ![](../../../../../assets/en/manual/web_interface/ha_nodes.png){width="600"}  Dades mostrades:  |Columna|Descripció| |--|---------| |*Nom*|Nom del node, tal com es defineix a la configuració del servidor.| |*Adreça*|Adreça IP i port del node.| |*DArrer accés*|Hora del darrer accés al node.<br>Si passeu el cursor per sobre de la cel·la, es veu la marca de temps del darrer accés en format llarg.| |*Estat*|Estat del node:<br>**Activat** - el node és en funcionament<br>**No disponible** - el node no s'ha vist durant més que el temps de migració per error (pot ser que vulgueu saber per què)<br>**Aturat** - el node s'ha aturat o no s'ha pogut iniciar (podeu iniciar-lo o esborrar-lo)<br>**Pendent** - el node és actiu i pendent|

en-us	# High availability node  This class is designed to work with server nodes that are part of a high availability cluster or a standalone server instance.  Object references:  -   [High availability node](/manual/api/reference/hanode/object#high_availability_node)  Available methods:  -   [hanode.get](/manual/api/reference/hanode/get) - retrieve nodes
ca	# Node d'alta disponibilitat  Aquesta classe és pensada per treballar amb servidors nodes que són part d'un cluster d'alta disponibilitat, o amb una instància de servidor autònom.  Referències dels objectes:  -   [Node d'alta disponibilitat](/manual/api/reference/hanode/object#high_availability_node)  Mètodes disponibles:  -   [hanode.get](/manual/api/reference/hanode/get) - consultar els nodes

en-us	 ##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile}  Calculates the φ-quantile from the buckets of a histogram.<br> Supported [foreach function](/manual/appendix/functions/aggregate/foreach): *bucket_rate_foreach*.  Parameters:   -   **quantile** - 0 ≤ φ ≤ 1;<br> -   **bucketN, valueN** - manually entered pairs (>=2) of parameters or the response of [bucket_rate_foreach](/manual/appendix/functions/aggregate/foreach).  Comments:  -   Supported only in calculated items; -   Functionally corresponds to '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' of PromQL; -   Returns -1 if values of the last 'Infinity' bucket (*"+inf"*) are equal to 0.  Examples:      histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]))     histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s))
ca	 ##### histogram_quantile(quantile,bucket1,value1,bucket2,value2,...) {#histogram-quantile}  Calcula el quantil φ a partir de les galledes d'un histograma.<br> Admet les [funcions foreach](/manual/appendix/functions/aggregate/foreach): *bucket_rate_foreach*.  Paràmetres:  - **quantil** - 0 ≤ φ ≤ 1;<br> - **bucketN, valueN** - parelles introduïdes manualment (>=2) de paràmetres o la resposta de [bucket_rate_foreach](/manual/appendix/functions/aggregate/foreach).  Comentaris:  - Admès només en articles calculats; - Funcionalment correspon a '[histogram\_quantile](https://prometheus.io/docs/prometheus/latest/querying/functions/#histogram_quantile)' de PromQL; - Retorna -1 si els valors de l'últim dipòsit 'Infinit' (*"+inf"*) són iguals a 0.  Exemples:      histogram_quantile(0.75,1.0,last(/host/rate_bucket[1.0]),"+Inf",last(/host/rate_bucket[Inf]))     histogram_quantile(0.5,bucket_rate_foreach(//item_key,30s))

en-us	##### HistoryCacheSize  The size of the history cache, in bytes. The shared memory size for storing history data.  Default: `16M`<br> Range: 128K-2G
ca	##### HistoryCacheSize  La mida de la cau de l'historial, en octets. La mida de memòria compartida per emmagatzemar les dades de l'històric.  Per defecte: `16M`<br> Rang: 128K-2G

en-us	##### HistoryCacheSize The size of the history cache, in bytes. The shared memory size for storing history data.  Default: `16M`<br> Range: 128K-2G
ca	##### HistoryCacheSize  Mida de la cau de l'historial, en octets. La mida de memòria compartida per emmagatzemar les dades de l'històric.  Per defecte: `16M`<br> Rang: 128K-2G

en-us	# history.clear
ca	# history.clear

en-us	# history.get
ca	# history.get

en-us	##### HistoryIndexCacheSize  The size of the history index cache, in bytes. The shared memory size for indexing the history data stored in history cache. The index cache size needs roughly 100 bytes to cache one item.  Default: `4M`<br> Range: 128K-2G
ca	##### HistoryIndexCacheSize  Mida de la memòria cau de l'índex d'historial, en octets. La mida de la memòria compartida per indexar les dades de l'historial emmagatzemades a la memòria cau de l'historial. La mida de la memòria cau d'índex necessita aproximadament 100 octets per emmagatzemar un element a la memòria cau.  Per defecte: `4M`<br> Rang: 128K-2G

en-us	##### HistoryIndexCacheSize The size of the history index cache, in bytes. The shared memory size for indexing the history data stored in history cache. The index cache size needs roughly 100 bytes to cache one item.  Default: `4M`<br> Range: 128K-2G
ca	##### HistoryIndexCacheSize  Mida de la memòria cau de l'índex d'historial, en octets. La mida de la memòria compartida per indexar les dades de l'historial emmagatzemades a la memòria cau de l'historial. La mida de la memòria cau d'índex necessita aproximadament 100 octets per emmagatzemar un element a la memòria cau.  Per defecte: `4M`<br> Rang: 128K-2G

en-us	# History object  The following objects are directly related to the `history` API.  ::: noteclassic History objects differ depending on the item's type of information. They are created by Zabbix server and cannot be modified via the API. :::
ca	# Objecte historial  Els objectes següents són vinculats a l'API`history`.  ::: noteclassic Els objectes d'històric difereixen segons el tipus d'informació de l'element. Es creen pel servidor Zabbix i no poden pas ésser modificats per via de l'API. :::

en-us	# history.push
ca	# history.push

en-us	**history.push**  For sending data to Zabbix server using the `history.push` API method, you could make the following HTTP POST request containing some test values:  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}' ```  If the request is correct, the response returned by API could look as follows:  ```json {     "jsonrpc": "2.0",     "result": {         "response": "success",         "data": [             {                 "itemid": "10600"             },             {                 "itemid": "10601",                 "error": "Item is disabled."             },             {                 "error": "No permissions to referred object or it does not exist."             }         ]     },     "id": 1 } ```  Errors in response data indicate that sending data for specific items has failed validation by Zabbix server. This can happen for the following reasons:  -   the user sending the data has no *read* permission to the item's host; -   the host is disabled or in maintenance without data collection; -   the item does not exist or is not yet included in the server configuration cache; -   the item is disabled or its type is other than Zabbix trapper or [HTTP agent](/manual/config/items/itemtypes/http) (with trapping enabled); -   the user's IP or DNS is not set in the item's *Allowed hosts* list; -   another item has a value with a duplicate timestamp on the nanosecond level.  The absence of errors indicates that the values sent have been accepted for processing, which includes preprocessing (if any), trigger processing, and saving to the database. Note that the processing of an accepted value may also fail (for example, during [preprocessing](/manual/config/items/preprocessing)), resulting in the value being discarded.  For more information on how to work with Zabbix API, see [API](/manual/api).
ca	**history.push**  Per enviar dades al servidor Zabbix mitjançant el mètode API `history.push`, podeu fer la següent petició HTTP POST que contingui alguns valors de prova:  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Authorization: Bearer 0424bd59b807674191e7d77572075f33' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"history.push","params":[{"itemid":10600,"value":"test value 1"},{"itemid":10601,"value":"test value 2"},{"itemid":99999,"value":"test value 3"}],"id":1}' ```  Si la petició és correcta, la resposta que retorna l'API podria ser la següent:  ```json {     "jsonrpc": "2.0",     "result": {         "response": "success",         "data": [             {                 "itemid": "10600"             },             {                 "itemid": "10601",                 "error": "Item is disabled."             },             {                 "error": "No permissions to referred object or it does not exist."             }         ]     },     "id": 1 } ```  Els errors a les dades de resposta indiquen que l'enviament de dades d'elements específics ha fallat en la validació del servidor Zabbix. Això pot passar pels motius següents:  - l'usuari que envia les dades no té permís de *lectura* a l'equip de l'element; - l'equip és desactivat o en manteniment sense recollida de dades; - l'element no existeix o encara no és pas  inclòs a la memòria cau de configuració del servidor; - l'element és desactivat o el seu tipus és diferent de Zabbix trapper o [agent HTTP](/manual/config/items/itemtypes/http) (amb la captura activada); - l'IP o el DNS de l'usuari no s'estableixen al llistat d'*Equips permesos* de l'element; - un altre element té un valor amb una marca de temps duplicada a nivell de nanosegons.  L'absència d'errors indica que els valors enviats s'han acceptat per al processament, que inclou el preprocessament (si n'hi ha), el processament del trigger i l'emmagatzematge a la base de dades. Tingueu en compte que el processament d'un valor acceptat també pot fallar (per exemple, durant el [preprocessament](/manual/config/items/preprocessing)), provocant que el valor es descarti.  Per obtindre més informació sobre com treballar amb l'API Zabbix, veieu [API](/manual/api).

en-us	#### History  Retrieve historical values gathered by Zabbix monitoring processes for presentation or further processing.  [History API](/manual/api/reference/history)
ca	#### Historial  Recupera els valors de l'historial recollits per els processos de monitoratge de Zabbix per presentar-los o tractar-los posteriorment.  [API Historial](/manual/api/reference/history)

en-us	##### HistoryStorageDateIndex Enable preprocessing of history values in history storage to store values in different indices based on date.  Default: `0`<br> Values: 0 - disable; 1 - enable
ca	##### HistoryStorageDateIndex Habiliteu el preprocessament dels valors de l'historial a l'emmagatzematge de l'historial per emmagatzemar valors en diferents índexs basats en la data.  Per defecte: `0`<br> Valors: 0 - desactivar; 1 - activar

en-us	##### HistoryStorageTypes A comma-separated list of value types to be sent to the history storage. This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.  Default: `uint,dbl,str,log,text`
ca	##### HistoryStorageTypes Llistat de tipus de valors separats per comes que s'enviaran a l'emmagatzematge de l'historial. Aquest paràmetre s'empra per a la configuració d'[Elasticsearch](/manual/appendix/install/elastic_search_setup).  Per defecte: `uint,dbl,str,log,text`

en-us	##### HistoryStorageURL The history storage HTTP\[S\] URL. This parameter is used for [Elasticsearch](/manual/appendix/install/elastic_search_setup) setup.
ca	##### HistoryStorageURL URL d'emmagatzematge de l'historial HTTP\[S\]. Aquest paràmetre s'empra per a la configuració d'[Elasticsearch](/manual/appendix/install/elastic_search_setup).

en-us	# History  This class is designed to work with history data.  Object references:  -   [Float history](/manual/api/reference/history/object#float_history) -   [Integer history](/manual/api/reference/history/object#integer_history) -   [String history](/manual/api/reference/history/object#string_history) -   [Text history](/manual/api/reference/history/object#text_history) -   [Log history](/manual/api/reference/history/object#log_history)  Available methods:  -   [history.clear](/manual/api/reference/history/clear) - clear history data -   [history.get](/manual/api/reference/history/get) - retrieve history data -   [history.push](/manual/api/reference/history/push) - send history data to Zabbix server
ca	# Històric  Aquesta classe és pensada per treballar amb les informació de l'històric.  Referències d'objectes:  -   [Històric](/manual/api/reference/history/object#history)  -   [Historial flotant](/manual/api/reference/history/object#float_history) -   [Historial enter](/manual/api/reference/history/object#integer_history) -   [Historial cadena](/manual/api/reference/history/object#string_history) -   [Historial text](/manual/api/reference/history/object#text_history) -   [Historial registre](/manual/api/reference/history/object#log_history)   Mètodes disponibles:\  -   [history.clear](/manual/api/reference/history/clear) - netejar les dades de l'històric -   [history.get](/manual/api/reference/history/get) - consultar dades de l'històric -   [history.push](/manual/api/reference/history/push) - enviar les dades de l'històric al servidor de Zabbix

en-us	#### history  [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: Parameter `sortfield` now supports `ns`.\ [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) Added new method `history.push`.\
ca	#### historial  [ZBXNEXT-9193](https://support.zabbix.com/browse/ZBXNEXT-9193) `history.get`: el paràmetre `sortfield` ara admet `ns`.\ [ZBXNEXT-8541](https://support.zabbix.com/browse/ZBXNEXT-8541) S'ha afegit el nou mètode `history.push`.\

en-us	#### Honeycomb  A *Honeycomb* widget has been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets), which offers a dynamic and vibrant overview of the monitored network infrastructure and resources, where host groups, such as virtual machines and network devices, along with their respective items, are visually represented as interactive hexagonal cells. For more information, see [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb).  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb.png){width="450"}
ca	#### Bresca  S'ha afegit un giny *Bresca* a [ginys del tauler de control](/manual/web_interface/frontend_sections/dashboards/widgets), que ofereix una visió general dinàmica i vibrant de la infraestructura i els recursos de xarxa monitorats, on els grups d'equips, com ara màquines virtuals i els dispositius de xarxa, juntament amb els seus respectius elements, es representen visualment com a cel·les hexagonals interactives. Per obtindre més informació, consulteu [*Bresca*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb).  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/honeycomb.png){width="450"}

en-us	##### Host configuration  A host must be configured to process IPMI checks. An IPMI interface must be added, with the respective IP and port numbers, and IPMI authentication parameters must be defined.  See the [configuration of hosts](/manual/config/hosts/host) for more details.
ca	##### Configuració de l'equip  S'ha de configurar un equip per tractar les verificacions IPMI. Una interfície IPMI s'ha d'afegir, amb les adreces IP i els nombres de port respectius, i s'han de definir els paràmetres d'autenticació IPMI.  Veieu la [configuració d'equips](/manual/config/hosts/host) per tindre més detalls.

en-us	##### Host configuration  You can specify that an individual host should be monitored by a proxy or proxy group  in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by* field.  ![](../../../assets/en/manual/proxies/proxy_set.png){width="600"}  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy or proxy group.
ca	##### Configuració de l'equip  Podeu especificar que un equip s'ha de monitorar a un proxy o grup de proxys al formulari [Configuració de l'equip](/manual/config/hosts/host), emprant el camp *Monitorat*.  ![](../../../assets/en/manual/proxies/proxy_set.png){width="600"}  L'[actualització massiva](/manual/config/hosts/hostupdate) dels equips pot ésser una altra manera d'especificar que els equips han d'ésser monitorats per un proxy o un grup de proxys.

en-us	# host.create
ca	# host.create

en-us	##### Host creation  A host is added if the *Add host* operation is selected. A host is also added, even if the *Add host* operation is missing, if you select operations resulting in actions on a host. Such operations are:  -   enable host -   disable host -   add host to a host group -   link template to a host  Created hosts are added to the *Discovered hosts* group (by default, configurable in *Administration* → *General* → *[Other](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). If you wish hosts to be added to another group, add a *Remove from host groups* operation (specifying "Discovered hosts") and also add an *Add to host groups* operation (specifying another host group), because a host must belong to a host group.
ca	##### Creació d'equip  S'afegeix un equip si és triada l'operació *Afegir equip*. També s'afegeix un equip, encara que falti l'operació *Afegir equip*, si trieu operacions que donen lloc a accions en un equip. Aquestes operacions són:  - activar equip - desactivar equip - afegir un equip a un grup d'equips - vincular un model a un equip  Els equips creats s'afegeixen al grup *Equips descoberts* (per defecte, configurable a *Administració* → *General* → *[Altres](/manual/web_interface/frontend_sections/administration/general#other_parameters)*). Si voleu que s'afegeixin equips a un altre grup, afegiu una operació *Treure dels grups d'equips* (especificant "Equips descoberts") i també una operació *Afegir als grups d'equips* (especificant un altre grup d'equips), perquè un equip ha de pertànyer a un grup d'equips.

en-us	#### Host dashboards tabs  All of the configured [host dashboards](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) for the selected host are now displayed as tabs under the host dashboards page header, replacing the previous dropdown in the upper right corner. This allows easy transition between various host dashboards and improves navigation through monitoring data.
ca	#### Pestanyes dels quadres de comandament de l'equip  Tots els [taulers de control de l'amfitrió](/manual/web_interface/frontend_sections/monitoring/hosts/dashboards) per a l'equip triat es mostren ara com a pestanyes a la capçalera de la pàgina dels taulers d'equip, substituint el menú desplegable anterior a l'extrem superior dret. Això permet una transició fàcil entre diversos taulers d'equips i millora la navegació a través de les dades de monitoratge.

en-us	# host.delete
ca	# host.delete

en-us	# host.get
ca	# host.get

en-us	##### Host graph items  |Element|<|Type|Description| |-|---|---|-----------------------| |sortorder|<|integer|Draw order. The smaller value is drawn first. Can be used to draw lines or regions behind (or in front of) another.| |drawtype|<|string|Draw style of the graph item.<br>Supported for NORMAL graphs.<br>Possible values:^[1](#footnotes)^ SINGLE\_LINE (0, default), FILLED\_REGION (1), BOLD\_LINE (2), DOTTED\_LINE (3), DASHED\_LINE (4), GRADIENT\_LINE (5).| |color|<|string|Element color (6 symbols, hex).| |yaxisside|<|string|Side of the graph where the graph item's Y scale will be drawn.<br>Supported for NORMAL and STACKED graphs.|<br>Possible values:^[1](#footnotes)^ LEFT (0, default), RIGHT (1).| |calc\_fnc|<|string|Data to draw if more than one value exists for an item.<br>Possible values:^[1](#footnotes)^ MIN (1), AVG (2, default), MAX (4), ALL (7; minimum, average, and maximum; supported for simple graphs), LAST (9, supported for pie/exploded graphs).| |type|<|string|Graph item type.<br>Possible values:^[1](#footnotes)^ SIMPLE (0, default), GRAPH\_SUM (2; value of the item represents the whole pie; supported for pie/exploded graphs).| |item|<| |(required) Individual item.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.|  ::: noteclassic See also: [Graph item object](manual/api/reference/graphitem/object) (refer to the relevant property with a matching name). :::
ca	##### Elements del gràfic d'equips  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |ordenar|<|integer|Ordre de dibuix. Primer es dibuixa el valor més petit. Es pot emprar per dibuixar línies o regions darrere (o davant) d'una altra.| |drawtype|<|string|Estil de dibuix de l'element del gràfic.<br>Admet per a gràfics NORMAL.<br>Valors possibles:^[1](#footnotes)^ SINGLE\_LINE (0, predeterminat), FILLED\_REGION ( 1), NEGRETA\_LÍNIA (2), LÍNIA DE PUNTS (3), LÍNIA DE GUIOT (4), GRADIENT\_LÍNIA (5).| |color|<|string|Color de l'element (6 símbols, hexadecimal).| |yaxisside|<|string|Lateral del gràfic on es dibuixarà l'escala Y de l'element del gràfic.<br>S'admet per a gràfics NORMAL i Apilat.|<br>Valors possibles:^[1](#footnotes)^ ESQUERRA (0) , per defecte), DRET (1).| |calc\_fnc|<|string|Dades per dibuixar si hi ha més d'un valor per a un element.<br>Valors possibles:^[1](#footnotes)^ MIN (1), AVG (2, predeterminat), MAX (4), TOTS (7; mínim, mitjà i màxim; compatible amb gràfics simples), LAST (9, compatible amb gràfics circulars/explotats).| |tipus|<|string|Tipus d'element de gràfic.<br>Valors possibles:^[1](#footnotes)^ SIMPLE (0, per defecte), GRAPH\_SUM (2; el valor de l'element representa tot el pastís; compatible amb gràfics circulars/explotats).| |element|<| |(obligatori) Element individual.| |<|host|string|(obligatori) Equip de l'element.| |^|clau|string|(obligatori) Clau d'element.|  ::: noteclassic Veieu també: [Objecte d'element gràfic](manual/api/reference/graphitem/object) (consulteu la propietat rellevant amb un nom coincident). :::

en-us	#### Host graphs  |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|Unique identifier of the graph.| |name|<|string|(required) Graph name.| |width|<|integer|Graph width, in pixels.<br>Used for preview and for pie/exploded graphs.<br>Possible values:^[1](#footnotes)^ 20-65535 (default: 900).| |height|<|integer|Graph height, in pixels.<br>Used for preview and for pie/exploded graphs.<br>Possible values:^[1](#footnotes)^ 20-65535 (default: 900).| |yaxismin|<|double|Value of Y axis minimum.<br>Supported for FIXED minimum value of Y axis.<br>Default: 0.| |yaxismax|<|double|Value of Y axis maximum.<br>Supported for FIXED minimum value of X axis.<br>Default: 0.| |show\_work\_period|<|string|Highlight non-working hours.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |show\_triggers|<|string|Display simple trigger values as a line.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |type|<|string|Graph type.<br>Possible values:^[1](#footnotes)^ NORMAL (0, default), STACKED (1), PIE (2), EXPLODED (3).| |show\_legend|<|string|Display graph legend.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |show\_3d|<|string|Enable 3D style.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |percent\_left|<|double|Show the percentile line for left axis.<br>Supported for NORMAL graphs.<br>Default: 0.| |percent\_right|<|double|Show the percentile line for right axis.<br>Supported for NORMAL graphs.<br>Default: 0.| |ymin\_type\_1|<|string|Minimum value of Y axis.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ CALCULATED (0, default), FIXED (1), ITEM (2).| |ymin\_item\_1|<| |(required if `ymin_type_1` is set to `ITEM`) Root element for individual item details.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| |ymax\_type\_1|<|string|Maximum value of Y axis.<br>Supported for NORMAL and STACKED graphs.<br>Possible values:^[1](#footnotes)^ CALCULATED (0, default), FIXED (1), ITEM (2).| |ymax\_item\_1|<| |(required if `ymax_type_1` is set to `ITEM`) Root element for individual item details.| |<|host|string|(required) Item host.| |^|key|string|(required) Item key.| |graph\_items|<| |(required) Root element for [host graph items](#host-graph-items).|  ::: noteclassic See also: [Graph object](manual/api/reference/graph/object) (refer to the relevant property with a matching name). :::
ca	#### Gràfics d'equips  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |uuid|<|string|Identificador únic del gràfic.| |nom|<|string|(obligatori) Nom del gràfic.| |amplada|<|integer|Amplada del gràfic, en píxels.<br>S'empra per a la previsualització i per a gràfics de sectors/explotats.<br>Valors possibles:^[1](#footnotes)^ 20-65535 (per defecte: 900). | |height|<|integer|Alçada del gràfic, en píxels.<br>S'empra per a la previsualització i per a gràfics de sectors/explotats.<br>Valors possibles:^[1](#footnotes)^ 20-65535 (per defecte: 900). | |yaxismin|<|double|Valor mínim de l'eix Y.<br>S'admet per al valor mínim FIX de l'eix Y.<br>Per defecte: 0.| |yaxismax|<|double|Valor màxim de l'eix Y.<br>S'admet per al valor mínim FIX de l'eix X.<br>Per defecte: 0.| |show\_work\_període|<|string|Resalta les hores no laborals.<br>S'admet per a gràfics NORMAL i Apilat.<br>Valors possibles:^[1](#footnotes)^ NO (0), SÍ (1) , per defecte).| |show\_triggers|<|string|Mostra valors d'activació simples com a línia.<br>S'admet per a gràfics NORMAL i Apilat.<br>Valors possibles:^[1](#footnotes)^ NO (0), SÍ (1). , per defecte).| |tipus|<|string|Tipus de gràfic.<br>Valors possibles:^[1](#footnotes)^ NORMAL (0, per defecte), Apilat (1), PIE (2), EXPLOT (3).| |show\_legend|<|string|Mostra la llegenda del gràfic.<br>Valors possibles:^[1](#footnotes)^ NO (0), SÍ (1, predeterminat).| |show\_3d|<|string|Activa l'estil 3D.<br>S'admet per a gràfics NORMAL i APILAT.<br>Valors possibles:^[1](#footnotes)^ NO (0, predeterminat), SÍ (1). | |percent\_left|<|double|Mostra la línia percentil de l'eix esquerre.<br>S'admet per a gràfics NORMAL.<br>Per defecte: 0.| |percent\_right|<|doble|Mostra la línia percentil de l'eix dret.<br>S'admet per a gràfics NORMAL.<br>Per defecte: 0.| |ymin\_type\_1|<|string|Valor mínim de l'eix Y.<br>S'admet per a gràfics NORMAL i APILAT.<br>Valors possibles:^[1](#footnotes)^ CALCULAT (0, predeterminat), FIXED (1), ELEMENT (2).| |ymin\_item\_1|<| |(obligatori si `ymin_type_1` s'estableix a `ITEM`) Element arrel per als detalls de l'element individual.| |<|host|string|(obligatori) Amfitrió de l'element.| |^|clau|string|(obligatori) Clau d'element.| |ymax\_type\_1|<|string|Valor màxim de l'eix Y.<br>S'admet per a gràfics NORMAL i APILAT.<br>Valors possibles:^[1](#footnotes)^ CALCULAT (0, predeterminat), FIXED (1), ELEMENT (2).| |ymax\_item\_1|<| |(necessari si `ymax_type_1` s'estableix en `ITEM`) Element arrel per als detalls de l'element individual.| |<|host|string|(obligatori) Amfitrió de l'element.| |^|clau|string|(obligatori) Clau d'element.| |gràfic\_elements|<| |(obligatori) Element arrel per a [elements del gràfic amfitrió](#host-graph-items).|  ::: noteclassic Veieu també: [Objecte gràfic](manual/api/referència/gràfic/objecte) (consulteu la propietat rellevant amb un nom coincident). :::

en-us	# hostgroup.create
ca	# hostgroup.create

en-us	# hostgroup.delete
ca	# hostgroup.delete

en-us	# hostgroup.get
ca	# hostgroup.get

en-us	# hostgroup.massadd
ca	# hostgroup.massadd

en-us	# hostgroup.massremove
ca	# hostgroup.massremove

en-us	# hostgroup.massupdate
ca	# hostgroup.massupdate

en-us	# Host group object  The following objects are directly related to the `hostgroup` API.
ca	# Objecte Grup d'equips  Els següents objectes són relacionats amb l'API `hostgroup`.

en-us	# hostgroup.propagate  
ca	# hostgroup.propagate  

en-us	##### Host groups, Hosts, Item, Item list  The *Host groups*, *Hosts*, *Item*, and *Item list* (since Zabbix 7.0.1) parameters allow selecting either the respective entities or a data source containing either host groups, hosts or items for which the widget can display data.  For *Host groups*, *Item*, and *Item list* parameters, the data source can be a compatible widget from the same dashboard.  For *Hosts* parameter, the data source can be a compatible widget from the same dashboard or the dashboard itself.  ::: noteclassic The *Map* widget can also broadcast host group and host data to compatible widgets. For more information, see [Widget behavior](#widget-behavior). :::
ca	##### Grups d'equips, Equips, Element  Els paràmetres *Grups d'equips*, *Equips* i *Element*des de Zabbix 7.0.1) permeten triar les entitats respectives o una font de dades que contingui grups d'equips, equips o elements dels quals el giny pot mostrar dades.  Per als paràmetres *Grups d'equips*, *Element* i *Llistat d'elements*, la font de dades pot ser un giny compatible des del mateix tauler.  Per al paràmetre *Equips*, la font de dades pot ser un giny compatible del mateix tauler o del mateix tauler.  ::: noteclassic El giny *Mapa* també pot transmetre dades de grups d'equips i d'equip a ginys compatibles. Per obtindre més informació, veieu [Comportament del giny](#widget-behavior). :::

en-us	 ### Host groups  |Macro|Supported in|Description| |--|--------|--------| |{HOSTGROUP.ID}|→ Map element labels, map URL names and values|*Host group ID.*|
ca	# Grups d'equips  |Macro|Admesa a|Descripció| |--|------|------| |{HOSTGROUP.ID}|→ Etiquetes dels elements del mapa, noms i valors d'URL del mapa|*ID del grup d'equips.*|

en-us	### Host group  The host group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|ID|ID of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |flags|integer|Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.|
ca	### Grup d'equips  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|ID|ID del grup d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions d'actualització| |nom|string|Nom del grup d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |flags|integer|Origen del grup d'equips.<br><br>Valors possibles:<br>0 - un grup d'equips en brut;<br>4 - un grup d'equips descobert.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |uuid|string|Identificador universal únic, emprat per enllaçar els grups d'equips importats als ja existents. Generat automàticament si no es proporciona.|

en-us	# Host group  This class is designed to work with host groups.  Object references:  -   [Host group](/manual/api/reference/hostgroup/object#host_group)  Available methods:  -   [hostgroup.create](/manual/api/reference/hostgroup/create) - create new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) - delete host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieve host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - add related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - remove related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - replace or remove related objects from host groups -   [hostgroup.propagate](/manual/api/reference/hostgroup/propagate) - propagate permissions and tag filters to host groups' subgroups -   [hostgroup.update](/manual/api/reference/hostgroup/update) - update host groups
ca	# Grup d'equips  Aquesta classe és dissenyada per treballar amb grups d'equips.  Referències d'objectes:  -   [Grup d'equips](/manual/api/reference/hostgroup/object#host_group)  Mètodes disponibles:  -   [hostgroup.create](/manual/api/reference/hostgroup/create) - crear grups d'equips -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) - esborrar grups d'equips -   [hostgroup.get](/manual/api/reference/hostgroup/get) - recuperar grups d'equips -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) - afegir objectes als grups d'equips -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) - esborrar objectes dels grups d'equips -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) - reemplaçar o esborrar objectes dels grups d'equips -   [hostgroup.propagate](/manual/api/reference/hostgroup/propagate) - propagar permisos i filtres d'etiqueta a als subgrups de grups d'equips -   [hostgroup.update](/manual/api/reference/hostgroup/update) - actualitzar grups d'equips

en-us	# hostgroup.update
ca	# hostgroup.update

en-us	#### hostgroup  [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: Method now also supports `status` property if `selectGroupDiscoveries` parameter is used.
ca	#### grup d'equips  [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `hostgroup.get`: El mètode ara admet la propietat `status` si s'empra el paràmetre `selectGroupDiscoveres`.

en-us	#### hostgroup  [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed parameters `selectHostPrototype` to `selectHostPrototypes`, `selectDiscoveryRule` to `selectDiscoveryRules`, `selectGroupDiscovery` to `selectGroupDiscoveries`; now each parameter will return an array of objects instead of an object.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Renamed output properties `hostPrototype` to `hostPrototypes`, `discoveryRule` to `discoveryRules`, `groupDiscovery` to `groupDiscoveries`.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Removed support for `groupid` property in `selectGroupDiscoveries` (previously - `selectGroupDiscovery`) parameter.\
ca	#### grup d'equips  [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: Paràmetres reanomenats `selectHostPrototype` a `selectHostPrototypes`, `selectDiscoveryRule` a `selectDiscoveryRules`, `selectGroupDiscovery` a `selectGroupDiscoveries`; ara cada paràmetre retornarà una taula d'objectes enlloc d'un objecte.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: S'han reanomenat les propietats de sortida `hostPrototype` a `hostPrototypes`, `discoveryRule` a `discoveryRules`, `groupDiscovery` a `groupDiscoveries`.\ [ZBXNEXT-8702](https://support.zabbix.com/browse/ZBXNEXT-8702) `hostgroup.get`: S'han tret el suport de la propietat `groupid` al paràmetre `selectGroupDiscoveries` (abans - `selectGroupDiscovery`).\

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
ca	##### HostInterface  Un paràmetre opcional que defineix la interfície de l'equip. La interfície de l'equip s'empra en el procés [autoregistre](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip. Si no es defineix, el valor s'agafarà de HostInterfaceItem.<br>L'agent donarà error i no començarà si el valor supera el límit de 255 caràcters.  Interval: 0-255 caràcters

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
ca	##### HostInterface  Un paràmetre opcional que defineix la interfície de l'equip. La interfície de l'equip s'empra en el procés [autoregistre](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip. Si no es defineix, el valor s'agafarà de HostInterfaceItem.<br>L'agent donarà error i no començarà si el valor supera el límit de 255 caràcters.  Interval: 0-255 caràcters

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
ca	##### HostInterface  Un paràmetre opcional que defineix la interfície de l'equip. La interfície de l'equip s'empra en el procés [autoregistre](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip. Si no es defineix, el valor s'agafarà de HostInterfaceItem.<br>L'agent donarà error i no començarà si el valor supera el límit de 255 caràcters.  Interval: 0-255 caràcters

en-us	##### HostInterface  An optional parameter that defines the host interface. The host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. If not defined, the value will be acquired from HostInterfaceItem.<br>The agent will issue an error and not start if the value is over the limit of 255 characters.  Range: 0-255 characters
ca	##### HostInterface  Un paràmetre opcional que defineix la interfície de l'equip. La interfície de l'equip s'empra en el procés [autoregistre](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip. Si no es defineix, el valor s'agafarà de HostInterfaceItem.<br>L'agent donarà error i no començarà si el valor supera el límit de 255 caràcters.  Interval: 0-255 caràcters

en-us	# hostinterface.create
ca	# hostinterface.create

en-us	# hostinterface.delete
ca	# hostinterface.delete

en-us	# hostinterface.get
ca	# hostinterface.get

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>This option is only used when HostInterface is not defined.
ca	##### HostInterfaceItem  Un paràmetre opcional que defineix un element emprat per obtindre la interfície de l'equip.<br>La interfície de l'equip s'empra al procés [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip.<br>Durant una petició d'autoregistre, l'agent registrarà un missatge d'avís si el valor retornat per l'element especificat supera el límit de 255 caràcters.<br>L'element [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) s'admet independentment dels valors AllowKey/DenyKey.<br>Aquesta opció només s'empra quan HostInterface és sense definir.

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>This option is only used when HostInterface is not defined.
ca	##### HostInterfaceItem  Un paràmetre opcional que defineix un element emprat per obtindre la interfície de l'equip.<br>La interfície de l'equip s'empra al procés [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip.<br>Durant una petició d'autoregistre, l'agent registrarà un missatge d'avís si el valor retornat per l'element especificat supera el límit de 255 caràcters.<br>L'element [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) s'admet independentment dels valors AllowKey/DenyKey.<br>Aquesta opció només s'empra quan HostInterface és sense definir.

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. This option is only used when HostInterface is not defined.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.
ca	##### HostInterfaceItem  Un paràmetre opcional que defineix un element emprat per obtindre la interfície de l'equip.<br>La interfície de l'equip s'empra al procés [autoregistre](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip. Aquesta opció només s'empra quan HostInterface no és definida.<br>L'element [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) s'accepta independentment dels valors AllowKey/DenyKey.<br>Durant una petició d'autoregistre, l'agent registrarà un missatge d'advertència si el valor retornat per l'element especificat supera el límit de 255 caràcters.

en-us	##### HostInterfaceItem  An optional parameter that defines an item used for getting the host interface.<br>Host interface is used at host [autoregistration](/manual/discovery/auto_registration#using_dns_as_default_interface) process. This option is only used when HostInterface is not defined.<br>The [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) item is supported regardless of AllowKey/DenyKey values.<br>During an autoregistration request the agent will log a warning message if the value returned by the specified item is over the limit of 255 characters.
ca	##### HostInterfaceItem  Un paràmetre opcional que defineix un element emprat per obtindre la interfície de l'equip.<br>La interfície de l'equip s'empra al procés [autoregistre](/manual/discovery/auto_registration#using_dns_as_default_interface) de l'equip. Aquesta opció només s'empra quan HostInterface no és definida.<br>L'element [system.run[]](/manual/config/items/itemtypes/zabbix_agent#system.run) s'accepta independentment dels valors AllowKey/DenyKey.<br>Durant una petició d'autoregistre, l'agent registrarà un missatge d'advertència si el valor retornat per l'element especificat supera el límit de 255 caràcters.

en-us	# hostinterface.massadd
ca	# hostinterface.massadd

en-us	# hostinterface.massremove
ca	# hostinterface.massremove

en-us	# Host interface object  The following objects are directly related to the `hostinterface` API.
ca	# Objecte interfície d'equip  Els següents objectes són enllaçats amb l'API `hostinterface`.

en-us	# hostinterface.replacehostinterfaces
ca	# hostinterface.replacehostinterfaces

en-us	#### Host interfaces  |Element|<|Type|Description| |-|---|---|-----------------------| |default|<|string|Whether this is the primary host interface. Note that there can be only one primary interface of one type on a host.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |type|<|string|Interface type.<br>Possible values:^[1](#footnotes)^ ZABBIX (1, default), SNMP (2), IPMI (3), JMX (4).| |useip|<|string|Whether to use IP as the interface for connecting to the host (otherwise, DNS will be used).<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |ip|<|string|(required for IP connections) IP address (IPv4 or IPv6).| |dns|<|string|(required for DNS connections) DNS name.| |port|<|string|Port number.| |details|<| |Root element for interface details.| |<|version|string|Use this SNMP version.<br>Possible values:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, default), SNMP\_V3 (3).| |^|community|string|(required for SNMPv1 and SNMPv2 items) SNMP community.| |^|max_repetitions|string|Max repetition value for native SNMP bulk requests (GetBulkRequest-PDUs).<br>Supported for SNMPv2 and SNMPv3 items (`discovery[]` and `walk[]` items).<br>Default: 10.| |^|contextname|string|SNMPv3 context name.<br>Supported for SNMPv3 items.| |^|securityname|string|SNMPv3 security name.<br>Supported for SNMPv3 items.| |^|securitylevel|string|SNMPv3 security level.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ NOAUTHNOPRIV (0, default), AUTHNOPRIV (1), AUTHPRIV (2).| |^|authprotocol|string|SNMPv3 authentication protocol.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ MD5 (0, default), SHA1 (1), SHA224 (2), SHA256 (3), SHA384 (4), SHA512 (5).| |^|authpassphrase|string|SNMPv3 authentication passphrase.<br>Supported for SNMPv3 items.| |^|privprotocol|string|SNMPv3 privacy protocol.<br>Supported for SNMPv3 items.<br>Possible values:^[1](#footnotes)^ DES (0, default), AES128 (1), AES192 (2), AES256 (3), AES192C (4), AES256C (5).| |^|privpassphrase|string|SNMPv3 privacy passphrase.<br>Supported for SNMPv3 items.| |^|bulk|string|Use bulk requests for SNMP.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |interface\_ref|<|string|Interface reference name to be used in items (format: `if<N>`).|  ::: noteclassic See also: [Host interface object](/manual/api/reference/hostinterface/object) (refer to the relevant property with a matching name). :::
ca	#### Interfícies d'equips  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |default|<|string|Si aquesta és la interfície principal de l'equip. Tingueu en compte que només hi pot haver una interfície principal d'un tipus en un euip.<br>Valors possibles:^[1](#footnotes)^ NO (0), YES (1, predeterminat).| |tipus|<|string|Tipus d'interfície.<br>Valors possibles:^[1](#footnotes)^ ZABBIX (1, predeterminat), SNMP (2), IPMI (3), JMX (4).| |useip|<|string|Si s'ha d'utilitzar la IP com a interfície per connectar-se a l'equip (en cas contrari, emprarà DNS).<br>Valors possibles:^[1](#footnotes)^ NO (0), YES ( 1, per defecte).| |ip|<|string|(necessari per a connexions IP) Adreça IP (IPv4 o IPv6).| |dns|<|string|(necessari per a connexions DNS) Nom DNS.| |port|<|string|Número de port.| |detalls|<| |Element arrel per als detalls de la interfície.| |<|versió|string|Utilitzeu aquesta versió SNMP.<br>Valors possibles:^[1](#footnotes)^ SNMPV1 (1), SNMP\_V2C (2, predeterminat), SNMP\_V3 (3).| |^|community|string|(necessari per als elements SNMPv1 i SNMPv2) Comunitat SNMP.| |^|max_repetitions|string|Valor de repetició màxim per a sol·licituds massives SNMP natives (GetBulkRequest-PDU).<br>S'admet per a elements SNMPv2 i SNMPv3 (elements `discovery[]` i `walk[]`).<br>Per defecte: 10.| |^|contextname|string|Nom de context SNMPv3.<br>S'admet per a elements SNMPv3.| |^|securityname|string|Nom de seguretat SNMPv3.<br>S'admet per a elements SNMPv3.| |^|securitylevel|string|Nivel de seguretat SNMPv3.<br>Admet per a elements SNMPv3.<br>Valors possibles:^[1](#footnotes)^ NOAUTHNOPRIV (0, predeterminat), AUTHNOPRIV (1), AUTHPRIV (2) .| |^|authprotocol|string|Protocol d'autenticació SNMPv3.<br>Admet per a elements SNMPv3.<br>Valors possibles:^[1](#footnotes)^ MD5 (0, predeterminat), SHA1 (1), SHA224 (2) , SHA256 (3), SHA384 (4), SHA512 (5).| |^|frase de pas|string|Frase de pas d'autenticació SNMPv3.<br>S'admet per a elements SNMPv3.| |^|privprotocol|string|Protocol de privadesa SNMPv3.<br>Admet per a elements SNMPv3.<br>Valors possibles:^[1](#footnotes)^ DES (0, predeterminat), AES128 (1), AES192 (2) , AES256 (3), AES192C (4), AES256C (5).| |^|frase de pas priv|string|Frase de pas de privadesa SNMPv3.<br>S'admet per a elements SNMPv3.| |^|bulk|string|Utilitza sol·licituds massives per a SNMP.<br>Valors possibles:^[1](#footnotes)^ NO (0), YES (1, predeterminat).| |interfície\_ref|<|string|Nom de referència de la interfície que s'emprarà als elements (format: `if<N>`).|  ::: noteclassic Veieu també: [Host interface object](/manual/api/reference/hostinterface/object) (consulteu la propietat rellevant amb un nom coincident). :::

en-us	##### Host interfaces  To add custom interfaces, switch the *Interface* selector from "Inherit" to "Custom". Click ![add\_link.png](../../../../assets/en/manual/config/add_link.png) and select the interface type - Zabbix agent, SNMP, JMX, IPMI.  ::: noteclassic If *Custom* is selected, but no interfaces have been set, the hosts will be created without interfaces.<br> If *Inherit* is selected and the host prototype belongs to a template, all discovered hosts will inherit the host interface from the host to which the template is linked. :::  If multiple custom interfaces are specified, the primary interface can be set in the *Default* column.  For an example of how to configure a custom host interface, see [*VMware monitoring setup example*](/manual/vm_monitoring/example#advanced-host-interface-configuration).  ::: notewarning A host will only be created if a host interface contains correct data. :::
ca	### Interfícies d'equips  Per afegir interfícies personalitzades, canvieu el selector "Interfície" del mode "Heretar" al mode "Personalitzat". A continuació, premeu ![add\_link.png](../../../../assets/en/manual/config/add_link.png) i trieu el tipus d'interfície - agent Zabbix, SNMP, JMX, IPMI.  ::: noteclassic Si es tria *Personalitzar*, però no s'ha especificat cap interfície, els equips es crearan sense interfícies. Si es tria *Heretar* per a un prototip d'equip que pertany a una plantilla, els equips descoberts heretaran la interfície d'un equip al que és enllaçada la plantilla. :::  Si s'especifiquen diverses interfícies personalitzades, empreu la columna *Predeterminada* per especificar la interfície principal.  Per obtindre un exemple de com configurar una interfície d'equip personalitzada, veieu l'[*exemple de configuració del monitoratge de VMware*](/manual/vm_monitoring/example#advanced-host-interface-configuration).  ::: notewarning No es crearà un equip si una interfície d'equip conté dades incorrectes. :::

en-us	### Host interface  The host interface object has the following properties.  ::: noteimportant Note that both `ip` and `dns` properties are *required* for create operations. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |interfaceid|ID|ID of the interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |available|integer|Availability of host interface.<br><br>Possible values:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |hostid|ID|ID of the host that the interface belongs to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |type|integer|Interface type.<br><br>Possible values:<br>1 - Agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |ip|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |dns|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |port|string|Port number used by the interface.<br>Can contain user macros.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |useip|integer|Whether the connection should be made via IP.<br><br>Possible values:<br>0 - connect using host DNS name;<br>1 - connect using host IP address.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |main|integer|Whether the interface is used as default on the host. Only one interface of some type can be set as default on a host.<br><br>Possible values:<br>0 - not default;<br>1 - default.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |details|array|Additional [details](#details) object for interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `type` is set to "SNMP"| |disable\_until|timestamp|The next polling time of an unavailable host interface.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |error|string|Error text if host interface is unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |errors\_from|timestamp|Time when host interface became unavailable.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
ca	### Interfície d'equip  L'objecte d'interfície d'equip té les propietats següents.  ::: nota important Tingueu en compte que les propietats `IP` i `DNS` són *obligatòries*. Si no s'ha d'emprar DNS, configureu-lo en una cadena buida. :::  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |interfaceid|ID|ID de la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |available|integer|Disponibilitat de la interfície de l'equip.<br><br>Els valors possibles són:<br>0 - *(per defecte)* desconegut;<br>1 - disponible;<br>2 - no disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |hostid|ID|ID de l'equip al que pertany la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatori* per operacions de creació| |tipus|integer|Tipus d'interfície.<br><br>Valors possibles:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI; <br> >4 - JMX.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |ip|string|adreça IP emprada per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant DNS.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |dns|string|Nom DNS emprat per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant IP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |port|string|Nombre de port emprat per la interfície.<br>Pot contindre macros d'usuari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |useip|integer|Indica si la connexió s'ha d'establir mitjançant IP.<br><br>Valors possibles:<br>0 - connecteu-vos amb el nom DNS de l'equip;<br>1 - connecteu-vos mitjançant l'adreça IP de l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |main|integer|Indica si la interfície s'empra per defecte a l'equip. Només es pot configurar per defecte una interfície d'un tipus determinat en un host.<br><br>Valors possibles:<br>0 - no (per defecte);<br>1 - predeterminat.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |details|array|Objecte addicional per a la interfície.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `type` és "SNMP"| |disable\_until|timestamp|La propera vegada que es consulta una interfície d'equip no disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |error|cadena|Text d'error si la interfície de l'equip no és pas disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |errors\_from|timestamp|Hora en què la interfície de l'equip no va estar disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|

en-us	# Host interface  This class is designed to work with host interfaces.  Object references:  -   [Host interface](/manual/api/reference/hostinterface/object#host_interface) -   [Details](/manual/api/reference/hostinterface/object#details)  Available methods:  -   [hostinterface.create](/manual/api/reference/hostinterface/create) - create new host interfaces -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) - delete host interfaces -   [hostinterface.get](/manual/api/reference/hostinterface/get) - retrieve host interfaces -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - add host interfaces to hosts -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - remove host interfaces from hosts -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) - replace host interfaces on a host -   [hostinterface.update](/manual/api/reference/hostinterface/update) - update host interfaces
ca	# Interfícies d'equips  Aquesta classe és dissenyada per treballar amb interfícies d'equips.  Referències d'objectes:\  -   [Interfície d'equips](/manual/api/reference/hostinterface/object#host_interface) -   [Detalls](/manual/api/reference/hostinterface/object#details)  Mètodes disponibles:\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) - crear interfícies d'equips -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) - esborrar interfícies d'equips -   [hostinterface.get](/manual/api/reference/hostinterface/get) - recuperar interfícies d'equips -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) - afegir objectes als interfícies d'equips -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) - esborrar objectes dels interfícies d'equips -   [hostinterface.replacehostinterfaces (/manual/api/reference/hostinterface/replacehostinterfaces) - reemplaçar les interfícies d'un equip -   [hostinterface.update](/manual/api/reference/hostinterface/update) - actualitzar interfícies d'equips

en-us	# hostinterface.update
ca	# hostinterface.update