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/browse?at=refs%2Fheads%2Frelease%2F6.0)|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. | |[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 Go  |Requisit|Estat obligatori|Versió mínima|Descripció| |--|-|-|-------| |[git.zabbix.com/ap/plugin-support](https://git.zabbix.com/projects/AP/repos/plugin-support)|Sí|1.X.X|Biblioteca d'assistència pròpia de Zabbix. Principalment per a connectors. | |[go.mongodb.org/mongo-driver](https://go.mongodb.org/mongo-driver)|^|1.7.6|Bloqueig 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. | |[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 fa ús de l'agent. És necessari ja que Zabbix empra la biblioteca que empra el paquet.

en-us	### Go library for Windows updated  Go library used by Zabbix agent 2 in conjunction with MongoDB or PostgreSQL plugins to monitor Windows now is `github.com/Microsoft/go-winio`, version 0.6.0 (previously `github.com/natefinch/npipe`). See also [Go libraries](/manual/installation/requirements#agent-2), [MongoDB plugin dependencies](/manual/installation/requirements/plugins/mongodb), and [PostgreSQL plugin dependencies](/manual/installation/requirements/plugins/postgresql).
ca	### Biblioteca Go actualitzada per a Windows  La biblioteca Go emprada per l'agent Zabbix 2 amb connectors de MongoDB o PostgreSQL per monitorar Windows és ara `github.com/Microsoft/go-winio`, versió 0.6.0 (abans `github.com/natefinch/npipe`). Veieu també [Biblioteques Go](/manual/installation/requirements#golang-libraries), [Dependències del connector MongoDB](/manual/installation/requirements/plugins/mongodb) i [Dependències del connector PostgreSQL](/manual/installation/requisits/connectors/postgresql).

en-us	 ### Google Cloud Platform Monitoring  A new [template](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloud/gcp) *Google Cloud Platform by HTTP (GCP by HTTP)* is available.  See setup instructions for [HTTP templates](/manual/config/templates_out_of_the_box/http).  You can get this template:  - In *Configuration → Templates* in new installations. - If you are upgrading from previous versions, you can download this template from Zabbix [Git repository](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) or find it in the *zabbix/templates* directory of the downloaded latest Zabbix version. Then, while in *Configuration → Templates* you can import it manually into Zabbix.
ca	### Monitoratge de la plataforma Google Cloud  Hi ha disponible una nova [plantilla](https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates/cloudgcp) *Google Cloud Platform per HTTP GCP per HTTP)*.  Veieu les instruccions de configuració per [plantilles HTTP](/manual/config/templates_out_of_the_box/http).  Podeu obtindre aquesta plantilla:  -   A *Configuració → Plantilles*, a les noves instal·lacions; -   si sou actualitzant de versions anteriors, podeu descarregar aquestes plantilles des del [repositori Git] de Zabbix (https://git.zabbix.com/projects/ZBX/repos/zabbix/browse/templates) o obtindre-les des del directori `templates` de la darrera versió descarregada de Zabbix. Després, dins de *Configuració* → *Plantilles* podeu importar-les manualment cap al Zabbix.

en-us	#### graph  Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: Graph availability doesn't depend on permissions to items specified in graph "ymin_itemid" and "ymax_itemid" fields.\ Graph having MIN or MAX Y axis linked to inaccessible items will still be accessible but MIN/MAX Y axis works the same way as if specified calculation method is "Calculated".\
ca	#### gràfic  Canvis:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graph.get`: La disponibilitat del gràfic no depèn dels permisos dels elements especificats als camps del gràfic "ymin_itemid" i "ymax_itemid".\ El gràfic amb l'eix MIN o MAX Y vinculat a elements inaccessibles seguirà essent accessible; però l'eix MIN/MAX Y funciona igual que si el mètode de càlcul especificat fos "Calculated".\

en-us	#### graph  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: the parameter `uuid` can now be updated.\
ca	#### gràfic  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graph.update`: el paràmetre `uuid` ara es pot actualitzar.\

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|string|*(readonly)* ID of the graph item.| |**color**<br>(required)|string|Graph item's draw color as a hexadecimal color code.| |**itemid**<br>(required)|string|ID of the item.| |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|string|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|string|*(només lectura)* ID de l'element del gràfic.| |**color**<br>(obligatori)|string|Traceu el color de l'element del gràfic com a codi de color hexadecimal.| |**item**<br>(obligatori)|string|ID de l'element.| |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|string|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) - retrieving     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  Changes:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: Graph prototype availability doesn't depend on permissions to items specified in graph prototype "ymin_itemid" and "ymax_itemid" fields.\
ca	#### prototip gràfic  Canvis:\ [ZBX-7706](https://support.zabbix.com/browse/ZBX-7706) `graphprototype.get`: La disponbilitat del prototip de gràfic no depèn pas dels permisos per a items triats als camps de prototip gràfic "ymin_itemid" i "ymax_itemid".\

en-us	#### graphprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: the parameter `uuid` can now be updated.\
ca	#### prototipus de gràfic  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `graphprototype.update`: el paràmetre `uuid` ara es pot actualitzar.\

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|string|*(readonly)* ID of the graph prototype.| |**height**<br>(required)|integer|Height of the graph prototype in pixels.| |**name**<br>(required)|string|Name of the graph prototype.| |**width**<br>(required)|integer|Width of the graph prototype in pixels.| |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|string|*(readonly)* ID of the parent template graph prototype.| |yaxismax|float|The fixed maximum value for the Y axis.| |yaxismin|float|The fixed minimum value for the Y axis.| |ymax\_itemid|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (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|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymin\_type would be set to '0' (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. Used only for graph prototypes on templates. Auto-generated, if not given.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
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|string|*(només de lectura)* ID del prototipus de gràfic.| |**height**<br>(obligatori)|integer|Alçada del gràfic del prototipus en píxels.| |**name**<br>(obligatori)|string|Nom del prototipus de gràfic.| |**width**<br>(obligatori)|integer|Amplada del prototipus de gràfic en píxels.| |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|string|*(només lectura)* ID de prototipus de gràfic de la plantilla principal.| |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|string|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|string|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.| |discover|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|string|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.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

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) -     creating new graph prototypes -   [graphprototype.delete](/manual/api/reference/graphprototype/delete) -     deleting graph prototypes -   [graphprototype.get](/manual/api/reference/graphprototype/get) -     retrieving graph prototypes -   [graphprototype.update](/manual/api/reference/graphprototype/update) -     updating 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  ##### 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|string|*(readonly)* ID of the graph.| |**height**<br>(required)|integer|Height of the graph in pixels.| |**name**<br>(required)|string|Name of the graph| |**width**<br>(required)|integer|Width of the graph in pixels.| |flags|integer|*(readonly)* Origin of the graph.<br><br>Possible values are:<br>0 - *(default)* a plain graph;<br>4 - a discovered graph.| |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|string|*(readonly)* ID of the parent template graph.| |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|string|ID of the item that is used as the maximum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (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|string|ID of the item that is used as the minimum value for the Y axis.<br><br>Starting with Zabbix 6.0.7, if user have no access to specified item, the graph is rendered like ymax\_type would be set to '0' (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. Used only for graphs on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Gràfic  L'objecte gràfic té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |graphid|string|*(només lectura)* ID del gràfic.| |**altura**<br>(obligatori)|integer|Alçada del gràfic en píxels.| |**nom**<br>(obligatori)|string|Nom del gràfic.| |**amplada**<br>(obligatori)|integer|Amplada del gràfic en píxels.| |flags|integer|*(només de lectura)* 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. | |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. | |mostra\_legenda|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|string|*(només de lectura)* ID del gràfic de plantilla principal.| |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|string|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|string|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. S'empra només per a gràfics de models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només de lectura*.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

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) - creating new     graphs -   [graph.delete](/manual/api/reference/graph/delete) - deleting graphs -   [graph.get](/manual/api/reference/graph/get) - retrieving graphs -   [graph.update](/manual/api/reference/graph/update) - updating 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	### Group link  The group link object links a host prototype with a host group and has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**groupid**<br>(required)|string|ID of the host group.|
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**<br>(obligatori)|cadena|ID del grup d'equips.|

en-us	### Group prototype  The group prototype object defines a group that will be created for a discovered host and has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Name of the group prototype.|
ca	### Prototipus 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**<br>(obligatori)|string|Nom del prototip del grup.|

en-us	#### groups/group  |Parameter|Type|Description|Details| |---------|----|-----------|-------| |name|*string*|Group name.| |
ca	#### grups/grup  |Paràmetre|Tipus|Descripció|Detalls| |---------|----|-----------|-------| |nom|*cadena*|Nom del grup.| |

en-us	#### Guest user authorization  Automatic login for the guest user has been removed. After this change, the guest user will need to log in like any other user. Previously, a guest could immediately get to almost any monitoring or reporting page without going through authorization.
ca	#### Autorització d'usuari convidat  S'ha tret l'inici de sessió automàtic per a l'usuari convidat. Després d'aquest canvi, l'usuari convidat haurà d'iniciar sessió com qualsevol altre usuari. Abans, un convidat podia accedir immediatament a gairebé qualsevol pàgina de seguiment o d'informe sense tindre pas autorització.

en-us	#### GUI debugging  Problems related to the frontend performance may be diagnosed using the frontend [debug mode](/manual/web_interface/debug_mode).
ca	#### Depuració de la interfície gràfica  Els problemes vinculats al rendiment de la interfície poden ésser diagnosticats emprant la interfície en [mode depuració](/manual/web_interface/debug_mode).

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 *Configuration → 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.<br>This parameter is supported since Zabbix 2.0.1.| |*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 (since Zabbix 3.4.0).| |*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/administration/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.<br>Aquesta configuració és compatible des de Zabbix 2.0.1.| |*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 (des de Zabbix 3.4.0).| |*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., 10 m (deu minuts), 5 w (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 NaN values in Prometheus preprocessing  There is a new behavior for handling (skipping) NaN values. So, if a dataset consists of  valid numeric values and NaNs, then NaN values are skipped and:  -   'avg', 'max', 'min', 'sum' return a result that is calculated from the valid values -   'count' returns the number of valid values  If all values in a dataset are NaNs then 'avg', 'max', 'min', and 'sum' return a "no data  (at least one value is required)" error, while 'count' returns 0.  Previously, if NaN was the first value in a dataset then:  -   'avg', 'max', 'min', 'sum' returned a "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" error -   'count' returned the number of values (including NaN values)  Also previously, if NaN was not the first value in a dataset then:  -   'avg', 'sum' returned a "Value "NAN" of type "string" is not suitable for \ value type "Numeric (float)"" error -   'max' returned the maximum of values until the first NaN was encountered -   'min' returned the minimum of values until the first NaN was encountered -   'count' returned the number of values (including NaN values)
ca	### Gestió de valors de NaN al preprocessament de Prometheus  Hi ha un comportament nou per manejar (ometre) els valors de NaN. Així, si un conjunt de dades consta de valors numèrics i NaN vàlids, els valors de NaN s'ignoren i:  - 'avg', 'màx', 'min', 'sum' retornen un resultat calculat a partir dels valors vàlids - 'count' retorna el nombre de valors vàlids  Si tots els valors d'un conjunt de dades són NaN, aleshores "mitjana", "màx", "mín" i "suma" retornen "no hi ha dades (es requereix almenys un valor)", mentre que "recompte" retorna 0.  Abans, si NaN era el primer valor d'un conjunt de dades, aleshores:  - 'avg', 'màx', 'min', 'sum' retornant un error "El valor "NAN" de tipus "cadena" no és adequat per al tipus de valor "Numèric (flotant)"" - 'count' retorna el nombre de valors (inclosos els valors de NaN)  També abans, si NaN no era el primer valor d'un conjunt de dades, aleshores:  - 'avg', 'sum' retornen l'error "El valor "NAN" del tipus "cadena" no és adequat per al tipus de valor "Numèric (flotant)"" - 'max' retorna el màxim de valors fins que es troba el primer NaN - 'min' retorna el mínim de valors fins que es troba el primer NaN - 'count' retorna el nombre de valors (inclosos els valors de NaN)

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).   Note that the logging of regular expression runtime errors is supported since Zabbix 6.0.21.  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, llavors l'element passa a l'estat NO ADMÈS 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 essent compatible i el monitoratge continua. L'error d'execució es registra al fitxer de registre de l'agent Zabbix (sense el registre del fitxer de registre).  Tingueu en compte que el registre d'errors d'execució d'expressions regulars és compatible des de Zabbix 6.0.21.  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 registre al registre de l'agent.  Excepció: si MaxLinesPerSecond=1 i l'interval d'actualització=1 (només es permet analitzar 1 registre per comprovació), no es registren els errors d'execució de l'expressió regular.  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	#### Hardware
ca	#### Maquinari

en-us	#### Hardware  General advice on hardware:  -   Use fastest processor available -   SCSI or SAS is better than IDE (performance of IDE disks may be     significantly improved by using utility hdparm) and SATA -   15K RPM is better than 10K RPM which is better than 7200 RPM -   Use fast RAID storage -   Use fast Ethernet adapter -   Having more memory is always better
ca	#### Material  Consells generals sobre el material:       * Empreu el processador més ràpid possible      * SCSI ou SAS és millor que IDE (el rendiment dels discs IDE poden millorar-se considerablement emprant hdparm) i SATA      * 15K RPM és millor que 10K RPM, que a la vegada és millor que no pas 7200 RPM      * Emprar un emmagatzematge RAID ràpid      * Emprar un adaptador de xarxa ràpid      * Tindre quanta més memòria, millor

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.  **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.  **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_5.2.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_5.2.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	##### Hidden menu  Even when the menu is hidden completely, a full menu is just one mouse click away, by clicking on the burger icon. 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. 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, it is suggested to limit access to the file `ui/data/top_passwords.txt` by modifying web server configuration. This file contains a list of the most common and context-specific passwords, and is used to prevent users from setting such passwords if *Avoid easy-to-guess passwords* parameter is enabled in the [password policy](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  For example, on NGINX file access can be limited by using the `location` directive:  ```ini location = /data/top_passwords.txt {     deny all;     return 404; } ```  On Apache - by using `.htaccess` file:  ```ini <Files "top_passwords.txt">     Order Allow,Deny     Deny from all </Files> ```
ca	#### Amagar l'arxiu amb la llista de mots de pas comuns  Per augmentar 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` modificant la configuració del servidor web. Aquest fitxer conté una llista dels mots de pas més comuns i específics del context, i s'empra per evitar que els usuaris estableixin aquests mots de pas si la configuració *Evitar mots de pas fàcils d'endevinar* és activada a la [política de seguretat dels mots de pas](/manual/web_interface/frontend_sections/administration/authentication#internal_authentication).  Per exemple, sota NGINX, l'accés als fitxers es pot limitar emprant la directiva "location":     ```     location = /data/top_passwords.txt {​​​​​​​         deny all;         return 404;     }​​​​​​​    ```  Sota Apache - emprant l'arxiu `.htaccess`:  ```ini     <Files "top_passwords.txt">         Order Allow,Deny       Deny from all     </Files> ```

en-us	#### High availability cluster for Zabbix server  The new version comes with a native high availability solution for Zabbix server.  The solution consists of multiple zabbix\_server instances or nodes, where only one node can be active (working) at a time, while other nodes are on standby, ready to take over in case the current node is stopped or fails.  See also: [High availability cluster](/manual/concepts/server/ha).
ca	### Cluster d'alta disponibilitat per al servidor Zabbix  La nova versió inclou una solució nadiua d'alta disponibilitat per al servidor Zabbix.  La solució consta de múltiples instàncies o nodes de zabbix\_server, on només un node pot ésser actiu (funcionant) alhora, mentre que els altres nodes són en espera, preparats per fer-se càrrec en cas que el node actual sigui caigut o falli.  Veieu també: [Cluster d'alta disponibilitat](/manual/concepts/server/ha).

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|string|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, t.i. 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|string|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: 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#hanode)  Available methods:\  -   [hanode.get](/manual/api/reference/hanode/get) - retrieving 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#hanode)  Mètodes disponibles:\  -   [hanode.get](/manual/api/reference/hanode/get) - consultar els nodes

en-us	#### history  Changes:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) added new API method `history.clear`.\
ca	#### historial  Canvis:\ [ZBXNEXT-6714](https://support.zabbix.com/browse/ZBXNEXT-6714) afegit un nou mètode d'API `history.clear`.\

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

en-us	#### History functions  |FUNCTION|<|<| |--|--|--| |**Description**|**Function-specific parameters**|**Comments**| |**change** (/host/key)|<|<| |The amount of difference between the previous and latest value.| |Supported value types: float, int, str, text, log<br><br>For strings returns:<br>0 - values are equal<br>1 - values differ<br><br>Example:<br>=> **change**(/host/key)>10<br><br>Numeric difference will be calculated, as seen with these incoming example values ('previous' and 'latest' value = difference):<br>'1' and '5' = `+4`<br>'3' and '1' = `-2`<br>'0' and '-2.5' = `-2.5`<br><br>See also: [abs](/manual/appendix/functions/math) for comparison| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Number of changes between adjacent values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**mode** (optional; must be double-quoted)<br><br>Supported `modes`:<br>*all* - count all changes (default)<br>*dec* - count decreases<br>*inc* - count increases|Supported value types: float, int, str, text, log<br><br>For non-numeric value types, *mode* parameter is ignored.<br><br>Examples:<br>=> **changecount**(/host/key, 1w) → number of value changes for the last week until [now](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → number of value increases (relative to the adjacent value) among the last 10 values<br>=> **changecount**(/host/key,24h,"dec") → number of value decreases (relative to the adjacent value) for the last 24 hours until [now](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Number of values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **count**(/host/key,**10m**) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,**10m**,"like","error") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **count**(/host/key,**10m**,,12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that equal '12'<br>=> **count**(/host/key,**10m**,"gt",12) → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**\#10**,"gt",12) → number of values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt",12) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **count**(/host/key,**10m**,"bitand","6/7") → number of values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **count**(/host/key,**10m:now-1d**) → number of values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Number of unique values within the defined evaluation period.|See [common parameters](#common-parameters).<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - matches if contains pattern (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** (optional) - required pattern (string arguments must be double-quoted)|Supported value types: float, integer, string, text, log<br><br>Float items match with the precision of 2.22e-16; if database is [not upgraded](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) the precision is 0.000001.<br><br>With *bitand* as the third parameter, the fourth `pattern` parameter can be specified as two numbers, separated by '/': **number\_to\_compare\_with/mask**. count() calculates "bitwise AND" from the value and the *mask* and compares the result to *number\_to\_compare\_with*. If the result of "bitwise AND" is equal to *number\_to\_compare\_with*, the value is counted.<br>If *number\_to\_compare\_with* and *mask* are equal, only the *mask* need be specified (without '/').<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings. For the purpose of regexp matching, float values will always be represented with 4 decimal digits after '.'. Also note that for large numbers difference in decimal (stored in database) and binary (used by Zabbix server) representation may affect the 4th decimal digit.<br><br>Examples:<br>=> **countunique**(/host/key,**10m**) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key,**10m**,"like","error") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that contain 'error'<br>=> **countunique**(/host/key,**10m**,"gt",12) → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**\#10**,"gt",12) → number of unique values within the last 10 values until [now](/manual/config/triggers#evaluation_period) that are over '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period) that were over '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → number of unique values for the last 10 minutes until [now](/manual/config/triggers#evaluation_period) having '110' (in binary) in the 3 least significant bits.<br>=> **countunique**(/host/key,**10m:now-1d**) → number of unique values between 24 hours and 10 minutes and 24 hours ago from [now](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operator>,<pattern>)|<|<| |Find a value match.|See [common parameters](#common-parameters).<br><br>**sec** or **\#num** (optional) - defaults to the latest value if not specified<br><br>**operator** (optional; must be double-quoted)<br><br>Supported `operators`:<br>*eq* - equal (default for integer, float)<br>*ne* - not equal<br>*gt* - greater<br>*ge* - greater or equal<br>*lt* - less<br>*le* - less or equal<br>*like* (default for string, text, log) - value contains the string given in `pattern` (case-sensitive)<br>*bitand* - bitwise AND<br>*regexp* - case-sensitive match of the regular expression given in `pattern`<br>*iregexp* - case-insensitive match of the regular expression given in `pattern`<br><br>Note that:<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *band*, *regexp*, *iregexp* are supported for integer items<br>*eq* (default), *ne*, *gt*, *ge*, *lt*, *le*, *regexp*, *iregexp* are supported for float items<br>*like* (default), *eq*, *ne*, *regexp*, *iregexp* are supported for string, text and log items<br><br>**pattern** - required pattern (string arguments must be double-quoted); [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) regular expression if `operator` is *regexp*, *iregexp*.|Supported value types: float, int, str, text, log<br><br>Returns:<br>1 - found<br>0 - otherwise<br><br>If more than one value is processed, '1' is returned if there is at least one matching value.<br><br>With *regexp* or *iregexp* as the third parameter, the fourth `pattern` parameter can be an ordinary or [global](/manual/regular_expressions#global_regular_expressions) (starting with '@') regular expression. In case of global regular expressions case sensitivity is inherited from global regular expression settings.<br><br>Example:<br>=> **find**(/host/key,**10m**,"like","error") → find a value that contains 'error' within the last 10 minutes until [now](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<| |The first (the oldest) value within the defined evaluation period.|See [common parameters](#common-parameters).|Supported value types: float, int, str, text, log<br><br>Example:<br>=> **first**(/host/key,**1h**) → retrieve the oldest value within the last hour until [now](/manual/config/triggers#evaluation_period)<br><br>See also last().| |**fuzzytime** (/host/key,sec)|<|<| |Checking how much the passive agent time differs from the Zabbix server/proxy time.|See [common-parameters](#common parameters).|Supported value types: float, int<br><br>Returns:<br>1 - difference between the passive item value (as timestamp) and Zabbix server/proxy timestamp (clock of value collection) is less than or equal to T seconds<br>0 - otherwise<br><br>Usually used with the 'system.localtime' item to check that local time is in sync with the local time of Zabbix server. *Note* that 'system.localtime' must be configured as a [passive check](/manual/appendix/items/activepassive#passive_checks).<br>Can be used also with vfs.file.time\[/path/file,modify\] key to check that file didn't get updates for long time.<br><br>Example:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detect a problem if the time difference is over 60 seconds<br><br>This function is not recommended for use in complex trigger expressions (with multiple items involved), because it may cause unexpected results (time difference will be measured with the most recent metric), e.g. in `fuzzytime(/Host/system.localtime,60s)=0 or last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<| |The most recent value.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: float, int, str, text, log<br><br>Take note that a hash-tagged time period (\#N) works differently here than with many other functions.<br>For example:<br>last() is always equal to last(\#1)<br>last(\#3) - third most recent value (*not* three latest values)<br><br>Zabbix does not guarantee the exact order of values if more than two values exist within one second in history.<br><br>Example:<br>=> **last**(/host/key) → retrieve the last value<br>=> **last**(/host/key,**\#2**) → retrieve the previous value<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key,**\#2**) → the last and previous values differ<br><br>See also first().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Checking if event ID of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<| |Log severity of the last log entry.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value|Supported value types: log<br><br>Returns:<br>0 - default severity<br>N - severity (integer, useful for Windows event logs: 1 - Information, 2 - Warning, 4 - Error, 7 - Failure Audit, 8 - Success Audit, 9 - Critical, 10 - Verbose).<br>Zabbix takes log severity from **Information** field of Windows event log.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Checking if log source of the last log entry matches a regular expression.|See [common parameters](#common-parameters).<br><br>**\#num** (optional) - the Nth most recent value<br><br>**pattern** (optional) - regular expression describing the required pattern, [Perl Compatible Regular Expression](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) style (string arguments must be double-quoted).|Supported value types: log<br><br>Returns:<br>0 - does not match<br>1 - matches<br><br>Normally used for Windows event logs. For example, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Check if there has been a monotonous decrease in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is smaller or the same as the previous one; default) or *strict* (every value has decreased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously decrease, 0 otherwise.<br><br>Example:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calculate in how many hosts there has been a decrease in free swap size| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Check if there has been a monotonous increase in values.|See [common parameters](#common-parameters).<br><br>**mode** (must be double-quoted) - *weak* (every value is bigger or the same as the previous one; default) or *strict* (every value has increased)|Supported value types: int<br><br>Returns 1 if all elements in the time period continuously increase, 0 otherwise.<br><br>Example:<br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - check if system local time has been increasing consistently| |**nodata** (/host/key,sec,<mode>)|<|<| |Checking for no data received.|See [common parameters](#common-parameters).<br><br>**sec** period should not be less than 30 seconds because the history syncer process calculates this function only every 30 seconds.<br><br>nodata(/host/key,0) is disallowed.<br><br>**mode** - if set to *strict* (double-quoted), this function will be insensitive to proxy availability (see comments for details).|All value types are supported.<br><br>Returns:<br>1 - if no data received during the defined period of time<br>0 - otherwise<br><br>Since Zabbix 5.0, the 'nodata' triggers monitored by proxy are, by default, sensitive to proxy availability - if proxy becomes unavailable, the 'nodata' triggers will not fire immediately after a restored connection, but will skip the data for the delayed period. Note that for passive proxies suppression is activated if connection is restored more than 15 seconds and no less than 2 & ProxyUpdateFrequency seconds later. For active proxies suppression is activated if connection is restored more than 15 seconds later.<br><br>To turn off sensitiveness to proxy availability, use the third parameter, e.g.: **nodata**(/host/key,**5m**,**"strict"**); in this case the function will work the same as before 5.0.0 and fire as soon as the evaluation period (five minutes) without data has past.<br><br>Note that this function will display an error if, within the period of the 1st parameter:<br>- there's no data and Zabbix server was restarted<br>- there's no data and maintenance was completed<br>- there's no data and the item was added or re-enabled<br>Errors are displayed in the *Info* column in trigger [configuration](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>This function may not work properly if there are time differences between Zabbix server, proxy and agent. See also: [Time synchronization requirement](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<| |P-th percentile of a period, where P (percentage) is specified by the third parameter.|See [common parameters](#common-parameters).<br><br>**percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point|Supported value types: float, int| |**rate** (/host/key,sec<:time shift>)|<|<| |Per-second average rate of the increase in a monotonically increasing counter within the defined time period.|See [common parameters](#common-parameters).|Supported value types: float, int<br><br>Functionally corresponds to '[rate](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)' of PromQL.<br><br>Example:<br>=> **rate**(/host/key,**30s**) → If the monotonic increase over 30 seconds is 20, this function will return 0.67.|
ca	#### Funcions d'històric  |FUNCIÓ|<|<| |--|--|--| |**Descripció**|**Paràmetres específics de la funció**|**Comentaris**| |**change** (/host/key)|<|<| |La quantitat de diferència entre el valor anterior i l'últim.| |Tipus de valors admesos: float, int, str, text, log<br><br>Per a les cadenes retorna:<br>0 - els valors són iguals<br>1 - els valors són diferents<br><br>Exemple:<br> => **change**(/host/key)>10<br><br>Es calcularà la diferència numèrica, tal com es veu en aquests valors d'exemple entrants (valor 'anterior' i 'darrer' = diferència):<br> "1" i "5" = "+4"<br>"3" i "1" = "-2"<br>"0" i "-2,5" = "-2,5"<br><br>Veieu també: [abs](/manual/apèndix/funcions/matemàtiques) per a la comparació| |**changecount** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Nombre de canvis entre valors adjacents dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (opcional; s'ha de fer entre cometes)<br>< br>Modes admesos:<br>*all* - comptar tots els canvis (predeterminat)<br>*dec* - recompte disminueix<br>*inc* - recompte augmenta|Tipus de valors admesos: float, int, str, text , registre<br><br>Per als tipus de valors no numèrics, el paràmetre *mode* s'ignora.<br><br>Exemples:<br>=> **changecount**(/host/key, 1w) → nombre de canvis de valor durant la darrera setmana fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **changecount**(/host/key,\#10,"inc") → nombre d'augments de valor (en relació amb el valor adjacent) entre els darrers 10 valors<br>=> **changecount**(/host/key,24h,"dec") → el nombre de disminucions de valor (en relació amb el valor adjacent) durant le darreres 24 hores fins a [ara](/manual/config/triggers#evaluation_period)| |**count** (/host/key,(sec\|\#num)<:time shift>,<operador>,<pattern>)|<|<| |Nombre de valors dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**operador** (opcional; ha d'ésser entre cometes)<br><br>Admet `operadors`:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - major de<br>*ge* - major o igual<br>*lt* - menor de <br>*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - concordança sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br><br>**patró** (opcional) - patró obligatori (els arguments de cadena han d'ésser entre cometes dobles)|Tipus de valors admesos: flotant, enter, cadena, text, registre<br><br>Els elements flotants coincideixen amb la precisió de 2.22e-16; si la base de dades no és [actualitzada](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) la precisió és de 0,000001.<br><br>Amb *bitand* com a tercer paràmetre, el quart paràmetre `patró` es pot especificar com a dos nombres, separats per "/": **nombre\_a\_comparar\_amb/màscara**. count() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre\_a\_comparar\_amb*. Si el resultat de "AND bit a bit" és igual a *nombre\_a\_comparar\_amb*, es compta el valor.<br>Si *nombre\_a\_comparar\_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions# global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.<br><br>Exemples:<br>=> **count**(/ host/key,**10m**) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **count**(/host/key,* *10m**,"like","error") → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que contenen "error"<br>=> **count**(/host/key,**10m**,,12) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que són iguals a '12'<br>=> * *count**(/host/key,**10m**,"gt",12) → nombre de valors dels darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que són superiors a '12 '<br>=> **count**(/host/key,**\#10**,"gt",12) → nombre de valors dins dels darrers 10 valors fins a [ara](/manual/config/ triggers#evaluation_period) que superen '12'<br>=> **count**(/host/key,**10m:now-1d**,"gt" ,12) → nombre de valors entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period) que eren superiors a '12'<br>=> **count**(/host /key,**10m**,"bitand","6/7") → nombre de valors dels darrers 10 minuts fins [ara](/manual/config/triggers#evaluation_period) que tinguin '110' (en binari) als 3 bits menys significatius.<br>=> **count**(/host/key,**10m:now-1d**) → nombre de valors entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)| |**countunique** (/host/key,(sec\|\#num)<:time shift>,<operator>,<pattern>)|<|<| |Nombre de valors únics dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).<br><br>**operador** (opcional; ha d'estar entre cometes)<br><br> `Operadors` admesos:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - més gran de <br>*ge* - major o igual<br>*lt* - més petit de <br>*le* - menor o igual<br>*like* - coincideix si conté un patró (distingeix entre majúscules i minúscules)<br>*bitand* - per bits AND<br>*regexp* - coincideix amb majúscules i minúscules de l'element normal expressió donada a `pattern`<br>*iregexp*: coincidència sense distinció entre majúscules i minúscules de l'expressió regular donada a `pattern`<br><br>**patró** (opcional) - patró obligatori (els arguments de la cadena han d'ésser dobles)|Tipus de valors admesos: flotant, enter, cadena, text, registre<br><br>Els elements flotants coincideixen amb la precisió de 2.22e-16; si la base de dades no és [actualitzada](https://www.zabbix.com/documentation/5.0/manual/installation/upgrade_notes_500#enabling_extended_range_of_numeric_float_values) la precisió és 0,000001.<br><br>Amb *bitand* com a tercer paràmetre, el quart paràmetre "patró" es pot especificar com a dos nombres, separats per "/": **nombre\_a\_comparar\_amb/màscara**. count() calcula "AND bit a bit" a partir del valor i la *màscara* i compara el resultat amb *nombre\_a\_comparar\_amb*. Si el resultat de "AND bit a bit" és igual a *nombre\_a\_comparar\_amb*, es compta el valor.<br>Si *nombre\_a\_comparar\_amb* i *màscara* són iguals, només cal especificar la *màscara* (sense '/').<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o una expressió regular [global](/manual/regular_expressions# global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars. Per a la concordança d'expressions regulars, els valors flotants sempre es representaran amb 4 dígits decimals després de ".". Tingueu en compte també que, per a nombres grans, la diferència de representació decimal (emmagatzemada a la base de dades) i binària (emprada pel servidor Zabbix) pot afectar el quart dígit decimal.<br><br>Exemples:<br>=> **countunique**(/ host/key,**10m**) → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period)<br>=> **countunique**(/host/key, **10m**,"like","error") → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que contenen "error"<br>=> ** countunique**(/host/key,**10m**,"gt",12) → nombre de valors únics durant els darrers 10 minuts fins a [ara](/manual/config/triggers#evaluation_period) que superen el '12 '<br>=> **countunique**(/host/key,**\#10**,"gt",12) → nombre de valors únics dins dels darrers 10 valors fins a [ara](/manual/config /triggers#evaluation_period) que superen '12'<br>=> **countunique**(/host/key,**10m:now-1d**,"gt",12) → nombre de valors únics entre 24 fa hores i 10 minuts i 24 hores des d'[ara](/man ual/config/triggers#evaluation_period) que eren superiors a '12'<br>=> **countunique**(/host/key,**10m**,"bitand","6/7") → nombre d'únics valors dels darrers 10 minuts fins [ara](/manual/config/triggers#evaluation_period) tingui '110' (en binari) als 3 bits menys significatius.<br>=> **countunique**(/host/key ,**10m:now-1d**) → nombre de valors únics entre 24 hores i 10 minuts i fa 24 hores des d'[ara](/manual/config/triggers#evaluation_period)| |**find** (/host/key,<(sec\|\#num)<:time shift>>,<operador>,<pattern>)|<|<| |Cerca una coincidència de valor.|Veieu [paràmetres comuns](#common-parameters).<br><br>**sec** o **\#num** (opcional) - per defecte el valor més recent si no s'especifica <br><br>**operador** (opcional; ha d'ésser entre cometes)<br><br>"operadors" admesos:<br>*eq* - igual (per defecte)<br>*ne* - no igual<br>*gt* - major de<br>*ge* - major o igual<br>*lt* - menor de<br>*le* - menor o igual<br>*com* - el valor conté la cadena donada a `pattern` (distingeix entre majúscules i minúscules)<br>*bitand* - bit a bit AND<br>*regexp* - concordança sensible a majúscules i minúscules de l'expressió regular donada a `pattern`<br>*iregexp* - coincidència insensible a majúscules i minúscules del expressió regular donada a `pattern`<br><br>**patró** - patró obligatori (els arguments de cadena han d'ésser entre cometes); [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) expressió regular si `operador` és *regexp*, *iregexp*.|Tipus de valors admesos: float, int, str, text, registre<br><br>Retorna:<br>1 - trobat<br>0 - en cas contrari<br><br>Si es processa més d'un valor, es retorna '1' si hi ha almenys un valor coincident.<br><br>Amb *regexp* o *iregexp* com a tercer paràmetre, el quart paràmetre `pattern` pot ser ordinari o  una expressió regular [global](/manual/regular_expressions#global_regular_expressions) (començant per '@'). En el cas de les expressions regulars globals, la distinció entre majúscules i minúscules s'hereta de la configuració global d'expressions regulars.<br><br>Exemple:<br>=> **find**(/host/key,**10m**,"like", "error") → cerca un valor que contingui "error" dins dels darrera 10 minuts fins [ara](/manual/config/triggers#evaluation_period)| |**first** (/host/key,sec<:time shift>)|<|<| |El primer valor (el més antic) dins del període d'avaluació definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int, str, text, log<br><br>Exemple:< br>=> **first**(/host/key,**1h**) → recupera el valor més antic durant la darrera hora fins a [ara](/manual/config/triggers#evaluation_period)<br><br> Veieu també last().| |**fuzzytime** (/host/key,sec)|<|<| |Comprovació de quant difereix el temps de l'agent passiu del temps del servidor/proxy Zabbix.|Veieu [paràmetres comuns](#common parameters).|Tipus de valors admesos: float, int<br><br>Retorna:<br>1 - La diferència entre el valor de l'element passiu (com a marca de temps) i la marca de temps del servidor/proxy Zabbix (rellotge de recollida de valors) és menor o igual a T segons<br>0 - en cas contrari<br><br>S'empra habitualment amb el 'system.localtime' (temps local del sistema) per comprovar que l'hora local és sincronitzada amb l'hora local del servidor Zabbix. *Tingueu en compte* que 'system.localtime' s'ha de configurar com a [comprovació passiva](/manual/appendix/items/activepassive#passive_checks).<br>També es pot emprar amb vfs.file.time\[/path/file ,modifica\] per comprovar que el fitxer no ha rebut actualitzacions durant molt de temps.<br><br>Exemple:<br>=> **fuzzytime**(/host/key,**60s**)=0 → detecta un problema si la diferència de temps supera els 60 segons<br><br>Aquesta funció no es recomana emprar-la en expressions d'activació complexes (amb diversos elements implicats), perquè pot provocar resultats inesperats (la diferència de temps es mesurarà amb el mètrica més recent), p. ex. a `fuzzytime(/Host/system.localtime,60s)=0 o last(/Host/trap)<>0`| |**last** (/host/key,<\#num<:time shift>>)|<|<| |El valor més recent.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent|Tipus de valors admesos: float, int, str, text, log<br><br>Tingueu en compte que un període de temps etiquetat amb hash (\#N) funciona de manera diferent aquí que a moltes altres funcions.<br>Per exemple:<br>last() sempre és igual a last(\#1)<br>darrer(\#3) - tercer valor més recent (*no* tres valors més recents)<br><br>Zabbix no garanteix l'ordre exacte dels valors si hi ha més de dos valors dins un segon a l'historial.<br><br>Exemple:<br>=> **last**(/host/key) → recupera el darrer valor<br>=> **last**(/host/key, **\#2**) → recupera el valor anterior<br>=> **last**(/host/key,**\#1**) <> **last**(/host/key, **\#2**) → els darrers valors i els anteriors són diferents<br><br>Veieu també primer().| |**logeventid** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Comprovar si l'ID d'esdeveniment de la darrera entrada de registre coincideix amb una expressió regular.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent <br><br>**pattern** (opcional) - expressió regular que descriu el patró requerit, estil [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (els arguments de cadena han d'ésser entre cometes dobles).|Tipus de valors admesos: log<br><br>Retorna:<br>0 - no coincideix<br>1 - coincideix| |**logseverity** (/host/key,<\#num<:time shift>>)|<|<| |Gravetat del registre de la darrera entrada del registre.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - el valor enèsim més recent|Tipus de valors admesos: registre <br><br>Retorna:<br>0 - gravetat predeterminada<br>N - gravetat (enter, útil per als registres d'esdeveniments de Windows: 1 - Informació, 2 - Avís, 4 - Error, 7 - Auditoria d'errors, 8 - Auditoria correcta, 9 - Crític, 10 - Detall).<br>Zabbix pren la gravetat del registre del camp **Information** del registre d'esdeveniments de Windows.| |**logsource** (/host/key,<\#num<:time shift>>,<pattern>)|<|<| |Comprovar si l'origen del registre de la darrera entrada del registre coincideix amb una expressió regular.|Veieu [paràmetres comuns](#common-parameters).<br><br>**\#num** (opcional) - l'enèsim valor més recent <br><br>**pattern** (opcional) - expressió regular que descriu el patró requerit, estil [Expressió regular compatible amb Perl](https://en.wikipedia.org/wiki/Perl_Compatible_Regular_Expressions) (PCRE) (els arguments de cadena han d'ésser entre cometes dobles).|Tipus de valors admesos: registre<br><br>Retorna:<br>0 - no coincideix<br>1 - coincideix<br><br>S'empra normalment per als registres d'esdeveniments de Windows. Per exemple, logsource("VMware Server").| |**monodec** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Comproveu si hi ha hagut una disminució monòtona dels valors.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (ha d'ésser entre cometes dobles) - *feble* (cada valor) és més petit o el mateix que l'anterior; per defecte) o *estricte* (tots els valors han disminuït)|Tipus de valors admesos: int<br><br>Retorna 1 si tots els elements del període de temps disminueixen contínuament, 0 en cas contrari.< br><br>Exemple:<br>=> **monodec**(/Host1/system.swap.size\[all,free\],**60s**) + **monodec**(/Host2/ system.swap.size\[all,free\],**60s**) + **monodec**(/Host3/system.swap.size\[all,free\],**60s**) - calcula a quants equips hi ha hagut una disminució de la mida de l'intercanvi lliure| |**monoinc** (/host/key,(sec\|\#num)<:time shift>,<mode>)|<|<| |Comprovar si hi ha hagut un increment monòton de valors.|Veieu [paràmetres comuns](#common-parameters).<br><br>**mode** (ha d'ésser entre cometes dobles) - *feble* (cada valor és més gran o el mateix que l'anterior; per defecte) o *estricte* (tots els valors han augmentat)|Tipus de valors admesos: int<br><br>Retorna 1 si tots els elements del període de temps augmenten contínuament, 0 en cas contrari.<br><br>Exemple:< br>=> **monoinc**(/Host1/system.localtime,**\#3**,"strict")=0 - comproveu si l'hora local del sistema ha pujat de forma constant| |**nodata** (/host/key,sec,<mode>)|<|<| |Comprovació de no rebuda de dades.|Veieu els [paràmetres comuns](#common-parameters).<br><br>El període de **seg** no hauria d'ésser inferior a 30 segons perquè el procés de sincronització de l'historial calcula aquesta funció només cada 30 segons.<br><br>nodata(/host/key,0) no és permesa.<br><br>**mode**: si s'estableix en *estricte* (entre cometes), aquesta funció serà insensible a Disponibilitat de proxy (veieu els comentaris per obtindre més informació).|S'admeten tots els tipus de valors.<br><br>Retorna:<br>1 - si no s'han rebut dades durant el període de temps definit<br>0 - en cas contrari<br><br >Des de Zabbix 5.0, els triggers de "nodata" monitorats pel proxy són, de manera predeterminada, sensibles a la disponibilitat del proxy; si el proxy no és pas disponible, els triggers de "nodata" no s'activaran immediatament quan es restauri la connexió, sinó que saltaran les dades per als períodes endarrerits. Tingueu en compte que per als proxys passius la supressió s'activa si la connexió es restableix més de 15 segons i no menys de 2 i ProxyUpdateFrequency segons més tard. Per als proxys actius, la supressió s'activa si la connexió es restaura més de 15 segons després.<br><br>Per desactivar la sensibilitat a la disponibilitat del proxy, empreu el tercer paràmetre, p. ex.: **nodata**(/host/key,** 5m**,**"estricte"**); en aquest cas, la funció anirà igual que abans de la 5.0.0 i s'activarà tan aviat com hagi passat el període d'avaluació (cinc minuts) sense dades.<br><br>Tingueu en compte que aquesta funció mostrarà un error si, dins del període del 1r paràmetre:<br>- no hi ha dades i el servidor Zabbix s'ha reiniciat<br>- no hi ha dades i s'ha completat el manteniment<br>- no hi ha dades i l'element s'ha afegit o tornat a habilitar<br>Es mostren errors a la columna *Informació* del trigger [configuració](/manual/web_interface/frontend_sections/configuration/hosts/triggers).<br><br>És possible que aquesta funció no funcioni correctament si hi ha diferències horàries entre el servidor Zabbix, el proxy i l'agent. Veieu també: [Requisit de sincronització de l'hora](/manual/installation/requirements#time_synchronization).| |**percentile** (/host/key,(sec\|\#num)<:time shift>,percentage)|<|<| |P-è percentil d'un període, on P (percentatge) s'especifica com a tercer paràmetre.|Veieu [paràmetres comuns](#common-parameters).<br><br>**percentatge** - un nombre de coma flotant entre 0 i 100 (inclosos) amb fins a 4 dígits després del punt decimal|Tipus de valors admesos: float, int| |**tax** (/host/key,sec<:time shift>)|<|<| |Taxa mitjana per segon de l'augment d'un comptador que augmenta monòtonament dins del període de temps definit.|Veieu [paràmetres comuns](#common-parameters).|Tipus de valors admesos: float, int<br><br>Correspon funcionalment a "[tarifa](https://prometheus.io/docs/prometheus/latest/querying/functions/#rate)" de PromQL.<br><br>Exemple:<br>=> **tarifa**(/ host/clau,**30s**) → Si l'augment monòton en 30 segons és 20, aquesta funció retornarà 0,67.|

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

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 the 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  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	# History  This class is designed to work with history data.  Object references:\  -   [History](/manual/api/reference/history/object#history)  Available methods:\  -   [history.get](/manual/api/reference/history/get) - retrieving     history data.
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)  Mètodes disponibles:\  -   [history.get](/manual/api/reference/history/get) - consultar dades de l'històric.

en-us	 ### HMAC function for JavaScript  A new function has been added to the JavaScript engine allowing to return HMAC hash:  -   `hmac('<hash type>',key,string)`  This is useful for cases when hash-based message authentication code (HMAC) is required for signing requests. MD5 and SHA256 hash types are supported, e. g.:     -   `hmac('md5',key,string)`    -   `hmac('sha256',key,string)`
ca	### Funció HMAC per JavaScript  S'ha afegit una nova funció al motor JavaScript per calcular el hash HMAC:  - `hmac('<tipus hash>',clau,cadena)`  Això és útil en els casos en què es requereix un codi d'autenticació de missatges basat en hash (HMAC) per signar les peticions. S'admeten els tipus hash MD5 i SHA256, per exemple:   · - · `hmac('md5',clau,cadena)`  · - · `hmac('sha256',clau,cadena)`

en-us	#### Host access from several user groups  A user may belong to any number of user groups. These groups may have different access permissions to hosts.  Therefore, it is important to know what hosts an unprivileged user will be able to access as a result. For example, let us consider how access to host **X** (in Hostgroup 1) will be affected in various situations for a user who is in user groups A and B.  -   If Group A has only *Read* access to Hostgroup 1, but Group B     *Read-write* access to Hostgroup 1, the user will get **Read-write**     access to 'X'.  ::: noteimportant “Read-write” permissions have precedence over “Read” permissions starting with Zabbix 2.2. :::  -   In the same scenario as above, if 'X' is simultaneously also in     Hostgroup 2 that is **denied** to Group A or B, access to 'X' will     be **unavailable**, despite a *Read-write* access to Hostgroup 1. -   If Group A has no permissions defined and Group B has a *Read-write*     access to Hostgroup 1, the user will get **Read-write** access to     'X'. -   If Group A has *Deny* access to Hostgroup 1 and Group B has a     *Read-write* access to Hostgroup 1, the user will get access to 'X'     **denied**.
ca	#### Accés a equips des de diferents grups d'usuaris  Un usuari pot pertànyer a qualsevol nombre de grups d'usuaris. Aquests grups poden tindre diferents permisos d'accés als equips.  Per tant, és important sabre a quins equips podrà accedir un usuari sense privilegis. Per exemple, examinem com es veurà afectat l'accés a l'equip **X** (al grup d'equip 1) en diverses situacions per a un usuari que es troba als grups d'usuaris A i B.  - Si el grup A només té accés de *lectura* al grup d'equip 1, però el grup B té accés de *lectura-escriptura* al grup d'equip 1, l'usuari tindrà accés de **lectura-escriptura** a 'X'.  ::: noteimportant Els permisos de "lectura-escriptura" tenen prioritat sobre els permisos de "lectura" des de Zabbix 2.2. :::  - En el mateix escenari que l'anterior, si 'X' també es troba simultàniament al grup d'equip 2 que és **denegat** al grup A o B, l'accés a 'X' serà **no disponible** , tot i haver-hi *lectura-escriptura* al grup d'equip 1. - Si el grup A no té permisos establerts i el grup B té accés de *Lectura-Escriptura* al grup d'equip 1, l'usuari obtindrà accés de **Lectura-Escriptura** a 'X'. - Si el grup A té accés *Denegat* al grup d'equip 1 i el grup B té accés de *Lectura-Escriptura* al grup d'equip 1, l'usuari tindrà accés a 'X' **denegat**.

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  To use VMware simple checks the host must have the following user macros defined:  -   **{$VMWARE.URL}** - VMware service (vCenter or ESX hypervisor) SDK     URL (<https://servername/sdk>) -   **{$VMWARE.USERNAME}** - VMware service user name -   **{$VMWARE.PASSWORD}** - VMware service {$VMWARE.USERNAME} user     password
ca	#### Configuració de l'equip  Per emprar VMware Simple Checks, l'equip ha d'haver definit les macros d'usuari següents:  - **{$VMWARE.URL}** - URL de l'SDK del servei VMware (vCenter o hipervisor ESX) (<https://servername/sdk>) - **{$VMWARE.USERNAME}** - Nom d'usuari del servei VMware - **{$VMWARE.PASSWORD}** - Mot de pas d'usuari del servei VMware {$VMWARE.USERNAME}

en-us	##### Host configuration  You can specify that an individual host should be monitored by a proxy in the [host configuration](/manual/config/hosts/host) form, using the *Monitored by proxy* field.  ![](../../../assets/en/manual/proxies/proxy_set.png)  Host [mass update](/manual/config/hosts/hostupdate) is another way of specifying that hosts should be monitored by a proxy.
ca	##### Configuració de l'equip  Podeu especificar que un equip s'ha de monitorar a un proxy al formulari [Configuració de l'equip](/manual/config/hosts/host), emprant el camp *Monitorat mitjançant proxy*.  ![](../../../assets/en/manual/proxies/proxy_set.png)  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.

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.delete
ca	# host.delete

en-us	#### Host editing as popup  The form for host creation and editing is now opened in a modal (popup) window, in *Configuration* → *Hosts*, *Monitoring* → *Hosts* and in any page, where there is a host menu or other direct link to the host configuration.  Direct links to the host edit page still work and are opening the host edit page in full page.
ca	##### Modificació d'equip via popup  El formulari de creació i edició de l'equip s'obre ara en una finestra modal (pop-up), a *Configuració* → *Equips*, *Monitoratge* → *Equips*, i a qualsevol pàgina on hi hagi un menú d'equips o un altre enllaç directe a la configuració de l'equip.  Els enllaços directes a la pàgina d'edició de l'equip encara funcionen i obren la pàgina d'edició de l'equip a pantalla completa.

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

en-us	##### Host graph tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |graphs| |\-| | |Root element for graphs.| | |name|x|`string`| |Graph name.| | |width|\-|`integer`|20-65535 (default: 900)|Graph width, in pixels. Used for preview and for pie/exploded graphs.| | |height|\-|`integer`|20-65535 (default: 200)|Graph height, in pixels. Used for preview and for pie/exploded graphs.| | |yaxismin|\-|`double`|Default: 0|Value of Y axis minimum.<br><br>Used if 'ymin\_type\_1' is FIXED.| | |yaxismax|\-|`double`|Default: 0|Value of Y axis maximum.<br><br>Used if 'ymax\_type\_1' is FIXED.| | |show\_work\_period|\-|`string`|0 - NO<br>1 - YES (default)|Highlight non-working hours.<br><br>Used by normal and stacked graphs.| | |show\_triggers|\-|`string`|0 - NO<br>1 - YES (default)|Display simple trigger values as a line.<br><br>Used by normal and stacked graphs.| | |type|\-|`string`|0 - NORMAL (default)<br>1 - STACKED<br>2 - PIE<br>3 - EXPLODED|Graph type.| | |show\_legend|\-|`string`|0 - NO<br>1 - YES (default)|Display graph legend.| | |show\_3d|\-|`string`|0 - NO (default)<br>1 - YES|Enable 3D style.<br><br>Used by pie and exploded pie graphs.| | |percent\_left|\-|`double`|Default:0|Show the percentile line for left axis.<br><br>Used only for normal graphs.| | |percent\_right|\-|`double`|Default:0|Show the percentile line for right axis.<br><br>Used only for normal graphs.| | |ymin\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Minimum value of Y axis.<br><br>Used by normal and stacked graphs.| | |ymax\_type\_1|\-|`string`|0 - CALCULATED (default)<br>1 - FIXED<br>2 - ITEM|Maximum value of Y axis.<br><br>Used by normal and stacked graphs.| |ymin\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymin\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |ymax\_item\_1| |\-| | |Individual item details.<br><br>Required if 'ymax\_type\_1' is ITEM.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.| |graph\_items| |x| | |Root element for graph items.| | |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`|0 - SINGLE\_LINE (default)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Draw style of the graph item.<br><br>Used only by normal graphs.| | |color|\-|`string`| |Element color (6 symbols, hex).| | |yaxisside|\-|`string`|0 - LEFT (default)<br>1 - RIGHT|Side of the graph where the graph item's Y scale will be drawn.<br><br>Used by normal and stacked graphs.| | |calc\_fnc|\-|`string`|1 - MIN<br>2 - AVG (default)<br>4 - MAX<br>7 - ALL (minimum, average and maximum; used only by simple graphs)<br>9 - LAST (used only by pie and exploded pie graphs)|Data to draw if more than one value exists for an item.| | |type|\-|`string`|0 - SIMPLE (default)<br>2 - GRAPH\_SUM (value of the item represents the whole pie; used only by pie and exploded pie graphs)|Graph item type.| |item| |x| | |Individual item.| | |host|x|`string`| |Item host.| | |key|x|`string`| |Item key.|
ca	##### Etiquetes de gràfic d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |gràfics| |\-| | |Element arrel per a gràfics.| | |name|x|`cadena`| |Nom del gràfic.| | |width|\-|`integer`|20-65535 (per defecte: 900)|Amplada del gràfic, en píxels. S'empra per a la previsualització i per a gràfics circulars/explotats.| | |height|\-|`integer`|20-65535 (per defecte: 200)|Alçada del gràfic, en píxels. S'empra per a la previsualització i per a gràfics circulars/explotats.| | |yaxismin|\-|`double`|Per defecte: 0|Valor mínim de l'eix Y.<br><br>S'empra si 'ymin\_type\_1' està FIXAT.| | |yaxismax|\-|`double`|Per defecte: 0|Valor màxim de l'eix Y.<br><br>S'empra si 'ymax\type\_1' està FIXAT.| | |show\_work\_period|\-|`cadena`|0 - NO<br>1 - SÍ (predeterminat)|Destaca les hores no treballades.<br><br>S'empren per gràfics normals i apilats. | | |show\_triggers|\-|`cadena`|0 - NO<br>1 - YES (per defecte)|Mostra els valors de trigger únics com a línia.<br><br>S'empren per gràfics normals i apilats .| | |type|\-|`cadena`|0 - NORMAL (predeterminat)<br>1 - APILAT<br>2 - PASTÍS<br>3 - EXPLOTAT|Tipus de gràfic.| | |show\_legend|\-|`cadena`|0 - NO<br>1 - SÍ (per defecte)|Mostra la llegenda del gràfic.| | |show\_3d|\-|`cadena`|0 - NO (predeterminat)<br>1 - SÍ|Activa l'estil 3D.<br><br>S'empren per gràfics de sectors i gràfics de sectors explotats. | | |percent\_left|\-|`double`|Per defecte: 0|Mostra la línia percentil per a l'eix esquerre.<br><br>Només s'empra per a gràfics normals.| | |percent\_right|\-|`double`|Per defecte: 0|Mostra la línia percentil per a l'eix dret.<br><br>Només s'empra per a gràfics normals.| | |ymin\_type\_1|\-|`cadena`|0 - CALCULAT (predeterminat)<br>1 - FIXAT<br>2 - ARTICLE|Valor mínim de l'eix Y.<br><br>Emprat amb gràfics normals i apilats.| | |ymax\_type\_1|\-|`cadena`|0 - CALCULAT (predeterminat)<br>1 - FIXAT<br>2 - ELEMENT|Valor màxim de l'eix Y.<br><br>Emprat per gràfics normals i apilats.| |ymin\_item\_1| |\-| | |Detalls de cada element.<br><br>Obligatori si 'ymin\_type\_1' és ELEMENT.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| |ymax\_item\_1| |\-| | |Detalls de cada element.<br><br>Obligatori si 'ymax\_type\_1' és ELEMENT.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.| |gràfic\_elements| |x| | |Element arrel per als elements del gràfic.| | |sortorder|\-|`enter`| |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|\-|`cadena`|0 - SINGLE\_LINE (per defecte)<br>1 - FILLED\_REGION<br>2 - BOLD\_LINE<br>3 - DOTTED\_LINE<br>4 - DASHED\_LINE<br>5 - GRADIENT\_LINE|Estil de dibuix d'elements gràfics.<br><br>Només s'empren els gràfics normals.| | |color|\-|`cadena`| |Color de l'element (6 símbols, hexadecimal).| | |yaxisside|\-|`cadena`|0 - ESQUERRE (per defecte)<br>1 - DRET|Lateral del gràfic on es dibuixarà l'escala Y de l'element del gràfic.<br><br>S'empra a gràfics normals i apilats.| | |calc\_fnc|\-|`cadena`|1 - MIN<br>2 - AVG (predeterminat)<br>4 - MAX<br>7 - ALL (mínim, mitjà i màxim; emprat només per gràfics simples)<br>9 - LAST (emprat només per gràfics de pastís i gràfics de pastís explotats)|Dades per dibuixar si hi ha diversos valors per a un element.| | |type|\-|`cadena`|0 - SINGLE (per defecte)<br>2 - GRAPH\_SUM (el valor de l'element representa el sector sencer; només s'empren els gràfics de pastís i de pastís explotats)|Tipus d'element de gràfic.| |element| |x| | |Element individual.| | |host|x|`cadena`| |Equip de l'element.| | |key|x|`cadena`| |Clau d'element.|

en-us	#### host group  Changes:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: `hosts` and `templates` fields are now required.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: added strict validation of the method parameters.\
ca	#### grup d'equips  Canvis:\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massupdate`: els camps `hosts` i `templates` ara són necessaris.\ [ZBXNEXT-6868](https://support.zabbix.com/browse/ZBXNEXT-6868) `hostgroup.massadd`, `hostgroup.massupdate`, `hostgroup.massremove`: afegida validació estricta dels paràmetres de mètode.\

en-us	#### hostgroup  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: the parameter `uuid` can now be updated.\
ca	#### grup d'equips  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostgroup.update`: el paràmetre `uuid` ara es pot actualitzar.\

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	### Host group  The host group object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|*(readonly)* ID of the host group.| |**name**<br>(required)|string|Name of the host group.| |flags|integer|*(readonly)* Origin of the host group.<br><br>Possible values:<br>0 - a plain host group;<br>4 - a discovered host group.| |internal|integer|*(readonly)* Whether the group is used internally by the system. An internal group cannot be deleted.<br><br>Possible values:<br>0 - *(default)* not internal;<br>1 - internal.| |uuid|string|Universal unique identifier, used for linking imported host groups to already existing ones. Auto-generated, if not given.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Grup d'equips  L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|string|*(nomes lectura)* ID del grup d'equips.| |**name**<br>(obligatori)|string|Nom del grup d'equips.| |flags|integer|*(nomes lectura)* Origen del grup d'equips.<br><br>Valors possibles:<br>0 - un grup d'equips en brut;<br>4 - un grup d'equips descobert.| |internal|integer|*(nomes lectura)* Indica si el grup s'empra internament per al sistema. Un grup intern no pot pas esborrar-se.<br><br>Valors possibles:<br>0 - *(per defecte)* no intern;<br>1 - intern.| |uuid|string|Identificador universal únic, emprat per enllaçar els grups d'equips importats als ja existents. Generat automàticament si no es proporciona.|  Veieu que per alguns mètodes (com ara actualitzar i esborrar), la combinació de paràmetres obligatoris o opcionals és diferent.

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) -     creating new host groups -   [hostgroup.delete](/manual/api/reference/hostgroup/delete) -     deleting host groups -   [hostgroup.get](/manual/api/reference/hostgroup/get) - retrieving     host groups -   [hostgroup.massadd](/manual/api/reference/hostgroup/massadd) -     adding related objects to host groups -   [hostgroup.massremove](/manual/api/reference/hostgroup/massremove) -     removing related objects from host groups -   [hostgroup.massupdate](/manual/api/reference/hostgroup/massupdate) -     replacing or removing related objects from host groups -   [hostgroup.update](/manual/api/reference/hostgroup/update) -     updating 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.update](/manual/api/reference/hostgroup/update) - actualitzar grups d'equips

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

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

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

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

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 interface  The host interface object has the following properties.  ::: noteimportant Note that both IP and DNS are required. If you do not want to use DNS, set it to an empty string. :::  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |available|integer|*(readonly)* Availability of host interface.<br><br>Possible values are:<br>0 - *(default)* unknown;<br>1 - available;<br>2 - unavailable.| |details|array|Additional object for interface. **Required** if interface 'type' is SNMP.| |disable\_until|timestamp|*(readonly)* The next polling time of an unavailable host interface.| |**dns**<br>(required)|string|DNS name used by the interface.<br><br>Can be empty if the connection is made via IP.| |error|string|*(readonly)* Error text if host interface is unavailable.| |errors\_from|timestamp|*(readonly)* Time when host interface became unavailable.| |**hostid**<br>(required)|string|ID of the host the interface belongs to.| |interfaceid|string|*(readonly)* ID of the interface.| |**ip**<br>(required)|string|IP address used by the interface.<br><br>Can be empty if the connection is made via DNS.| |**main**<br>(required)|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 are:<br>0 - not default;<br>1 - default.| |**port**<br>(required)|string|Port number used by the interface. Can contain user macros.| |**type**<br>(required)|integer|Interface type.<br><br>Possible values are:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br>| |**useip**<br>(required)|integer|Whether the connection should be made via IP.<br><br>Possible values are:<br>0 - connect using host DNS name;<br>1 - connect using host IP address for this host interface.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Interfície d'equip  L'objecte d'interfície d'equip té les propietats següents.  ::: nota important Tingueu en compte que cal IP i DNS. Si no s'ha d'emprar DNS, configureu-lo en una cadena buida. :::  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |available|integer|*(només lectura)*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.| |details|array|Objecte addicional per a la interfície. **Obligatori** si el "tipus" d'interfície és SNMP.| |disable\_until|timestamp|*(només lectura)* La propera vegada que es consulta una interfície d'equip no disponible.| |**dns**<br>(obligatori)|string|Nom DNS emprat per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant IP.| |error|string|*(només lectura)* Text d'error si la interfície de l'equip no és pas disponible.| |errors\_from|timestamp|*(només lectura)*Hora en què la interfície de l'equip no va estar disponible.| |**hostid**<br>(obligatori)|string|ID de l'equip al que pertany la interfície.| |interfaceid|string|*(només lectura)* ID de la interfície.| |**ip**<br>(obligatori)|string|adreça IP emprada per la interfície.<br><br>Pot ésser buit si la connexió s'estableix mitjançant DNS.| |**main**<br>(obligatori)|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.| |**port**<br>(obligatori)|string|Nombre de port emprat per la interfície. Pot contindre macros d'usuari.| |**tipus**<br>(obligatori)|integer|Tipus d'interfície.<br><br>Valors possibles:<br>1 - agent;<br>2 - SNMP;<br>3 - IPMI; <br> >4 - JMX.<br>| |**useip**<br>(obligatori)|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 per a aquesta interfície d'equip.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Host interface  This class is designed to work with host interfaces.  Object references:\  -   [Host     interface](/manual/api/reference/hostinterface/object#host_interface)  Available methods:\  -   [hostinterface.create](/manual/api/reference/hostinterface/create) -     creating new host interfaces -   [hostinterface.delete](/manual/api/reference/hostinterface/delete) -     deleting host interfaces -   [hostinterface.get](/manual/api/reference/hostinterface/get) -     retrieving host interfaces -   [hostinterface.massadd](/manual/api/reference/hostinterface/massadd) -     adding host interfaces to hosts -   [hostinterface.massremove](/manual/api/reference/hostinterface/massremove) -     removing host interfaces from hosts -   [hostinterface.replacehostinterfaces](/manual/api/reference/hostinterface/replacehostinterfaces) -     replacing host interfaces on a host -   [hostinterface.update](/manual/api/reference/hostinterface/update) -     updating 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)  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

en-us	### Host inventory  The host inventory object has the following properties.  ::: notetip Each property has it's own unique ID number, which is used to associate host inventory fields with items. :::  |ID|Property|[Type](/manual/api/reference_commentary#data_types)|Description|Maximum length| |-|--|-|-----|-----| |4|alias|string|Alias.|128 characters| |11|asset\_tag|string|Asset tag.|64 characters| |28|chassis|string|Chassis.|64 characters| |23|contact|string|Contact person.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |32|contract\_number|string|Contract number.|64 characters| |47|date\_hw\_decomm|string|HW decommissioning date.|64 characters| |46|date\_hw\_expiry|string|HW maintenance expiry date.|64 characters| |45|date\_hw\_install|string|HW installation date.|64 characters| |44|date\_hw\_purchase|string|HW purchase date.|64 characters| |34|deployment\_status|string|Deployment status.|64 characters| |14|hardware|string|Hardware.|255 characters| |15|hardware\_full|string|Detailed hardware.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |39|host\_netmask|string|Host subnet mask.|39 characters| |38|host\_networks|string|Host networks.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |40|host\_router|string|Host router.|39 characters| |30|hw\_arch|string|HW architecture.|32 characters| |33|installer\_name|string|Installer name.|64 characters| |24|location|string|Location.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |25|location\_lat|string|Location latitude.|16 characters| |26|location\_lon|string|Location longitude.|16 characters| |12|macaddress\_a|string|MAC address A.|64 characters| |13|macaddress\_b|string|MAC address B.|64 characters| |29|model|string|Model.|64 characters| |3|name|string|Name.|128 characters| |27|notes|string|Notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |41|oob\_ip|string|OOB IP address.|39 characters| |42|oob\_netmask|string|OOB host subnet mask.|39 characters| |43|oob\_router|string|OOB router.|39 characters| |5|os|string|OS name.|128 characters| |6|os\_full|string|Detailed OS name.|255 characters| |7|os\_short|string|Short OS name.|128 characters| |61|poc\_1\_cell|string|Primary POC mobile number.|64 characters| |58|poc\_1\_email|string|Primary email.|128 characters| |57|poc\_1\_name|string|Primary POC name.|128 characters| |63|poc\_1\_notes|string|Primary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |59|poc\_1\_phone\_a|string|Primary POC phone A.|64 characters| |60|poc\_1\_phone\_b|string|Primary POC phone B.|64 characters| |62|poc\_1\_screen|string|Primary POC screen name.|64 characters| |68|poc\_2\_cell|string|Secondary POC mobile number.|64 characters| |65|poc\_2\_email|string|Secondary POC email.|128 characters| |64|poc\_2\_name|string|Secondary POC name.|128 characters| |70|poc\_2\_notes|string|Secondary POC notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |66|poc\_2\_phone\_a|string|Secondary POC phone A.|64 characters| |67|poc\_2\_phone\_b|string|Secondary POC phone B.|64 characters| |69|poc\_2\_screen|string|Secondary POC screen name.|64 characters| |8|serialno\_a|string|Serial number A.|64 characters| |9|serialno\_b|string|Serial number B.|64 characters| |48|site\_address\_a|string|Site address A.|128 characters| |49|site\_address\_b|string|Site address B.|128 characters| |50|site\_address\_c|string|Site address C.|128 characters| |51|site\_city|string|Site city.|128 characters| |53|site\_country|string|Site country.|64 characters| |56|site\_notes|string|Site notes.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |55|site\_rack|string|Site rack location.|128 characters| |52|site\_state|string|Site state.|64 characters| |54|site\_zip|string|Site ZIP/postal code.|64 characters| |16|software|string|Software.|255 characters| |18|software\_app\_a|string|Software application A.|64 characters| |19|software\_app\_b|string|Software application B.|64 characters| |20|software\_app\_c|string|Software application C.|64 characters| |21|software\_app\_d|string|Software application D.|64 characters| |22|software\_app\_e|string|Software application E.|64 characters| |17|software\_full|string|Software details.|Depends on the database used:<br>- 65535 characters for SQL databases<br>- 2048 characters for Oracle databases| |10|tag|string|Tag.|64 characters| |1|type|string|Type.|64 characters| |2|type\_full|string|Type details.|64 characters| |35|url\_a|string|URL A.|255 characters| |36|url\_b|string|URL B.|255 characters| |37|url\_c|string|URL C.|255 characters| |31|vendor|string|Vendor.|64 characters|
ca	### Inventari d'equip  L'objecte d'inventari d'equip té les propietats següents.  ::: notetip Cada propietat té el seu propi nombre d'identificació únic, que s'empra per associar camps d'inventari de l'equip amb articles. :::  |ID|Propietat|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |-|--|-|-----|-----| |4|alias|string|Àlies.|128 caràcters| |11|asset\_tag|string|Etiqueta característica.|64 caràcters| |28|chassis|string|Xassís.|64 caràcters| |23|contact|string|Persona de contacte.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |32|contract\_number|string|Nombre de contracte.|64 caràcters| |47|date\_hw\_decomm|string|Material - Data de retirada.|64 caràcters| |46|data\_hw\_expiry|string|Maquinari - Data de finalització del manteniment|64 caràcters| |45|date\_hw\_install|string|Maquinari - Data d'instal·lació.|64 caràcters| |44|data\_hw\_purchase|string|Material - Data de compra.|64 caràcters| |34|desplegament\_estat|string|Estat del desplegament.|64 caràcters| |14|hardware|string|Maquinari.|255 caràcters| |15|hardware\_full|string|Detalls complets del maquinari.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |39|host\_netmask|string|Màscara de subxarxa de l'equip.|39 caràcters| |38|host\_networks|string|Xarxes d'equip.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |40|host\_router|string|Equip - Encaminador.|39 caràcters| |30|hw\_arch|string|Arquitectura del material.|32 caràcters| |33|installer\_name|string|Nom de l'instal·lador.|64 caràcters| |24|location|string|Ubicació.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |25|location\_lat|string|Latitud de la ubicació.|16 caràcters| |26|location\_lon|string|Longitud de la ubicació.|16 caràcters| |12|macaddress\_a|string|adreça MAC A.|64 caràcters| |13|macaddress\_b|string|adreça MAC B.|64 caràcters| |29|model|string|Model.|64 caràcters| |3|name|string|Nom.|128 caràcters| |27|notes|string|Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |41|oob\_ip|string|Adreça IP OOB.|39 caràcters| |42|oob\_netmask|string|Màscara de subxarxa OOB.|39 caràcters| |43|oob\_router|string|OOB de l'encaminador.|39 caràcters| |5|os|string|OS.|128 caràcters| |6|os\_full|string|Nom complet del sistema operatiu.|255 caràcters| |7|os\_short|string|Nom curt del SO.|128 caràcters| |61|poc\_1\_cell|string|Contacte principal - mòbil.|64 caràcters| |58|poc\_1\_email|string|Contacte principal - Correu electrònic.|128 caràcters| |57|poc\_1\_name|string|Contacte principal - Nom.|128 caràcters| |63|poc\_1\_notes|string|Contacte principal - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |59|poc\_1\_phone\_a|string|Contacte principal - Telèfon 1.|64 caràcters| |60|poc\_1\_phone\_b|string|Contacte principal - Telèfon 2.|64 caràcters| |62|poc\_1\_screen|string|Contacte principal - Nom d'usuari.|64 caràcters| |68|poc\_2\_cell|string|Contacte secundari - Mòbil.|64 caràcters| |65|poc\_2\_email|string|Contacte secundari - Correu electrònic.|128 caràcters| |64|poc\_2\_name|string|Contacte secundari - Nom.|128 caràcters| |70|poc\_2\_notes|string|Contacte secundari - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |66|poc\_2\_phone\_a|string|Contacte secundari - Telèfon 1.|64 caràcters| |67|poc\_2\_phone\_b|string|Contacte secundari - Telèfon 2.|64 caràcters| |69|poc\_2\_screen|string|Contacte secundari - ID.|64 caràcters| |8|serialno\_a|string|Nombre de sèrie A.|64 caràcters| |9|serialno\_b|string|Nombre de sèrie B.|64 caràcters| |48|site\_address\_a|string|Lloc - Adreça 1.|128 caràcters| |49|site\_address\_b|string|Lloc - Adreça 2.|128 caràcters| |50|site\_address\_c|string|Lloc - Adreça 3.|128 caràcters| |51|site\_city|string|Lloc - Ciutat.|128 caràcters| |53|lloc\_country|string|Lloc - País.|64 caràcters| |56|lloc\_notes|string|Lloc - Notes.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |55|site\_rack|string|Lloc - Ubicació del bastidor.|128 caràcters| |52|lloc\_state|string|Lloc - estat/província.|64 caràcters| |54|site\_zip|string|Lloc - codi postal.|64 caràcters| |16|software|string|Programari.|255 caràcters| |18|software\_app\_a|string|Aplicació de programari A.|64 caràcters| |19|software\_app\_b|string|Aplicació de programari B.|64 caràcters| |20|software\_app\_c|string|Aplicació de programari C.|64 caràcters| |21|software\_app\_d|string|Aplicació de programari D.|64 caràcters| |22|software\_app\_e|string|Aplicació de programari E.|64 caràcters| |17|software\_full|string|Detalls del programari.|Depèn de la base de dades emprada: <br>- 65535 caràcters per a bases de dades SQL <br>- 2048 caràcters per a bases de dades Oracle| |10|tag|string|Etiqueta.|64 caràcters| |1|type|string|Tipus.|64 caràcters| |2|type\_full|string|Detalls del tipus.|64 caràcters| |35|url\_a|string|URL A.|255 caràcters| |36|url\_b|string|URL B.|255 caràcters| |37|url\_c|string|URL C.|255 caràcters| |31|vendor|string|Proveïdor.|64 caràcters|

en-us	##### Host item tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |items| |\-| | |Root element for items.| | |name|x|`string`| |Item name.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULATED<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Item type.| | |snmp\_oid|\-|`string`| |SNMP object ID.<br><br>Required by SNMP items.| | |key|x|`string`| |Item key.| | |delay|\-|`string`|Default: 1m|Update interval of the item.<br><br>Note that `delay` will be always '0' for trapper items.<br><br>Accepts seconds or a time unit with suffix (30s, 1m, 2h, 1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).| | |history|\-|`string`|Default: 90d|Time period of how long the history data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |trends|\-|`string`|Default: 365d|Time period of how long the trends data should be stored. A time period using the time suffix, a user macro or LLD macro.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Item status.| | |value\_type|\-|`string`|0 - FLOAT<br>1 - CHAR<br>2 - LOG<br>3 - UNSIGNED (default)<br>4 - TEXT|Received value type.| | |allowed\_hosts|\-|`string`| |List of IP addresses (comma delimited) of hosts allowed sending data for the item.<br><br>Used by trapper and HTTP agent items.| | |units|\-|`string`| |Units of returned values (bps, B, etc).| | |params|\-|`text`| |Additional parameters depending on the type of the item:<br>- executed script for Script, SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items.| | |ipmi\_sensor|\-|`string`| |IPMI sensor.<br><br>Used only by IPMI items.| | |authtype|\-|`string`|Authentication type for SSH agent items:<br>0 - PASSWORD (default)<br>1 - PUBLIC\_KEY<br><br>Authentication type for HTTP agent items:<br>0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication type.<br><br>Used only by SSH and HTTP agent items.| | |username|\-|`string`| |Username for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX agent, password should also be specified together with the username or both properties should be left blank.| | |password|\-|`string`| |Password for authentication.<br>Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>When used by JMX agent, username should also be specified together with the password or both properties should be left blank.| | |publickey|\-|`string`| |Name of the public key file.<br><br>Required for SSH agent items.| | |privatekey|\-|`string`| |Name of the private key file.<br><br>Required for SSH agent items.| | |description|\-|`text`| |Item description.| | |inventory\_link|\-|`string`|0 - NONE<br><br>Capitalized host inventory field name. For example:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.| | |logtimefmt|\-|`string`| |Format of the time in log entries.<br>Used only by log items.| | |interface\_ref|\-|`string`|Format: `if<N>`|Reference to the host interface.| | |jmx\_endpoint|\-|`string`| |JMX endpoint.<br><br>Used only by JMX agent items.| | |url|\-|`string`| |URL string.<br><br>Required only for HTTP agent items.| | |allow\_traps|\-|`string`|0 - NO (default)<br>1 - YES|Allow to populate value as in a trapper item.<br><br>Used only by HTTP agent items.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP response redirects while polling data.<br><br>Used only by HTTP agent items.| |headers| |\-| | |Root element for HTTP(S) request headers, where header name is used as key and header value as value.<br>Used only by HTTP agent items.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |http\_proxy|\-|`string`| |HTTP(S) proxy connection string.<br><br>Used only by HTTP agent items.| | |output\_format|\-|`string`|0 - RAW (default)<br>1 - JSON|How to process response.<br><br>Used only by HTTP agent items.| | |post\_type|\-|`string`|0 - RAW (default)<br>2 - JSON<br>3 - XML|Type of post data body.<br><br>Used only by HTTP agent items.| | |posts|\-|`string`| |HTTP(S) request body data.<br><br>Used only by HTTP agent items.| |query\_fields| |\-| | |Root element for query parameters.<br><br>Used only by HTTP agent items.| | |name|x|`string`| |Parameter name.| | |value|\-|`string`| |Parameter value.| | |request\_method|\-|`string`|0 - GET (default)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Request method.<br><br>Used only by HTTP agent items.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|What part of response should be stored.<br><br>Used only by HTTP agent items.| | |ssl\_cert\_file|\-|`string`| |Public SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_file|\-|`string`| |Private SSL Key file path.<br><br>Used only by HTTP agent items.| | |ssl\_key\_password|\-|`string`| |Password for SSL Key file.<br><br>Used only by HTTP agent items.| | |status\_codes|\-|`string`| |Ranges of required HTTP status codes separated by commas. Supports user macros.<br>Example: 200,200-{$M},{$M},200-400<br><br>Used only by HTTP agent items.| | |timeout|\-|`string`| |Item data polling request timeout. Supports user macros.<br><br>Used by HTTP agent and Script items.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>Used only by HTTP agent items.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's certificate is authentic.<br><br>Used only by HTTP agent items.| |parameters| |\-| | |Root element for user-defined parameters.<br><br>Used only by Script items.| | |name|x|`string`| |Parameter name.<br><br>Used only by Script items.| | |value|\-|`string`| |Parameter value.<br><br>Used only by Script items.| |value map| |\-| | |Value map.| | |name|x|`string`| |Name of the value map to use for the item.| |preprocessing| |\-| | |Root element for item value preprocessing.| |step| |\-| | |Individual item value preprocessing step.| | |type|x|`string`|1 - MULTIPLIER<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculated as (received value-previous value))<br>10 - CHANGE\_PER\_SECOND (calculated as (received value-previous value)/(time now-time of last check))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| | |parameters|\-| | |Root element for parameters of the item value preprocessing step.| | |parameter|x|`string`| |Individual parameter of the item value preprocessing step.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (default)<br>1 - DISCARD\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Action type used in case of preprocessing step failure.| | |error\_handler\_params|\-|`string`| |Error handler parameters used with 'error\_handler'.| |master\_item| |\-| | |Individual item master item.<br><br>Required by dependent items.| | |key|x|`string`| |Dependent item master item key value.<br><br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.| |triggers| |\-| | |Root element for simple triggers.| | |*For trigger element tag values, see host [trigger tags](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Root element for item tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.|
ca	##### Etiquetes d'element d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |items| |\-| | |Element arrel dels elements.| | |name|x|`cadena`| |Nom de l'element.| | |type|\-|`string`|0 - ZABBIX\_PASSIVE (per defecte)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERN<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERN <br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>15 - CALCULAT<br>16 - JMX<br>17 - SNMP\_TRAP<br>18 - DEPENDENT <br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT<br>21 - ITEM\_TYPE\_SCRIPT|Tipus d'element.| | |snmp\_oid|\-|`cadena`| |ID d'objecte SNMP.<br><br>Requerit pels elements SNMP.| | |key|x|`cadena`| |Clau d'element.| | |delay|\-|`cadena`|Per defecte: 1m|Interval d'actualització de l'element.<br><br>Tingueu en compte que el `retard` sempre serà '0' per als elements trapper.<br> <br>Accepta segons o unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com a programació.<br> Diversos intervals es separen per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten múltiples macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).| | |history|\-|`string`|Per defecte: 90d|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'historial. Unitat de temps amb sufix, macro d'usuari o macro LLD.| | |trends|\-|`string`|Per defecte: 365d|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendència. Unitat de temps amb sufix, macro d'usuari o macro LLD.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'element.| | |value\_type|\-|`cadena`|0 - FLOAT<br>1 - CHAR<br>2 - REGISTR<br>3 - SIN signa (per defecte)<br>4 - TEXT|Tipus de valor rebut.| | |allowed\_hosts|\-|`cadena`| |Llista d'adreces IP (separades per comes) dels equips amb permís per enviar dades de l'element.<br><br>Emprat pels elements de trapper i d'agent HTTP.| | |units|\-|`cadena`| |Unitats de valors retornats (bps, B, etc).| | |params|\-|`text`| |Paràmetres addicionals segons el tipus d'element:<br>- script executat per a elements Script, SSH i Telnet;<br>- Consulta SQL per a elements del monitor de base de dades;<br>- fórmula per als elements calculats.| | |ipmi\_sensor|\-|`cadena`| |Sensor IPMI.<br><br>Ús només per elements IPMI.| | |authtype|\-|`string`|Tipus d'autenticació per als elements de l'agent SSH:<br>0 - MOT DE PAS (per defecte)<br>1 - PUBLIC\_KEY<br><br>Tipus d'autenticació per als elements de l'agent HTTP:<br> 0 - CAP (per defecte)<br>1 - BÀSICA<br>2 - NTLM|Tipus d'autenticació.<br><br>Només l'empren els elements de l'agent SSH i HTTP.| | |username|\-|`cadena`| |Nom d'usuari per a l'autenticació.<br>Emprat per elements d'agent de simple comprovació, SSH, Telnet, Database Monitor, JMX i HTTP.<br><br>Requerit per elements SSH i Telnet. <br>Quan l'empra l'agent JMX, el mot de pas també s'ha d'especificar amb el nom d'usuari o les dues propietats s'han de deixar en blanc.| | |password|\-|`cadena`| |Mot de pas per a l'autenticació.<br>S'empra per comprovació simple, SSH, Telnet, monitor de base de dades, elements de l'agent JMX i HTTP.<br><br>Quan l'empra l'agent JMX, el nom d'usuari també s'ha d'especificar amb el mot de pas o ambdues propietats s'han de deixar en blanc.| | |publickey|\-|`cadena`| |Nom del fitxer de clau pública.<br><br>Requerit per als elements de l'agent SSH.| | |privatekey|\-|`cadena`| |Nom del fitxer de clau privada.<br><br>Requerit per als elements de l'agent SSH.| | |description|\-|`text`| |Descripció de l'element.| | |inventory\_link|\-|`string`|0 - CAP<br><br>El nom del camp d'inventari de l'equip en majúscula. Per exemple:<br>4 - ALIAS<br>6 - OS\_FULL<br>14 - HARDWARE<br>etc.|Camp d'inventari de l'equip ocupat per element.<br><br>Informe: aneu a la [pàgina de l'inventari d'equip](/manual/api/reference/host/object#host_inventory) per obtindre una llista de camps d'inventari d'equip admesos i els seus ID. | | |logtimefmt|\-|`cadena`| |Format d'hora a les entrades de registre.<br>Ús només pels elements de registre.| | |interface\_ref|\-|`cadena`|Format: `if<N>`|Referència a la interfície de l'equip.| | |jmx\_endpoint|\-|`cadena`| |Punt final JMX.<br><br>Només l'empren els elements de l'agent JMX.| | |url|\-|`cadena`| |Cadena d'URL.<br><br>Només cal per als elements de l'agent HTTP.| | |allow\_traps|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Permet que el valor s'ompli com en un element de trapper.<br><br>Emprat només amb elements de l'agent HTTP.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - SÍ (per defecte)|Seguiu les redireccions de resposta HTTP quan s'afegeixin dades.<br><br>Només s'empren els elements de l'agent HTTP.| |headers| |\-| | |L'element arrel per a les capçaleres de peticions HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br>Només l'empren els elements de capçalera d'Agent HTTP.| | |name|x|`cadena`| |Nom de la capçalera.| | |value|x|`cadena`| |Valor de la capçalera.| | |http\_proxy|\-|`cadena`| |Cadena de connexió del proxy HTTP(S).<br><br>Només s'empren els elements de l'agent HTTP.| | |output\_format|\-|`string`|0 - RAW (predeterminat)<br>1 - JSON|Com processar la resposta.<br><br>Ús només pels elements de l'agent HTTP.| | |post\_type|\-|`string`|0 - RAW (predeterminat)<br>2 - JSON<br>3 - XML|Tipus de cos de dades de publicació.<br><br>Només s'empren els elements de l'agent HTTP.| | |posts|\-|`cadena`| |Dades del cos de la petició HTTP(S).<br><br>Només s'empren els elements de l'agent HTTP.| |query\_fields| |\-| | |Element arrel per als paràmetres de consulta.<br><br>Només l'empren els elements de l'agent HTTP.| | |name|x|`cadena`| |Nom del paràmetre.| | |value|\-|`cadena`| |Valor del paràmetre.| | |request\_method|\-|`string`|0 - GET (per defecte)<br>1 - POST<br>2 - PUT<br>3 - HEAD|Mètode de petició.<br><br>Ús només per elements d'agent HTTP.| | |retrieve\_mode|\-|`string`|0 - COS (per defecte)<br>1 - CAPÇALERA<br>2 - AMBDÓS|Quina part de la resposta s'ha d'emmagatzemar.<br><br>Ús només per elements de l'agent HTTP.| | |ssl\_cert\_file|\-|`cadena`| |Camí al fitxer de clau SSL pública.<br><br>Només l'empren els elements de l'agent HTTP.| | |ssl\_key\_file|\-|`cadena`| |Camí al fitxer de clau SSL privada.<br><br>Només l'empren els elements de l'agent HTTP.| | |ssl\_key\_password|\-|`cadena`| |Mot de pas per al fitxer de clau SSL.<br><br>Només l'empren els elements de l'agent HTTP.| | |status\_codes|\-|`cadena`| |Intervals de codis d'estat HTTP obligatoris separats per comes. Admet macros d'usuari.<br>Exemple: 200.200-{\$M},{\$M},200-400<br><br>Només l'empren els elements de l'agent HTTP.| | |timeout|\-|`cadena`| |Temps d'espera de la petició de consulta de dades d'element. Admet macros d'usuari.<br><br>Emprat per l'agent HTTP i els elements d'script.| | |verify\_host|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Valida si el nom d'equip de la connexió coincideix amb el nom del certificat d'equip.<br><br>Ús només pels elements de l'agent HTTP.| | |verify\_peer|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Valida si el certificat de l'equip és autèntic.<br><br>Només l'empra l'agent HTTP dels iguals.| |parameters| |\-| | |Element arrel per als paràmetres definits per l'usuari.<br><br>Només l'empren els elements de l'script.| | |name|x|`cadena`| |Nom del paràmetre.<br><br>Només l'empren els elements de l'script.| | |value|\-|`cadena`| |Valor del paràmetre.<br><br>Només l'empren els elements de l'script.| |value map| |\-| | |Coincidència de valors.| | |name|x|`cadena`| |Nom del mapa de valors que s'emprarà per a l'element.| |preprocessing| |\-| | |Element arrel per al preprocessament del valor de l'element.| |step| |\-| | |Passa de preprocessament del valor d'element individual.| | |type|x|`string`|1 - MULTIPLICADOR<br>2 - RTRIM<br>3 - LTRIM<br>4 - TRIM<br>5 - REGEX<br>6 - BOOL\_TO\_DECIMAL<br>7 - OCTAL\_TO\_DECIMAL<br>8 - HEX\_TO\_DECIMAL<br>9 - SIMPLE\_CHANGE (calculat com a (valor rebut-valor anterior))<br>10 - CHANGE\_PER\_SECOND (calculat com a (valor valor rebut-anterior)/(hora actual-hora de darrera comprovació))<br>11 - XMLPATH<br>12 - JSONPATH<br>13 - IN\_RANGE<br>14 - MATCHES\_REGEX<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>18 - CHECK\_REGEX\_ERROR<br>19 - DISCARD\_UNCHANGED<br>20 - DESCART\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>22 - PROMETHEUS\_PATTERN<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>26 - CHECK\_NOT\_SUPPORTED<br>27 - XML\_TO\_JSON|Tipus de passa de preprocessament del valor de l'element.| | |parameters|\-| | |Element arrel per als paràmetres de la passa de preprocessament del valor de l'element.| | |parameter|x|`cadena`| |Paràmetre individual de la passa de preprocessament del valor de l'element.| | |error\_handler|\-|`string`|0 - ORIGINAL\_ERROR (per defecte)<br>1 - DESCART\_VALUE<br>2 - CUSTOM\_VALUE<br>3 - CUSTOM\_ERROR|Tipus d'acció a emprendre si la passa de preprocessament falla.| | |error\_handler\_params|\-|`cadena`| |Paràmetres del gestor d'errors emprats amb 'error\_handler'.| |master\_item| |\-| | |Element individual de l'element principal.<br><br>Requerit pels elements dependents.| | |key|x|`cadena`| |Valor clau de l'element principal de l'element dependent.<br><br>Es permet la recursió fins a 3 elements dependents i un nombre màxim d'elements dependents igual a 29.999.| |triggers| |\-| | |Element arrel per a triggers simples.| | |*Per als valors de l'etiqueta de trigger, veieu [etiquetes de trigger d'equips](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |tags| |\-| | |Element arrel per a les etiquetes d'elements.| | |tag|x|`cadena`| |Nom de l'etiqueta.| | |value|\-|`cadena`| |Valor de l'etiqueta.|

en-us	##### Host low-level discovery rule tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Root element for low-level discovery rules.| | |*For most of the element tag values, see element tag values for a regular item. Only the tags that are specific to low-level discovery rules, are described below.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (default)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERNAL<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERNAL<br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Item type.| | |lifetime|\-|`string`|Default: 30d|Time period after which items that are no longer discovered will be deleted. Seconds, time unit with suffix or user macro.| |filter| | | | |Individual filter.| | |evaltype|\-|`string`|0 - AND\_OR (default)<br>1 - AND<br>2 - OR<br>3 - FORMULA|Logic to use for checking low-level discovery rule filter conditions.| | |formula|\-|`string`| |Custom calculation formula for filter conditions.| |conditions| |\-| | |Root element for filter conditions.| | |macro|x|`string`| |Low-level discovery macro name.| | |value|\-|`string`| |Filter value: regular expression or global regular expression.| | |operator|\-|`string`|8 - MATCHES\_REGEX (default)<br>9 - NOT\_MATCHES\_REGEX|Condition operator.| | |formulaid|x|`character`| |Arbitrary unique ID that is used to reference a condition from the custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |lld\_macro\_paths| |\-| | |Root element for LLD macro paths.| | |lld\_macro|x|`string`| |Low-level discovery macro name.| | |path|x|`string`| |Selector for value which will be assigned to the corresponding macro.| |preprocessing| |\-| | |LLD rule value preprocessing.| |step| |\-| | |Individual LLD rule value preprocessing step.| | |*For most of the element tag values, see element tag values for a host item value preprocessing. Only the tags that are specific to low-level discovery value preprocessing, are described below.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Type of the item value preprocessing step.| |trigger\_prototypes| |\-| | |Root element for trigger prototypes.| | |*For trigger prototype element tag values, see regular [host trigger](/manual/xml_export_import/hosts#host_trigger_tags) tags.*| | | | | |graph\_prototypes| |\-| | |Root element for graph prototypes.| | |*For graph prototype element tag values, see regular [host graph](/manual/xml_export_import/hosts#host_graph_tags) tags.*| | | | | |host\_prototypes| |\-| | |Root element for host prototypes.| | |*For host prototype element tag values, see regular [host](/manual/xml_export_import/hosts#host_tags) tags.*| | | | | |item\_prototypes| |\-| | |Root element for item prototypes.| | |*For item prototype element tag values, see regular [host item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |master\_item| |\-| | |Individual item prototype master item/item prototype data.| | |key|x|`string`| |Dependent item prototype master item/item prototype key value.<br><br>Required for a dependent item.|
ca	##### Etiquetes de regla de descoberta de baix nivell  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |discovery\_rules| |\-| | |Element arrel per a regles de descoberta de baix nivell.| | |*Per a la majoria dels valors de l'etiqueta d'element, consulteu els valors de l'etiqueta d'element per a un element estàndard. A continuació només es descriuen les etiquetes específiques de les regles de descoberta de baix nivell.*| | | | | | |type|\-|`string`|0 - ZABBIX\_PASSIVE (per defecte)<br>2 - TRAP<br>3 - SIMPLE<br>5 - INTERN<br>7 - ZABBIX\_ACTIVE<br>10 - EXTERN <br>11 - ODBC<br>12 - IPMI<br>13 - SSH<br>14 - TELNET<br>16 - JMX<br>18 - DEPENDENT<br>19 - HTTP\_AGENT<br>20 - SNMP\_AGENT|Tipus d'element.| | |lifetime|\-|`string`|Per defecte: 30d|Període després del qual s'esborraran els elements que no es trobn. Segons, unitat de temps amb sufix o macro d'usuari.| |filter| | | | |Filtre individual.| | |evaltype|\-|`string`|0 - I\_O (per defecte)<br>1 - I<br>2 - O<br>3 - FORMULA|Lògica que s'empra per comprovar les condicions de filtre de les regles de descoberta de baix nivell.| | |formula|\-|`cadena`| |Fórmula de càlcul personalitzada per a condicions de filtre.| |conditions| |\-| | |Element arrel per a condicions de filtre.| | |macro|x|`cadena`| |Nom de la macro de descoberta de baix nivell.| | |value|\-|`cadena`| |Valor del filtre: expressió regular o expressió regular global.| | |operator|\-|`string`|8 - MATCHES\_REGEX (per defecte)<br>9 - NOT\_MATCHES\_REGEX|Operador de condició.| | |formulaid|x|`caràcter`| |ID únic arbitrari emprat per fer referència a una condició de l'expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho demani més endavant.| |lld\_macro\_paths| |\-| | |Element arrel per a camins de macro LLD.| | |lld\_macro|x|`cadena`| |Nom de la macro de descoberta de baix nivell.| | |path|x|`cadena`| |Selector de valors que s'assignarà a la macro corresponent.| |preprocessing| |\-| | |Preprocessament del valor de la regla LLD.| |step| |\-| | |Passa de preprocessament del valor de la regla LLD individual.| | |*Per a la majoria dels valors de l'etiqueta d'element, consulteu Valors de l'etiqueta d'element per al preprocessament del valor de l'element equip. Tot seguit es descriuen les etiquetes específiques per al preprocessament de valors de descoberta de baix nivell.*| | | | | | |type|x|`string`|5 - REGEX<br>11 - XMLPATH<br>12 - JSONPATH<br>15 - NOT\_MATCHES\_REGEX<br>16 - CHECK\_JSON\_ERROR<br>17 - CHECK\_XML\_ERROR<br>20 - DISCARD\_UNCHANGED\_HEARTBEAT<br>21 - JAVASCRIPT<br>23 - PROMETHEUS\_TO\_JSON<br>24 - CSV\_TO\_JSON<br>25 - STR\_REPLACE<br>27 - XML\_TO\_JSON|Tipus de passa de preprocessament del valor de l'element.| |trigger\_prototypes| |\-| | |Element arrel per a prototips de triggers.| | |*Per als valors de l'etiqueta d'element del prototip de trigger, consulteu les etiquetes habituals [trigger d'equip](/manual/xml_export_import/hosts#host_trigger_tags).*| | | | | |graph\_prototypes| |\-| | |Element arrel per a prototips de gràfics.| | |*Per als valors de l'etiqueta d'elements de gràfic prototip, veieu les etiquetes de [gràfics d'equip](/manual/xml_export_import/hosts#host_graph_tags).*| | | | | |host\_prototypes| |\-| | |Element arrel per a prototips d'equips.| | |*Per als valors de l'etiqueta d'element del prototip d'amfitrió, vegeu les etiquetes habituals [host](/manual/xml_export_import/hosts#host_tags).*| | | | | |item\_prototypes| |\-| | |Element arrel per a prototips d'elements.| | |*Per als valors de l'etiqueta d'element del prototip d'element, consulteu les etiquetes [element d'equip](/manual/xml_export_import/hosts#host_item_tags).*| | | | | |master\_item| |\-| | |Prototip d'element individual Element mestre/Dades de prototip d'element.| | |key|x|`cadena`| |Valor clau de l'element principal del prototip d'element dependent/prototip d'element.<br><br>Requerit per a un element dependent.|

en-us	### Host macro  The host macro object defines a macro available on a host, host prototype or template. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostmacroid|string|*(readonly)* ID of the host macro.| |**hostid**<br>(required)|string|ID of the host that the macro belongs to.| |**macro**<br>(required)|string|Macro string.| |**value**<br>(required)|string|Value of the macro.| |type|integer|Type of macro.<br><br>Possible values:<br>0 - *(default)* Text macro;<br>1 - Secret macro;<br>2 - Vault secret.| |description|string|Description of the macro.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Macro d'equip  L'objecte defineix una macro disponible a un equip, prototip d'equip o plantilla. Té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostmacroid|string|*(només lectura)* ID de la macro d'equip.| |**hostid**<br>(obligatori)|string|ID de l'equip a qui pertany la macro.| |**macro**<br>(obligatori)|string|Cadena de la macro.| |**valor**<br>(obligatori)|string|Valor de la macro.| |type|integer|Tipus de la macro.<br><br>Valors possibles:<br>0 - *(per defecte)* Text de la macro;<br>1 - Macro secreta;<br>2 - Secret de caixa de cabals.| |description|string|Descripció de la macro.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	Host markers displayed on the map have the color of the host's most serious problem and green color if a host has no problems. Clicking on a host marker allows viewing the host's visible name and the number of unresolved problems grouped by severity. Clicking on the visible name will open [host menu](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Hosts displayed on the map can be filtered by problem severity. Press on the filter icon in the widget's upper right corner and mark the required severities.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)
ca	Els marcadors d'equips que es mostren al mapa tenen el color del problema més greu de l'equip i el color verd si un equip no té cap problema. Si feu clic a un marcador d'equip, es mostra el nom visible de l'equip i el nombre de problemes no resolts agrupats per gravetat. Si feu clic al nom visible, s'obrirà el [menú de l'equip](/manual/web_interface/frontend_sections/monitoring/dashboard#host_menu).  Els equips que es mostren al mapa es poden filtrar per la gravetat del problema. Toqueu la icona de filtre a l'extrem superior dret del giny i marqueu la gravetat que considereu.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget_filter.png)

en-us	# host.massadd
ca	# host.massadd

en-us	# host.massremove
ca	# host.massremove

en-us	# host.massupdate
ca	# host.massupdate

en-us	#### Host menu  Clicking on a host in the *Problems* widget brings up the host menu. It includes links to host inventory, latest data, problems, graphs, dashboards, web scenarios and configuration. Note that host configuration is available for Admin and Superadmin users only.  ![](../../../../../assets/en/manual/web_interface/host_menu.png)  [Global scripts](/manual/web_interface/frontend_sections/administration/scripts) can also be run from the host menu. These scripts need to have their scope defined as 'Manual host action' to be available in the host menu.  The host menu is accessible by clicking on a host in several other frontend sections:  -   Monitoring → [Problems](problems) -   Monitoring → [Problems](problems) → Event details -   Monitoring → [Hosts](hosts) -   Monitoring → Hosts → [Web     Monitoring](/manual/web_interface/frontend_sections/monitoring/hosts/web) -   Monitoring → [Latest data](latest_data) -   Monitoring → [Maps](maps) -   Reports → [Triggers top     100](/manual/web_interface/frontend_sections/reports/triggers_top)
ca	#### Menú equips  Si feu clic a un equip al giny *Problemes*, s'obre el menú d'equips. Inclou enllaços a l'inventari d'allotjament, dades més recents, problemes, gràfics, taulers, escenaris web i configuració. Tingueu en compte que la configuració de l'equip només és disponible per als usuaris administradors i superadministradors.  ![](../../../../../assets/en/manual/web_interface/host_menu.png)  També es poden executar [Guions globals](/manual/web_interface/frontend_sections/administration/scripts) des del menú de l'equip. Aquests scripts han de tindre el seu abast definit a "Acció manual de l'equip" perquè estiguin disponibles al menú de l'equip.  Es pot accedir al menú de l'equip fent clic a un equip en diverses altres seccions de la interfície:  - Monitoratge → [Problemes](problems) - Monitoratge → [Problemes](problems) → Detalls de l'esdeveniment - Monitoratge → [Equips](hosts) - Monitoratge → Equips → [Web](/manual/web_interface/frontend_sections/monitoring/hosts/web) - Monitoratge → [Darreres dades](latest_data) - Monitoratge → [Mapes](maps) - Informes → [Els 100 triggers principals](/manual/web_interface/frontend_sections/reports/triggers_top)

en-us	##### Hostname parameter  To perform [active checks](/manual/appendix/items/activepassive#active_checks) on a host Zabbix agent needs to have the hostname defined. Moreover, the hostname value set on the agent side should exactly match the "[Host name](/manual/config/hosts/host)" configured for the host in the frontend.  The hostname value on the agent side can be defined by either the **Hostname** or **HostnameItem** parameter in the agent [configuration file](/manual/appendix/config/zabbix_agentd_win) - or the default values are used if any of these parameters are not specified.  The default value for **HostnameItem** parameter is the value returned by the "system.hostname" agent key. For Windows, it returns result of the gethostname() function, which queries namespace providers to determine the local host name. If no namespace provider responds, the NetBIOS name is returned.  The default value for **Hostname** is the value returned by the **HostnameItem** parameter. So, in effect, if both these parameters are unspecified, the actual hostname will be the host NetBIOS name; Zabbix agent will use NetBIOS host name to retrieve the list of active checks from Zabbix server and send results to it.  The "system.hostname" key supports two optional parameters - *type* and *transform*.  *Type* parameter determines the type of the name the item should return. Supported values:  -   *netbios* (default) - returns the NetBIOS host name which is limited     to 15 symbols and is in the UPPERCASE only; -   *host* - case-sensitive, returns the full, real Windows host name (without a domain); -   *shorthost* (supported since Zabbix 5.4.7) - returns part of the     hostname before the first dot. It will return a full string if the     name does not contain a dot.  *Transform* parameter is supported since Zabbix 5.4.7 and allows to specify additional transformation rule for the hostname. Supported values:  -   *none* (default) - use the original letter case; -   *lower* - convert the text into lowercase.  So, to simplify the configuration of zabbix\_agentd.conf file and make it unified, two different approaches could be used.  1.  leave **Hostname** or **HostnameItem** parameters undefined and     Zabbix agent will use NetBIOS host name as the hostname; 2.  leave **Hostname** parameter undefined and define **HostnameItem**     like this:\     **HostnameItem=system.hostname\[host\]** - for Zabbix agent to use     the full, real (case sensitive) Windows host name as the hostname\     **HostnameItem=system.hostname\[shorthost,lower\]** - for Zabbix     agent to use only part of the hostname before the first dot,     converted into lowercase.  Host name is also used as part of Windows service name which is used for installing, starting, stopping and uninstalling the Windows service. For example, if Zabbix agent configuration file specifies `Hostname=Windows_db_server`, then the agent will be installed as a Windows service "`Zabbix Agent [Windows_db_server]`". Therefore, to have a different Windows service name for each Zabbix agent instance, each instance must use a different host name.
ca	##### Paràmetre Hostname  Per fer [verificacions actives](/manual/appendix/items/activepassive#active_checks) d'un equip, l'agent Zabbix ha de definir el nom de l'equip. A més, el valor del nom d'equip definit ha de ser el mateix que el "[Nom d'equip](/manual/config/hosts/host)" configurar per l'equip a la interfície.  El valor del nom d'equip de la banda de l'agent es pot definir amb el paràmetre **Hostname** o **HostnameItem**, a l'[arxiu de configuració](/manual/appendix/config/zabbix_agentd_win) de l'agent - o els valors per defecte s'empren si cap paràmetre és especificat.  El valor per defecte del paràmetre **HostnameItem** és el valor reenviat per la clau de l'agent "system.hostname". Per Windows, reenvia el resultat de la funció gethostname(), qui demana els proveïdors d'espais de noms per determinar el nom d'equip local. si cap proveïdor de noms respon, enviarà el nom NetBIOS.  El valor per defecte de **Hostname** és el valor reenviat per el paràmetre **HostnameItem**. Per tant, si aquests dos paràmetres no són pas especificats, el nom d'equip real serà el nom NetBIOS de l'equip; i l'agent Zabbix emprarà el nom d'equip NetBIOS per recuperar la llista de verificacions actives del servidor Zabbix i enviar-li els resultats.  La clau "system.hostname" suporta dos paràmtres opcionals - *type* i *transform*.  El paràmetre *Type* determina el tipus de nom que l'element ha d'enviar. Valors admesos:  -   *netbios* (per defecte) - retorna el nom d'equip NetBIOS, limitat a 15 símbols i només en MAJÚSCULES; -   *host* - sensible a majúscules i minúscules, retorna el nom real d'equip Windows sencer (sense domini); -   *shorthost* (suportat des de Zabbix 5.4.7) - retorna una part del nom d'equip abans del primer punt. Retornarà una cadena sencera si el nom no té cap punt.  El paràmetre *transform* es suporta des de Zabbix 5.4.7 i permet especificar una regla de transformació addicional per al nom d'equip. Valors admesos:  -   *none* (per defecte) - empra el text original, em majúscules o minúscules; -   *lower* - converteix el text a minúscules.  Per tant, per simplificar la configuració de l'arxiu zabbix\_agentd.conf i unificar, es poden emprar dues maneres diferents.  1.  deixar els paràmetres **Hostname** o **HostnameItem** sense definir i l'agent Zabbix emprarà el nom d'equip NetBIOS com a nom d'equip; 2.  deixar el paràmetre **Hostname** sense definir i definir **HostnameItem** així:\ **HostnameItem=system.hostname\[host\]** - perquè l'agent Zabbix empri el nom d'equip Windows sencer i real (sensible a majúscules i minúscules) com a nom d'equip\ **HostnameItem=system.hostname\[shorthost,lower\]** - perquè l'agent Zabbix només empri una part del nom d'equip abans del primer punt, convertit a minúscules.  El nom d'equip s'empra igualment al quadre del nom de servei Windows que s'empra per instal·lar, aturar, engegar i desinstal·lar el servei Windows. Per exemple, si l'arxiu de configuració de l'agent Zabbix especifica `Hostname=Windows_db_server`, llavors l'agent s'instal·larà com a servei Windows "`Zabbix Agent [Windows_db_server]`". Per tant, per tindre un nom de servei Windows diferent per cada instància d'agent Zabbix, cada instància ha d'emprar un nom d'equip diferent.

en-us	##### Host naming  When adding hosts, a host name is the result of reverse DNS lookup or IP address if reverse lookup fails. Lookup is performed from the Zabbix server or Zabbix proxy, depending on which is doing the discovery. If lookup fails on the proxy, it is not retried on the server. If the host with such a name already exists, the next host would get **\_2** appended to the name, then **\_3** and so on.  It is also possible to override DNS/IP lookup and instead use an item value for host name, for example:  -   You may discover multiple servers with Zabbix agent running using a     Zabbix agent item for discovery and assign proper names to them     automatically, based on the string value returned by this item -   You may discover multiple SNMP network devices using an SNMP agent     item for discovery and assign proper names to them automatically,     based on the string value returned by this item  If the host name has been set using an item value, it is not updated during the following discovery checks. If it is not possible to set host name using an item value, default value (DNS name) is used.  If a host already exists with the discovered IP address, a new host is not created. However, if the discovery action contains operations (link template, add to host group, etc), they are performed on the existing host.
ca	##### Nomenament de l'equip  Quan s'afegeixen equips, un nom d'equip és el resultat d'una cerca DNS inversa o una adreça IP si la cerca inversa falla. La cerca es realitza des del servidor Zabbix o des del proxy Zabbix, depenent de quina és fent la descoberta. Si la cerca falla al proxy, no es torna a provar al servidor. Si l'equip amb aquest nom ja existeix, el següent equip tindrà **_2** afegit al nom, després **_3** i així successivament.  També és possible anul·lar la cerca DNS/IP i emprar un valor d'element per al nom d'equip, per exemple:  - Podeu descobrir diversos servidors amb l'agent Zabbix en execució mitjançant un element d'agent Zabbix per a la descoberta i assignar-los automàticament noms propis, en funció del valor de cadena que retorna aquest element - Podeu descobrir diversos dispositius de xarxa SNMP mitjançant un element d'agent SNMP per a la descoberta i assignar-los automàticament noms propis, en funció del valor de cadena que retorna aquest element  Si el nom d'equip es va establir amb un valor d'element, no s'actualitzarà en comprovacions de descoberta posteriors. Si no és possible establir el nom d'equip mitjançant un valor d'element, s'empra el valor per defecte (nom DNS).  Si ja existeix un equip amb l'adreça IP descoberta, no s'en crea cap de nou. Tanmateix, si l'acció de descoberta conté operacions (enllaç a una plantilla, afegir a un grup d'equip, etc.), es realitzen a l'equip existent.

en-us	# > Host object  The following objects are directly related to the host API.
ca	# > Objecte equip  Els següents objectes són relacionats amb l'API d'equip.

en-us	#### host prototype  Changes:\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: dropped support of properties `group_prototypeid`, `hostid`, `templateid` of group link and group prototype API objects.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: dropped the ability to modify the readonly fields `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` of inherited host prototypes.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: added strict validation of the method parameters.\
ca	#### Prototipus d'equip  Canvis :\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.get`: es deixa de suportar les propietats `group_prototypeid`, `hostid`, `templateid` dels objetes API dels enllaços i prototips de grups.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.update`: es treu la possibilitat de modificar els camps de només lectura `host`, `name`, `custom_interfaces`, `interfaces`, `groupLinks`, `groupPrototypes`, `templates`, `tags`, `macros`, `inventory_mode` dels prototipus d'equips heretats.\ [ZBXNEXT-6959](https://support.zabbix.com/browse/ZBXNEXT-6959) `hostprototype.create`, `hostprototype.update`, `hostprototype.delete`: afegida una validació estricta dels paràmetres del mètode.\

en-us	#### hostprototype  Changes:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: the parameter `uuid` can now be updated.\
ca	#### prototip d'equips  Canvis:\ [ZBXNEXT-7951](https://support.zabbix.com/browse/ZBXNEXT-7951) `hostprototype.update`: el paràmetre `uuid` ara es pot actualitzar.\

en-us	# hostprototype.create
ca	# hostprototype.create

en-us	# hostprototype.delete
ca	# hostprototype.delete

en-us	# hostprototype.get
ca	# hostprototype.get

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

en-us	#### Host prototypes  Host prototypes can be created with the low-level discovery rule. When virtual machines  are discovered, these prototypes are the basis for generating real hosts. Prototypes, before becoming discovered, cannot have their own items and triggers, other than those from the linked templates.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png){width="600"}  In order for hosts created from a prototype to have unique host names, the *Host name* field must contain at least one [low-level discovery macro](/manual/config/macros/lld_macros).  Since Zabbix 5.2, discovered hosts may be configured with custom interfaces or inherit the IP of a host the discovery rule belongs to (default). To add one or more custom interface, switch the *Interface* selector from *Inherit* to *Custom* mode, then press ![add\_link.png](../../assets/en/manual/config/add_link.png) and select the required interface type from the drop-down menu that appears. All supported types of interfaces can be defined for a host prototype: Zabbix agent, SNMP, JMX, IPMI. Interface fields support low-level discovery macros and [user macros](/manual/config/macros/user_macros). If several custom interfaces are specified - use the *Default* column to specify the primary interface.  Notes:  -   If *Custom* is selected, but no interfaces have been specified the     hosts will be created without interfaces. -   If *Inherit* is selected for a host prototype that belongs to a     template, discovered hosts will inherit the interface of a host to     which the template is linked to.  ::: notewarning  A host will not be created, if the host interface contains incorrect data  :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  LLD macros can also be used for the visible name, host group prototype fields, tag values, or values of host prototype user macros.  Other options that can be specified for a host prototype are:  -   Linkage to existing host groups -   Template linkage -   Encryption  If *Create enabled* is checked, the host will be added in an enabled state. If unchecked, the host will be added, but in a disabled state.  If *Discover* is checked (default), the host will be created. If unchecked, the host will not be created, unless this setting is overridden in the [discovery rule](/manual/discovery/low_level_discovery#override). This functionality provides additional flexibility when creating discovery rules.  Discovered hosts are prefixed with the name of the discovery rule that created them, in the host list. Discovered hosts can be manually deleted. Discovered hosts will also be automatically deleted, based on the *Keep lost resources period (in days)* value of the discovery rule. Most of the configuration options are read-only, except for enabling/disabling the host and host inventory.  ::: noteclassic Zabbix does not support nested host prototypes, i.e. host prototypes are not supported on hosts that are discovered by low-level discovery rule. :::
ca	#### Prototips d'equips  Els prototips d'equips es poden crear amb la regla de descoberta de baix nivell. Quan es descobreixen màquines virtuals, aquests prototips es converteixen en equips reals. Els prototips, abans de ser trobats, no poden tindre els seus propis elements i triggers, excepte els de les plantilles enllaçades. Els equips trobats pertanyeran a un equip existent.  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes.png){width="600"}  Perquè els equips creats a partir d'un prototip tinguin noms d'equip únics, el camp *Nom d'equip* ha de contindre almenys una [macro de descoberta de baix nivell](/manual/config/macros/lld_macros).  Des de Zabbix 5.2, els equips descoberts es poden configurar amb interfícies personalitzades o heretar la IP d'un equip al qual pertany la regla de descoberta (per defecte). Per afegir una o més interfícies personalitzades, canvieu el selector *Interfície* del mode *Heretar* al mode *Personalitzat* i, a continuació, premeu ![add\_link.png](../../assets/en/manual/config/add_link .png) i trieu el tipus d'interfície requerit al menú desplegable que apareix. Tots els tipus d'interfícies compatibles es poden definir per a un prototip d'equip: agent Zabbix, SNMP, JMX, IPMI. Els camps de la interfície admeten macros de descoberta de baix nivell i [macros d'usuari](/manual/config/macros/user_macros). Si s'especifiquen diverses interfícies personalitzades, empreu la columna *Predeterminada* per especificar la interfície principal.  Notes:  - 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 qual la plantilla és enllaçada.  ::: notewarning   No es crearà cap equip si la interfície de l'equip conté dades incorrectes :::  ![](../../assets/en/manual/vm_monitoring/vm_host_prototypes_if2.png)  Les macros LLD també es poden emprar per al nom visible, els camps del prototip del grup d'equip, els valors de l'etiqueta o els valors de les macros d'usuari del prototip de l'equip.  Altres opcions que es poden especificar per a un prototip d'equip són:  - Enllaç amb grups d'acollida existents - Enllaç de plantilles - Xifrat  Si s'ha marcat *Crear activat*, l'equip s'afegirà en estat habilitat. Si no és marcat, s'afegirà l'equip, però en un estat desactivat.  Si és marcat *Descoberta* (per defecte), es crearà l'equip. Si no és marcat, l'equip no es crearà, tret que aquesta configuració es substitueixi a la [regla de descoberta](/manual/discovery/low_level_discovery#override). Aquesta funcionalitat proporciona flexibilitat addicional a l'hora de crear regles de descoberta.  Els equips descoberts tenen com a prefix el nom de la regla de descoberta que els ha creat, a la llista d'equips. Els equips descoberts es poden esborrar manualment. Els equips descoberts també s'esborraran automàticament, en funció del valor de la regla de descoberta *Conservar el període de recursos perduts (en dies)*. La majoria de les opcions de configuració són de només lectura, tret d'activar/desactivar l'inventari de l'equip i l'equip.  ::: noteclassic Zabbix no admet prototips d'equip heretats, és a dir, els prototips d'equip no s'admeten als equips que es troben per regla de descoberta de baix nivell. :::

en-us	### Host prototype tag  The host prototype tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host prototype tag name.| |value|string|Host prototype tag value.|
ca	### Etiqueta de prototip d'equips  L'objecte d'etiqueta de prototip d'equips té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta de prototip d'equips.| |value|string|Valor de l'etiqueta de prototip d'equips.|

en-us	### Host prototype  The host prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host prototype.| |**host**<br>(required)|string|Technical name of the host prototype.| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.| |status|integer|Status of the host prototype.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|string|*(readonly)* ID of the parent template host prototype.| |discover|integer|Host prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new hosts will be discovered;<br>1 - new hosts will not be discovered and existing hosts will be marked as lost.| |custom\_interfaces|integer|Source of interfaces for hosts created by the host prototype.<br><br>Possible values:<br>0 - *(default)* inherit interfaces from parent host;<br>1 - use host prototypes custom interfaces.| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Used only for host prototypes on templates. Auto-generated, if not given.<br><br>For update operations this field is *readonly*.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Prototipus d'equip  L'objecte prototip d'equip té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|*(només lectura)* ID del prototip d'equips.| |**host**<br>(obligatori)|cadena|Nom tècnic del prototip d'equips.| |name|string|Nom visible del prototip d'equips.<br><br>Per defecte: valor de la propietat `host`.| |status|integer|Estat del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* equip supervisat;<br>1 - equip no supervisat.| |inventory\_mode|integer|Mode d'omplerta d'inventari de l'equip.<br><br>Els valors possibles són:<br>-1 - *(per defecte)* desactivat;<br>0 - manual ;<br>1 - automàtic .| |templateid|string|*(només lectura)* ID de la plantilla principal del prototip d'equips.| |discover|integer|Estat de descobriment del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran nous equips;<br>1 - no es descobriran els nous equips i els existents es marcaran com a perduts.| |custom\_interfaces|integer|Font de les interfícies dels equips creats per el prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* hereta les interfícies de l'equip principal; <br>1 - empra personalitzat interfícies de prototips d'equips.| |uuid|string|Identificador universal únic, que s'empra per enllaçar els prototips d'equips importats amb els existents. S'empra només per a prototips d'equips en models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Host prototype  This class is designed to work with host prototypes.  Object references:\  -   [Host     prototype](/manual/api/reference/hostprototype/object#host_prototype) -   [Host prototype     inventory](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Group link](/manual/api/reference/hostprototype/object#group_link) -   [Group     prototype](/manual/api/reference/hostprototype/object#group_prototype)  Available methods:\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) -     creating new host prototypes -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) -     deleting host prototypes -   [hostprototype.get](/manual/api/reference/hostprototype/get) -     retrieving host prototypes -   [hostprototype.update](/manual/api/reference/hostprototype/update) -     updating host prototypes
ca	# Prototipus d'equip  Aquesta classe és dissenyada per treballar amb prototipus d'equips.  Referències d'objectes:\  -   [Prototipus d'equip](/manual/api/reference/hostprototype/object#host_prototype) -   [Inventari de prototipus d'equip](/manual/api/reference/hostprototype/object#host_prototype_inventory) -   [Enllaç de grup](/manual/api/reference/hostprototype/object#group_link) -   [Prototipus de grup](/manual/api/reference/hostprototype/object#group_prototype)  Mètodes disponibles:\  -   [hostprototype.create](/manual/api/reference/hostprototype/create) - crear nou prototipus d'equip -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) - esborrar prototipus d'equip -   [hostprototype.get](/manual/api/reference/hostprototype/get) -recuperar prototipus d'equip -   [hostprototype.update](/manual/api/reference/hostprototype/update) - actualitzar prototipus d'equip

en-us	# hostprototype.update
ca	# hostprototype.update

en-us	##### Host removal  Hosts discovered by a network discovery rule are removed automatically from *Monitoring* → *Discovery* if a discovered entity is not in the rule's IP range any more. Hosts are removed immediately.
ca	##### Esborrar un equip  Els equips trobats per una regla de descoberta de xarxa s'esborren automàticament de *Monitoratge* → *Descoberta* si una entitat descoberta no es troba pas al rang IP de la regla. Els equips s'esborren de seguida.

en-us	#### Hosts and host groups  Manage host groups, hosts and everything related to them, including host interfaces, host macros and maintenance periods.  [Host API](/manual/api/reference/host) | [Host group API](/manual/api/reference/hostgroup) | [Host interface API](/manual/api/reference/hostinterface) | [User macro API](/manual/api/reference/usermacro) | [Value map API](/manual/api/reference/valuemap) | [Maintenance API](/manual/api/reference/maintenance)
ca	#### Equips i grup d'equips  Gestionar els grups d'equips, els equips i tot el que hi ha relacionat, fins i tot les interfícies i les macros d'equips i els períodes de manteniment.  [API Equip](/manual/api/reference/host) | [API Grup d'equips](/manual/api/reference/hostgroup) | [API Interfície d'equip](/manual/api/reference/hostinterface) | [API Macro d'usuari](/manual/api/reference/usermacro) | [API Mapa de valors](/manual/api/reference/valuemap) | [API Manteniment](/manual/api/reference/maintenance)

en-us	#### Hosts/host prototypes  In a [host](/manual/config/hosts/host) and [host prototype](/manual/vm_monitoring#host_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interface IP/DNS|<|DNS only| |Interface port|<|no| |*SNMP v1, v2*|<|<| | |SNMP community|yes| |*SNMP v3*|<|<| | |Context name|yes| |^|Security name|yes| |^|Authentication passphrase|yes| |^|Privacy passphrase|yes| |*IPMI*|<|<| | |Username|yes| |^|Password|yes| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes|
ca	#### Equips/prototips d'equips  A la configuració d'[equip](/manual/config/hosts/host) i de [prototip d'equip](/manual/vm_monitoring#host_prototypes), les macros d'usuari es poden emprar en aquest camps:  |Ubicació|<|Múltiples macros/barreja de text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Interfície IP/DNS|<|només DNS| |Port d'Interfície|<|no| |*SNMP v1, v2*|<|<| | |Comunitat SNMP|sí| |*SNMP v3*|<|<| | |Nom del context|sí| |^|Nom de seguretat|sí| |^|Frase secreta d'autenticació|sí| |^|Frase secreta de confidencialitat|sí| |*IPMI*|<|<| | |Nom d'usuari|sí| |^|Paraula de pas|sí| |*Etiquetes*^[2](supported_by_location_user#footnotes)^|<|<| | |Noms d'etiqueta|sí| |^|Valors d'etiqueta|sí|

en-us	##### Host tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |groups| |x| | |Root element for host groups.| | |name|x|`string`| |Host group name.| |hosts| |\-| | |Root element for hosts.| | |host|x|`string`| |Unique host name.| | |name|\-|`string`| |Visible host name.| | |description|\-|`text`| |Host description.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Host status.| | |ipmi\_authtype|\-|`string`|-1 - DEFAULT (default)<br>0 - NONE<br>1 - MD2<br>2 - MD5<br>4 - STRAIGHT<br>5 - OEM<br>6 - RMCP\_PLUS|IPMI session authentication type.| | |ipmi\_privilege|\-|`string`|1 - CALLBACK<br>2 - USER (default)<br>3 - OPERATOR<br>4 - ADMIN<br>5 - OEM|IPMI session privilege level.| | |ipmi\_username|\-|`string`| |Username for IPMI checks.| | |ipmi\_password|\-|`string`| |Password for IPMI checks.| |proxy| |\-| | |Proxy.| | |name|x|`string`| |Name of the proxy (if any) that monitors the host.| |templates| |\-| | |Root element for linked templates.| | |name|x|`string`| |Template name.| |interfaces| |\-| | |Root element for host interfaces.| | |default|\-|`string`|0 - NO<br>1 - YES (default)|Whether this is the primary host interface.<br>There can be only one primary interface of one type on a host.| | |type|\-|`string`|1 - ZABBIX (default)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|Interface type.| | |useip|\-|`string`|0 - NO<br>1 - YES (default)|Whether to use IP as the interface for connecting to the host (if not, DNS will be used).| | |ip|\-|`string`| |IP address, can be either IPv4 or IPv6.<br><br>Required if the connection is made via IP.| | |dns|\-|`string`| |DNS name.<br><br>Required if the connection is made via DNS.| | |port|\-|`string`| |Port number. Supports user macros.| | |interface\_ref|x|`string`|Format: `if<N>`|Interface reference name to be used in items.| |details| |\-| | |Root element for interface details.| | |version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (default)<br>3 - SNMP\_V3|Use this SNMP version.| | |community|\-|`string`| |SNMP community.<br><br>Required by SNMPv1 and SNMPv2 items.| | |contextname|\-|`string`| |SNMPv3 context name.<br><br>Used only by SNMPv3 items.| | |securityname|\-|`string`| |SNMPv3 security name.<br><br>Used only by SNMPv3 items.| | |securitylevel|\-|`string`|0 - NOAUTHNOPRIV (default)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|SNMPv3 security level.<br><br>Used only by SNMPv3 items.| | |authprotocol|\-|`string`|0 - MD5 (default)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|SNMPv3 authentication protocol.<br><br>Used only by SNMPv3 items.| | |authpassphrase|\-|`string`| |SNMPv3 authentication passphrase.<br><br>Used only by SNMPv3 items.| | |privprotocol|\-|`string`|0 - DES (default)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 privacy protocol.<br><br>Used only by SNMPv3 items.| | |privpassphrase|\-|`string`| |SNMPv3 privacy passphrase.<br><br>Used only by SNMPv3 items.| | |bulk|\-|`string`|0 - NO<br>1 - YES (default)|Use bulk requests for SNMP.| |items| |\-| | |Root element for items.| | |*For item element tag values, see host [item](/manual/xml_export_import/hosts#host_item_tags) tags.*| | | | | |tags| |\-| | |Root element for host tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.| |macros| |\-| | |Root element for macros.| | |macro|x| | |User macro name.| | |type|\-|`string`|0 - TEXT (default)<br>1 - SECRET\_TEXT<br>2 - VAULT|Type of the macro.| | |value|\-|`string`| |User macro value.| | |description|\-|`string`| |User macro description.| |inventory| |\-| | |Root element for host inventory.| | |<inventory\_property>|\-| | |Individual inventory property.<br><br>All available inventory properties are listed under the respective tags, e.g. <type>, <name>, <os> (see example above).| |inventory\_mode| |\-|`string`|-1 - DISABLED<br>0 - MANUAL (default)<br>1 - AUTOMATIC|Inventory mode.| |valuemaps| |\-| | |Root element for host value maps.| | |name|x|`string`| |Value map name.| | |mapping|\-| | |Root element for mappings.| | |value|x|`string`| |Value of a mapping.| | |newvalue|x|`string`| |New value of a mapping.|
ca	##### Etiquetes d'equips  |Element|Propietat de l'element|Obligatori|Tipus|Interval^**[1](#footnote)**^|Descripció| |-------|-----------------|---------|-----|---------- ----------------|------------| |groups|<|x|<|<|Element arrel per a grups d'equips.| |<|name|x|`cadena`|<|Nom del grup d'equips.| |hosts|<|\-|<|<|Element arrel per a equips.| |<|host|x|`string`|<|Nom d'equip distingit. |<|name|\-|`cadena`|<|Nom visible d'equip.| |<|description|\-|`text`|<|Descripció de l'equip.| |<|status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'equip.| |<|ipmi\_authtype|\-|`cadena`|-1 - PER DEFECTE (predeterminat)<br>0 - CAP<br>1 - MD2<br>2 - MD5<br>4 - DRET<br>5 - OEM<br>6 - RMCP\_PLUS|Tipus d'autenticació de sessió IPMI.| |<|ipmi\_privilege|\-|`string`|1 - RECORDATORI<br>2 - USUARI (per defecte)<br>3 - OPERADOR<br>4 - ADMINISTRADOR<br>5 - OEM|Nivell de privilegi de la sessió IPMI .| |<|ipmi\_username|\-|`string`|<|Nom d'usuari per a comprovacions IPMI.| |<|ipmi\_password|\-|`string`|<|Mot de pas per a comprovacions IPMI.| |proxy|<|\-|<|<|Proxy.| |<|name|x|`string`|<|Nom del proxy (si n'hi ha) que monitora l'equip.| |templates|<|\-|<|<|Element arrel per a plantilles enllaçades.| |<|name|x|`cadena`|<|Nom de la plantilla.| |interfaces|<|\-|<|<|Element arrel per a les interfícies d'equip. |<|per defecte|\-|`cadena`|0 - NO<br>1 - SÍ (predeterminat)|Si aquesta és la interfície principal de l'equip.<br>Només pot haver-hi una única interfície principal d'un tipus en un equip.| |<|type|\-|`cadena`|1 - ZABBIX (per defecte)<br>2 - SNMP<br>3 - IPMI<br>4 - JMX|tipus d'interfície.| |<|useip|\-|`string`|0 - NO<br>1 - sí (per defecte)|Empreu la IP com a interfície per connectar-vos a l'equip (en cas contrari s'emprarà DNS).| |<|ip|\-|`string`|<|adreça IP, pot ser IPv4 o IPv6.<br><br>Requerit si us connecteu mitjançant una adreça IP.| |<|dns|\-|`string`|<|Nom DNS.<br><br>Requerit si es connecta mitjançant DNS.| |<|port|\-|`cadena`|<|Nombre de port. Admet macros d'usuari.| |<|interfície\_ref|x|`cadena`|Format: `if<N>`|Nom de referència de la interfície a emprar als elements.| |details|<|\-|<|<|Element arrel per als detalls de la interfície.| |<|version|\-|`string`|1 - SNMPV1<br>2 - SNMP\_V2C (per defecte)<br>3 - SNMP\_V3|Emprar aquesta versió de SNMP.| |<|community|\-|`cadena`|<|Comunitat SNMP.<br><br>Requerit pels elements SNMPv1 i SNMPv2.| |<|contextname|\-|`cadena`|<|Nom de context SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|securityname|\-|`string`|<|Nom de seguretat SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|securitylevel|\-|`string`|0 - NOAUTHNOPRIV (per defecte)<br>1 - AUTHNOPRIV<br>2 - AUTHPRIV|Nivell de seguretat SNMPv3.<br><br>Només s'empra per a elements SNMPv3. | |<|authprotocol|\-|`string`|0 - MD5 (per defecte)<br>1 - SHA1<br>2 - SHA224<br>3 - SHA256<br>4 - SHA384<br>5 - SHA512|Protocol d'autenticació SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|authpassphrase|\-|`cadena`|<|Frase de pas d'autenticació SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|privprotocol|\-|`string`|0 - DES (predeterminat)<br>1 - AES128<br>2 - AES192<br>3 - AES256<br>4 - AES192C<br>5 - AES256C|SNMPv3 protocol de privadesa.<br><br>Només s'empra per a elements SNMPv3.| |<|privpassphrase|\-|`cadena`|<|Frase de pas de privadesa SNMPv3.<br><br>Només s'empra per a elements SNMPv3.| |<|bulk|\-|`string`|0 - NO<br>1 - SÍ (per defecte)|Empreu consultes massives per a SNMP.| |items|<|\-|<|<|Element arrel dels elements.| |<|*Per als valors de l'etiqueta d'element, veieu [etiquetes d'element d'equip](/manual/xml_export_import/hosts#host_item_tags).*|<|<|<|<| |tags|<|\-|<|<|Element arrel per a les etiquetes d'equip.| |<|tag|x|`cadena`|<|Nom de l'etiqueta.| |<|value|\-|`cadena`|<|Valor de l'etiqueta.| |macros|<|\-|<|<|Element arrel per a macros.| |<|macro|x|<|<|Nom de la macro d'usuari.| |<|type|\-|`cadena`|0 - TEXT (per defecte)<br>1 - SECRET\_TEXT<br>2 - VAULT|Tipus de macro.| |<|value|\-|`cadena`|<|Valor de la macro d'usuari.| |<|description|\-|`cadena`|<|Descripció de la macro de l'usuari.| |inventory|<|\-|<|<|Element arrel per a l'inventari de l'amfitrió.| |<|<inventory\_property>|\-|<|<|Propietat d'inventari individual.<br><br>Totes les propietats d'inventari disponibles es mostren sota les etiquetes respectives, p. <tipus>, <nom>, <SO> (veieu l'exemple anterior).| |mode\_inventory|<|\-|`cadena`|-1 - DESACTIVAT<br>0 - MANUAL (per defecte)<br>1 - AUTOMÀTIC|Mode d'inventari.| |valuemaps|<|\-|<|<|Element arrel per a l'assignació de valors de l'equip.| |<|name|x|`cadena`|<|El nom del valor coincideix.| |<|mapping|\-|<|<|Element arrel per al mapeig.| |<|valor|x|`cadena`|<|Concorda amb el valor.| |<|newvalue|x|`string`|<|Nou valor de coincidència.|

en-us	### Host tag  The host tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Host tag name.| |value|string|Host tag value.|
ca	### Etiqueta d'equip  L'objecte d'etiqueta d'equip té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom de l'etiqueta d'equip.| |value|string|Valor de l'etiqueta d'equip.|

en-us	### Host  The host object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|*(readonly)* ID of the host.| |**host**<br>(required)|string|Technical name of the host.| |description|text|Description of the host.| |flags|integer|*(readonly)* Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values are:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values are:<br>-1 - *(default)* default;<br>0 - none;<br>1 - MD2;<br>2 - MD5<br>4 - straight;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|IPMI password.| |ipmi\_privilege|integer|IPMI privilege level.<br><br>Possible values are:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|*(readonly)* Starting time of the effective maintenance.| |maintenance\_status|integer|*(readonly)* Effective maintenance status.<br><br>Possible values are:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.| |maintenance\_type|integer|*(readonly)* Effective maintenance type.<br><br>Possible values are:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.| |maintenanceid|string|*(readonly)* ID of the maintenance that is currently in effect on the host.| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |proxy\_hostid|string|ID of the proxy that is used to monitor the host.| |status|integer|Status and function of the host.<br><br>Possible values are:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br><br>Possible bitmap values are:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_issuer|string|Certificate issuer.| |tls\_subject|string|Certificate subject.| |tls\_psk\_identity|string|*(write-only)* PSK identity. Required if either `tls_connect` or `tls_accept` has PSK enabled.<br>Do not put sensitive information in the PSK identity, it is transmitted unencrypted over the network to inform a receiver which PSK to use.| |tls\_psk|string|*(write-only)* The preshared key, at least 32 hex digits. Required if either `tls_connect` or `tls_accept` has PSK enabled.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Equip  L'objecte equip té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|*(només lectura)* ID de l'equip.| |**host**<br>(obligatori)|string|Nom tècnic de l'equip.| |description|text|Descripció de l'equip.| |flags|integer|*(només lectura)* Origen de l'equip.<br><br>Valors possibles:<br>0 - un equip normal;<br>4 - un equip descobert.| |inventory\_mode|integer|Mode de població d'inventari de l'equip.<br><br>Valors possibles:<br>-1 - *(per defecte)* desactivat;<br>0 - manual;<br>1 - automàtic.| |ipmi\_authtype|integer|Algorisme d'autenticació IPMI.<br><br>Valors possibles:<br>-1 - *(per defecte)* per defecte;<br>0 - cap;<br>1 - MD2; <br> 2 - MD5<br>4 - recte;<br>5 - OEM;<br>6 - RMCP+.| |ipmi\_password|string|mot de pas IPMI.| |ipmi\_privilege|integer|Nivell de privilegis IPMI.<br><br>Valors possibles:<br>1 - devolució de trucada;<br>2 - *(per defecte)* usuari;<br>3 - operador;<br >4 - admin;<br>5 - OEM.| |ipmi\_username|string|Nom d'usuari IPMI.| |maintenance\_from|timestamp|*(només lectura)* Hora d'inici del manteniment efectiu.| |maintenance\_status|integer|*(només lectura)* Estat efectiu del manteniment.<br><br>Valors possibles:<br>0 - *(per defecte)* sense manteniment;<br>1 - manteniment efectiu. | |maintenance\_type|integer|*(només lectura)* Tipus de manteniment efectiu<br><br>Valors possibles:<br>0 - *(per defecte)* manteniment amb recollida de dades;<br>1 - manteniment sense recollida de dades. | |maintenanceid|string|*(només lectura)* ID del manteniment vigent actualment a l'equip.| |name|string|Nom de l'equip visible.<br><br>Per defecte: valor de la propietat `equip`.| |proxy\_hostid|string|ID de proxy emprat per supervisar l'equip.| |status|integer|Estat i funció de l'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* equip supervisat;<br>1 - equip no supervisat.| |tls\_connect|integer|Connexions a l'equip.<br><br>Valors possibles:<br>1 - *(per defecte)* Sense xifrat;<br>2 - PSK;<br>4 - certificat.| |tls\_accept|integer|Connexions de l'equip.<br><br>Els valors de mapa de bits possibles són:<br>1 - *(per defecte)* Sense xifratge;<br>2 - PSK;<br> 4 - certificat. | |tls\_issuer|string|Emissor del certificat.| |tls\_subject|string|Assumpte del certificat.| |tls\_psk\_identity|string|*(només escriptura)*PSK Identitat. Necessari si `tls_connect` o `tls_accept` tenen PSK habilitat.| |tls\_psk|string|*(només escriptura)*La clau prèviament compartida, com a mínim 32 dígits hexadecimals. Necessari si `tls_connect` o `tls_accept` tenen PSK habilitat.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Host  This class is designed to work with hosts.  Object references:\  -   [Host](/manual/api/reference/host/object#host) -   [Host inventory](/manual/api/reference/host/object#host_inventory)  Available methods:\  -   [host.create](/manual/api/reference/host/create) - creating new     hosts -   [host.delete](/manual/api/reference/host/delete) - deleting hosts -   [host.get](/manual/api/reference/host/get) - retrieving hosts -   [host.massadd](/manual/api/reference/host/massadd) - adding related     objects to hosts -   [host.massremove](/manual/api/reference/host/massremove) - removing     related objects from hosts -   [host.massupdate](/manual/api/reference/host/massupdate) - replacing     or removing related objects from hosts -   [host.update](/manual/api/reference/host/update) - updating hosts
ca	# Equip  Aquesta classe és pensada per treballar amb equips.  Referències d'objectes:\  -   [Equip](/manual/api/reference/host/object#host) -   [Inventari d'equips](/manual/api/reference/host/object#host_inventory)  Mètodes disponibles:\  -   [host.create](/manual/api/reference/host/create) - crear un nou equip -   [host.delete](/manual/api/reference/host/delete) - esborrar equips -   [host.get](/manual/api/reference/host/get) - consultar equips -   [host.massadd](/manual/api/reference/host/massadd) - afegir objectes als equips -   [host.massremove](/manual/api/reference/host/massremove) - esborrar objectes dels equips -   [host.massupdate](/manual/api/reference/host/massupdate) - reemplaçar o esborrar objectes dels equips -   [host.update](/manual/api/reference/host/update) - actualitzar equips

en-us	##### Host trigger tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |triggers| |\-| | |Root element for triggers.| | |expression|x|`string`| |Trigger expression.| | |recovery\_mode|\-|`string`|0 - EXPRESSION (default)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Basis for generating OK events.| | |recovery\_expression|\-|`string`| |Trigger recovery expression.| | |correlation\_mode|\-|`string`|0 - DISABLED (default)<br>1 - TAG\_VALUE|Correlation mode (no event correlation or event correlation by tag).| | |correlation\_tag|\-|`string`| |The tag name to be used for event correlation.| | |name|x|`string`| |Trigger name.| | |event_name|\-|`string`| |Event name.| | |opdata|\-|`string`| |Operational data.| | |url|\-|`string`| |URL associated with the trigger.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Trigger status.| | |priority|\-|`string`|0 - NOT\_CLASSIFIED (default)<br>1 - INFO<br>2 - WARNING<br>3 - AVERAGE<br>4 - HIGH<br>5 - DISASTER|Trigger severity.| | |description|\-|`text`| |Trigger description.| | |type|\-|`string`|0 - SINGLE (default)<br>1 - MULTIPLE|Event generation type (single problem event or multiple problem events).| | |manual\_close|\-|`string`|0 - NO (default)<br>1 - YES|Manual closing of problem events.| |dependencies| |\-| | |Root element for dependencies.| | |name|x|`string`| |Dependency trigger name.| | |expression|x|`string`| |Dependency trigger expression.| | |recovery\_expression|\-|`string`| |Dependency trigger recovery expression.| |tags| |\-| | |Root element for event tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.|
ca	##### Etiquetes de trigger d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Range^**[1](#footnote)**^|Descripció| |-------|-----------------|---------|-----|---------- ----------------|------------| |triggers|<|\-|<|<|Element arrel dels triggers.| |<|expression|x|`cadena`|<|Expressió de trigger.| |<|recovery\_mode|\-|`string`|0 - EXPRESSIÓ (per defecte)<br>1 - RECOVERY\_EXPRESSION<br>2 - NONE|Base per generar esdeveniments OK| |<|recovery\_expression|\-|`string`|<|Activar l'expressió de recuperació.| |<|correlation\_mode|\-|`string`|0 - DESACTIVAT (predeterminat)<br>1 - TAG\_VALUE|Mode de correlació (sense correlació d'esdeveniments o correlació d'esdeveniments per etiqueta). | |<|correlation\_tag|\-|`string`|<|El nom de l'etiqueta que s'emprarà per a la correlació d'esdeveniments.| |<|nom|x|`cadena`|<|Nom del trigger.| | |event_name|\-|`cadena`| |Nom de l'esdeveniment.| | |opdata|\-|`cadena`| |Informació operacional.| |<|url|\-|`string`|<|URL associat amb el trigger.| |<|estat|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat del trigger.| |<|prioritat|\-|`string`|0 - NO\_CLASSIFICAT (predeterminat)<br>1 - INFO<br>2 - ADVERTIMENT<br>3 - MITJANA<br>4 - ALTA<br>5 - DESASTRE |Gravetat del trigger.| |<|descripció|\-|`text`|<|Descripció del trigger.| |<|tipus|\-|`cadena`|0 - SINGLE (per defecte)<br>1 - MULTIPLE|Tipus de generació d'esdeveniments (un sol esdeveniment problema o diversos esdeveniments problema).| |<|manual\_close|\-|`string`|0 - NO (per defecte)<br>1 - SÍ|Tancament manual dels esdeveniments del problema.| |dependències|<|\-|<|<|Element arrel per a dependències.| |<|nom|x|`cadena`|<|Nom de la dependència del trigger.| |<|expressió|x|`cadena`|<|Expressió de dependència del trigger.| |<|recovery\_expression|\-|`string`|<|Activar l'expressió de recuperació de dependència.| |etiquetes|<|\-|<|<|Element arrel per a les etiquetes d'esdeveniments.| |<|etiqueta|x|`cadena`|<|Nom de l'etiqueta.| |<|valor|\-|`cadena`|<|Valor de l'etiqueta.|

en-us	# host.update
ca	# host.update

en-us	##### Host web scenario tags  |Element|Element property|Required|Type|Range^**[1](#footnotes)**^|Description| |--|--|-|--|----|--------| |httptests| |\-| | |Root element for web scenarios.| | |name|x|`string`| |Web scenario name.| | |delay|\-|`string`|Default: 1m|Frequency of executing the web scenario. Seconds, time unit with suffix or user macro.| | |attempts|\-|`integer`|1-10 (default: 1)|The number of attempts for executing web scenario steps.| | |agent|\-|`string`|Default: Zabbix|Client agent. Zabbix will pretend to be the selected browser. This is useful when a website returns different content for different browsers.| | |http\_proxy|\-|`string`| |Specify an HTTP proxy to use, using the format: `http://[username[:password]@]proxy.example.com[:port]`| |variables| |\-| | |Root element for scenario-level variables (macros) that may be used in scenario steps.| | |name|x|`text`| |Variable name.| | |value|x|`text`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`text`| |Header name.| | |value|x|`text`| |Header value.| | |status|\-|`string`|0 - ENABLED (default)<br>1 - DISABLED|Web scenario status.| | |authentication|\-|`string`|0 - NONE (default)<br>1 - BASIC<br>2 - NTLM|Authentication method.| | |http\_user|\-|`string`| |User name used for basic, HTTP or NTLM authentication.| | |http\_password|\-|`string`| |Password used for basic, HTTP or NTLM authentication.| | |verify\_peer|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host's certificate is authentic.| | |verify\_host|\-|`string`|0 - NO (default)<br>1 - YES|Whether to validate that the host name for the connection matches the one in the host's certificate.| | |ssl\_cert\_file|\-|`string`| |Name of the SSL certificate file used for client authentication (must be in PEM format).| | |ssl\_key\_file|\-|`string`| |Name of the SSL private key file used for client authentication (must be in PEM format).| | |ssl\_key\_password|\-|`string`| |SSL private key file password.| |steps| |x| | |Root element for web scenario steps.| | |name|x|`string`| |Web scenario step name.| | |url|x|`string`| |URL for monitoring.| |query\_fields| |\-| | |Root element for query fields - an array of HTTP fields that will be added to the URL when performing a request.| | |name|x|`string`| |Query field name.| | |value|\-|`string`| |Query field value.| |posts| |\-| | |HTTP POST variables as a string (raw post data) or as an array of HTTP fields (form field data).| | |name|x|`string`| |Post field name.| | |value|x|`string`| |Post field value.| |variables| |\-| | |Root element of step-level variables (macros) that should be applied after this step.<br><br>If the variable value has a 'regex:' prefix, then its value is extracted from the data returned by this step according to the regular expression pattern following the 'regex:' prefix| | |name|x|`string`| |Variable name.| | |value|x|`string`| |Variable value.| |headers| |\-| | |Root element for HTTP headers that will be sent when performing a request. Headers should be listed using the same syntax as they would appear in the HTTP protocol.| | |name|x|`string`| |Header name.| | |value|x|`string`| |Header value.| | |follow\_redirects|\-|`string`|0 - NO<br>1 - YES (default)|Follow HTTP redirects.| | |retrieve\_mode|\-|`string`|0 - BODY (default)<br>1 - HEADERS<br>2 - BOTH|HTTP response retrieve mode.| | |timeout|\-|`string`|Default: 15s|Timeout of step execution. Seconds, time unit with suffix or user macro.| | |required|\-|`string`| |Text that must be present in the response. Ignored if empty.| | |status\_codes|\-|`string`| |A comma delimited list of accepted HTTP status codes. Ignored if empty. For example: 200-201,210-299| |tags| |\-| | |Root element for web scenario tags.| | |tag|x|`string`| |Tag name.| | |value|\-|`string`| |Tag value.|
ca	##### Etiquetes d'escenari web d'equip  |Element|Propietat de l'element|Obligatori|Tipus|Rang^**[1](#footnotes)**^|Descripció| |--|--|-|--|----|--------| |httptests| |\-| | |Element arrel per a escenaris web.| | |name|x|`cadena`| |Nom de l'escenari web.| | |delay|\-|`cadena`|Per defecte: 1m|Freqüència d'execució de l'escenari web. Segons, unitat de temps amb sufix o macro d'usuari.| | |attempts|\-|`enter`|1-10 (per defecte: 1)|Nombre d'intents d'execució de passes d'escenari web.| | |agent|\-|`cadena`|Per defecte: Zabbix|Agent client. Zabbix simularà ser el navegador seleccionat. Això és útil quan un lloc web retorna contingut diferent amb diferents navegadors.| | |http\_proxy|\-|`cadena`| |Especifiqueu un proxy HTTP per emprar, en format:`http://[nom d'usuari[:mot de pas]@]proxy.exemple.com[:port]`| |variables| |\-| | |Element arrel per a variables a nivell d'escenari (macros) que es poden emprar a passes d'escenari.| | |name|x|`text`| |Nom de la variable.| | |value|x|`text`| |Valor variable.| |headers| |\-| | |L'element arrel de les capçaleres HTTP que s'enviarà en executar una petició. Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| | |name|x|`text`| |Nom de la capçalera.| | |value|x|`text`| |Valor de la capçalera.| | |status|\-|`cadena`|0 - ACTIVAT (per defecte)<br>1 - DESACTIVAT|Estat de l'escenari web.| | |authentication|\-|`cadena`|0 - CAP (per defecte)<br>1 - BÀSICA<br>2 - NTLM|Mètode d'autenticació.| | |http\_user|\-|`cadena`| |Nom d'usuari emprat per a l'autenticació bàsica, HTTP o NTLM.| | |http\_password|\-|`cadena`| |Mot de pas emprat a l'autenticació bàsica, HTTP o NTLM.| | |verify\_peer|\-|`cadena`|0 - NO (predeterminat)<br>1 - SÍ|Validar que el certificat de l'equip és autèntic.| | |verify\_host|\-|`cadena`|0 - NO (per defecte)<br>1 - YES|Valida que el nom de l'equip per a la connexió coincideixi amb el del certificat de l'equip.| | |ssl\_cert\_file|\-|`cadena`| |Nom del fitxer de certificat SSL emprat per a l'autenticació del client (ha de ser en format PEM).| | |ssl\_key\_file|\-|`cadena`| |Nom del fitxer de clau privada SSL emprat per a l'autenticació del client (ha de ser en format PEM).| | |ssl\_key\_password|\-|`cadena`| |Mot de pas del fitxer de clau privada SSL.| |steps| |x| | |Element arrel per a les passes de l'escenari web.| | |name|x|`cadena`| |Nom de la passa de l'escenari web.| | |url|x|`cadena`| |URL de seguiment.| |query\_fields| |\-| | |Element arrel per als camps de consulta: una matriu de camps HTTP que s'afegiran a l'URL quan s'executa una consulta.| | |name|x|`cadena`| |Nom del camp de consulta.| | |value|\-|`cadena`| |Valor del camp de consulta.| |posts| |\-| | |Variables HTTP POST com a cadena (dades de publicació en brut) o com a matriu de camps HTTP (dades de camp de formulari).| | |name|x|`cadena`| |Nom del camp del missatge.| | |value|x|`cadena`| |Valor del camp Post.| |variables| |\-| | |Element arrel de les variables de nivell de passa (macros) que s'haurien d'aplicar després d'aquesta passa.<br><br>Si el valor de la variable té un prefix "regex:", aleshores el seu valor s'agafa de les dades retornades per aquesta passa segons el patró d'expressió regular seguint el prefix 'regex:'| | |name|x|`cadena`| |Nom de la variable.| | |value|x|`cadena`| |Valor variable.| |headers| |\-| | |L'element arrel de les capçaleres HTTP que s'enviarà en executar una petició. Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| | |name|x|`cadena`| |Nom de la capçalera.| | |value|x|`cadena`| |Valor de la capçalera.| | |follow\_redirects|\-|`cadena`|0 - NO<br>1 - SÍ (per defecte)|Seguiu les redireccions HTTP.| | |retrieve\_mode|\-|`cadena`|0 - COS (per defecte)<br>1 - CAPÇALERES<br>2 - AMBDÚES|Mode de recuperació de la resposta HTTP.| | |timeout|\-|`cadena`|Per defecte: 15s|Temps d'execució de la passa. Segons, unitat de temps amb sufix o macro d'usuari.| | |required|\-|`cadena`| |Text que ha de ser present a la resposta. S'ignora si és buit.| | |status\_codes|\-|`cadena`| |Una llista delimitada per comes de codis d'estat HTTP acceptats. S'ignora si és buit. Per exemple: 200-201,210-299| |tags| |\-| | |Element arrel per a les etiquetes de la història web.| | |tag|x|`cadena`| |Nom de l'etiqueta.| | |value|\-|`cadena`| |Valor de l'etiqueta.|

en-us	#### - Housekeeper  The housekeeper is a periodical process, executed by Zabbix server. The process removes outdated information and information deleted by user.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  In this section housekeeping tasks can be enabled or disabled on a per-task basis separately for: events and alerts/IT services/user sessions/history/trends. Audit housekeeping settings are available in a separate [menu section](/manual/web_interface/frontend_sections/administration/general#audit_log).  If housekeeping is enabled, it is possible to set for how many days data records will be kept before being removed by the housekeeper.  Deleting an item/trigger will also delete problems generated by that item/trigger.  Also, an event will only be deleted by the housekeeper if it is not associated with a problem in any way. This means that if an event is either a problem or recovery event, it will not be deleted until the related problem record is removed. The housekeeper will delete problems first and events after, to avoid potential problems with stale events or problem records.  For history and trends an additional option is available: *Override item history period* and *Override item trend period*. This option allows to globally set for how many days item history/trends will be kept (1 hour to 25 years; or "0"), in this case overriding the values set for individual items in *History storage period/Trend storage period* fields in [item configuration](/manual/config/items/item). Note, that the storage period will not be overridden for items that have configuration option *Do not keep history* and/or *Do not keep trends* enabled.  It is possible to override the history/trend storage period even if internal housekeeping is disabled. Thus, when using an external housekeeper, the history storage period could be set using the history *Data storage period* field.  ::: noteimportant If using TimescaleDB, in order to take full advantage of TimescaleDB automatic partitioning of history and trends tables, *Override item history period* and *Override item trend period* options must be enabled as well as *Enable internal housekeeping* option for history and trends. Otherwise, data kept in these tables will still be stored in partitions, however, the housekeeper will not drop outdated partitions, and warnings about incorrect configuration will be displayed. When dropping of outdated partitions is enabled, Zabbix server and frontend will no longer keep track of deleted items, and history for deleted items will be cleared when an outdated partition is deleted. :::  [Time suffixes](/manual/appendix/suffixes) are supported in the period fields, e.g. 1d (one day), 1w (one week). The minimum is 1 day (1 hour for history), the maximum - 25 years.  *Reset defaults* button allows to revert any changes made.
ca	#### - Neteja  La neteja és un procés periòdic, realitzat pel servidor Zabbix. El procés esborra la informació obsoleta i la informació esborrada per l'usuari.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_housekeeper1.png)  En aquesta secció, les tasques de manteniment es poden habilitar o desactivar per separat per a cada tasca: Esdeveniments i alertes/Serveis de TI/Sessions d'usuari/Historial/Tendències. La configuració de manteniment de l'auditoria és disponible a una [secció de menú] independent (/manual/web_interface/frontend_sections/administration/general#audit_log).  Si l'esborrat és activat, és possible definir quants dies es conservaran els registres de dades abans d'esborrar-se.  L'esborrat d'un element/trigger també esborrarà els problemes generats per aquest element/trigger.  A més, un esdeveniment només s'esborra mitjançant la neteja si ja no és associat a un problema. Això vol dir que si un esdeveniment és un problema o un esdeveniment de recuperació, no s'esborrarà fins que no s'esborri el registre del problema associat. La neteja esborrarpa els problemes primer i els esdeveniments després, per evitar possibles problemes amb esdeveniments obsolets o registres de problemes.  Per a l'historial i les tendències, hi ha una opció addicional disponible: *Anul·lació del període de l'historial d'articles* i *Anul·lació del període de tendència d'elements*. Aquesta opció us permet establir globalment quants dies es mantindran l'historial/tendències d'articles (d'1 hora a 25 anys; o "0"), en aquest cas, anul·lant els valors establerts per a articles individuals a la [configuració de l'element](/manual/config/items/item) *Període d'emmagatzematge de l'historial/Període d'emmagatzematge de tendències*. Tingueu en compte que el període d'emmagatzematge no es substituirà per als articles que tinguin l'opció de configuració *No conservar l'historial* i/o *No mantindre les tendències* activada.  És possible anul·lar l'historial/període d'emmagatzematge de tendències fins i tot si la neteja interna és desactivada. Per tant, quan s'empra una neteja externa, el període d'emmagatzematge de l'historial es pot establir mitjançant el camp Historial *Període d'emmagatzematge de dades*.  ::: noteimportant Si empreu TimescaleDB, per tal d'aprofitar al màxim la partició automàtica de les taules històriques i de tendències de TimescaleDB, les opcions *Substituïr el període de l'historial d'elements* i *Substituïr el període de tendència d'elements* haurien d'habilitar-se així com l'opció *Activar la neteja interna* per a història i tendències. En cas contrari, les dades conservades en aquestes taules encara s'emmagatzemaran a les particions, però, la neteja no esborrarà pas les particions antigues i es mostraran avisos sobre una configuració incorrecta. Quan s'habilita l'esborrat de particions antigues, el servidor Zabbix i la interfície ja no faran un seguiment dels elements esborrats i l'historial dels elements suprimits s'esborrarà quan s'elimini una partició obsoleta. :::  S'admeten [sufixos de temps](/manual/apèndix/sufixos) als camps de període de temps, per exemple, 1d (un dia), 1w (una setmana). El mínim és 1 dia (1 hora per a la història), el màxim - 25 anys.  El botó *Restableix els valors predeterminats* us permet desfer els canvis fets.

en-us	#### housekeeping  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) added support of property `hk_events_service`.\
ca	#### Manteniment  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) afegit el suport de la propietat `hk_events_service`.\

en-us	# housekeeping.get
ca	# housekeeping.get

en-us	# > Housekeeping object  The following objects are directly related to the `housekeeping` API.
ca	# > Objecte de manteniment  Els següents objectes tenen relació directa a l'API `housekeeping`.

en-us	### Housekeeping  The settings object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hk\_events\_mode|integer|Enable internal housekeeping for events and alerts.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_events\_trigger|string|Trigger data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_events\_service|string|Service data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_internal|string|Internal data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_discovery|string|Network discovery data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_events\_autoreg|string|Autoregistration data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 1d.| |hk\_services\_mode|integer|Enable internal housekeeping for services.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_services|string|Services data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_audit\_mode|integer|Enable internal housekeeping for audit.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_audit|string|Audit data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_sessions\_mode|integer|Enable internal housekeeping for sessions.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_sessions|string|Sessions data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |hk\_history\_mode|integer|Enable internal housekeeping for history.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_history\_global|integer|Override item history period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_history|string|History data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 90d.| |hk\_trends\_mode|integer|Enable internal housekeeping for trends.<br><br>Possible values:<br>0 - Disable;<br>1 - *(default)* Enable.| |hk\_trends\_global|integer|Override item trend period.<br><br>Possible values:<br>0 - Do not override;<br>1 - *(default)* Override.| |hk\_trends|string|Trends data storage period. Accepts seconds and time unit with suffix.<br><br>Default: 365d.| |db\_extension|string|*(readonly)* Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.| |compression\_status|integer|Enable TimescaleDB compression for history and trends.<br><br>Possible values:<br>0 - *(default)* Off;<br>1 - On.| |compress\_older|string|Compress history and trends records older than specified period. Accepts seconds and time unit with suffix.<br><br>Default: 7d.| |compression\_availability|integer|*(readonly)* Compression availability.<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.|
ca	### Manteniment  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hk\_events\_mode|integer|Activa el manteniment intern per a esdeveniments i alertes.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_events\_trigger|string|Període d'activació d'emmagatzematge de dades. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_events\_service|string|Període d'emmagatzematge de dades del servei. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_internal|string|Període d'emmagatzematge de dades intern. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_discovery|string|Període d'emmagatzematge de dades de descoberta de xarxa. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_events\_autoreg|string|Període d'emmagatzematge de dades del registre automàtic. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 1d.| |hk\_services\_mode|integer|Activa la neteja interna dels serveis.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_services|string|Període d'emmagatzematge de dades del servei. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_audit\_mode|integer|Activa el manteniment intern per a l'auditoria.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_audit|string|Període d'emmagatzematge de dades d'auditoria. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_sessions\_mode|integer|Activa la neteja interna per a les sessions.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_sessions|string|Període d'emmagatzematge de dades de la sessió. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |hk\_history\_mode|integer|Activa el manteniment intern de l'historial.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_history\_global|integer|Substitueix el període de l'historial d'elements.<br><br>Valors possibles:<br>0 - No substitueix;<br>1 - *(per defecte)* Substitueix.| |hk\_history|string|Període d'emmagatzematge de dades de l'historial. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 90d.| |hk\_trends\_mode|integer|Activa la neteja interna per a tendències.<br><br>Valors possibles:<br>0 - Desactiva;<br>1 - *(per defecte)* Activa.| |hk\_trends\_global|integer|Anul·lació del període de tendència de l'element.<br><br>Valors possibles:<br>0 - No substituir;<br>1 - *(per defecte)* Anul·lar. | |hk\_trends|string|Període de temps per emmagatzemar dades de tendències. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 365d.| |db\_extension|string|*(només lectura)* Marcador de configuració de l'extensió de la base de dades. Si aquesta marca s'estableix a "timescaledb", el servidor canvia el seu comportament per netejar i suprimir elements.| |compression\_status|integer|Activa la compressió TimescaleDB per a l'historial i les tendències.<br><br>Valors possibles:<br>0 - *(per defecte)* Desactiva;<br>1 - Activa.| |compress\_older|string|Comprimir l'historial i els registres de tendències anteriors al període de temps especificat. Accepta segons i unitat de temps amb sufix.<br><br>Per defecte: 7d.| |compression\_availability|integer|*(només lectura)* Disponibilitat de compressió.<br><br>Valors possibles:<br>0 - No disponible;<br>1 - Disponible.|

en-us	# Housekeeping  This class is designed to work with housekeeping.  Object references:\  -   [Housekeeping](/manual/api/reference/housekeeping/object#housekeeping)  Available methods:\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) -     retrieve housekeeping -   [housekeeping.update](/manual/api/reference/housekeeping/update) -     update housekeeping
ca	# Manteniment  Aquesta classe és dissenyada per treballar amb el manteniment.  Referències d'objectes:\  -   [Manteniment](/manual/api/reference/housekeeping/object#housekeeping)  Mètodes disponibles:\  -   [housekeeping.get](/manual/api/reference/housekeeping/get) - recuperar el manteniment -   [housekeeping.update](/manual/api/reference/housekeeping/update) - actualitzar el manteniment

en-us	# housekeeping.update
ca	# housekeeping.update

en-us	#### How it works  In log monitoring you may encounter lines similar to these:      Line1: Application 1 stopped     Line2: Application 2 stopped     Line3: Application 1 was restarted     Line4: Application 2 was restarted  The idea of event correlation is to be able to match the problem event from Line1 to the resolution from Line3 and the problem event from Line2 to the resolution from Line4, and close these problems one by one:      Line1: Application 1 stopped     Line3: Application 1 was restarted #problem from Line 1 closed      Line2: Application 2 stopped     Line4: Application 2 was restarted #problem from Line 2 closed  To do this you need to tag these related events as, for example, "Application 1" and "Application 2". That can be done by applying a regular expression to the log line to extract the tag value. Then, when events are created, they are tagged "Application 1" and "Application 2" respectively and problem can be matched to the resolution.
ca	#### Com funciona tot plegat  Al monitoratge del registre, podeu trobar línies semblants a aquestes:       Línia 1: s'ha aturat l'aplicació 1      Línia 2: s'ha aturat l'aplicació 2      Línia 3: s'ha reiniciat l'aplicació 1      Línia 4: s'ha reiniciat l'aplicació 2  La idea de la correlació d'esdeveniments és poder fer coincidir l'esdeveniment problema de Línia 1 amb la resolució de Línia 3 i l'esdeveniment problema Línia 2 amb la resolució de Línia 4, i tancar aquests problemes un per un:       Línia 1: s'ha aturat l'aplicació 1      Línia 3: s'ha reiniciat l'aplicació 1 #problema de la línia 1 tancada       Línia 2: s'ha aturat l'aplicació 2      Línia 4: s'ha reiniciat l'aplicació 2 #problema de la línia 2 tancada  Per fer-ho, heu d'etiquetar aquests esdeveniments associats com, per exemple, "Aplicació 1" i "Aplicació 2". Això es pot fer aplicant una expressió regular a la línia de registre per extreure el valor de l'etiqueta. Aleshores, quan es creen els esdeveniments, s'etiqueten "Aplicació 1" i "Aplicació 2" respectivament i el problema es pot associar amb la resolució.

en-us	#### How to  First you need to create a PHP file and save it as *local/conf/brand.conf.php*. The contents of the file should be as follows:  ```php <?php  return []; ```  This will hide the links to the *Zabbix Support* and *Zabbix Integrations* pages.
ca	#### Com fer-ho  Primer, haureu de crear un arxiu PHP i desar-lo com a *local/conf/brand.conf.php*. El contingut hauria de ser com això:  ```php <?php  return []; ```  Això amagarà els enllaços de les pàgines *Zabbix Support* i *Zabbix Integrations*.

en-us	#### HP OpenView  Zabbix can be configured to send messages to OpenView server. The following steps must be performed:
ca	#### HP OpenView  Es pot configurar Zabbix per enviar els missatges al servidor OpenView. Les següents passes s'haurien de seguir:

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped. If this field already contains HTML, it will be rendered as plain text after the upgrade.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
ca	### S'ha deixat el suport HTML a l'atribució de Geomap  El text d'atribució per al [Giny del tauler de geomapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) ara només pot contindre text pla; S'ha tret el suport HTML. Si aquest camp ja conté HTML, es representarà com a text senzill després de l'actualització.  A la configuració de [Mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical-maps) dins la secció Administració → General, el camp *Atribució* ara només és visible quan el *Proveïdor de rajoles* sigui establert a *Altres*.

en-us	### HTML support in Geomap attribution dropped  The attribution text for the [Geomap dashboard widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) can now only contain plain text; HTML support has been dropped.  In [Geographical maps](/manual/web_interface/frontend_sections/administration/general#geographical-maps) settings in the Administration → General section, the field *Attribution* is now only visible when *Tile provider* is set to *Other*.
ca	### S'ha deixat el suport HTML a l'atribució de Geomap  El text d'atribució per al [Giny del tauler de geomapa](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/geomap) ara només pot contindre text pla; S'ha tret el suport HTML.   A la configuració de [Mapes geogràfics](/manual/web_interface/frontend_sections/administration/general#geographical-maps) dins la secció Administració → General, el camp *Atribució* ara només és visible quan el *Proveïdor de rajoles* sigui establert a *Altres*.