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* determines the type of the name the item should return:  -   *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* - returns part of the hostname before the first dot.     It will return a full string if the name does not contain a dot. -   *fqdn* - returns Fully Qualified Domain Name (without the trailing dot).  *Transform* allows to specify additional transformation rule for the hostname:  -   *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, three different approaches can 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.\     **HostnameItem=system.hostname\[fqdn\]** - for Zabbix agent to use the Fully Qualified Domain Name as the hostname.  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'especifiquen, 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 navigator and Item navigator  *Host navigator* and *Item navigator* widgets have been added to [dashboard widgets](/manual/web_interface/frontend_sections/dashboards/widgets). These widgets display hosts or items, respectively, based on various filtering and grouping options, and allow to control the information displayed in other widgets based on the selected host or item. For more information, see [*Host navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) and [*Item navigator*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator).  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/host_item_navigator_control.png){width="600"}
ca	#### Navegador de l'equipi navegador d'elements  Els ginys *Navegador d'eequip* i *Navegador d'elements* s'han afegit a [ginys del tauler de control](/manual/web_interface/frontend_sections/dashboards/widgets). Aquests ginys mostren equips o elements, respectivament, basats en diverses opcions de filtrat i agrupació, i permeten controlar la informació que es mostra en altres ginys en funció de l'equip o element seleccionat. Per obtindre més informació, consulteu [*Navegador d'equips*](/manual/web_interface/frontend_sections/dashboards/widgets/host_navigator) i [*Navegador d'elements*](/manual/web_interface/frontend_sections/dashboards/widgets/item_navigator).  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/host_item_navigator_control.png){width="600"}

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	# 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 are blueprints for creating hosts through [low-level discovery](/manual/discovery/low_level_discovery) rules. Before being discovered as hosts, these prototypes cannot have items and triggers, except those linked from templates.
ca	Els prototips d'equips són com els plànols dels equips que es creen amb una regla de [descoberta de baix nivell](/manual/discovery/low_level_discovery). Els prototips, abans de ser descoberts, no poden tindre els seus propis elements i triggers, excepte els de les plantilles enllaçades.

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

en-us	### Host prototype  The host prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|ID|ID of the host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |host|string|Technical name of the host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations<br>- *read-only* for inherited objects| |name|string|Visible name of the host prototype.<br><br>Default: `host` property value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for inherited objects| |status|integer|Status of the host prototype.<br><br>Possible values:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |templateid|ID|ID of the parent template host prototype.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |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 [custom interfaces](#custom-interface) 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.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only* for inherited objects| |uuid|string|Universal unique identifier, used for linking imported host prototypes to already existing ones. Auto-generated, if not given.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *supported* if the host prototype belongs to a template|
ca	### Prototipus d'equip  L'objecte prototip d'equip té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|ID|ID del prototip d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |host|string|Nom tècnic del prototip d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació<br>- *només lectura* per objectes heretats| |name|string|Nom visible del prototip d'equips.<br><br>Per defecte: valor de la propietat `host`.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* per objectes heretats| |status|integer|Estat del prototip d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* equip monitorat;<br>1 - equip no monitorat.| |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|ID|ID de la plantilla principal del prototip d'equips.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |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.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura* per objectes heretats| |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>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *admès* si el prototip d'equip pertany a una plantilla|

en-us	# Host prototype  This class is designed to work with host prototypes.  Object references:  -   [Host prototype](/manual/api/reference/hostprototype/object#host_prototype) -   [Group link](/manual/api/reference/hostprototype/object#group_link) -   [Group prototype](/manual/api/reference/hostprototype/object#group_prototype) -   [Host prototype tag](/manual/api/reference/hostprototype/object#host_prototype_tag) -   [Custom interface](/manual/api/reference/hostprototype/object#custom_interface) -   [Custom interface details](/manual/api/reference/hostprototype/object#custom_interface_details)  Available methods:  -   [hostprototype.create](/manual/api/reference/hostprototype/create) - create new host prototypes -   [hostprototype.delete](/manual/api/reference/hostprototype/delete) - delete host prototypes -   [hostprototype.get](/manual/api/reference/hostprototype/get) - retrieve host prototypes -   [hostprototype.update](/manual/api/reference/hostprototype/update) - update 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) -   [Enllaç de grup](/manual/api/reference/hostprototype/object#group_link) -   [Prototipus de grup](/manual/api/reference/hostprototype/object#group_prototype) -   [Etiqueta de prototip d'equip](/manual/api/reference/hostprototype/object#host_prototype_tag) -   [Interfície personalitzada](/manual/api/reference/hostprototype/object#custom_interface) -   [Detalls de la interfície personalitzada](/manual/api/reference/hostprototype/object#custom_interface_details)  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 reassignment  Zabbix server checks the balance between host assignments to the proxies. The group is considered "out of balance" if there is:  -   **host excess** - a proxy has many more hosts than the group average; -   **host deficit** - a proxy has far fewer hosts than the group average.  The group is considered "out of balance" if the number of hosts assigned to the proxy is above/below the group average by more than **10** and a factor of **2**. In this case the group is marked by the server for host reassignment after the grace period (10 x failover delay), if the balance is not restored.   The following table illustrates with example numbers when host reassignment is (or is not) triggered:  |Number of hosts on proxy|Group average|Host reassignment| |---|---|----| |>100|50|Yes| |60|50|No| |40|50|No| |<25|50|Yes| |>15|5|Yes| |10|5|No|  The proxy group manager will re-distribute hosts in proxy groups in the following way:  -   calculate the average number of proxies per host; -   for proxies with host excess - move excess hosts to unassigned hosts; -   for proxies with host deficit - calculate the number of hosts needed to balance proxies;  -   remove the missing number of hosts from proxies with most hosts; -   distribute unassigned hosts between proxies with least hosts.
ca	 #### Reassignació d'equip  El servidor Zabbix comprova l'equilibri entre les assignacions d'equip als proxys. El grup es considera "desequilibri" si hi ha:  - **excés d'equips** - un proxy té molts més equips que la mitjana del grup; - **dèficit d'equip** - un proxy té molts menys equips que la mitjana del grup.  El grup es considera "desequilibrat" si el nombre d'equips assignats al proxy és per sobre/per sota de la mitjana del grup en més de **10** i un factor de **2**. En aquest cas, el servidor marca el grup per a la reassignació de l'equip després del període de gràcia (10 vegades el retard de la migració per error), si no es restaura el saldo.   La taula següent il·lustra amb números d'exemple quan s'activa (o no) la reassignació de l'equip:  |Nombre d'equips al proxy|Mitjana del grup|Reassignació de l'equip| |---|---|----| |>100|50|Sí| |60|50|No| |40|50|No| |<25|50|Sí| |>15|5|Sí| |10|5|No|  El gestor de grups de proxys redistribuirà els equips als grups de proxys de la manera següent:  - calcular el nombre mitjà de proxys per equip; - per als proxys amb excés d'equip: moure l'excés d'equips a equips no assignats; - per als proxys amb dèficit d'equip: calculeu el nombre d'equips necessaris per equilibrar els proxys;  - eliminar el nombre d'equips que falten dels proxys amb la majoria d'equips; - Distribuïu els equips no assignats entre els proxys amb menys equips.

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  |Element|<|Type|Description| |-|---|---|-----------------------| |host|<|string|(required) Unique host name.| |name|<|string|Visible host name.| |description|<|text|Host description.| |monitored_by|<|string|Host is monitored by: SERVER, PROXY, or PROXY_GROUP.| |proxy|<| |Root element for proxy.| | |name|string|(required) Name of the proxy (if any) that monitors the host.| |proxy_group|<| |Root element for proxy group.| | |name|string|(required) Name of the proxy group (if any) that is used to monitor the host.| |status|<|string|Host status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |ipmi\_authtype|<|string|IPMI session authentication type.<br>Possible values:^[1](#footnotes)^ DEFAULT (-1, default), NONE (0), MD2 (1), MD5 (2), STRAIGHT (4), OEM (5), RMCP\_PLUS (6).| |ipmi\_privilege|<|string|IPMI session privilege level.<br>Possible values:^[1](#footnotes)^ CALLBACK (1), USER (2, default), OPERATOR (3), ADMIN (4), OEM (5).| |ipmi\_username|<|string|Username for IPMI checks.| |ipmi\_password|<|string|Password for IPMI checks.| |templates|<| |Root element for linked templates.| | |name|string|(required) Template name.| |groups|<| |Root element for host groups to which the host belongs.| | |name|string|(required) Host group name.| |interfaces|<| |Root element for [host interfaces](#host-interfaces).| |items|<| |Root element for [host items](#host-items).| |discovery_rules|<| |Root element for [host low-level discovery rules](#host-low-level-discovery-rules).| |http_tests|<| |Root element for [host web scenarios](#host-web-scenarios).| |tags|<| |Root element for host tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.| |macros|<| |Root element for host macros.| |<|macro|string|(required) User macro name.| |^|type|string|User macro type.<br>Possible values:^[1](#footnotes)^ TEXT (0, default), SECRET\_TEXT (1), VAULT (2).| |^|value|string|User macro value.| |^|description|string|User macro description.| |inventory|<| |Root element for host inventory.| | |<inventory\_property>|string|Inventory property. All properties have their respective element (`type`, `name`, `os`, etc.; for example, see [Export format](#export-format)).| |inventory\_mode|<|string|Inventory mode.<br>Possible values:^[1](#footnotes)^ DISABLED (-1), MANUAL (0, default), AUTOMATIC (1).| |valuemaps|<| |Root element for [host value maps](#host-value-maps).|  ::: noteclassic See also: [Host object](/manual/api/reference/host/object) (refer to the relevant property with a matching name). :::
ca	##### Etiquetes d'equips  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |equip|<|string|(obligatori) Nom d'equip únic.| |nom|<|string|Nom d'equip visible.| |descripció|<|text|Descripció de l'equip.| |monitored_by|<|string|L'equip és monitorat per: SERVER, PROXY o PROXY_GROUP.| |proxy|<| |Element arrel per al proxy.| | |nom|string|(obligatori) Nom del proxy (si n'hi ha) que monitora l'equip.| |grup_proxy|<| |Element arrel per al grup de proxys.| | |nom|string|(obligatori) Nom del grup de proxys (si n'hi ha) que s'empra per monitorar l'equip.| |estat|<|string|Estat de l'equip.<br>Valors possibles:^[1](#footnotes)^ ACTIVAT (0, predeterminat), DESACTIVAT (1).| |ipmi\_authtype|<|string|Tipus d'autenticació de sessió IPMI.<br>Valors possibles:^[1](#footnotes)^ PREDETERMINAT (-1, predeterminat), NONE (0), MD2 (1), MD5 (2) ), RECTE (4), OEM (5), RMCP\_PLUS (6).| |ipmi\_privilege|<|string|Nivell de privilegis de sessió IPMI.<br>Valors possibles:^[1](#footnotes)^ CALLBACK (1), USER (2, predeterminat), OPERADOR (3), ADMIN (4) , OEM (5).| |ipmi\_username|<|string|Nom d'usuari per a comprovacions IPMI.| |ipmi\_password|<|string|Mot de pas per a comprovacions IPMI.| |plantilles|<| |Element arrel per a plantilles enllaçades.| | |nom|string|(obligatori) Nom de la plantilla.| |grups|<| |Element arrel per als grups d'equip als quals pertany l'equip.| | |nom|string|(obligatori) Nom del grup d'equip.| |interfícies|<| |Element arrel per a [interfícies host](#host-interfaces).| |items|<| |Element arrel per a [elements equip](#elements-equip).| |discovery_rules|<| |Element arrel per a [regles de descobriment de baix nivell de l'equip](#host-low-level-discovery-rules).| |http_tests|<| |Element arrel per a [escenaris web host](#host-web-scenarios).| |etiquetes|<| |Element arrel per a les etiquetes d'equip.| |<|etiqueta|string|(obligatori) Nom de l'etiqueta.| |^|valor|string|Valor de l'etiqueta.| |macros|<| |Element arrel per a macros d'equip.| |<|macro|string|(obligatori) Nom de la macro d'usuari.| |^|tipus|string|Tipus de macro d'usuari.<br>Valors possibles:^[1](#footnotes)^ TEXT (0, predeterminat), SECRET\_TEXT (1), VAULT (2).| |^|valor|string|Valor de la macro d'usuari.| |^|descripció|string|Descripció de la macro de l'usuari.| |inventari|<| |Element arrel per a l'inventari de l'equip.| | |<inventory\_property>|string|Propietat d'inventari. Totes les propietats tenen el seu element respectiu (`type`, `name`, `os`, etc.; per exemple, veieu [Format d'exportació](#export-format)).| |inventory\_mode|<|string|Mode d'inventari.<br>Valors possibles:^[1](#footnotes)^ DESACTIVAT (-1), MANUAL (0, predeterminat), AUTOMÀTIC (1).| |mapatge de valors|<| |Element arrel per a [mapes de valors d'equip](#host-value-maps).|  ::: noteclassic Veieu també: [Objecte d'equip](/manual/api/reference/host/object) (consulteu la propietat rellevant amb un nom coincident). :::

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	 ### Hosts  |Macro|Supported in|Description| |--|--------|--------| |{HOST.CONN}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host IP address or DNS name, depending on host settings*^[2](supported_by_location#footnotes)^.<br><br>May be used with a numeric index as {HOST.CONN[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DESCRIPTION}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host description.*<br><br>This macro may be used with a numeric index e.g. {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.DNS}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host DNS name*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.DNS[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.HOST}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Item key parameters<br>→ Map element labels, map URL names and values<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.HOST[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{HOSTNAME<1-9>}` is deprecated.<br><br>[Macro functions](/manual/config/macros/macro_functions) are not supported for this macro if it is used as a placeholder in the first parameter of a [history function](/manual/appendix/functions/history), for example, `last(/{HOST.HOST}/{ITEM.KEY})`.| |{HOST.ID}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (only for type URL, including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (only for type URL, including confirmation text)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host ID.*<br><br>May be used with a numeric index as {HOST.ID[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.IP}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters^[1](supported_by_location#footnotes)^<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ JMX item endpoint field<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host IP address*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.IP[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).<br><br>`{IPADDRESS<1-9>}` is deprecated.| |{HOST.METADATA}|→ Autoregistration notifications and commands|*Host metadata.*<br>Used only for active agent autoregistration.| |{HOST.NAME}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Internal notifications<br>→ Map element labels, map URL names and values<br>→ Item key parameters<br>→ Host interface IP/DNS<br>→ Trapper item "Allowed hosts" field<br>→ Database monitoring additional parameters<br>→ SSH and Telnet scripts<br>→ Web monitoring^[4](supported_by_location#footnotes)^<br>→ Low-level discovery rule filter regular expressions<br>→ URL field of dynamic URL dashboard widget<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Script-type and Browser-type item, item prototype and discovery rule parameter names and values<br>→ HTTP agent type item, item prototype and discovery rule fields:<br>URL, Query fields, Request body, Headers, SSL certificate file, SSL key file, Allowed hosts.<br>→ Manual host action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts) (including confirmation text)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Visible host name.*<br><br>This macro may be used with a numeric index e.g. {HOST.NAME[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.PORT}|→ Trigger-based notifications and commands<br>→ Problem update notifications and commands<br>→ Autoregistration notifications and commands<br>→ Internal notifications<br>→ Trigger names, event names, operational data and descriptions<br>→ Trigger URLs<br>→ JMX item endpoint field<br>→ [Tag names and values](/manual/config/tagging#macro_support)<br>→ Manual event action [scripts](/manual/web_interface/frontend_sections/alerts/scripts)<br>→ *Description* parameter in [*Item value*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) and [*Gauge*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration) widget<br>→ Primary/Secondary label *Text* parameter in [*Honeycomb*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration) widget|*Host (agent) port*^[2](supported_by_location#footnotes)^.<br><br>This macro may be used with a numeric index e.g. {HOST.PORT[<1-9>](supported_by_location#indexed_macros)} to point to the first, second, third, etc. host in a trigger expression. See [indexed macros](supported_by_location#indexed_macros).| |{HOST.TARGET.CONN}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*IP address or DNS name of the target host*, depending on host settings.| |{HOST.TARGET.DNS}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*DNS name of the target host*.| |{HOST.TARGET.HOST}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*Technical name of the target host*.| |{HOST.TARGET.IP}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*IP address of the target host*.| |{HOST.TARGET.NAME}|→ Trigger-based commands<br>→ Problem update commands<br>→ Discovery commands<br>→ Autoregistration commands|*Visible name of the target host*.|  See also: [Host inventory](#host-inventory)
ca	# Equips  |Macro|Admesa a|Descripció| |--|------|------| |{HOST.CONN}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Etiquetes d'elements del mapa, noms i valors d'URL del mapa<br>→ Paràmetres de clau d'element^ [1](supported_by_location#footnotes)^<br>→ IP/DNS de la interfície de l'equip<br>→ Camp "Equips permesos" de l'element Trapper<br>→ Paràmetres addicionals de supervisió de la base de dades<br>→ Scripts SSH i Telnet<br>→ JMX camp del punt final de l'element<br>→ Monitoratge web^[4](supported_by_location#footnotes)^<br>→ Expressions regulars de filtre de regles de descoberta de baix nivell<br>→ Camp d'URL del giny del tauler d'URL dinàmics<br>→ Noms d'activació, esdeveniment noms, dades operatives i descripcions<br>→ URL d'activació<br>→ [Noms i valors de l'etiqueta](/manual/config/tagging#macro_support)<br>→ Noms i valors dels paràmetres de l'element del tipus d'script, del prototip d'element i de la regla de descoberta< br>→ Element de tipus agent HTTP, prototip d'element i camps de regla de descoberta:<br>URL, camps de consulta, cos de la petició, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL, equips permesos.<br>→ Equip manual, [scripts](/manual/web_interface/frontend_sections/administration/scripts)  d'acció (inclòs el text de confirmació)<br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts) (incloent el text de confirmació)<br >→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Adreça IP de l'equip o nom DNS, segons la configuració de l'equip*^[2](supported_by_location#footnotes)^.<br><br>Es pot emprar amb un índex numèric com a {HOST.CONN [<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{HOST.DESCRIPTION}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Etiquetes d'elements del mapa<br>→ Acció manual d'esdeveniments [scripts](/manual/ web_interface/frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Descripció de l'equip.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {HOST.DESCRIPTION[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{HOST.HOST}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes<br>→ Paràmetres clau de l'element<br>→ Element del mapa etiquetes, noms i valors d'URL del mapa<br>→ IP/DNS de la interfície de l'equip<br>→ Camp "Equips permesos" de l'element Trapper<br>→ Paràmetres addicionals de supervisió de bases de dades<br>→ Scripts SSH i Telnet<br>→ Camp de punt final d'element JMX<br>→ Monitorització web^[4](supported_by_location#footnotes)^<br>→ Expressions regulars de filtre de regles de descoberta de baix nivell<br>→ Camp d'URL del giny del tauler d'URL dinàmics<br>→ Noms d'activació, noms d'esdeveniments, dades operatives i descripcions<br>→ URL d'activació<br> → [Noms i valors de l'etiqueta](/manual/config/tagging#macro_support)<br>→ Noms i valors i valors de l'element de tipus d'script, prototip d'element i regla de descoberta de paràmetres<br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta: <br>URL, camps de consulta, cos de la petició, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL, equips permesos.<br>→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (incloent-hi text de confirmació)<br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Nom d'equip.*<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {HOST.HOST[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).<br><br>`{HOSTNAME<1-9>}` està obsolet.| |{HOST.DNS}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Etiquetes d'elements del mapa, noms i valors d'URL del mapa<br>→ Paràmetres de clau d'element^ [1](supported_by_location#footnotes)^<br>→ IP/DNS de la interfície de l'equip<br>→ Camp "Equips permesos" de l'element Trapper<br>→ Paràmetres addicionals de supervisió de la base de dades<br>→ Scripts SSH i Telnet<br>→ JMX camp del punt final de l'element<br>→ Supervisió web^[4](supported_by_location#footnotes)^<br>→ Expressions regulars de filtre de regles de descoberta de baix nivell<br>→ Camp d'URL del giny del tauler d'URL dinàmics<br>→ Noms d'activació, esdeveniment noms, dades operatives i descripcions<br>→ URL d'activació<br>→ [Noms i valors de l'etiqueta](/manual/config/tagging#macro_support)<br>→ Noms i valors dels paràmetres de l'element de tipus d'script, del prototip d'element i de la regla de descoberta< br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta:<br>URL, camps de consulta, cos de la petició, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL, equips permesos.<br>→ [scripts](/manual/web_interface/frontend_sections/administration/scripts) d'acció manual d'equips (inclòs el text de confirmació)<br>→ [scripts](/manual/web_interface/frontend_sections/administration/scripts) d'acció d'esdeveniment manual (incloent el text de confirmació)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Nom DNS de l'equip*^[2](supported_by_location#footnotes)^.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {HOST.DNS[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{HOST.ID}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Etiquetes d'elements del mapa, noms i valors d'URL del mapa<br>→ Camp d'URL de dinàmica de giny del tauler d'URL<br>→ URL d'activació<br>→ [Noms i valors de l'etiqueta](/manual/config/tagging#macro_support)<br>→ Acció manual d'esdeveniments [scripts](/manual/web_interface/frontend_sections/administration/scripts )<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*ID de l'equip.*<br><br>Es pot emprar amb un índex numèric com a {HOST.ID[<1-9>](supported_by_location#indexed_macros)} per apuntar a el primer, segon, tercer, etc. host en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{HOST.IP}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes<br>→ Etiquetes d'elements del mapa, noms i valors d'URL del mapa <br>→ Paràmetres clau d'element^[1](supported_by_location#footnotes)^<br>→ IP/DNS de la interfície de l'equip<br>→ Camp "Equips permesos" de l'element de Trapper<br>→ Paràmetres addicionals de monitoratge de la base de dades<br>→ SSH i scripts Telnet<br>→ Camp de punt final d'element JMX<br>→ Monitorització web^[4](supported_by_location#footnotes)^<br>→ Expressions regulars de filtre de regles de descoberta de baix nivell<br>→ Camp d'URL del giny del tauler d'URL dinàmic <br>→ Nom del trigger, noms dels esdeveniments, dades operatives i descripcions<br>→ URL del trigger<br>→ [Noms i valors de l'etiqueta](/manual/config/tagging#macro_support)<br>→ Element de tipus d'script, prototip d'element i noms i valors dels paràmetres de la regla de descoberta<br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta:<br>URL, camps de consulta, cos de la petició, capçaleres, proxy, fitxer de certificat SSL , fitxer de clau SSL, equips permesos.<br>→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Acció manual d'esdeveniment [scripts](/manual/web_interface /frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Adreça IP de l'equip*^[2](supported_by_location#footnotes)^.<br><br>Aquesta macro es pot emprar amb un índex numèric, p. {HOST.IP[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).<br><br>`{IPADDRESS<1-9>}` és obsolet.| |{HOST.METADATA}|→ Notificacions i ordres d'autoregistre|*Metadades de l'equip.*<br>S'empra només per al registre automàtic d'agents actius.| |{HOST.NAME}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions internes<br>→ Etiquetes d'elements del mapa, noms i valors d'URL del mapa<br>→ Paràmetres clau de l'element< br>→ IP/DNS de la interfície de l'equip<br>→ Camp "Equips permesos" de l'element Trapper<br>→ Paràmetres addicionals de supervisió de la base de dades<br>→ Scripts SSH i Telnet<br>→ Monitoratge web^[4](supported_by_location#footnotes) ^<br>→ Expressions regulars de filtre de regles de descoberta de baix nivell<br>→ Camp d'URL del giny del tauler d'URL dinàmics<br>→ Nom del trigger, noms d'esdeveniments, dades operatives i descripcions<br>→ URL del trigger<br>→ [Etiqueta noms i valors](/manual/config/tagging#macro_support)<br>→ Element de tipus d'script, prototip d'element i noms i valors de paràmetres de regla de descoberta<br>→ Element de tipus d'agent HTTP, prototip d'element i camps de regla de descoberta:<br> URL, camps de consulta, cos de la petició, capçaleres, proxy, fitxer de certificat SSL, fitxer de clau SSL, equips permesos.<br>→ Acció manual de l'equip [scripts](/manual/web_interface/frontend_sections/administration/scripts) (inclòs el text de confirmació)<br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface/frontend_sections/administration/scripts) (incloent el text de confirmació)<br>→ Paràmetre *Descripció* als ginys [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Nom d'equip visible.*<br><br>Aquesta macro es pot emprar amb un índex numèric, com ara {HOST.NAME[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).||{HOST.PORT}|→ Notificacions i ordres basades en triggers<br>→ Notificacions i ordres d'actualització de problemes<br>→ Notificacions i ordres d'autoregistre<br>→ Notificacions internes<br>→ Nom del trigger, noms d'esdeveniments, dades operatives i descripcions<br>→ URL dels triggers<br>→ Camp de punt final d'element JMX<br>→ [Noms i valors de l'etiqueta](/manual/config/tagging#macro_support)<br>→ Acció d'esdeveniment manual [scripts](/manual/web_interface /frontend_sections/administration/scripts)<br>→ Paràmetre *Descripció* al [*Valor de l'element*](/manual/web_interface/frontend_sections/dashboards/widgets/item_value#advanced-configuration) i el giny [*Calibre*](/manual/web_interface/frontend_sections/dashboards/widgets/gauge#advanced-configuration)<br>→ Paràmetre de *Text* d'etiqueta Primària/Secundària al giny [*Rusc*](/manual/web_interface/frontend_sections/dashboards/widgets/honeycomb#advanced-configuration)|*Port de l'equip (agent)*^[2](supported_by_location#footnotes)^.<br><br>Aquesta macro es pot emprar amb un índex numèric, per exemple. {HOST.PORT[<1-9>](supported_by_location#indexed_macros)} per apuntar al primer, segon, tercer, etc. equip en un trigger. Veieu [macros indexades](supported_by_location#indexed_macros).| |{HOST.TARGET.CONN}|→ Ordres basades en triggers<br>→ Ordres d'actualització de problemes<br>→ Ordres de descoberta<br>→ Ordres d'autoregistre|*Adreça IP o nom DNS de l'equip destí, segons la configuració de l'equip*.| |{HOST.TARGET.DNS}|→ Ordres basades en triggers<br>→ Ordres d'actualització de problemes<br>→ Ordres de descoberta<br>→ Ordres d'autoregistre|*Nom DNS de l'equip destí*. | |{HOST.TARGET.HOST}|→ Ordres basades en triggers<br>→ Ordres d'actualització de problemes<br>→ Ordres de descoberta<br>→ Ordres d'autoregistre|*Nom tècnic de l'equip destí*.| |{HOST.TARGET.IP}|→ Ordres basades en triggers<br>→ Ordres d'actualització de problemes<br>→ Ordres de descoberta<br>→ Ordres d'autoregistre|*Adreça IP de l'equip destí*.| |{HOST.TARGET.NAME}|→ Ordres basades en triggers<br>→ Ordres d'actualització de problemes<br>→ Ordres de descoberta<br>→ Ordres d'autoregistre|*Nom visible de l'equip destí*.|  Veieu també: [Inventari d'equips](#host-inventory)

en-us	### Host tag  The host tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |tag|string|Host tag name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Host tag value.| |automatic|integer|Type of host tag.<br><br>Possible values:<br>0 - *(default)* manual (tag created by user);<br>1 - automatic (tag created by low-level discovery) |
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|cadena|Nom de l'etiqueta d'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value|cadena|Valor de l'etiqueta d'equip.| |automatic|enter|Tipus d'etiqueta d'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* manual (etiqueta creada per l'usuari);<br>1 - automàtic (etiqueta creada per una descoberta de baix nivell) |

en-us	### Host  The host object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|ID|ID of the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |host|string|Technical name of the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |description|text|Description of the host.| |flags|integer|Origin of the host.<br><br>Possible values:<br>0 - a plain host;<br>4 - a discovered host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |inventory\_mode|integer|Host inventory population mode.<br><br>Possible values:<br>-1 - *(default)* disabled;<br>0 - manual;<br>1 - automatic.| |ipmi\_authtype|integer|IPMI authentication algorithm.<br><br>Possible values:<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:<br>1 - callback;<br>2 - *(default)* user;<br>3 - operator;<br>4 - admin;<br>5 - OEM.| |ipmi\_username|string|IPMI username.| |maintenance\_from|timestamp|Starting time of the effective maintenance.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |maintenance\_status|integer|Effective maintenance status.<br><br>Possible values:<br>0 - *(default)* no maintenance;<br>1 - maintenance in effect.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |maintenance\_type|integer|Effective maintenance type.<br><br>Possible values:<br>0 - *(default)* maintenance with data collection;<br>1 - maintenance without data collection.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |maintenanceid|ID|ID of the maintenance that is currently in effect on the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |name|string|Visible name of the host.<br><br>Default: `host` property value.| |monitored_by|integer|Source that is used to monitor the host.<br><br>Possible values:<br>0 - *(default)* Zabbix server;<br>1 - Proxy;<br>2 - Proxy group.| |proxyid|ID|ID of the proxy that is used to monitor the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `monitored_by` is set to "Proxy"| |proxy_groupid|ID|ID of the proxy group that is used to monitor the host.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* if `monitored_by` is set to "Proxy group"| |status|integer|Status and function of the host.<br><br>Possible values:<br>0 - *(default)* monitored host;<br>1 - unmonitored host.| |tls\_connect|integer|Connections to host.<br><br>Possible values:<br>1 - *(default)* No encryption;<br>2 - PSK;<br>4 - certificate.| |tls\_accept|integer|Connections from host.<br>This is a bitmask field, any combination of possible bitmap values is acceptable.<br><br>Possible bitmap values:<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|PSK identity.<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.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit| |tls\_psk|string|The preshared key, at least 32 hex digits.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *write-only*<br>- *required* if `tls_connect` is set to "PSK", or `tls_accept` contains the "PSK" bit| |active_available|integer|Host active interface availability status.<br><br>Possible values:<br>0 - interface status is unknown;<br>1 - interface is available;<br>2 - interface is not available.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |assigned_proxyid|ID|ID of the proxy assigned by Zabbix server, if the host is monitored by a proxy group.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
ca	### Equip  L'objecte equip té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|ID|ID de l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br> - *obligatori* per operacions d'actualització| |host|string|Nom tècnic de l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |description|text|Descripció de l'equip.| |flags|integer|Origen de l'equip.<br><br>Valors possibles:<br>0 - un equip normal;<br>4 - un equip descobert.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |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|Hora d'inici del manteniment efectiu.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |maintenance\_status|integer|Estat efectiu del manteniment.<br><br>Valors possibles:<br>0 - *(per defecte)* sense manteniment;<br>1 - manteniment efectiu.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |maintenance\_type|integer|Tipus de manteniment efectiu<br><br>Valors possibles:<br>0 - *(per defecte)* manteniment amb recollida de dades;<br>1 - manteniment sense recollida de dades.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |maintenanceid|ID|ID del manteniment vigent actualment a l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |name|string|Nom de l'equip visible.<br><br>Per defecte: valor de la propietat `equip`.| |monitored_by|integer|Origen que s'empra per monitorar l'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* Servidor Zabbix;<br>1 - Proxy;<br>2 - Grup de proxys.| |proxyid|ID|ID del proxy emprat per monitorar l'equip.| |proxy_groupid|ID|ID del grup de proxys que s'empra per monitorar l'equip.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* si `monitored_by` s'ha definit a "Grup de proxys"| |status|integer|Estat i funció de l'equip.<br><br>Valors possibles:<br>0 - *(per defecte)* equip monitorat;<br>1 - equip no monitorat.| |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 xifrat;<br>2 - PSK;<br> 4 - certificat. | |tls\_issuer|string|Emissor del certificat.| |tls\_subject|string|Assumpte del certificat.| |tls\_psk\_identity|string|Identitat PSK.<br>No hi poseu pas informació sensible a la identitat PSK, doncs es transmet sense xifrat per la xarxa per informar al receptor quina PSK emprar.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només escriptura*<br> - *obligatori* si `tls_connect` és "PSK", o `tls_accept` conté el bit "PSK".| |tls\_psk|string|La clau prèviament compartida, com a mínim 32 dígits hexadecimals.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només escriptura*<br> - *obligatori* si `tls_connect` o `tls_accept` tenen "PSK" habilitat.| |active_available|integer|Estat de disponibilitat de la interfície activa .<br><br>Valors possibles:<br>0 - estat de la interfície desconegut;<br>1 - la interfície és disponible;<br>2 - la interfície no és pas disponible.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*| |assigned_proxyid|ID|ID del proxy assignat per el servidor Zabbix, si l'equip és monitorat per un grup de proxys.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|

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) -   [Host tag](/manual/api/reference/host/object#host_tag)  Available methods:  -   [host.create](/manual/api/reference/host/create) - create new hosts -   [host.delete](/manual/api/reference/host/delete) - delete hosts -   [host.get](/manual/api/reference/host/get) - retrieve hosts -   [host.massadd](/manual/api/reference/host/massadd) - add related objects to hosts -   [host.massremove](/manual/api/reference/host/massremove) - remove related objects from hosts -   [host.massupdate](/manual/api/reference/host/massupdate) - replace or remove related objects from hosts -   [host.update](/manual/api/reference/host/update) - update 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) -   [Etiqueta d'equip](/manual/api/reference/host/object#host_tag)  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.update
ca	# host.update

en-us	#### Host value maps  |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this value map.| |name|<|string|(required) Value map name.| |mapping|<| |Root element for mappings.| |<|type|string|Mapping match type.<br>Possible values:^[1](#footnotes)^ EQUAL (0, default), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP (5), DEFAULT (6).| |^|value|string|Original value.| |^|newvalue|string|(required) Value to which the original value is mapped to.|  ::: noteclassic See also: [Value map object](/manual/api/reference/valuemap/object) (refer to the relevant property with a matching name). :::
ca	#### Mapes de valors de l'equip  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |uuid|<|string|(obligatori) Identificador únic per a aquest mapa de valors.| |nom|<|string|(obligatori) Nom del mapa de valors.| |cartografia|<| |Element arrel per a mapes.| |<|tipus|string|Tipus de concordança de mapatge.<br>Valors possibles:^[1](#footnotes)^ EQUAL (0, predeterminat), GREATER_OR_EQUAL (2), LESS_OR_EQUAL (3), IN_RANGE (4), REGEXP ( 5), PER Defecte (6).| |^|valor|string|Valor original.| |^|newvalue|string|(obligatori) Valor al qual s'assigna el valor original.|  ::: noteclassic Veieu també: [Objecte del mapa de valors](/manual/api/reference/valuemap/object) (consulteu la propietat rellevant amb un nom coincident). :::

en-us	#### Host web scenarios  |Element|<|Type|Description| |-|---|---|-----------------------| |uuid|<|string|(required) Unique identifier for this web scenario.| |name|<|string|(required) Web scenario name.| |delay|<|string|Frequency (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of executing web scenario.<br>Default: 1m.| |attempts|<|integer|The number of attempts for executing web scenario steps.<br>Possible values: 1-10 (default: 1).| |agent|<|string|Client agent. Zabbix will pretend to be the selected browser.<br>This is useful when a website returns different content for different browsers.<br>Default: Zabbix.| |http\_proxy|<|string|Proxy that will be used by the web scenario given as: `http://[username[:password]@]proxy.example.com[:port]`| |variables|<| |Root element for web scenario variables that may be used in scenario steps.| |<|name|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.<br>Headers should be listed using the same syntax as they would appear in the HTTP protocol.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |status|<|string|Web scenario status.<br>Possible values:^[1](#footnotes)^ ENABLED (0, default), DISABLED (1).| |authentication|<|string|Authentication method.<br>Possible values:^[1](#footnotes)^ NONE (0, default), BASIC (1), NTLM (2).| |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|Verify the SSL certificate of the web server.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |verify\_host|<|string|Verify that the *Common Name* field or the *Subject Alternate Name* field of the web server certificate matches.<br>Possible values:^[1](#footnotes)^ NO (0, default), YES (1).| |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|<| |(required) Root element for [host web scenario steps](#host-web-scenario-steps).| |tags|<| |Root element for web scenario tags.| |<|tag|string|(required) Tag name.| |^|value|string|Tag value.|  ::: noteclassic See also: [Web scenario object](/manual/api/reference/httptest/object) (refer to the relevant property with a matching name). :::
ca	#### Escenaris d'allotjament web  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |uuid|<|string|(obligatori) Identificador únic per a aquest escenari web.| |nom|<|string|(obligatori) Nom de l'escenari web.| |retard|<|string|Freqüència (emprant segons, [sufix de temps](/manual/appendix/suffixes#time-sufix) o [macro d'usuari](/manual/config/macros/user_macros)) d'execució de l'escenari web. <br>Per defecte: 1m.| |intents|<|integer|Nombre d'intents per executar passos de l'escenari web.<br>Valors possibles: 1-10 (per defecte: 1).| |agent|<|string|Agent client. Zabbix simularà ser el navegador seleccionat.<br>Això és útil quan un lloc web retorna contingut diferent per a diferents navegadors.<br>Per defecte: Zabbix.| |http\_proxy|<|string|Proxy que emprarà l'escenari web com a: `http://[nom d'usuari[:mot de pas]@]proxy.example.com[:port]`| |variables|<| |Element arrel per a variables d'escenari web que es poden emprar en els passos de l'escenari.| |<|nom|string|(obligatori) Nom de la variable.| |^|valor|text|(obligatori) Valor variable.| |capçaleres|<| |Element arrel per a les capçaleres HTTP que s'enviaran quan es faci una petició.<br>Les capçaleres s'han de llistar emprant la mateixa sintaxi que apareixeria al protocol HTTP.| |<|nom|string|(obligatori) Nom de la capçalera.| |^|valor|text|(obligatori) Valor de la capçalera.| |estat|<|string|Estat de l'escenari web.<br>Valors possibles:^[1](#footnotes)^ ACTIVAT (0, predeterminat), DESACTIVAT (1).| |autenticació|<|string|Mètode d'autenticació.<br>Valors possibles:^[1](#footnotes)^ CAP (0, predeterminat), BASIC (1), NTLM (2).| |http\_user|<|string|Nom d'usuari emprat per a l'autenticació BASIC (HTTP) o NTLM.| |http\_password|<|string|Mot de pas emprada per a l'autenticació BASIC (HTTP) o NTLM.| |verify\_peer|<|string|Verificar el certificat SSL del servidor web.<br>Valors possibles:^[1](#footnotes)^ NO (0, predeterminat), SÍ (1).| |verify\_host|<|string|Verifiqueu que el camp *Common Name* o el camp *Subject Alternate Name* del certificat del servidor web coincideix.<br>Possibles valors:^[1](#footnotes)^ NO (0 , per defecte), SÍ (1).| |ssl\_cert\_file|<|string|Nom del fitxer de certificat SSL emprat per a l'autenticació del client (ha d'estar en format PEM).| |ssl\_key\_file|<|string|Nom del fitxer de clau privada SSL emprat per a l'autenticació del client (ha de ser en format PEM).| |ssl\_key\_password|<|string|mot de pas del fitxer de clau privada SSL.| |passos|<| |(obligatori) Element arrel per a [passos de l'escenari web equip](#host-web-scenario-steps).| |etiquetes|<| |Element arrel per a les etiquetes d'escenari web.| |<|etiqueta|string|(obligatori) Nom de l'etiqueta.| |^|valor|string|Valor de l'etiqueta.|  ::: noteclassic Veieu també: [Objecte d'escenari web](/manual/api/reference/httptest/object) (consulteu la propietat rellevant amb un nom coincident). :::

en-us	##### Host web scenario steps  |Element|<|Type|Description| |-|---|---|-----------------------| |name|<|string|(required) Web scenario step name.| |url|<|string|(required) URL for monitoring.| |query\_fields|<| |Root element for query parameters (an array of HTTP fields to be added to the URL when performing a request).| |<|name|string|(required) Query parameter name.| |^|value|string|Query parameter value.| |posts|<| |Root element for HTTP POST variables (a string (raw post data) or an array of HTTP fields (form field data)).| |<|name|string|(required) Post field name.| |^|value|string|(required) Post field value.| |variables|<| |Root element of step-level variables (macros) that should be applied after this step.<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|string|(required) Variable name.| |^|value|text|(required) Variable value.| |headers|<| |Root element for HTTP headers to be sent when performing a request.| |<|name|string|(required) Header name.| |^|value|text|(required) Header value.| |follow\_redirects|<|string|Follow HTTP redirects.<br>Possible values:^[1](#footnotes)^ NO (0), YES (1, default).| |retrieve\_mode|<|string|HTTP response retrieve mode.<br>Possible values:^[1](#footnotes)^ BODY (0, default), HEADERS (1), BOTH (2).| |timeout|<|string|Timeout (using seconds, [time suffix](/manual/appendix/suffixes#time-suffixes), or [user macro](/manual/config/macros/user_macros)) of step execution.<br>Default: 15s.| |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 (e.g., `200-201,210-299`; ignored if empty).|  ::: noteclassic See also: [Web scenario step object](/manual/api/reference/httptest/object#scenario-step) (refer to the relevant property with a matching name). :::
ca	##### Passes de l'escenari web de l'equip  |Element|<|Tipus|Descripció| |-|---|---|------------------------| |nom|<|string|(obligatori) Nom de la passa de l'escenari web.| |url|<|string|(obligatori) URL per al seguiment.| |query\_fields|<| |Element arrel per als paràmetres de consulta (una matriu de camps HTTP que s'han d'afegir a l'URL quan es fa una petició).| |<|nom|string|(obligatori) Nom del paràmetre de consulta.| |^|valor|string|Valor del paràmetre de consulta.| |publicacions|<| |Element arrel per a variables HTTP POST (una cadena (dades de publicació en brut) o una matriu de camps HTTP (dades de camp de formulari)).| |<|nom|string|(obligatori) Nom del camp de publicació.| |^|valor|string|(obligatori) Valor del camp de publicació.| |variables|<| |Element arrel de les variables de nivell de passa (macros) que s'haurien d'aplicar després d'aquesta passa.<br>Si el valor de la variable té un prefix "regex:", aleshores el seu valor s'extreu de les dades que retorna la passa d'acord amb el prefix normal del patró d'expressió seguint el prefix 'regex:'| |<|nom|string|(obligatori) Nom de la variable.| |^|valor|text|(obligatori) Valor variable.| |capçaleres|<| |Element arrel per a les capçaleres HTTP que s'enviaran en realitzar una sol·licitud.| |<|nom|string|(obligatori) Nom de la capçalera.| |^|valor|text|(obligatori) Valor de la capçalera.| |follow\_redirects|<|string|Seguiu les redireccions HTTP.<br>Valors possibles:^[1](#footnotes)^ NO (0), YES (1, predeterminat).| |retrieve\_mode|<|string|Mode de recuperació de la resposta HTTP.<br>Valors possibles:^[1](#footnotes)^ BODY (0, predeterminat), HEADERS (1), BOTH (2).| |timeout|<|string|Timeout (emprant segons, [sufix de temps](/manual/appendix/suffixes#time-sufixes) o [macro d'usuari](/manual/config/macros/user_macros)) de l'execució de la passa.< br>Per defecte: 15 s.| |obligatori|<|string|Text que ha d'estar present a la resposta (ignorat si és buit).| |status\_codes|<|string|Llista delimitada per comes de codis d'estat HTTP acceptats (p. ex., `200-201,210-299`; ignorat si és buit).|  ::: noteclassic Veieu també: [Objecte de passa d'escenari web](/manual/api/reference/httptest/object#scenario-step) (consulteu la propietat rellevant amb un nom coincident). :::

en-us	#### host  [ZBXNEXT-5878](https://support.zabbix.com/browse/ZBXNEXT-5878) `host.create`, `host.update`, `host.massAdd`, `host.massUpdate`, `host.massRemove`: Added strict validation of the `groups`, `macros`, `tags`, `templates` parameters.
ca	#### equip  [ZBXNEXT-5878](https://support.zabbix.com/browse/ZBXNEXT-5878) `host.create`, `host.update`, `host.massAdd`, `host.massUpdate`, `host.massRemove`: S'han afegit els paràmetres `groups`, `macros`, `tags`, `templates` de validació estricta.

en-us	#### host  [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `host.get`: Removed support for parameter `proxy_hosts`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) Renamed property `proxy_hostid` to `proxyid`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `host.get`: Method now also supports `status`, `ts_disable` and `disable_source` properties if `selectHostDiscovery` parameter is used.
ca	#### host  [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) `host.get`: S'ha tret el suport del paràmetre `proxy_hosts`.\ [ZBXNEXT-8500](https://support.zabbix.com/browse/ZBXNEXT-8500) S'ha reanomenat la propietat `proxy_hostid` a `proxyid`.\ [ZBXNEXT-2020](https://support.zabbix.com/browse/ZBXNEXT-2020) `host.get`: El mètode ara admet les propietats `status`, `ts_disable` i `disable_source` si s'ha emprat el paràmetre `selectHostDiscovery`.

en-us	#### Housekeeping  Configure housekeeping.  [Housekeeping API](/manual/api/reference/housekeeping)
ca	#### Manteniment  Configurar el manteniment.  [API manteniment](/manual/api/reference/housekeeping)

en-us	##### HousekeepingFrequency  How often Zabbix will perform housekeeping procedure (in hours). Housekeeping is removing outdated information from the database.<br>*Note*: To lower load on proxy startup housekeeping is postponed for 30 minutes after proxy start. Thus, if HousekeepingFrequency is 1, the very first housekeeping procedure after proxy start will run after 30 minutes, and will repeat every hour thereafter.<br>It is possible to disable automatic housekeeping by setting HousekeepingFrequency to 0. In this case the housekeeping procedure can only be started by *housekeeper\_execute* runtime control option.  Default: `1`<br> Range: 0-24
ca	##### HousekeepingFrequency  Amb quina freqüència Zabbix realitzarà el procediment de neteja (en hores). El servei de neteja esborra informació obsoleta de la base de dades.<br>*Nota*: Per reduir la càrrega d'inici del proxy, la neteja s'ajorna durant 30 minuts després de l'inici del proxy. Per tant, si HousekeepingFrequency és 1, el primer procediment de neteja després de l'inici del proxy s'executarà al cap de 30 minuts i es repetirà cada hora després.<br>És possible desactivar la neteja automàtica posant HousekeepingFrequency a 0. En aquest cas, el procediment de neteja només es pot iniciar mitjançant l'opció de control del temps d'execució *housekeeper\_execute*.  Per defecte: `1`<br> Rang: 0-24

en-us	##### HousekeepingFrequency This parameter determines how often Zabbix will perform the housekeeping procedure in hours. Housekeeping is removing outdated information from the database.<br>*Note*: To prevent housekeeper from being overloaded (for example, when history and trend periods are greatly reduced), no more than 4 times HousekeepingFrequency hours of outdated information are deleted in one housekeeping cycle, for each item. Thus, if HousekeepingFrequency is 1, no more than 4 hours of outdated information (starting from the oldest entry) will be deleted per cycle.<br>*Note*: To lower load on server startup housekeeping is postponed for 30 minutes after server start. Thus, if HousekeepingFrequency is 1, the very first housekeeping procedure after server start will run after 30 minutes, and will repeat with one hour delay thereafter.<br>It is possible to disable automatic housekeeping by setting HousekeepingFrequency to 0. In this case the housekeeping procedure can only be started by *housekeeper\_execute* runtime control option and the period of outdated information deleted in one housekeeping cycle is 4 times the period since the last housekeeping cycle, but not less than 4 hours and not greater than 4 days.<br>See also [runtime control](/manual/concepts/server#server_process) options.  Default: `1`<br> Range: 0-24
ca	##### HousekeepingFrequency Aquest paràmetre determina la freqüència amb què Zabbix realitzarà el procediment de neteja en hores. El servei de neteja esborra informació obsoleta de la base de dades.<br>*Nota*: Per evitar que la tasca es sobrecarregui (per exemple, quan es redueixen molt els períodes de l'historial i les tendències), no s'esborren més de 4 hores d'informació obsoleta cada cicle de neteja, per a cada element. Per tant, si HousekeepingFrequency és 1, no s'esborraran més de 4 hores d'informació obsoleta (a partir de l'entrada més antiga) per cicle.<br>*Nota*: Per reduir la càrrega a l'inici del servidor, la neteja s'ajorna 30 minuts després de l'inici del servidor. Per tant, si HousekeepingFrequency és 1, el primer procediment de neteja després de l'inici del servidor s'executarà al cap de 30 minuts i es repetirà amb una hora d'endarreriment.<br>És possible desactivar la neteja automàtica posant HousekeepingFrequency a 0. En aquest cas, El procediment de neteja només es pot iniciar mitjançant l'opció de control del temps d'execució *housekeeper\_execute* i el període d'informació obsoleta esborrada en un cicle de neteja és 4 vegades el període des de l'últim cicle de neteja, però no menys de 4 hores ni superior a 4 dies. <br>Veieu també les opcions [control en temps d'execució](/manual/concepts/server#server_process).  Per defecte: `1`<br> Rang: 0-24

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: 31d.| |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: 31d.| |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|Configuration flag DB extension. If this flag is set to "timescaledb" then the server changes its behavior for housekeeping and item deletion.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |compression\_availability|integer|Whether data compression is supported by the database (or its extension).<br><br>Possible values:<br>0 - Unavailable;<br>1 - Available.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*| |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.|
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\_availability|integer|*(només lectura)* Disponibilitat de compressió.<br><br>Valors possibles:<br>0 - No disponible;<br>1 - Disponible.| |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.|

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 modules work  -   An enabled module is launched on each HTTP request, before executing the action code. -   The module will register new actions or redefine the existing ones. -   The module will add new frontend sections and remove or redefine the existing ones. -   The module will hook to frontend events like onBeforeAction and onTerminate, if needed. -   The requested action is finally executed by running the action code - either the default one, or module-defined.
ca	### Com treballen els mòduls  - S'inicia un mòdul habilitat a cada petició HTTP, abans d'executar el codi d'acció. - El mòdul registrarà noves accions o redefinirà les existents. - El mòdul afegirà noves seccions d'interfície i esborrarà o redefinirà les existents. - El mòdul es connectarà a esdeveniments de frontend com onBeforeAction i onTerminate, si cal. - L'acció demanada es du a terme executant el codi d'acció, ja sigui el predeterminat o definit pel mòdul.

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	##### HTTP agent items  [HTTP agent](/manual/config/items/itemtypes/http) item is an item for executing data requests over HTTP/HTTPS. HTTP agent items are useful for sending requests to HTTP endpoints to retrieve data from services such as *Elasticsearch* and *OpenWeatherMap*, for checking the status of Zabbix API or the status of Apache or Nginx web server, etc. HTTP agent items (with trapping enabled) can also function as [trapper items](#trapper-items).
ca	##### Elements d'agent HTTP  L'element [agent HTTP](/manual/config/items/itemtypes/http) és un element per executar peticions de dades mitjançant HTTP/HTTPS. Els elements d'agent HTTP són útils per enviar peticions a punts finals HTTP per recuperar dades de serveis com ara *Elasticsearch* i *OpenWeatherMap*, per comprovar l'estat de l'API Zabbix o l'estat del servidor web Apache o Nginx, etc. Els elements HTTP agent (amb trapping activat) també poden funcionar com a [elements trapper](#trapper-items).

en-us	### HTTP field  The HTTP field object defines the name and value that is used to specify the web scenario variables, HTTP headers, and POST fields or query fields. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Name of header/variable/POST or GET field.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Value of header/variable/POST or GET field.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Camp HTTP  L'objecte de camp HTTP defineix un nom i un valor emprats per especificar una variable, una capçalera HTTP, les dades del camp de formulari POST o les dades de camp de petició. Té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|string|Nom de la capçalera / variable / camp POST o GET.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |value|string|Valor de la capçalera / variable / camp POST o GET.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### HTTP header  The header object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |name|string|HTTP header name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Header value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Capçalera HTTP  L'objecte de capçalera té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom de la capçalera HTTP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|string|Valor de la capçalera.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### HTTP header  The header object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |name|string|HTTP header name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Header value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Capçalera HTTP  L'objecte de capçalera té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom de la capçalera HTTP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|string|Valor de la capçalera.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### HTTP header  The header object has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |name|string|HTTP header name.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Header value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Capçalera HTTP  L'objecte de capçalera té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom de la capçalera HTTP.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|string|Valor de la capçalera.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### HTTP query field  The query field object defines a name and value that is used to specify a URL parameter. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |name|string|Name of the parameter.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Parameter value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Camp de consulta HTTP  L'objecte del camp de consulta defineix un nom i un valor que s'empra per especificar un paràmetre d'URL. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom del paràmetre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|string|Valor del paràmetre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### HTTP query field  The query field object defines a name and value that is used to specify a URL parameter. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |name|string|Name of the parameter.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Parameter value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Camp de consulta HTTP  L'objecte del camp de consulta defineix un nom i un valor que s'empra per especificar un paràmetre d'URL. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom del paràmetre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|string|Valor del paràmetre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	### HTTP query field  The query field object defines a name and value that is used to specify a URL parameter. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--------|---------------------------------------------------|-----------| |name|string|Name of the parameter.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |value|string|Parameter value.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
ca	### Camp de consulta HTTP  L'objecte del camp de consulta defineix un nom i un valor que s'empra per especificar un paràmetre d'URL. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--------|----------------------------------------- -----------|-----------| |nom|string|Nom del paràmetre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |valor|string|Valor del paràmetre.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*|

en-us	#### HttpRequest  This object encapsulates cURL handle allowing to make simple HTTP requests. Errors are thrown as exceptions.  ::: noteimportant The initialization of multiple `HttpRequest` objects is limited to 10 per script execution. :::  |Method|Description| |--|--------| |`addHeader(value)`|Adds HTTP header field. This field is used for all following requests until cleared with the `clearHeader()` method.<br>The total length of header fields that can be added to a single `HttpRequest` object is limited to 128 Kbytes (special characters and header names included).| |`clearHeader()`|Clears HTTP header. If no header fields are set, `HttpRequest` will set Content-Type to application/json if the data being posted is JSON-formatted; text/plain otherwise.| |`connect(url)`|Sends HTTP CONNECT request to the URL and returns the response.| |`customRequest(method, url, data)`|Allows to specify any HTTP method in the first parameter. Sends the method request to the URL with optional *data* payload and returns the response.| |`delete(url, data)`|Sends HTTP DELETE request to the URL with optional *data* payload and returns the response.| |`getHeaders(<asArray>)`|Returns the object of received HTTP header fields.<br>The `asArray` parameter may be set to "true" (e.g., `getHeaders(true)`), "false" or be undefined. If set to "true", the received HTTP header field values will be returned as arrays; this should be used to retrieve the field values of multiple same-name headers.<br>If not set or set to "false", the received HTTP header field values will be returned as strings.| |`get(url, data)`|Sends HTTP GET request to the URL with optional *data* payload and returns the response.| |`head(url)`|Sends HTTP HEAD request to the URL and returns the response.| |`options(url)`|Sends HTTP OPTIONS request to the URL and returns the response.| |`patch(url, data)`|Sends HTTP PATCH request to the URL with optional *data* payload and returns the response.| |`put(url, data)`|Sends HTTP PUT request to the URL with optional *data* payload and returns the response.| |`post(url, data)`|Sends HTTP POST request to the URL with optional *data* payload and returns the response.| |`getStatus()`|Returns the status code of the last HTTP request.| |`setProxy(proxy)`|Sets HTTP proxy to "proxy" value. If this parameter is empty, then no proxy is used.| |`setHttpAuth(bitmask, username, password)`|Sets enabled HTTP authentication methods (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) in the 'bitmask' parameter.<br>The HTTPAUTH\_NONE flag allows to disable HTTP authentication.<br>Examples:<br>`request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, username, password)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Sends HTTP TRACE request to the URL with optional *data* payload and returns the response.|  Example:  ```javascript try {     Zabbix.log(4, 'jira webhook script value='+value);        var result = {         'tags': {             'endpoint': 'jira'         }     },     params = JSON.parse(value),     req = new HttpRequest(),     fields = {},     resp;        req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic '+params.authentication);        fields.summary = params.summary;     fields.description = params.description;     fields.project = {"key": params.project_key};     fields.issuetype = {"id": params.issue_id};     resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );        if (req.getStatus() != 201) {         throw 'Response code: '+req.getStatus();     }        resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key; } catch (error) {     Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));     Zabbix.log(4, 'jira issue creation failed : '+error);        result = {}; }    return JSON.stringify(result); ```
ca	#### HttpRequest  Aquest objecte encapsula el maneig cURL que permet fer peticions HTTP senzilles. Els errors es llancen com a excepcions.  ::: nota important La inicialització de diversos objectes `HttpRequest` és limitada a 10 per execució de l'script. :::  |Mètode|Descripció| |--|---------| |`addHeader(name, value)`|Afegeix un camp de capçalera HTTP. Aquest camp s'empra per a totes les peticions següents fins que s'esborri amb el mètode `clearHeader()`.<br>La longitud total dels camps de capçalera que es poden afegir a un sol objecte `HttpRequest` és limitada a 128 Koctets (caràcters especials i noms de capçalera inclosos).| |`clearHeader()`|Esborra la capçalera HTTP. Si no s'estableix cap camp de capçalera, `HttpRequest` establirà Content-Type a application/json si les dades que es publiquen tenen format JSON; text/llaç en cas contrari.| |`connect(url)`|Envia la petició HTTP CONNECT a l'URL i retorna la resposta.| |`customRequest(method, url, data)`|Permet especificar qualsevol mètode HTTP al primer paràmetre. Envia la petició de mètode a l'URL amb la càrrega útil opcional *data* i retorna la resposta.| |`delete(url, data)`|Envia la petició HTTP DELETE a l'URL amb una càrrega útil opcional *data* i retorna la resposta.| |`getHeaders(<asArray>)`|Retorna l'objecte dels camps de capçalera HTTP rebuts.<br>El paràmetre `asArray` es pot establir com a "cert" (per exemple, `getHeaders(true)`), "fals" o no estar definit. Si es defineix com a "cert", els valors dels camps de capçalera HTTP rebuts es retornaran com a matrius; així s'ha d'emprar per recuperar els valors de camp de diverses capçaleres del mateix nom.<br>Si no s'estableix o s'estableix com a "fals", els valors dels camps de la capçalera HTTP rebuts es retornaran com a cadenes.| |`get(url, data)`|Envia la petició HTTP GET a l'URL amb una càrrega útil opcional *data* i retorna la resposta.| |`head(url)`|Envia la petició HTTP HEAD a l'URL i retorna la resposta.| |`options(url)`|Envia la petició HTTP OPTIONS a l'URL i retorna la resposta.| |`patch(url, data)`|Envia la petició HTTP PATCH a l'URL amb una càrrega útil opcional *data* i retorna la resposta.| |`put(url, dades)`|Envia la petició HTTP PUT a l'URL amb una càrrega útil opcional *data* i retorna la resposta.| |`post(url, data)`|Envia la petició HTTP POST a l'URL amb una càrrega útil opcional *data* i retorna la resposta.| |`getStatus()`|Retorna el codi d'estat de la darrera petició HTTP.| |`setProxy(proxy)`|Defineix el proxy HTTP al valor "proxy". Si aquest paràmetre és buit, no s'empra cap proxy.| |`setHttpAuth(bitmask, username, password)`|Defineix els mètodes d'autenticació HTTP activats (HTTPAUTH\_BASIC, HTTPAUTH\_DIGEST, HTTPAUTH\_NEGOTIATE, HTTPAUTH\_NTLM, HTTPAUTH\_NONE) al paràmetre 'bitmask'.<br>L'HTTPAUTH. \_NONE permet desactivar l'autenticació HTTP.<br>Exemples:<br>`request.setHttpAuth(HTTPAUTH_NTLM \| HTTPAUTH_BASIC, nom d'usuari, mot de pas)`<br>`request.setHttpAuth(HTTPAUTH_NONE)`| |`trace(url, data)`|Envia la petició HTTP TRACE a l'URL amb una càrrega útil opcional *data* i retorna la resposta.|  Exemple:  ```javascript try {     Zabbix.log(4, 'jira webhook script value='+value);        var result = {         'tags': {             'endpoint': 'jira'         }     },     params = JSON.parse(value),     req = new HttpRequest(),     fields = {},     resp;        req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic '+params.authentication);        fields.summary = params.summary;     fields.description = params.description;     fields.project = {"key": params.project_key};     fields.issuetype = {"id": params.issue_id};     resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );        if (req.getStatus() != 201) {         throw 'Response code: '+req.getStatus();     }        resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key; } catch (error) {     Zabbix.log(4, 'jira issue creation failed json : '+JSON.stringify({"fields": fields}));     Zabbix.log(4, 'jira issue creation failed : '+error);        result = {}; }    return JSON.stringify(result); ```

en-us	# httptest.create
ca	# httptest.create

en-us	# httptest.delete
ca	# httptest.delete

en-us	# httptest.get
ca	# httptest.get

en-us	# httptest.update
ca	# httptest.update

en-us	#### Hysteresis  Sometimes an interval is needed between problem and recovery states, rather than a simple threshold. For example, if we want to define a trigger that reports a problem when server room temperature goes above 20°C and we want it to stay in the problem state until the temperature drops below 15°C, a simple trigger threshold at 20°C will not be enough.  Instead, we need to define a trigger expression for the problem event first (temperature above 20°C). Then we need to define an additional recovery condition (temperature below 15°C). This is done by defining an additional *Recovery expression* parameter when [defining](/manual/config/triggers/trigger) a trigger.  In this case, problem recovery will take place in two steps:  -   First, the problem expression (temperature above 20°C) will have to     evaluate to FALSE -   Second, the recovery expression (temperature below 15°C) will have     to evaluate to TRUE  The recovery expression will be evaluated only when the problem event is resolved first.  ::: notewarning The recovery expression being TRUE alone does not resolve a problem if the problem expression is still TRUE! :::
ca	#### Histèresi  De vegades cal un interval entre els estats de problema i de recuperació, en lloc de només un llindar. Per exemple, si volem establir un trigger per informar d'un problema quan la temperatura de la sala del servidor supera els 20 °C i volem que es mantingui en l'estat de problema fins que la temperatura baixi dels 15 °C, un llindar d'activació simple a 20 °C no serà suficient.  el que hem de fer és, primer, definir un trigger per a l'esdeveniment problemàtic (temperatura superior a 20 °C). Tot seguit, hem de definir una condició de recuperació addicional (temperatura inferior a 15 °C). Per fer-ho, definiu un paràmetre addicional *Expressió de recuperació* quan [definiu](/manual/config/triggers/trigger) el trigger.  En aquest cas, la recuperació del problema es farà en dues passes:  - En primer lloc, l'expressió del problema (temperatura superior a 20°C) s'ha de valorar com a FALSE - En segon lloc, l'expressió de recuperació (temperatura inferior a 15 °C) s'ha de valorar com a TRUE  L'expressió de recuperació s'avaluarà només quan es resolgui primer l'esdeveniment problema.  ::: notewarning   L'expressió de recuperació per si sola a TRUE no resol el problema si l'expressió problema encara és TRUE! :::

en-us	 ##### icmppingloss\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmppingloss}  <br> The percentage of lost packets.<br> Return value: *Float*.  Parameters:  -   **target** - the host IP or DNS name; -   **packets** - the number of packets; -   **interval** - the time between successive packets in milliseconds; -   **size** - the packet size in bytes; -   **timeout** - the timeout in milliseconds; -   **options** - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to *allow_redirect*, redirected responses are treated as target host up.  See also the table of [default values](#default-values).
ca	 ##### icmppingloss\[<target>,<packets>,<interval>,<size>,<timeout>,<opcions>\] {#icmppingloss}  <br> El percentatge de paquets perduts.<br> Valor de retorn: *Flotant*  Paràmetres:  - **target** - IP de l'equip o nom DNS; - **paquets** - nombre de paquets; - **interval** - temps entre paquets successius en mil·lisegons; - **mida** - mida del paquet en octets; - **timeout** - temps d'espera en mil·lisegons; - **opcions** - emprat per permetre redireccions: si és buit (valor per defecte), les respostes redirigides es tracten com a equip destí caigut; si s'estableix en *allow_redirect*, les respostes redirigides es tracten com que l'equip destí és actiu.  Veieu també la taula de [valors per defecte](#valors-predeterminats).

en-us	 ##### icmppingsec\[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<options>\] {#icmppingsec}  <br> The ICMP ping response time (in seconds).<br> Return value: *Float*.  Parameters:  -   **target** - the host IP or DNS name; -   **packets** - the number of packets; -   **interval** - the time between successive packets in milliseconds; -   **size** - the packet size in bytes; -   **timeout** - the timeout in milliseconds; -   **mode** - possible values: *min*, *max*, or *avg* (default); -   **options** - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to *allow_redirect*, redirected responses are treated as target host up.  Comments:  -   Packets which are lost or timed out are not used in the calculation; -   If the host is not available (timeout reached), the item will return 0; -   If the return value is less than 0.0001 seconds, the value will be set to 0.0001 seconds; -   See also the table of [default values](#default-values).
ca	 ##### icmppingsec\[<target>,<packets>,<interval>,<size>,<timeout>,<mode>,<opcions>\] {#icmppingsec}  <br> Temps de resposta al ping ICMP (en segons).<br> Valor de retorn: *Flotant*.  Paràmetres:  - **target** - IP de l'equip o el nom DNS; - **paquets** - nombre de paquets; - **interval** - emps entre paquets successius en mil·lisegons; - **mida** - mida del paquet en octets; - **timeout** - temps d'espera en mil·lisegons; - **mode** - valors possibles: *min*, *max* o *avg* (per defecte); - **opcions** - emprat per permetre redireccions: si és buit (valor per defecte), les respostes redirigides es tracten com a equip destí caigut; si s'estableix en *allow_redirect*, les respostes redirigides es tracten com que l'equip destí és actiu.  Comentaris:  - Els paquets que es perden o s'han esgotat no s'empren al càlcul; - Si l'equip no és disponible (s'ha arribat al temps d'espera), l'element tornarà 0; - Si el valor de retorn és inferior a 0,0001 segons, el valor s'establirà en 0,0001 segons; - Veieu també la taula de [valors per defecte](#valors-predeterminats).

en-us	### ICMP pings  Zabbix uses an external utility **[fping](https://fping.org/)** to process ICMP pings (**icmpping**, **icmppingloss**, **icmppingsec**).
ca	#### Pings ICMP  Zabbix empra la utilitat externa **fping** per fer pings ICMP.  La utilitat no forma part de la distribució Zabbix i s'ha d'instal·lar addicionalment. Si manca la utilitat, té permisos incorrectes o la seva ubicació no coincideix amb la ubicació definida al fitxer de configuració del servidor/proxy Zabbix (paràmetre 'FpingLocation'), els pings ICMP (**icmpping**, **icmppingloss**, ** icmppingsec**) no es processaran pas.  Veieu també: [problemes coneguts](/manual/installation/known_issues#simple_checks)  **fping** ha d'ésser executable per l'usuari dels dimonis Zabbix que s'executen com a root i setuid. Executeu aquestes ordres com a usuari **root** per configurar els permisos correctes:      shell> chown root:zabbix /usr/sbin/fping     shell> chmod 4710 /usr/sbin/fping  Després d'executar les dues ordres anteriors, comproveu la propietat de l'executable **fping**. En alguns casos, la propietat es pot restablir executant l'ordre chmod.  Comproveu també si l'usuari zabbix pertany al grup zabbix executant:      shell> groups zabbix  i si no, afegiu-lo executant:      shell> usermod -a -G zabbix zabbix  Després d'executar les dues ordres anteriors, comproveu la propietat de l'executable **fping**. En alguns casos, la propietat es pot restablir executant l'ordre chmod.  Comproveu també si l'usuari zabbix pertany al grup zabbix executant:       shell>grups zabbix Valors per defecte, límits i descripció dels valors dels paràmetres de control ICMP:  |Paràmetre|Unitat|Descripció|Etiqueta Fping|Valors per defecte establerts per|<|Límits permesos<br>per Zabbix|<| |--|--|---------|-|--|--|--|--| |||||**fping**|**Zabbix**|**min**|**max**| |paquets|nombre|nombre de paquets de petició a un objectiu|-C||3|1|10000| |interval|mil·lisegons|temps d'espera entre paquets successius|-p|1000||20|il·limitat| |mida|octets|mida del paquet en octets<br>56 octets a x86, 68 octets a x86_64|-b|56 o 68||24|65507| |timeout|mil·lisegons|**fping v3.x** - temps d'espera després de l'enviament del darrer paquet, afectat per la marca *-C*<br> **fping v4.x** - temps d'espera individual per a cada paquet |-t|* *fping v3.x** - 500<br>**fping v4.x** - heretat de l'assenyalador *-p*, però no més de 2000||50| il·limitat|  A més, Zabbix empra les opcions fping *-i interval ms* (no s'ha de confondre amb el paràmetre d'element *interval* esmentat a la taula anterior, que correspon a l'opció fping *-p*) i *-S adreça IP font* (o * -I* en versions anteriors d'fping). Aquestes opcions es detecten automàticament executant comprovacions amb diferents combinacions d'opcions. Zabbix prova de detectar el valor mínim en mil·lisegons que fping permet emprar amb *-i* provant 3 valors: 0, 1 i 10. El valor que té èxit primer s'empra per a les comprovacions ICMP posteriors. Aquest procés el fa cada procés [ICMP pinger](/manual/concepts/server#server_process_types) individualment.  Les opcions d'fping detectades automàticament s'invaliden cada hora i es tornen a detectar al següent intent de verificació ICMP. Establiu DebugLevel>=4 per mostrar els detalls d'aquest procés al fitxer de registre del servidor o del proxy.  ::: notewarning Exempció de responsabilitat: els valors predeterminats d'fping poden variar segons la plataforma i la versió; en cas de dubte, consulteu la documentació d'fping. :::  Zabbix escriu adreces IP per ésser verificades amb una de les tres claus *icmpping\** a un fitxer temporal, que després es passa a **fping**. Si els elements tenen paràmetres clau diferents, només s'escriuen en un sol fitxer aquells amb paràmetres clau idèntics.\ Totes les adreces IP escrites al fitxer únic es comprovaran mitjançant fping en paral·lel, de manera que el procés Zabbix icmp pinger passarà un temps fix independentment del nombre d'adreces IP del fitxer.

en-us	 ##### icmpping\[<target>,<packets>,<interval>,<size>,<timeout>,<options>\] {#icmpping}  <br> The host accessibility by ICMP ping.<br> Return value: *0* - ICMP ping fails; *1* - ICMP ping successful.  Parameters:  -   **target** - the host IP or DNS name; -   **packets** - the number of packets; -   **interval** - the time between successive packets in milliseconds; -   **size** - the packet size in bytes; -   **timeout** - the timeout in milliseconds; -   **options** - used for allowing redirect: if empty (default value), redirected responses are treated as target host down; if set to *allow_redirect*, redirected responses are treated as target host up.  See also the table of [default values](#default-values).  Example:      icmpping[,4] #If at least one packet of the four is returned, the item will return 1.
ca	 ##### icmpping\[<target>,<packets>,<interval>,<size>,<timeout>,<opcions>\] {#icmpping}  <br> L'accessibilitat de l'equip mitjançant ping ICMP.<br> Valor de retorn: *0* - Ping ICMP falla; *1* - Ping ICMP correcte.  Paràmetres:  - **target** - IP de l'equip o nom DNS; - **paquets** - nombre de paquets; - **interval** - temps entre paquets successius en mil·lisegons; - **mida** - mida del paquet en octets; - **timeout** - temps d'espera en mil·lisegons; - **opcions** - emprat per permetre redireccions: si és buit (valor per defecte), les respostes redirigides es tracten com a equip destí caigut; si s'estableix en *allow_redirect*, les respostes redirigides es tracten com que l'equip destí és actiu.  Veieu també la taula de [valors per defecte](#valors-predeterminats).  Exemple:       icmpping[,4] #Si es retorna almenys un paquet dels quatre, l'element retornarà 1.

en-us	##### Icon highlighting  If a map element is in problem status, it is highlighted with a round circle. The fill color of the circle corresponds to the severity color of the problem. Only problems on or above the selected severity level will be displayed with the element. If all problems are acknowledged, a thick green border around the circle is displayed.  Additionally:  -   a host in [maintenance](/manual/maintenance) is highlighted with an     orange, filled square. Note that maintenance highlighting has     priority over the problem severity highlighting, if the map element is      host. -   a disabled (not-monitored) host is highlighted with a gray, filled     square.  Highlighting is displayed if the *Icon highlighting* check-box is marked in map [configuration](/manual/config/visualization/maps/map#creating_a_map).
ca	##### Icona ressaltada  Si un element del mapa es troba en un estat problemàtic, es ressalta amb un cercle. El color de farcit del cercle correspon al color de la gravetat del problema. Amb l'element només es mostraran problemes amb el nivell de gravetat seleccionat o superior. Si es resolen tots els problemes, es mostrarà una vora verda gruixuda al voltant del cercle.  A més de:  - un equip a [manteniment](/manual/maintenance) es ressalta amb un quadrat carbassa sòlid. Tingueu en compte que el ressaltat de manteniment té prioritat sobre el ressaltat de la gravetat del problema, si l'element del mapa és un equip. - un equip desactivat (no monitorat) es ressalta amb un quadrat gris ple.  El ressaltat es mostra si la casella de selecció *Icona destacada* és marcada a la [configuració](/manual/config/visualization/maps/map#creating_a_map) del mapa.

en-us	# iconmap.create
ca	# iconmap.create

en-us	# iconmap.delete
ca	# iconmap.delete

en-us	# iconmap.get
ca	# iconmap.get

en-us	# Icon map object  The following objects are directly related to the `iconmap` API.
ca	# Objecte mapa d'icones imatge  Els següents objectes tenen relació directa amb l'API `iconmap`.

en-us	### Icon mapping  The icon mapping object defines a specific icon to be used for hosts with a certain inventory field value. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconid|ID|ID of the icon used by the icon mapping.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |expression|string|Expression to match the inventory field against.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |inventory\_link|integer|ID of the host inventory field.<br><br>Refer to the [host inventory object](/manual/api/reference/host/object#host_inventory) for a list of supported inventory fields.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |sortorder|integer|Position of the icon mapping in the icon map.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*|
ca	### Mapatge d'icones  L'objecte defineix una icona específica per emprar-la per als equips amb un valor de camp d'inventari determinat. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconid|ID|ID de la icona emprada per el mapatge d'icones.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |expression|string|Expressió que coincideixi amb el camp d'inventari.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |inventory\_link|integer|ID de camp d'inventari de l'equip.<br><br>Consulteu [Objecte d'inventari d'equip](/manual/ api/reference/host/object#host_inventory) per a una llista de camps d'inventari compatibles.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |sortorder|integer|Posició de l'assignació d'icones a l'assignació d'icones.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*|

en-us	#### - Icon mapping  This section allows creating the mapping of certain hosts with certain icons. Host inventory field information is used to create the mapping.  The mappings can then be used in [network map configuration](/manual/config/visualization/maps/map) to assign appropriate icons to matching hosts automatically.  To create a new icon map, click on *Create icon map* in the top right corner.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_icon_map.png){width="600"}  Configuration parameters:  |Parameter|Description| |--|--------| |*Name*|Unique name of icon map.| |*Mappings*|A list of mappings. The order of mappings determines which one will have priority. You can move mappings up and down the list with drag-and-drop.| |*Inventory field*|Host inventory field that will be looked into to seek a match.| |*Expression*|Regular expression describing the match.| |*Icon*|Icon to use if a match for the expression is found.| |*Default*|Default icon to use.|
ca	#### - Mapatge d'icones  Aquesta secció us permet crear el mapatge de determinats equips amb determinades icones. La informació del camp d'inventari de l'equip s'empra per crear el mapatge.  Els mapatges es poden emprar a la [configuració del mapa de xarxa](/manual/config/visualization/maps/map) per assignar automàticament les icones correctes als equips corresponents.  Per crear un mapa d'icones nou, feu clic a *Crear un mapa d'icones* a l'extrem superior dret.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_icon_map.png){width="600"}  Paràmetres de configuració:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic del mapa d'icones.| |*Mapatges*|Una llista de mapes. L'ordre dels mapes determina quins tindran prioritat. Podeu moure mapes amunt i avall per la llista arrossegant i deixant anar.| |*Camp d'inventari*|Camp d'inventari de l'equip que es comprovarà si hi ha una coincidència.| |*Expressió*|Expressió regular que descriu la coincidència.| |*Icona*|Icona a emprar si es troba una coincidència per a l'expressió.| |*Per defecte*|Icona per defecte a emprar.|

en-us	### Icon map  The icon map object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |iconmapid|ID|ID of the icon map.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |default\_iconid|ID|ID of the default icon.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |name|string|Name of the icon map.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
ca	### Mapa d'icones  El mapa d'icones té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |iconmapid|ID|ID del mapa d'icones.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions d'actualització| |default\_iconid|ID|ID de la icona per defecte.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |name|string|Nom del mapa d'icones.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|  Veieu que per alguns mètodes (actualitzar, esborrar), la combinació de paràmetres obligatoris o opcionals és diferent.

en-us	# Icon map  This class is designed to work with icon maps.  Object references:  -   [Icon map](/manual/api/reference/iconmap/object#icon_map) -   [Icon mapping](/manual/api/reference/iconmap/object#icon_mapping)  Available methods:  -   [iconmap.create](/manual/api/reference/iconmap/create) - create new icon maps -   [iconmap.delete](/manual/api/reference/iconmap/delete) - delete icon maps -   [iconmap.get](/manual/api/reference/iconmap/get) - retrieve icon maps -   [iconmap.update](/manual/api/reference/iconmap/update) - update icon maps
ca	# Mapa d'icones  Aquesta classe és dissenyada per treballar amb mapes d'icones.  Referències d'objectes:  -   [Mapa d'icones](/manual/api/reference/iconmap/object#icon_map) -   [Cartografia d'icones](/manual/api/reference/iconmap/object#icon_mapping)  Mètodes disponibles:  -   [iconmap.create](/manual/api/reference/iconmap/create) - crear nou mapa d'icones -   [iconmap.delete](/manual/api/reference/iconmap/delete) - esborrar mapa d'icones -   [iconmap.get](/manual/api/reference/iconmap/get) - recuperar mapa d'icones -   [iconmap.update](/manual/api/reference/iconmap/update) - actualitzar mapa d'icones

en-us	# iconmap.update
ca	# iconmap.update

en-us	#### Icons replaced by fonts  All icons in the frontend have been switched from icon image sheets to fonts.
ca	#### Icones substituïdes per fonts  Totes les icones de la interfície s'han canviat dels fulls d'imatges d'icones als tipus de lletra.

en-us	#### Icons replaced by fonts  All icons in the frontend have been switched from icon image sheets to fonts.
ca	#### Icones substituïdes per fonts  Totes les icones de la interfície s'han canviat dels fulls d'imatges d'icones als tipus de lletra.

en-us	 ### id  Module ID. Must be unique. To avoid future naming conflicts, it is recommended to use prefix for modules (author or company name, or any other). For example, if a module is an example for lessons and the module name is "My module", then the ID will be "example_my_module".  *Type*: String  *Example*:  ```json "id": "example_my_module" ```
ca	 ### id  ID del mòdul. Ha de ser únic. Per evitar futurs conflictes de noms, es recomana emprar el prefix per als mòduls (nom de l'autor o de l'empresa, o qualsevol altre). Per exemple, si un mòdul és un exemple per a les lliçons i el nom del mòdul és "El meu mòdul", l'ID serà "example_my_module".  *Tipus*: Cadena  *Exemple*:  ```json "id": "example_my_module" ```

en-us	If access rights to persistent storage files are removed during agent operation or other errors occur (e.g. disk full) then errors are logged into the agent log file but the log item does not become NOTSUPPORTED.
ca	Si els drets d'accés als arxius d'emmagatzematge persistent s'esborren durant el funcionament de l'agent o si hi ha altre errors (per exemple, disc dur ple), els errors s'afegiran a l'arxiu de registre de l'agent però l'element de registre serà NO SUPORTAT.

en-us	##### If installed as package  Zabbix agent runs as a daemon process. The agent can be started by executing:      service zabbix-agent start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-agent start  Similarly, for stopping/restarting/viewing status of Zabbix agent, use the following commands:      service zabbix-agent stop     service zabbix-agent restart     service zabbix-agent status
ca	##### Si s'instal·la com a paquet  L’agent Zabbix s'executa com un procés dimoni. L'agent es pot engegar executant:      service zabbix-agent start  Això funcionarà a la majoria de sisetmes GNU/Linux. Sota altres sistemes haureu d'executar aquesta comanda:      /etc/init.d/zabbix-agent start  Igualment, per aturar/reiniciar/veure l'estat de l'agent Zabbix, empreu aquestes comandes:      service zabbix-agent stop     service zabbix-agent restart     service zabbix-agent status

en-us	##### If installed as package  Zabbix proxy runs as a daemon process. The proxy can be started by executing:      service zabbix-proxy start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-proxy start  Similarly, for stopping/restarting/viewing status of Zabbix proxy, use the following commands:      service zabbix-proxy stop     service zabbix-proxy restart     service zabbix-proxy status
ca	##### Si s'instal·la com a paquet  El proxy Zabbix s'executa com a procés dimoni. El proxy es pot engegar executant:      service zabbix-proxy start  Això funcionarà a la majoria dels sistemes GNU/Linux. Sota altres sistemes, haurem d'executar:      /etc/init.d/zabbix-proxy start  De la mateixa manera, per aturar/reiniciar/veure l'estat dell proxy Zabbix, empreu les comandes següents:      service zabbix-proxy stop     service zabbix-proxy restart     service zabbix-proxy status

en-us	##### If installed as package  Zabbix server runs as a daemon process. The server can be started by executing:      service zabbix-server start  This will work on most of GNU/Linux systems. On other systems you may need to run:      /etc/init.d/zabbix-server start  Similarly, for stopping/restarting/viewing status, use the following commands:      service zabbix-server stop     service zabbix-server restart     service zabbix-server status
ca	##### Si s'instal·la com a paquet  El servidor funciona com un procés dimoni. Pot engegar-se executant:      service zabbix-server start  això funcionarà a la majoria dels sistemes GNU/Linux. Sota altre sistemes, haureu de poder executar:      /etc/init.d/zabbix-server start  De la mateixa manera, per aturar/reiniciar/consultar l'estat, empreu les comandes següents:      service zabbix-server stop     service zabbix-server restart     service zabbix-server status

en-us	If item or discovery rule is of type "Dependent item", then top level master item must be of type:  -   Zabbix agent -   SNMPv1/v2/v3 agent -   Simple check -   Internal check -   External check -   Database monitor -   HTTP agent -   IPMI agent -   SSH agent -   TELNET agent -   Calculated check -   JMX agent
ca	Si l'element o la regla de descoberta és del tipus "Element dependent", llavors el nivell més alt de l'element mestre ha de ser del tipus:  - Agent Zabbix - Agent SNMPv1/v2/v3 - Comprovació simple - Comprovació interna - Comprovació externa - Monitor de base de dades - Agent HTTP - Agent IPMI - Agent SSH - Agent TELNET - Verificació calculada - Agent JMX

en-us	**If the webhook test fails:**  -   *"Media type test failed."* message is displayed, followed by     additional failure details.
ca	** Si el test de webhook falla: **  - El missatge *"Ha fallat el test de tipus de suport."* es mostra, seguit de detalls suplementaris de l'error.

en-us	**If the webhook test is successful:**  -   *"Media type test successful."* message is displayed. -   Server response appears in the gray *Response* field. -   Response type (JSON or String) is specified below the *Response*     field.
ca	** Si el test de webhook ha funcionat: **  - Apareix el missatge *"La prova de tipus de suport ha funcionat."* - La resposta del servidor apareix al camp gris *Resposta* - El tipus de resposta (JSON o String) s'especifica al camp *Resposta*

en-us	 If Zabbix proxy is started for the first time and the SQLite database file is missing, proxy creates it automatically.  **Note** that if Zabbix proxy uses SQLite3 and on startup detects that existing database file version is older than required, it will **delete the database file automatically** and create a new one. Therefore, history data stored in the SQLite database file will be lost. If Zabbix proxy's version is older than the database file version, Zabbix will log an error and exit.  Depending on the database size, the database upgrade to version 7.0 may take a long time.
ca	 Si el proxy Zabbix s'inicia per primer cop i manca el fitxer de base de dades SQLite, el proxy el crea automàticament. **Tingueu en compte** que si el proxy Zabbix empra SQLite3 i a l'inici detecta que la versió del fitxer de base de dades existent és més antiga que la necessària, s'**esborrarà el fitxer de base de dades automàticament** i en crearà un de nou. Per tant, les dades de l'historial emmagatzemades al fitxer de base de dades SQLite es perdran. Si la versió del proxy de Zabbix és més antiga que la versió del fitxer de la base de dades, Zabbix registrarà un error i sortirà.  Depenent de la mida de la base de dades, l'actualització de la base de dades a la versió 7.0 pot trigar molt de temps.

en-us	# image.create
ca	# image.create

en-us	# image.delete
ca	# image.delete

en-us	# image.get
ca	# image.get

en-us	# Image object  The following objects are directly related to the `image` API.
ca	# Objecte imatge  Els següents objectes tenen relació directa amb l'API `image`.

en-us	#### - Images  The Images section displays all the images available in Zabbix. Images are stored in the database.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}  The *Type* dropdown allows you to switch between icon and background images:  -   Icons are used to display [network     map](/manual/config/visualization/maps/map) elements -   Backgrounds are used as background images of network maps  **Adding image**  You can add your own image by clicking on the *Create icon* or *Create background* button in the top right corner.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)  Image attributes:  |Parameter|Description| |--|--------| |*Name*|Unique name of an image.| |*Upload*|Select the file (PNG, JPEG, GIF) from a local system to be uploaded to Zabbix.<br>*Note* that it may be possible to upload other formats that will be converted to PNG during upload. GD library is used for image processing, therefore formats that are supported depend on the library version used (2.0.28 or higher is required by Zabbix).|  ::: noteclassic Maximum size of the upload file is limited by the value of ZBX\_MAX\_IMAGE\_SIZE that is 1024x1024 bytes or 1 MB.\ \ The upload of an image may fail if the image size is close to 1 MB and the `max_allowed_packet` MySQL configuration parameter is at a default of 1MB. In this case, increase the [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet) parameter. :::
ca	#### - Imatges  La secció Imatges mostra totes les imatges disponibles a Zabbix. Les imatges s'emmagatzemen a la base de dades.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_images.png){width="600"}  La llista desplegable *Tipus* us permet canviar entre icones i imatges de fons:  - Les icones s'empren per mostrar elements de [mapes de xarxa](/manual/config/visualization/maps/map) - Els fons s'empren com a imatges de fons de les targetes de xarxa  **Afegir una imatge**  Podeu afegir la vostra pròpia imatge fent clic al botó *Crear una icona* o *Crear fons* a l'extrem superior dret.  ![](../../../../../assets/en/manual/web_interface/frontend_sections/administration/general_img_upload.png)  Atributs de la imatge:  |Paràmetre|Descripció| |--|---------| |*Nom*|Nom únic d'una imatge.| |*Càrrega*|Seleccioneu el fitxer (PNG, JPEG, GIF) d'un sistema local per carregar-lo a Zabbix.<br>*Tingueu en compte* que és possible que es puguin penjar altres formats que es convertiran a PNG en baixar. La biblioteca GD s'empra per al processament d'imatges, de manera que els formats admesos depenen de la versió de la biblioteca emprada (Zabbix requereix 2.0.28 o superior).|  :::noteclassic La mida màxima del fitxer de càrrega és limitada pel valor de ZBX\_MAX\_IMAGE\_SIZE, que és de 1024 x 1024 octets o 1 Mo.\ \ La càrrega d'una imatge pot fallar si la mida de la imatge és propera a 1 Mo i el paràmetre de configuració de MySQL `max_allowed_packet` és d'1Mo per defecte. En aquest cas, augmenteu el paràmetre [max\_allowed\_packet](http://dev.mysql.com/doc/refman/5.5/en/server-system-variables.html#sysvar_max_allowed_packet). :::

en-us	### Image  The image object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |imageid|ID|ID of the image.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *read-only*<br>- *required* for update operations| |name|string|Name of the image.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations| |imagetype|integer|Type of image.<br><br>Possible values:<br>1 - *(default)* icon;<br>2 - background image.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *required* for create operations| |image|string|Base64 encoded image.<br>The maximum size of the encoded image is 1 MB. Maximum size can be adjusted by changing `ZBX_MAX_IMAGE_SIZE` constant value.<br>Supported image formats: PNG, JPEG, GIF.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
ca	### Imatge  L'objecte imatge té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |imageid|ID|ID de l'imatge.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *només lectura*<br>- *obligatori* per operacions d'actualització| |name|string|Nom de l'imatge.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació| |imagetype|integer|Tipus d'imatge.<br><br>Valors admesos:<br>1 - *(per defecte)* icona;<br>2 - imatge de fons.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *constant*<br>- *obligatori* per operacions de creació| |image|string|Image codificada en Base64.<br>La mida màxima de les imatges codificades és d'1Mo. La mida màxima es pot ajustar canviant el valor de la constant `ZBX_MAX_IMAGE_SIZE`.<br>Formats d'imatge admesos: PNG, JPEG, GIF.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|

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

en-us	# image.update
ca	# image.update

en-us	 ### Implementation details  The high availability (HA) cluster is an opt-in solution and it is supported for Zabbix server. The native HA solution is designed to be simple in use, it will work across sites and does not have specific requirements for the databases that Zabbix recognizes. Users are free to use the native Zabbix HA solution, or a third-party HA solution, depending on what best suits the high availability requirements in their environment.  The solution consists of multiple zabbix\_server instances or nodes. Every node:  -   is configured separately -   uses the same database -   may have several modes: active, standby, unavailable, stopped  Only one node can be active (working) at a time. A standby node runs only one  process - the HA manager. A standby node does no data collection,  processing or other regular server activities; they do not listen  on ports; they have minimum database connections.  Both active and standby nodes update their last access time every 5 seconds. Each standby node monitors the last access time of the active node. If the last access time of the active node is over 'failover delay' seconds, the standby node switches itself to be the active node and assigns 'unavailable' status to the previously active node.  The active node monitors its own database connectivity - if it is lost for more than `failover delay-5` seconds, it must stop all processing and switch to standby mode. The active node also monitors the status of the standby nodes - if the last access time of a standby node is over 'failover delay' seconds, the standby node is assigned the 'unavailable' status.  The nodes are designed to be compatible across minor Zabbix versions.
ca	### Detalls de la implementació  El clúster d'alta disponibilitat (HA) és una solució activada i és compatible amb el servidor Zabbix. La solució nadiua HA és dissenyada per ser senzilla d'emprar, funcionarà en tots els llocs i no té requisits específics per a les bases de dades reconegudes per Zabbix. Els usuaris poden emprar la solució nadiua de Zabbix HA o una solució de tercers, la que s'adapti millor als requisits d'alta disponibilitat del seu entorn.  La solució consta de múltiples instàncies o nodes zabbix\_server. Cada node: - es configura per separat - empra la mateixa base de dades - pot tindre diversos modes: actiu, en espera, no disponible, aturat  Només un node pot ésser actiu alhora. Un node d'espera només executa un procés: el gestor d'HA. Un node en espera no fa la recollida de dades, el processament ni altres activitats normals del servidor, ni escolta els ports; té connexions de base de dades mínimes.  Els nodes actius i en espera actualitzen el seu darrer temps d'accés cada 5 segons. Cada node d'espera monitora el darrer moment d'accés del node actiu. Si el darrer moment d'accés del node actiu és superior als segons de "temps d'espera de commutació per error", el node en espera es converteix en el node actiu i assigna l'estat "no disponible" al node anteriorment actiu.  El node actiu controla la seva pròpia connectivitat a la base de dades: si es perd durant més de `delay de failover-5` segons, hauria d'aturar tot el processament i passar al mode d'espera. El node actiu també monitora l'estat dels nodes en espera: si el darrer temps d'accés d'un node en espera supera els segons de "temps d'espera per a errors", al node en espera se li assigna l'estat "no disponible".  Els nodes són dissenyats per ésser compatibles amb versions menors de Zabbix.

en-us	**Important notes**  -   Database monitoring items will become unsupported if no *odbc poller* processes are started in the server or proxy configuration.     To activate ODBC pollers, set the `StartODBCPollers` parameter in Zabbix [server](/manual/appendix/config/zabbix_server) configuration file or, for checks performed by proxy, in Zabbix [proxy](/manual/appendix/config/zabbix_proxy) configuration file. -   The *Timeout* parameter value in the [item configuration](/manual/config/items/item#configuration) form is used as the ODBC login timeout and the query execution timeout.     Note that these timeout settings might be ignored if the installed ODBC driver does not support them. -   The SQL command must return a result set like any query using the `select` statement.     The query syntax will depend on the RDBMS which will process them.     The syntax of request to a storage procedure must be started with the `call` keyword.
ca	**Notes importants**  - Els elements de monitoratge de la base de dades no seran compatibles si no s'inicia cap procés *odbc poller* a la configuració del servidor o del proxy.     Per habilitar els enquestadors ODBC, configureu el paràmetre `StartODBCPollers` al fitxer de configuració del [servidor](/manual/appendix/config/zabbix_server) Zabbix o, per a comprovacions de proxy, al [proxy](/manual/appendix/config/zabbix_proxy) Zabbix. - El valor del paràmetre *Timeout* al formulari de la [configuració de l'element](/manual/config/items/item#configuration)s'empra com a temps d'espera del login ODBC i el temps d'epera de l'execució de la consulta.  Fixeu-vos que aquesta configuració de temps d'espera s'ignorarà si el driver ODBC instal·lat no ho admet. - La comanda SQL ha de retornar un conjunt de resultats com qualsevol consulta amb `select`.  La sintaxi de les peticions dependrà de l'RDBMS, que les processarà.  La sintaxi de consulta d'un procediment d'emmagatzematge s'ha d'iniciar amb la paraula clau `call`.

en-us	#### Important notes  -   If more than one user macro with context exists, Zabbix will try to     match the simple context macros first and then context macros with     regular expressions in an undefined order.  ::: notewarning Do not create different context macros matching the same string to avoid undefined behavior. :::  -   If a macro with its context is not found on host, linked templates     or globally, then the macro without context is searched for. -   Only low-level discovery macros are supported in the context. Any     other macros are ignored and treated as plain text.  Technically, macro context is specified using rules similar to [item key](/manual/config/items/item/key) parameters, except macro context is not parsed as several parameters if there is a `,` character:  -   Macro context must be quoted with `"` if the context contains a `}`     character or starts with a `"` character. Quotes inside quoted     context must be escaped with the `\` character. -   The `\` character itself is not escaped, which means it's impossible     to have a quoted context ending with the `\` character - the macro     {$MACRO:"a:\\b\\c\\"} is invalid. -   The leading spaces in context are ignored, the trailing spaces are     not:     -   For example {$MACRO:A} is the same as {$MACRO: A}, but not         {$MACRO:A }. -   All spaces before leading quotes and after trailing quotes are     ignored, but all spaces inside quotes are not:     -   Macros {$MACRO:"A"}, {$MACRO: "A"}, {$MACRO:"A" } and {$MACRO:         "A" } are the same, but macros {$MACRO:"A"} and {$MACRO:" A "}         are not.  The following macros are all equivalent, because they have the same context: {$MACRO:A}, {$MACRO: A} and {$MACRO:"A"}. This is in contrast with item keys, where 'key\[a\]', 'key\[ a\]' and 'key\["a"\]' are the same semantically, but different for uniqueness purposes.
ca	#### Notes importants  - Si hi ha diverses macros d'usuari amb context, Zabbix mirarà de fer coincidir macros de context simples primer, després macros de context amb expressions regulars en ordre no definit.  ::: notewarning No creeu macros de context diferents que coincideixin amb la mateixa cadena per evitar un comportament no definit. :::  - Si una macro amb el seu context no es troba a l'equip, en models enllaçats o globalment, es cerca la macro sense context. - Només s'admeten macros de descoberta de baix nivell en context. La resta de macros s'ignoren i es tracten com a text sense format.  Tècnicament, el context de la macro s'especifica mitjançant regles similars als paràmetres [clau d'element](/manual/config/items/item/key), excepte que el context de la macro no s'analitzi com a paràmetres múltiples per haver-hi un caràcter `,`:  - El context de la macro s'ha de citar amb `"` si el context conté un caràcter `}` o comença amb un caràcter `"`. Les cometes dins del context citat s'han d'escapar amb el caràcter `\`. - El caràcter `\` en si no s'escapa, la qual cosa significa que és impossible tindre un context entre cometes que acabi amb el caràcter `\` - la macro {$MACRO:"a:\\ b\\c\\"} és invàlid. - Els espais inicials en el context s'ignoren, els espais finals no són:      - Per exemple {\$MACRO:A} és idèntic a {\$MACRO:A}, però no a {$MACRO:A }. - Tots els espais abans de les cometes inicials i després de les cometes finals s'ignoren, però tots els espais dins de les cometes no ho són:      - Les macros {\$MACRO:"A"}, {\$MACRO: "A"}, {\$MACRO:"A" } i {\$MACRO: "A" } són idèntiques, però les macros {\ $MACRO:"A"} i {\$MACRO:"A"} no ho són.  Les macros següents són equivalents perquè tenen el mateix context: {\$MACRO:A}, {\$MACRO:A} i {\$MACRO:"A"}. Això contrasta amb les claus d'element, on "clau\[a\]", "clau\[a\]" i "clau\["a"\]" són semànticament iguals, però diferents per a finalitats d'unicitat.

en-us	 ### Important notes  - Make sure to back up the database before the upgrade. - If the database uses partitions, contact the DB administrator or Zabbix support team for help. - Stopping Zabbix server for the time of the upgrade is strongly recommended. However, if absolutely necessary, there is a way to perform an upgrade while the server is running (only for MySQL, MariaDB and PostgreSQL without TimescaleDB). - CSV files can be removed after a successful upgrade to primary keys and double precision data types. - Optionally, Zabbix frontend may be switched to [maintenance mode](/manual/web_interface/maintenance_mode). - Upgrade to primary keys and double precision data types should be done after upgrading Zabbix server to 6.0. - On proxy, history tables that are not used can be upgraded by executing `history_upgrade_prepare.sql`.
ca	#### Notes importants  - Assegureu-vos de fer una còpia de seguretat de la base de dades abans de l'actualització. - Si la vostra base de dades empra particions, contacteu amb l'administrador de la base de dades o l'equip de suport de Zabbix per obtindre ajut. - Es recomana aturar el servidor al moment de l'actualització. Però, si és estrictament necessari, hi ha una manera d'actualitzar mentre el servidor és en marxa (només per a MySQL, MariaDB i PostgreSQL sense TimescaleDB). - Els arxius CSV es podran esborrar després de l'actualització correcta cap a claus primàries i tipus de dades de doble precisió. - De manera opcional, la interfície de Zabbix es pot canviar cap a [mode de manteniment](/manual/web_interface/maintenance_mode) - L'actualització cap a claus primàries i tipus de dades de doble precisió s'ha de fer després de l'actualització del servidor cap a la versió 6.0. - Amb un proxy, `history_upgrade_prepare.sql` es pot executar per posar les taules d'històric (que no s'empren) en claus primàries.

en-us	##### Important notes on rebuilding indexes  MySQL automatically rebuilds indexes for the primary key during the `ALTER TABLE` operation. However, it is highly recommended to also manually rebuild indexes with the `OPTIMIZE TABLE` statement to ensure optimal database performance.  Rebuilding indexes may temporarily require as much additional disk space as the table itself uses. To obtain the current size of data and indexes, you can execute the following statements:  ```sql ANALYZE TABLE auditlog; SHOW TABLE STATUS LIKE 'auditlog'; ```  If the available disk space is a concern, follow the [Altering primary key without downtime](#altering-primary-key-without-downtime) instructions. Other options are also available:  -   Increasing the [`sort_buffer_size`](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html) MySQL parameter may help to reduce disk space usage when manually rebuilding indexes.     However, modifying this variable may impact overall memory usage of the database. -   Consider freeing up space by deleting potentially unnecessary data. -   Consider decreasing the *Data storage period* [housekeeper](/manual/web_interface/frontend_sections/administration/housekeeping#overview) parameter before executing the housekeeper.
ca	##### Notes importants sobre la reconstrucció d'índexs  MySQL reconstrueix automàticament els índexs per a la clau primària durant l'operació `ALTER TABLE`. Tanmateix, és molt recomanable també reconstruir manualment els índexs amb la instrucció `OPTIMIZE TABLE` per garantir un rendiment òptim de la base de dades.  La reconstrucció d'índexs pot requerir temporalment tant d'espai de disc addicional com la mateixa taula empra. Per obtindre la mida actual de dades i índexs, podeu executar les instruccions següents:  ```sql ANALYZE TABLE auditlog; SHOW TABLE STATUS LIKE 'auditlog'; ```  Si l'espai disponible en disc és un problema, seguiu les instruccions [Alteració de la clau primària sense temps d'inactivitat](#altering-primary-key-without-downtime). També hi ha altres opcions disponibles:  - Augmentar el paràmetre [`sort_buffer_size`](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html) MySQL pot ajudar a reduir l'ús d'espai en disc quan es reconstrueixen manualment índexs.     Tanmateix, modificar aquesta variable pot afectar l'ús general de la memòria de la base de dades. - Penseu en alliberar espai esborrant dades potencialment innecessàries. - Considereu la possibilitat de reduir el paràmetre [neteja](/manual/web_interface/frontend_sections/administration/housekeeping#overview) del *Període d'emmagatzematge de dades* abans d'executar la neteja.

en-us	##### Important notes on rebuilding indexes  Oracle automatically rebuilds indexes for the primary key during the `ALTER TABLE` operation. However, it is highly recommended to also manually rebuild indexes with the `ALTER INDEX <index> REBUILD PARALLEL` statements to ensure optimal database performance.  Rebuilding indexes may temporarily require significant disk space.  If the available disk space is a concern, follow the [Altering primary key without downtime](#altering-primary-key-without-downtime-2) instructions. Other options are also available:  -   Increasing the [`SORT_AREA_SIZE`](https://docs.oracle.com/en/database/oracle/oracle-database/19/refrn/SORT_AREA_SIZE.html) Oracle parameter may help to reduce disk space usage when manually rebuilding indexes.     However, modifying this variable will impact the overall memory usage of the database. -   You can set parallel degree using the PARALLEL clause, for example: `ALTER INDEX auditlog_1 REBUILD PARALLEL 4` -   Consider freeing up space by deleting potentially unnecessary data. -   Consider decreasing the *Data storage period* [housekeeper](/manual/web_interface/frontend_sections/administration/housekeeping#overview) parameter before executing the housekeeper.
ca	##### Notes importants sobre la reconstrucció d'índexs  Oracle reconstrueix automàticament els índexs per a la clau primària durant l'operació `ALTER TABLE`. Tanmateix, és molt recomanable també reconstruir manualment els índexs amb les instruccions `ALTER INDEX <index> REBUILD PARALLEL` per garantir un rendiment òptim de la base de dades.  La reconstrucció dels índexs pot requerir temporalment un espai de disc important.  Si l'espai disponible en disc és un problema, seguiu les instruccions [Alteració de la clau primària sense temps d'inactivitat](#altering-primary-key-without-downtime-2). També hi ha altres opcions disponibles:  - Augmentar el paràmetre [`SORT_AREA_SIZE`](https://docs.oracle.com/en/database/oracle/oracle-database/19/refrn/SORT_AREA_SIZE.html) Oracle pot ajudar a reduir l'ús d'espai en disc quan es reconstrueixen manualment índexs .     Tanmateix, modificar aquesta variable afectarà l'ús general de la memòria de la base de dades. - Podeu establir el grau paral·lel mitjançant la clàusula PARALLEL, per exemple: `ALTER INDEX auditlog_1 REBUILD PARALLEL 4` - Penseu en alliberar espai esborrant dades potencialment innecessàries. - Considereu la possibilitat de reduir el paràmetre [domèstic](/manual/web_interface/frontend_sections/administration/housekeeping#overview) del *Període d'emmagatzematge de dades* abans d'executar la neteja.

en-us	##### Important notes on rebuilding indexes  PostgreSQL automatically rebuilds indexes for the primary key during the `ALTER TABLE` operation. However, it is highly recommended to also manually rebuild indexes with the `REINDEX TABLE CONCURRENTLY` statement to ensure optimal database performance.  Rebuilding indexes may temporarily require up to three times of disk space currently used by indexes. To obtain the current size of indexes, you can execute the following query:  ```sql SELECT pg_size_pretty(pg_indexes_size('auditlog')); ```  If the available disk space is a concern, follow the [Altering primary key without downtime](#altering-primary-key-without-downtime-1) instructions. Other options are also available:  -   Increasing the [`maintenance_work_mem`](https://www.postgresql.org/docs/current/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM) PostgreSQL parameter may help to reduce disk space usage when manually rebuilding indexes.     However, modifying this variable may impact overall memory usage of the database. -   If you have another disk or tablespace with more available space, you might consider changing the temporary storage location for the index rebuild.     You can set the [`temp_tablespaces`](https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-TEMP-TABLESPACES) PostgreSQL parameter to specify a different tablespace for temporary objects. -   Consider freeing up space by deleting potentially unnecessary data. -   Consider decreasing the *Data storage period* [housekeeper](/manual/web_interface/frontend_sections/administration/housekeeping#overview) parameter before executing the housekeeper.
ca	##### Notes importants sobre la reconstrucció d'índexs  PostgreSQL reconstrueix automàticament els índexs per a la clau primària durant l'operació `ALTER TABLE`. Tanmateix, és molt recomanable també reconstruir manualment els índexs amb la sentència `REINDEX TABLE CONCURRENTLY` per garantir un rendiment òptim de la base de dades.  La reconstrucció d'índexs pot requerir temporalment fins a tres vegades l'espai de disc emprat actualment pels índexs. Per obtenir la mida actual dels índexs, podeu executar la consulta següent:  ```sql SELECT pg_size_pretty(pg_indexes_size('auditlog')); ```  Si l'espai disponible en disc és un problema, seguiu les instruccions [Alteració de la clau primària sense temps d'inactivitat](#altering-primary-key-without-downtime-1). També hi ha altres opcions disponibles:  - Augmentar el paràmetre PostgreSQL [`maintenance_work_mem`](https://www.postgresql.org/docs/current/runtime-config-resource.html#GUC-MAINTENANCE-WORK-MEM) pot ajudar a reduir l'ús d'espai en disc quan es fa manualment reconstruint índexs.     Tanmateix, modificar aquesta variable pot afectar l'ús general de la memòria de la base de dades. - Si teniu un altre disc o espai de taula amb més espai disponible, podeu considerar canviar la ubicació d'emmagatzematge temporal per a la reconstrucció de l'índex.     Podeu establir el paràmetre PostgreSQL [`temp_tablespaces`](https://www.postgresql.org/docs/current/runtime-config-client.html#GUC-TEMP-TABLESPACES) per especificar un espai de taula diferent per als objectes temporals. - Penseu en alliberar espai esborrant dades potencialment innecessàries. - Considereu la possibilitat de reduir el paràmetre [neteja](/manual/web_interface/frontend_sections/administration/housekeeping#overview) del *Període d'emmagatzematge de dades* abans d'executar la neteja.

en-us	#### Important notes  -   The server and agent keep the trace of a monitored log's size and     last modification time (for logrt) in two counters. Additionally:     -   The agent also internally uses inode numbers (on         UNIX/GNU/Linux), file indexes (on Microsoft Windows) and MD5         sums of the first 512 log file bytes for improving decisions         when logfiles get truncated and rotated.     -   On UNIX/GNU/Linux systems it is assumed that the file systems         where log files are stored report inode numbers, which can be         used to track files.     -   On Microsoft Windows Zabbix agent determines the file system         type the log files reside on and uses:         -   On NTFS file systems 64-bit file indexes.         -   On ReFS file systems (only from Microsoft Windows             Server 2012) 128-bit file IDs.         -   On file systems where file indexes change (e.g. FAT32,             exFAT) a fall-back algorithm is used to take a sensible             approach in uncertain conditions when log file rotation             results in multiple log files with the same last             modification time.     -   The inode numbers, file indexes and MD5 sums are internally         collected by Zabbix agent. They are not transmitted to Zabbix         server and are lost when Zabbix agent is stopped.     -   Do not modify the last modification time of log files with         'touch' utility, do not copy a log file with later restoration         of the original name (this will change the file inode number).         In both cases the file will be counted as different and will be         analyzed from the start, which may result in duplicated alerts.     -   If there are several matching log files for `logrt[]` item and         Zabbix agent is following the most recent of them and this most         recent log file is deleted, a warning message         `"there are no files matching "<regexp mask>" in "<directory>"`         is logged. Zabbix agent ignores log files with modification time         less than the most recent modification time seen by the agent         for the `logrt[]` item being checked. -   The agent starts reading the log file from the point it stopped the     previous time. -   The number of bytes already analyzed (the size counter) and last     modification time (the time counter) are stored in the Zabbix     database and are sent to the agent to make sure the agent starts     reading the log file from this point in cases when the agent is just     started or has received items which were previously disabled or not     supported. However, if the agent has received a non-zero size     counter from server, but the logrt\[\] or logrt.count\[\] item is     unable to find matching files, the size counter is     reset to 0 to analyze from the start if the files appear later. -   Whenever the log file becomes smaller than the log size counter     known by the agent, the counter is reset to zero and the agent     starts reading the log file from the beginning taking the time     counter into account. -   If there are several matching files with the same last modification     time in the directory, then the agent tries to correctly analyze all     log files with the same modification time and avoid skipping data or     analyzing the same data twice, although it cannot be guaranteed in     all situations. The agent does not assume any particular log file     rotation scheme nor determines one. When presented multiple log     files with the same last modification time, the agent will process     them in a lexicographically descending order. Thus, for some     rotation schemes the log files will be analyzed and reported in     their original order. For other rotation schemes the original log     file order will not be honored, which can lead to reporting matched     log file records in altered order (the problem does not happen if     log files have different last modification times). -   Zabbix agent processes new records of a log file once per *Update     interval* seconds. -   Zabbix agent does not send more than **maxlines** of a log file per     second. The limit prevents overloading of network and CPU resources     and overrides the default value provided by **MaxLinesPerSecond**     parameter in the [agent configuration     file](/manual/appendix/config/zabbix_agentd). -   To find the required string Zabbix will process 10 times more new     lines than set in MaxLinesPerSecond. Thus, for example, if a `log[]`     or `logrt[]` item has *Update interval* of 1 second, by default the     agent will analyze no more than 200 log file records and will send     no more than 20 matching records to Zabbix server in one check. By     increasing **MaxLinesPerSecond** in the agent configuration file or     setting **maxlines** parameter in the item key, the limit can be     increased up to 10000 analyzed log file records and 1000 matching     records sent to Zabbix server in one check. If the *Update interval*     is set to 2 seconds the limits for one check would be set 2 times     higher than with *Update interval* of 1 second. -   Additionally, log and log.count values are always limited to 50% of     the agent send buffer size, even if there are no non-log values in     it. So for the **maxlines** values to be sent in one connection (and     not in several connections), the agent     [BufferSize](/manual/appendix/config/zabbix_agentd) parameter must     be at least maxlines x 2. Zabbix agent can upload data during log gathering and thus free the buffer, whereas Zabbix agent 2 will stop log gathering until the data is uploaded and the buffer is freed, which is performed asynchronously. -   In the absence of log items all agent buffer size is used for     non-log values. When log values come in they replace the older     non-log values as needed, up to the designated 50%. -   For log file records longer than 256kB, only the first 256kB are     matched against the regular expression and the rest of the record is     ignored. However, if Zabbix agent is stopped while it is dealing     with a long record the agent internal state is lost and the long     record may be analyzed again and differently after the agent is     started again. -   Special note for "\\" path separators: if file\_format is     "file\\.log", then there should not be a "file" directory, since it     is not possible to unambiguously define whether "." is escaped or is     the first symbol of the file name. -   Regular expressions for `logrt` are supported in filename only,     directory regular expression matching is not supported. -   On UNIX platforms a `logrt[]` item becomes NOTSUPPORTED if a     directory where the log files are expected to be found does not     exist. -   On Microsoft Windows, if a directory does not exist the item will     not become NOTSUPPORTED (for example, if directory is misspelled in     item key). -   An absence of log files for `logrt[]` item does not make it     NOTSUPPORTED. Errors of reading log files for `logrt[]` item are     logged as warnings into Zabbix agent log file but do not make the     item NOTSUPPORTED. -   Zabbix agent log file can be helpful to find out why a `log[]` or     `logrt[]` item became NOTSUPPORTED. Zabbix can monitor its agent log     file, except when at DebugLevel=4 or DebugLevel=5. -   Searching for a question mark using a regular expression, e.g. `\?` may result in false positives if the text file contains NUL symbols, as those are replaced with "?" by Zabbix to continue processing the line until the newline character.
ca	#### Notes importants  - El servidor i l'agent fan un seguiment de la mida d'un registre monitorat i modificat durant la darrera hora (per al logrt) a dos comptadors. Addicionalment: - L'agent també empra internament nombres d'inode (a UNIX/GNU/Linux), índexs de fitxers (a Microsoft Windows) i sumes MD5 dels primers 512 octets de fitxers de registre per millorar les decisions quan els fitxers de registre es trunquen i giren. - Als sistemes UNIX/GNU/Linux, se suposa que els sistemes de fitxers on s'emmagatzemen els fitxers de registre retornen nombres d'inode, que es poden emprar per fer un seguiment dels fitxers. - A Microsoft Windows, l'agent Zabbix determina el tipus de sistema de fitxers on resideixen els fitxers de registre i empra: - En sistemes de fitxers NTFS indexa fitxers de 64 bits. - En sistemes de fitxers ReFS (només des de Microsft Windows Server 2012) ID de fitxer de 128 bits. - En sistemes de fitxers on els índexs de fitxers canvien (per exemple, FAT32, exFAT) s'empra un algorisme de reserva per adoptar un enfocament raonable en condicions incertes quan la rotació del fitxer de registre dóna lloc a diversos fitxers de registre amb el mateix temps de modificació. - Els nombres d'inode, els índexs de fitxers i les sumes MD5 es recullen internament per l'agent Zabbix. No es transmeten al servidor Zabbix i es perden quan s'atura l'agent Zabbix. - No modifiqueu l'hora de la darrera modificació dels fitxers de registre amb la utilitat `touch`, no recupereu un fitxer de registre conservant el seu nom original (això canviarà el nombre d'inode del fitxer). En qualsevol dels casos, el fitxer es considerarà diferent i s'escanejarà des del principi, la qual cosa pot generar alertes duplicades. - Si hi ha diversos fitxers de registre coincidents per a l'element `logrt[]` i l'agent de Zabbix fa un seguiment del més recent d'ells i s'esborra aquest fitxer de registre més recent, s'envia al registre un missatge d'avís `"no hi ha cap fitxer que coincideixi"<regexp màscara>" a "<directori>"`. L'agent Zabbix ignora els fitxers de registre el temps de modificació dels quals és inferior al temps de modificació més recent vist per l'agent per a l'element `logrt[]` que s'està comprovant. - L'agent comença a llegir el fitxer de registre des de quan es va aturar la vegada anterior. - El nombre d'octets ja escanejats (el comptador de mida) i la darrera modificació (el comptador de temps) s'emmagatzemen a la base de dades de Zabbix i s'envien a l'agent per assegurar que l'agent comença a llegir el fitxer de registre des d'aquesta ubicació en cas que l'agent acabi d'iniciar-se o hagi rebut elements desactivats o no compatibles. Tanmateix, si l'agent va rebre un comptador de mida diferent de zero del servidor, però l'element logrt\[\] o logrt.count\[\] no s'ha trobat i no ha trobat cap fitxer coincident, el comptador de mida es restablirà a 0 si els fitxers apareixen més tard. - Cada cop que el fitxer de registre sigui més petit que el comptador de mida del fitxer de registre conegut per l'agent, el comptador es reinicia i l'agent comença a llegir el fitxer de registre des del principi tinguent en compte el comptador de temps. - Si al directori hi ha diversos fitxers corresponents amb el mateix temps de modificació, l'agent analitza tots els fitxers de registre amb el mateix temps de modificació i evita saltar dades o analitzar les mateixes dades dues vegades, encara que això no es pot garantir. L'agent no assumeix cap esquema de rotació de fitxers de registre particular i no en determina cap. Quan es presenten diversos fitxers de registre amb la mateixa hora de darrera modificació, l'agent els processa en ordre lexicogràfic descendent. Així, per a determinats esquemes de rotació, els fitxers de registre s'analitzaran i s'informaran en el seu ordre original. Per a altres esquemes de rotació, no es respectarà l'ordre dels fitxers de registre originals, fet que pot provocar que es generin informes als fitxers de registre corresponents (el problema no es produeix si els fitxers de registre tenen diferents temps de modificació). - L'agent Zabbix processa nous registres de fitxers de registre una vegada per *interval d'actualització* segons. - L'agent Zabbix no envia més d'un fitxer de registre **maxlines** per segon. El límit evita la sobrecàrrega de recursos de la xarxa i de la CPU i anul·la el valor predeterminat proporcionat pel paràmetre **MaxLinesPerSecond** al [fitxer de configuració de l'agent](/manual/appendix/config/zabbix_agentd). - Per trobar la cadena necessària, Zabbix processarà 10 vegades més noves línies que a MaxLinesPerSecond. Per exemple, si un element `log[]` o `logrt[]` té un *interval d'actualització* d'1 segon, l'agent no analitzarà, de manera predeterminada, més de 200 registres de fitxers de registre i no enviarà més de 20 registres coincidents al servidor Zabbix en una sola comprovació. Augmentant **MaxLinesPerSecond** al fitxer de configuració de l'agent o establint el paràmetre **maxlines** a la clau d'element, el límit es pot augmentar fins a 10.000 registres de fitxer de registre escanejats i 1.000 registres coincidents enviats al servidor Zabbix en una sola comprovació. Si l'*interval d'actualització* s'estableix a 2 segons, els límits d'una comprovació s'establiran 2 vegades més que amb l'*interval d'actualització* d'1 segon. - A més, els valors de log i log.count sempre són limitats al 50% de la mida del buffer d'enviament de l'agent, fins i tot si no hi ha valors que no siguin de registre. Per tant, perquè els valors de **maxlines** s'enviïn en una connexió (i no en diverses connexions), el paràmetre [BufferSize](/manual/appendix/config/zabbix_agentd) de l'agent ha d'ésser com a mínim maxlines x 2. L'agent Zabbix pot carregar dades durant la recollida de registres i, per tant, alliberar el buffer, mentre que l'agent Zabbix 2 aturarà el recull de registres fins que es carreguin les dades i s'alliberi el buffer, que es fa de manera asíncrona. - Si no hi ha elements de registre, s'empra tota la mida del buffer de l'agent per als valors que no són de registre. Quan arriben els valors dels fitxers de registre, sobreescriuen els valors antics que no són de registre, segons sigui necessari, fins a un 50%. - Per als registres de fitxers de registre més grans de 256Ko, només els primers 256Ko coincideixen amb l'expressió regular i la resta del registre s'ignora. Tanmateix, si l'agent Zabbix s'atura mentre processa un registre llarg, l'estat intern de l'agent es perd i el registre llarg es pot analitzar de nou i de manera diferent després de reiniciar l'agent. - Nota especial per als separadors de camins "\\": si filer\_format és "file\\.log", no hi ha d'haver un directori "file" perquè és impossible definir sense ambigüitats si "." s'escapa o és el primer símbol del nom del fitxer. - Les expressions regulars per a `logrt` només s'admeten al nom de fitxer, la concordança d'expressions regulars del directori no és compatible. - A les plataformes UNIX, `logrt[]` passa a NO ADMÈS si no existeix un directori on s'hi han de trobar els fitxers de registre. - A Microsoft Windows, si un directori no existeix, l'element no passarà a NO ADMÈS (per exemple, si el directori s'ha escrit malament a la clau de l'element). - L'absència de fitxers de registre per a `logrt[]` no fa que NO S'ADMETI. Els errors de lectura dels fitxers de registre per a `logrt[]` es registren com a avisos al fitxer de registre de l'agent Zabbix, però no mostren l'element NO ADMÈS. - El fitxer de registre de l'agent Zabbix pot ésser útil per sapiguer per què un element `log[]` o `logrt[]` no s'admet. Zabbix pot monitorar el fitxer de registre de l'agent excepte a DebugLevel=4 i DebugLevel=5. - Buscar un signe d'interrogació mitjançant una expressió regular, com ara `\?` pot donar lloc a falsos positius si el fitxer de text conté símbols NUL, ja que es substitueixen per "?" per Zabbix per continuar processant la línia fins al caràcter de nova línia.

en-us	#### Important rules  -   A whitelist without a deny rule is only allowed for system.run\[\*\]     items. For all other items, AllowKey parameters are not allowed     without a DenyKey parameter; in this case Zabbix agent **will not     start** with only AllowKey parameters. -   The order matters. The specified parameters are checked one by one     according to their appearance order in the configuration file:     -   As soon as an item key matches an allow/deny rule, the item is         either allowed or denied; and rule checking stops. So if an item         matches both an allow rule and a deny rule, the result will         depend on which rule comes first.     -   The order affects also EnableRemoteCommands parameter (if used). -   Unlimited numbers of AllowKey/DenyKey parameters is supported. -   AllowKey, DenyKey rules do not affect HostnameItem,     HostMetadataItem, HostInterfaceItem configuration parameters. -   Key pattern is a wildcard expression where the wildcard (\*)     character matches any number of any characters in certain position.     It might be used in both the key name and parameters. -   If a specific item key is disallowed in the agent configuration, the     item will be reported as unsupported (no hint is given as to the     reason); -   Zabbix agent with --print (-p) command line option will not show     keys that are not allowed by configuration; -   Zabbix agent with --test (-t) command line option will return     "Unsupported item key." status for keys that are not allowed by     configuration; -   Denied remote commands will not be logged in the agent log (if     LogRemoteCommands=1).
ca	#### Regles importants  - La llista blanca sense una regla de denegació només es permet per als elements system.run\[\*\]. Per a la resta d'elements, els paràmetres AllowKey no es permeten sense un paràmetre DenyKey; en aquest cas, l'agent Zabbix **no començarà** només amb paràmetres AllowKey. - L'ordre compta. Els paràmetres especificats es comproven un a un segons el seu ordre d'aparició al fitxer de configuració:      - Tan aviat com una clau d'element coincideix amb una regla d'autorització/denegació, l'element es permet o es denega; i la comprovació de regles s'atura. Per tant, si un element coincideix amb una regla d'autorització i una regla de denegació, el resultat dependrà de quina regla sigui primera.      - L'ordre també afecta la configuració EnableRemoteCommands (si s'empra). - S'admeten paràmetres AllowKey/DenyKey il·limitats. - Les regles AllowKey i DenyKey no afecten els paràmetres de configuració de HostnameItem, HostMetadataItem i HostInterfaceItem. - El patró de clau és una expressió de comodí on el caràcter comodí (\*) coincideix amb qualsevol nombre de caràcters en una posició determinada. Es pot emprar tant en el nom de la clau com en els paràmetres. - Si no es permet una clau d'element específica a la configuració de l'agent, l'element es marcarà com a no compatible (no s'indica per què); - L'agent Zabbix amb l'opció de línia d'ordres --print (-p) no mostrarà les claus que la configuració no permet; - L'agent Zabbix amb l'opció de línia d'ordres --test (-t) retornarà l'estat "La clau d'element no és compatible". per a claus no autoritzades per la configuració; - Les ordres remotes denegades no es registraran al registre de l'agent (si LogRemoteCommands=1).

en-us	#### Importing a template  Import the template configuration contained in the XML string. If any items or triggers in the XML string are missing, they will be deleted from the database, and everything else will be left unchanged.  [Request](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "configuration.import",     "params": {         "format": "xml",         "rules": {             "templates": {                 "createMissing": true,                 "updateExisting": true             },             "items": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "triggers": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "valueMaps": {                 "createMissing": true,                 "updateExisting": false             }         },         "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter>&lt;dt&gt;Server uptime: (.*)&lt;\/dt&gt;</parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)&gt;2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n"     },     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```
ca	#### Importar una plantilla  Importa la configuració d'un model contingut a la cadena XML. Si manquen elements o triggers de la cadena XML, s'esborraran de la base de dades i la resta es mantindrà sense canvis.  [Consulta](/manual/api#performing-requests):  ```json {     "jsonrpc": "2.0",     "method": "configuration.import",     "params": {         "format": "xml",         "rules": {             "templates": {                 "createMissing": true,                 "updateExisting": true             },             "items": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "triggers": {                 "createMissing": true,                 "updateExisting": true,                 "deleteMissing": true             },             "valueMaps": {                 "createMissing": true,                 "updateExisting": false             }         },         "source": "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<zabbix_export><version>7.0</version><template_groups><template_group><uuid>7df96b18c230490a9a0a9e2307226338</uuid><name>Templates</name></template_group></template_groups><templates><template><uuid>5aef0444a82a4d8cb7a95dc4c0c85330</uuid><template>New template</template><name>New template</name><groups><group><name>Templates</name></group></groups><items><item><uuid>7f1e6f1e48aa4a128e5b6a958a5d11c3</uuid><name>Zabbix agent ping</name><key>agent.ping</key></item><item><uuid>77ba228662be4570830aa3c503fcdc03</uuid><name>Apache server uptime</name><type>DEPENDENT</type><key>apache.server.uptime</key><delay>0</delay><trends>0</trends><value_type>TEXT</value_type><preprocessing><step><type>REGEX</type><parameters><parameter><dt>Server uptime: (.*)<\/dt></parameter><parameter>\\1</parameter></parameters></step></preprocessing><master_item><key>web.page.get[127.0.0.1/server-status]</key></master_item></item><item><uuid>6805d4c39a624a8bab2cc8ab63df1ab3</uuid><name>CPU load</name><key>system.cpu.load</key><value_type>FLOAT</value_type><triggers><trigger><uuid>ab4c2526c2bc42e48a633082255ebcb3</uuid><expression>avg(/New template/system.cpu.load,3m)>2</expression><name>CPU load too high on 'New host' for 3 minutes</name><priority>WARNING</priority></trigger></triggers></item><item><uuid>590efe5731254f089265c76ff9320726</uuid><name>Apache server status</name><key>web.page.get[127.0.0.1/server-status]</key><trends>0</trends><value_type>TEXT</value_type></item></items><valuemaps><valuemap><uuid>8fd5814c45d44a00a15ac6eaae1f3946</uuid><name>Zabbix agent ping</name><mappings><mapping><value>1</value><newvalue>Available</newvalue></mapping><mapping><value>0</value><newvalue>Not available</newvalue></mapping></mappings></valuemap></valuemaps></template></templates></zabbix_export>\n"     },     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```

en-us	##### Importing data  Import initial schema:      cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix  For proxy with PostgreSQL (or SQLite):      cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db
ca	##### Importació de dades  Importeu l'esquema inicial:      cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix  Per un proxy amb PostgreSQL (o SQLite) :      cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db

en-us	##### Importing data  Import initial schema:      cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix  For proxy with PostgreSQL (or SQLite):      cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db
ca	##### Importació de dades  Importeu l'esquema inicial:      cat /usr/share/zabbix-sql-scripts/mysql/proxy.sql | mysql -uzabbix -p zabbix  Per un proxy amb PostgreSQL (o SQLite) :      cat /usr/share/zabbix-sql-scripts/postgresql/proxy.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/sqlite3/proxy.sql | sqlite3 zabbix.db

en-us	#### Importing data  Now import initial schema and data for the **server** with MySQL:      zcat /usr/share/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix  You will be prompted to enter your newly created database password.  With PostgreSQL:      zcat /usr/share/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix  With TimescaleDB, in addition to the previous command, also run:      zcat /usr/share/packages/zabbix-sql-scripts/postgresql/timescaledb/schema.sql.gz | sudo -u <username> psql zabbix  ::: notewarning TimescaleDB is supported with Zabbix server only. :::  For proxy, import initial schema:      zcat /usr/share/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix  For proxy with PostgreSQL:      zcat /usr/share/packages/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix
ca	#### Importació de dades  Ara importeu l'esquema inicial i les dades del **servidor** amb MySQL:      # zcat /usr/share/packages/zabbix-sql-scripts/mysql/create.sql.gz | mysql -uzabbix -p zabbix  Se us demanarà que introduïu el mot de pas de la base de dades que acabeu de crear.  Amb PostgreSQL:      zcat /usr/share/packages/zabbix-sql-scripts/postgresql/create.sql.gz | sudo -u zabbix psql zabbix  Amb TimescaleDB, a més de l'ordre anterior, executeu també:      zcat /usr/share/packages/zabbix-sql-scripts/postgresql/timescaledb/schema.sql.gz | sudo -u <username> psql zabbix  ::: notewarning TimescaleDB només és compatible amb el servidor Zabbix. :::  Per al proxy, importeu l'esquema inicial:      zcat /usr/share/packages/zabbix-sql-scripts/mysql/schema.sql.gz | mysql -uzabbix -p zabbix  Per al proxy amb PostgreSQL:      zcat /usr/share/packages/zabbix-sql-scripts/postgresql/schema.sql.gz | sudo -u zabbix psql zabbix

en-us	#### Importing data with Timescale DB  With TimescaleDB, in addition to the import command for PostgreSQL, also run:      cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix  ::: notewarning TimescaleDB is supported with Zabbix server only. :::
ca	#### Importació de dades amb Timescale DB  Amb TimescaleDB afegida a la comanda d'importació per a PostgreSQL, executeu també:      cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix  ::: notewarning TimescaleDB s'admet només amb el servidor Zabbix. :::

en-us	#### Importing data with Timescale DB  With TimescaleDB, in addition to the import command for PostgreSQL, also run:      cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix  ::: notewarning TimescaleDB is supported with Zabbix server only. :::
ca	#### Importació de dades amb Timescale DB  Amb TimescaleDB afegida a la comanda d'importació per a PostgreSQL, executeu també:      cat /usr/share/zabbix-sql-scripts/postgresql/timescaledb/schema.sql | sudo -u zabbix psql zabbix  ::: notewarning TimescaleDB s'admet només amb el servidor Zabbix. :::

en-us	#### Importing  To import hosts, do the following:  1. Go to *Data collection* → *Hosts*. 2. Click *Import* in the top right corner. 3. Select the import file. 4. Click *Import* in the bottom right corner of the configuration form.  ![](../../../assets/en/manual/xml_export_import/import_hosts.png){width="600"}  If you mark the *Advanced options* checkbox, a detailed list of all importable elements will be displayed - mark or unmark each import rule as required.  If you click the checkbox in the *All* row, all elements below it will be marked/unmarked.  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New elements will be created using data from the import file. Otherwise, they will not be created.| |*Delete missing*|Existing elements not present in the import file will be removed. Otherwise, they will not be removed.<br>If *Delete missing* is marked for *Template linkage*, current template linkage not present in the import file will be unlinked. Entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).|  A success or failure message of the import will be displayed in the frontend.
ca	#### Importar  Per importar equips, feu el següent:  1. Aneu a *Recull de dades* → *Equips*. 2. Feu clic a *Importar* a la dreta. 3. Trieu el fitxer d'importació. 4. Feu clic a *Importar* abaix a la cantonada dreta del formulari de configuració.  ![](../../../assets/en/manual/xml_export_import/import_hosts.png){width="600"}  Si marqueu la casella de selecció *Opcions avançades*, es mostrarà una llista detallada de tots els elements importables: marqueu o desmarqueu cada regla d'importació segons sigui necessari.  Si feu clic a la casella de selecció de la filera *Tot*, tots els elements que hi ha a sota es marquen/desmarquen.  Regles d'importació:  |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb les dades extretes del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crear nou*|La importació afegirà nous elements emprant les dades del fitxer d'importació. En cas contrari no els afegirà.| |*Esborrar el que manca*|La importació esborrarà els elements existents que no són presents al fitxer d'importació. En cas contrari, no els esborrarà.<br>Si es marca *Esborrar el que manca* per a l'enllaç de plantilles, es desenllaçarà l'enllaç de plantilles existent que no sigui present al fitxer d'importació. Les entitats (elements, triggers, gràfics, etc.) heretades de les plantilles no enllaçades no s'esborraran (tret que també s'hagi triat l'opció *Esborrar el que manca* per a cada entitat).|  Es veurà un missatge d'èxit o fallida de la importació a la interfície.

en-us	#### Importing  To import media types, do the following:  1. Go to *Alerts* → *Media types*. 2. Click *Import* in the top right corner. 3. Select the import file. 4. Mark the required options in import rules. 5. Click *Import* in the bottom right corner of the configuration form.  ![](../../../assets/en/manual/xml_export_import/import_media.png){width="600"}  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New elements will be created using data from the import file. Otherwise, they will not be created.|  A success or failure message of the import will be displayed in the frontend.
ca	#### Importació  Per importar tipus de suport, feu el següent:  1. Anar a: *Administració* → *Tipus de suport*. 2. Cliqueu *Importar* a la cantonada de dalt a la dreta. 3. Trieu el fitxer a importar. 4. Comproveu les opcions requerides a les regles d'importació. 5. Cliqueu *Importar* al botó d'abaix a la dreta del formulari de configuració.  ![](../../../assets/en/manual/xml_export_import/import_media.png){width="600"}    Regles d'importació:  |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran emprant dades del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crear nou*|Els nous elements es crearan emprant les dades del fitxer d'importació. En cas contrari, no es crearan pas.|  A la interfície veureu un missatge d'èxit o error d'importació.

en-us	#### Importing  To import network maps, do the following:  1. Go to *Monitoring* → *Maps*. 2. Click *Import* in the top right corner. 3. Select the import file. 4. Mark the required options in import rules. 5. Click *Import* in the bottom right corner of the configuration form.  ![](../../../assets/en/manual/xml_export_import/import_maps.png){width="600"}  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing maps will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New maps will be created using data from the import file. Otherwise, they will not be created.|  If you uncheck both map options and check the respective options for images, images only will be imported. Image importing is only available to *Super admin* users.  A success or failure message of the import will be displayed in the frontend.  ::: notewarning If replacing an existing image, it will affect all maps that are using this image. :::
ca	#### Importació  Per importar mapes de xarxa, feu el següent:  1. Aneu a *Monitoratge* → *mapes*. 2. Feu clic a *Importar* a la cantonada de dalt a la dreta. 3. Trieu el fitxer a importar. 4. Comproveu les opcions requerides a les regles d'importació. 5. Cliqueu *Importar* al botó de la cantonada d'abaix dreta al formulari de configuració.  ![](../../../assets/en/manual/xml_export_import/import_maps.png){width="600"}  Regles d'importació:  |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb dades del fitxer d'importació. En cas contrari,no s'actualitzaran.| |*Crear nou*|Es crearan nous mapes emprant les dades del fitxer d'importació. En cas contrari, no es crearan pas.|  Si desmarqueu les dues opcions del mapa i marqueu les opcions respectives per a les imatges, només s'importaran les imatges. La importació d'imatges només és disponible per als usuaris *superadministradors*.  A la interfície es veurà un missatge d'èxit o error d'importació.  ::: notewarning Si sobreescriu una imatge existent, afectarà totes les targes que empren aquesta imatge. :::

en-us	#### Importing  To import templates, do the following:  1. Go to *Data collection* → *Templates*. 2. Click *Import* in the top right corner. 3. Select the import file. 4. Click *Import* in the bottom right corner of the configuration form.  ![](../../../assets/en/manual/xml_export_import/import_templates.png){width="600"}  If you mark the *Advanced options* checkbox, a detailed list of all importable elements will be displayed - mark or unmark each import rule as required.  If you click the checkbox in the *All* row, all elements below it will be marked/unmarked.  Import rules:  |Rule|Description| |----|-----------| |*Update existing*|Existing elements will be updated using data from the import file. Otherwise, they will not be updated.| |*Create new*|New elements will be created using data from the import file. Otherwise, they will not be created.| |*Delete missing*|Existing elements not present in the import file will be removed. Otherwise, they will not be removed.<br>If *Delete missing* is marked for *Template linkage*, current template linkage not present in the import file will be unlinked. Entities (items, triggers, graphs, etc.) inherited from the unlinked templates will not be removed (unless the *Delete missing* option is selected for each entity as well).|  On the next screen, you will be able to view the content of a template being imported. If this is a new template, all elements will be listed in green. If updating an existing template, new template elements will be highlighted in green; removed template elements will be highlighted in red; elements that have not changed will be listed on a gray background.  ![](../../../assets/en/manual/xml_export_import/import_templates_details.png){width="600"}  The menu on the left can be used to navigate through the list of changes. The *Updated* section highlights all changes made to existing template elements. The *Added* section lists new template elements. The elements in each section are grouped by element type; click the gray arrow to expand or collapse the group of elements.  ![](../../../assets/en/manual/xml_export_import/import_templates_menu.png)  Review template changes and then click *Import* to perform the template import. A success or failure message of the import will be displayed in the frontend.
ca	#### Importació  Per importar plantilles, feu el següent:  1. Aneu a: *Recull de dades* → *Plantilles*. 2. Feu clic a *Importar* a la dreta. 3. Trieu el fitxer d'importació. 4. Feu clic a *Importar*.  ![](../../../assets/en/manual/xml_export_import/import_templates.png){width="600"}  Si marqueu la casella de selecció *Opcions avançades*, es mostrarà una llista detallada de tots els elements importables: marqueu o desmarqueu cada regla d'importació segons sigui necessari.  Si feu clic a la casella de selecció de la filera *Tot*, tots els elements que hi ha a sota es marquen/desmarquen.  Regles d'importació:  |Regla|Descripció| |----|-----------| |*Actualització existent*|Els elements existents s'actualitzaran amb les dades extretes del fitxer d'importació. En cas contrari, no s'actualitzaran.| |*Crea nou*|La importació afegirà nous elements emprant les dades del fitxer d'importació. En cas contrari, no els afegirà.| |*Esborra el que manca*|La importació esborrarà els elements existents que no són presents al fitxer d'importació. En cas contrari, no els esborrarà.<br>Si es marca *Esborra el que manca* per a *Enllaç de plantilles*, l'enllaç de plantilla actual que no és present al fitxer d'importació es desenllaçarà. Les entitats (elements, triggers, gràfics, etc.) heretades de les plantilles no enllaçades no s'esborraran pas (tret que també s'hagi triat l'opció *Esborra el que manca* per a cada entitat).|  A la pantalla següent, podreu veure el contingut d'una plantilla que s'és important. Si aquesta és una plantilla nova, tots els elements es mostraran en verd. Si actualitzeu una plantilla existent, els nous elements de plantilla es ressalten en verd; els elements de plantilla esborrats es destaquen en vermell; els elements que no han canviat es llisten sobre fons gris.  ![](../../../assets/en/manual/xml_export_import/import_templates_details.png){width="600"}  El menú de l'esquerra es pot emprar per navegar per la llista de canvis. La secció *Actualitzat* destaca tots els canvis fets als elements de la plantilla existents. La secció *Afegit* enumera els nous elements de plantilla. Els elements de cada secció s'agrupen per tipus d'element; premeu la fletxa grisa cap avall per ampliar o reduir el grup d'elements.  ![](../../../assets/en/manual/xml_export_import/import_templates_menu.png)  Reviseu els canvis de plantilla i, a continuació, premeu *Importar* per importar la plantilla. Es veurà un missatge d'èxit o error de la importació a la interfície.

en-us	#### Improved menu section for top triggers  The menu section for viewing the top triggers is now named [*Top 100 triggers*](/manual/web_interface/frontend_sections/reports/triggers_top). The possibility to filter triggers by problem name and tags has been added. Also, the number of detected problems instead of the number of status changes is now displayed for each trigger.
ca	#### Secció de menú millorada per als triggers principals  La secció de menú per visualitzar els triggers principals ara s'anomena [*Els 100 triggers principals*](/manual/web_interface/frontend_sections/reports/triggers_top). S'ha afegit la possibilitat de filtrar els triggers pel nom del problema i les etiquetes. A més, ara es mostra el nombre de problemes detectats en comptes del nombre de canvis d'estat per a cada trigger.

en-us	##### In accepting-side log:      ...failed to accept an incoming connection: from 127.0.0.1: support for TLS was not compiled in
ca	##### Al registre del costat del servidor/proxy :   ...no s'ha pogut acceptar una connexió entrant: a partir de 127.0.0.1: el suport per a TLS no s'ha compilat pas

en-us	In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)  for all widgets, you may set the following specific options:  |   |   | |--|--------| |*Host groups*|Select host groups to be displayed on the map.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to be displayed on the map.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>If nothing is selected in both *Host groups* and *Hosts* fields, all hosts with valid coordinates will be displayed.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Tags*|Specify tags to limit the number of hosts displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the *Or* condition;<br>**Or** - enough if one condition is met.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Initial view*|Comma-separated center coordinates and an optional zoom level to display when the widget is initially loaded in the format `<latitude>,<longitude>,<zoom>`<br>If initial zoom is specified, the Geomap widget is loaded at the given zoom level. Otherwise, initial zoom is calculated as half of the [max zoom](/manual/web_interface/frontend_sections/administration/general#geographical_maps) for the particular tile provider.<br>The initial view is ignored if the default view is set (see below).<br>Examples:<br>40.6892494,-74.0466891,14<br>40.6892494,-122.0466891|
ca	A més dels paràmetres [comuns](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters) a tots els ginys, podeu establir les opcions específiques següents:  | | | |--|---------| |*Grups d'equips*|Trieu els grups d'equips que es veuran al mapa.<br>Alternativament, trieu un giny compatible com a [font de dades](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) per als grups d'equips.<br>Aquest camp s'emplena automàticament, de manera que començar a escriure el nom d'un grup oferirà un menú desplegable de grups coincidents.<br>Si no es tria res als camps *Grups d'equips* i *Equips*, es mostraran tots els equips amb coordenades vàlides.<br>Aquest paràmetre no és pas disponible quan configurem el giny a un [tauler de plantilles](/manual/config/templates/template#adding-dashboards).| |*Equips*|Trieu equips per mostrar-se a tot el mapa.<br>Alternativament, trieu un giny compatible com a [font de dades](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) per als grups d'equips.<br>Aquest camp s'emplena automàticament, de manera que començar a escriure el nom d'un equip oferirà un menú desplegable d'equips coincidents.<br>Si no se selecciona res als camps *Grups d'equips* i *Equips*, es mostraran tots els equips amb coordenades vàlides.<br>Aquest paràmetre no és pas disponible quan configurem el giny a un [tauler de plantilles](/manual/config/templates/template#adding-dashboards).| |*Etiquetes*|Especifiqueu etiquetes per limitar el nombre d'equips que es mostren al giny.<br>És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden establir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br><br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats<br>**Igual** - inclou els noms d'etiquetes especificats i valors (distingeix entre majúscules i minúscules)<br>**Conté** - inclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules)<br>**No existeix** - exclou l'especificat noms d'etiquetes<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules)<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta continguin la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules).<br><br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions que tinguin el mateix nom d'etiqueta s'agruparan per la condició O<br>**O** - n'hi ha prou si es compleix una condició.<br>Aquest paràmetre no és pas disponible quan configurem el giny a un [tauler de plantilles](/manual/config/templates/template#adding-dashboards).| |*Vista inicial*|Coordenades centrals separades per comes i un nivell de zoom opcional per mostrar quan el giny es carrega inicialment en el format `<latitud>,<longitud>,<zoom>`<br>Si s'especifica el zoom inicial, el giny del geomapa es carrega al nivell de zoom donat. En cas contrari, el zoom inicial es calcula com la meitat del [zoom màxim](/manual/web_interface/frontend_sections/administration/general#geographical_maps) per al proveïdor de mosaic en concret.<br>La vista inicial s'ignora si s'estableix la vista predeterminada (veieu a continuació).<br>Exemples:<br>=> 40,6892494,-74,0466891,14<br>=> 40,6892494,-122,0466891|

en-us	In addition to the parameters that are [common](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)  for all widgets, you may set the following specific options:  |   |   | |--|--------| |*Host groups*|Select host groups to display in the widget.<br>Alternatively, select a compatible widget as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for host groups.<br>This field is auto-complete, so starting to type the name of a group will offer a dropdown of matching groups.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Hosts*|Select hosts to display in the widget.<br>Alternatively, select a compatible widget or the dashboard as the [data source](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) for hosts.<br>This field is auto-complete, so starting to type the name of a host will offer a dropdown of matching hosts.<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Host tags*|Specify tags to limit the number of hosts displayed in the widget.<br>It is possible to include as well as exclude specific tags and tag values. Several conditions can be set. Tag name matching is always case-sensitive.<br><br>There are several operators available for each condition:<br>**Exists** - include the specified tag names;<br>**Equals** - include the specified tag names and values (case-sensitive);<br>**Contains** - include the specified tag names where the tag values contain the entered string (substring match, case-insensitive);<br>**Does not exist** - exclude the specified tag names;<br>**Does not equal** - exclude the specified tag names and values (case-sensitive);<br>**Does not contain** - exclude the specified tag names where the tag values contain the entered string (substring match, case-insensitive).<br><br>There are two calculation types for conditions:<br>**And/Or** - all conditions must be met, conditions having the same tag name will be grouped by the Or condition;<br>**Or** - enough if one condition is met.<br><br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).| |*Show hosts in maintenance*|Mark this checkbox for hosts in maintenance to be displayed as well (in this case, maintenance icon will be shown next to the host name). Unmarked by default.| |*Columns*|Add data [columns](#column-configuration) to display.<br>The column order determines their display from left to right.<br>Columns can be reordered by dragging up and down by the handle before the column name.| |*Order by*|Specify the column from the defined *Columns* list to use for *Top N* or *Bottom N* ordering.| |*Order*|Specify the ordering of rows:<br>**Top N** - in descending order according to the *Order by* aggregated value;<br>**Bottom N** - in ascending order according to the *Order by* aggregated value.| |*Host limit*|Number of host rows to be shown (1-100).<br>This parameter is not available when configuring the widget on a [template dashboard](/manual/config/templates/template#adding-dashboards).|
ca	A més dels paràmetres que són [comuns](/manual/web_interface/frontend_sections/dashboards/widgets#common-parameters)  per a tots els ginys, podeu establir les opcions específiques següents:  |   |   | |--|---------| |*Grups d'equips*|Trieu els grups d'equips per mostrar-los al giny.<br>Com a alternativa, trieu un giny compatible com a [font de dades](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) per als grups d'equips.<br>Aquest camp s'emplena automàticament, de manera que en començar a escriure el nom d'un grup s'oferirà un menú desplegable de grups coincidents.<br>Aquest paràmetre no és disponible quan es configura el giny en un [tauler de plantilla](/manual/ config/templates/template#adding-dashboards).| |*Equips*|Trieu els equips per mostrar-los al giny.<br>Com a alternativa, trieu un giny compatible o el tauler com a [font de dades](/manual/web_interface/frontend_sections/dashboards/widgets/#dynamic-parameters) per als equips.<br>Aquest camp s'emplena automàticament, de manera que en començar a escriure el nom d'un equip s'oferirà un menú desplegable d'equips coincidents.<br>Aquest paràmetre no és disponible quan es configura el giny en un [tauler de plantilla](/manual/ config/templates/template#adding-dashboards).| |*Etiquetes d'equips*|Especifiqueu etiquetes per limitar el nombre d'equips que es mostren al giny.<br>És possible incloure i excloure etiquetes i valors d'etiquetes específics. Es poden establir diverses condicions. La concordança de noms d'etiqueta sempre distingeix entre majúscules i minúscules.<br><br>Hi ha diversos operadors disponibles per a cada condició:<br>**Existeix** - inclou els noms d'etiquetes especificats;<br>**Igual** - inclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules);<br>**Conté** - inclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules);<br>**No existeix ** - exclou els noms d'etiquetes especificats;<br>**No és igual** - exclou els noms i valors d'etiquetes especificats (distingeix entre majúscules i minúscules);<br>**No conté** - exclou els noms d'etiquetes especificats on els valors de l'etiqueta contenen la cadena introduïda (coincidència de subcadenes, no distingeix entre majúscules i minúscules).<br><br>Hi ha dos tipus de càlcul per a les condicions:<br>**I/O** - s'han de complir totes les condicions, les condicions tenen el el mateix nom d'etiqueta s'agruparà per la condició O;<br>**O** - prou si es compleix una condició.<br><br>Aquest paràmetre no és disponible quan es configura el giny en un [tauler de plantilla](/ manual/config/templates/template#adding-dashboards).| |*Veure els equips en manteniment*|Marqueu aquesta casella de selecció perquè també es vegin els equips en manteniment (en aquest cas, la icona de manteniment es mostrarà al costat del nom de l'equip). Desmarcat per defecte.| |*Columnes*|Afegiu dades [columnes](#column-configuration) per mostrar-les.<br>L'ordre de les columnes determina la seva visualització d'esquerra a dreta.<br>Les columnes es poden reordenar arrossegant cap amunt i cap avall per la maneta abans del nom de columna.| |*Ordenar per*|Especifiqueu la columna de la llista definida *Columnes* per emprar-la per ordenar *N superior* o *N inferior*.| |*Ordre*|Especifiqueu l'ordre de les files:<br>**N superior** - en ordre descendent segons el valor agregat *Ordena per*;<br>**N** inferior** - en ordre ascendent segons el *Ordena per* valor agregat.| |*Límit d'equips*|Nombre de files d'equips que es mostraran (1-100).<br>Aquest paràmetre no és disponible quan es configura el giny en un [tauler de control de plantilla](/manual/config/templates/template#adding-dashboards ).|

en-us	In addition, Zabbix provides the zabbix-selinux-policy package as a part of source RPM packages for the following OS:  -   RHEL [7](https://repo.zabbix.com/zabbix/7.0/rhel/7/x86_64/), [8](https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/), and [9](https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/) -   AlmaLinux [8](https://repo.zabbix.com/zabbix/7.0/alma/8/x86_64/) and [9](https://repo.zabbix.com/zabbix/7.0/alma/9/x86_64/) -   CentOS Stream [8](https://repo.zabbix.com/zabbix/7.0/centos/8/x86_64/) and [9](https://repo.zabbix.com/zabbix/7.0/centos/9/x86_64/) -   Oracle Linux [8](https://repo.zabbix.com/zabbix/7.0/oracle/8/x86_64/) and [9](https://repo.zabbix.com/zabbix/7.0/oracle/9/x86_64/) -   Rocky Linux [8](https://repo.zabbix.com/zabbix/7.0/rocky/8/x86_64/) and [9](https://repo.zabbix.com/zabbix/7.0/rocky/9/x86_64/)  This package provides a basic default policy for SELinux and makes zabbix components work out-of-the-box by allowing Zabbix to create and use sockets and enabling httpd connection to PostgreSQL (used by frontend).   The source *zabbix_policy.te* file contains the following rules:        module zabbix_policy 1.2;      require {       type zabbix_t;       type zabbix_port_t;       type zabbix_var_run_t;       type postgresql_port_t;       type httpd_t;       class tcp_socket name_connect;       class sock_file { create unlink };       class unix_stream_socket connectto;     }          #============= zabbix_t ==============     allow zabbix_t self:unix_stream_socket connectto;     allow zabbix_t zabbix_port_t:tcp_socket name_connect;     allow zabbix_t zabbix_var_run_t:sock_file create;     allow zabbix_t zabbix_var_run_t:sock_file unlink;     allow httpd_t zabbix_port_t:tcp_socket name_connect;          #============= httpd_t ==============     allow httpd_t postgresql_port_t:tcp_socket name_connect;  This package has been created to prevent users from turning off SELinux because of the configuration complexity. It contains the default policy that is sufficient to speed up Zabbix deployment and configuration. For maximum security level, it is recommended to set custom SELinux settings. 
ca	A més, Zabbix proporciona el paquet zabbix-selinux-policy com a part dels paquets RPM font per als següents sistemes operatius:  - RHEL [7](https://repo.zabbix.com/zabbix/7.0/rhel/7/x86_64/), [8](https://repo.zabbix.com/zabbix/7.0/rhel/8/x86_64/), i [9](https://repo.zabbix.com/zabbix/7.0/rhel/9/x86_64/) - AlmaLinux [8](https://repo.zabbix.com/zabbix/7.0/alma/8/x86_64/) i [9](https://repo.zabbix.com/zabbix/7.0/alma/9/x86_64/) - CentOS Stream [8](https://repo.zabbix.com/zabbix/7.0/centos/8/x86_64/) i [9](https://repo.zabbix.com/zabbix/7.0/centos/9/x86_64/) - Oracle Linux [8](https://repo.zabbix.com/zabbix/7.0/oracle/8/x86_64/) i [9](https://repo.zabbix.com/zabbix/7.0/oracle/9/x86_64/) - Rocky Linux [8](https://repo.zabbix.com/zabbix/7.0/rocky/8/x86_64/) i [9](https://repo.zabbix.com/zabbix/7.0/rocky/9/x86_64/)  Aquest paquet proporciona una política bàsica per defecte per a SELinux i fa que els components de zabbix funcionin de manera immediata, permetent a Zabbix crear i emprar sòcols i habilitar la connexió httpd a PostgreSQL (emprada per la interfície).  El fitxer d'origen *zabbix_policy.te* conté les regles següents:      module zabbix_policy 1.2;      require {       type zabbix_t;       type zabbix_port_t;       type zabbix_var_run_t;       type postgresql_port_t;       type httpd_t;       class tcp_socket name_connect;       class sock_file { create unlink };       class unix_stream_socket connectto;     }          #============= zabbix_t ==============     allow zabbix_t self:unix_stream_socket connectto;     allow zabbix_t zabbix_port_t:tcp_socket name_connect;     allow zabbix_t zabbix_var_run_t:sock_file create;     allow zabbix_t zabbix_var_run_t:sock_file unlink;     allow httpd_t zabbix_port_t:tcp_socket name_connect;          #============= httpd_t ==============     allow httpd_t postgresql_port_t:tcp_socket name_connect;  Aquest paquet s'ha creat per evitar que els usuaris apaguin SELinux a causa de la complexitat de la configuració. Conté la política predeterminada que és suficient per accelerar el desplegament i la configuració de Zabbix. Per obtindre el màxim nivell de seguretat, es recomana la configuració personalitzada de SELinux.

en-us	##### Include  You may include individual files or all files in a directory in the configuration file.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching.<br>See [special notes](special_notes_include) about limitations.  Example:      Include=/absolute/path/to/config/files/*.conf
ca	##### Include  Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració. Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.Veieu [special notes](special_notes_include) sobre les limitacions.  Exemple:      Include=/absolute/path/to/config/files/*.conf

en-us	##### Include  You may include individual files or all files in a directory in the configuration file. During the installation Zabbix will create the include directory in /usr/local/etc, unless modified during the compile time. The path can be relative to the *zabbix\_agent2.conf* file location.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching.<br>See [special notes](special_notes_include) about limitations.  Example:      Include=/absolute/path/to/config/files/*.conf
ca	##### Include  Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració. Durant la instal·lació, Zabbix crearà el directori d'inclusió a /usr/local/etc, tret que es modifiqui durant el temps de compilació. El camí pot ser relatiu a la ubicació del fitxer *zabbix\_agent2.conf*.<br>Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.<br>Veieu les [notes especials] (special_notes_include) sobre les limitacions.  Exemple:      Include=/absolute/path/to/config/files/*.conf

en-us	##### Include  You may include individual files or all files in a directory in the configuration file (located in `C:\Program Files\Zabbix Agent 2` by default if Zabbix agent is installed using Windows MSI installer packages; located in the folder specified during installation if Zabbix agent is installed as a zip archive). All included files must have correct syntax, otherwise agent will not start. The path can be relative to the *zabbix_agent2.conf* file location (e.g., `Include=.\zabbix_agent2.d\plugins.d\*.conf`).<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching.<br>See [special notes](special_notes_include) about limitations.  Example:      Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf
ca	##### Include  Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració (ubicat a `C:\Program Files\Zabbix Agent 2` per defecte si l'agent de Zabbix s'instal·la amb l'MSI de Windows; o al directori específic durant la instal·lació si l'agent s'ha instal·lat des d'un arxiu zip). Tots els arxius inclosos han de tindre una sintaxi correcta; altrament, l'agent no engegarà pas. El camí pot ser relatiu a la ubicació del fitxer *zabbix\_agent2.conf* (per exemple, `Include=.\zabbix_agent2.d\plugins.d\*.conf`).<br>Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.<br>Veieu les [notes especials] (special_notes_include) sobre les limitacions.  Exemple:  Include=C:\Program Files\Zabbix Agent2\zabbix_agent2.d\*.conf

en-us	##### Include  You may include individual files or all files in a directory in the configuration file (located in `C:\Program Files\Zabbix Agent` by default if Zabbix agent is installed using Windows MSI installer packages; located in the folder specified during installation if Zabbix agent is installed as a zip archive). All included files must have correct syntax, otherwise agent will not start.<br>To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching.<br>See [special notes](special_notes_include) about limitations.  Example:      Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf
ca	##### Include  Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració (ubicat a `C:\Program Files\Zabbix Agent 2` per defecte si l'agent de Zabbix s'instal·la amb l'MSI de Windows; o al directori específic durant la instal·lació si l'agent s'ha instal·lat des d'un arxiu zip). Tots els arxius inclosos han de tindre una sintaxi correcta; altrament, l'agent no engegarà pas. La ruta pot ésser relativa a *zabbix_agent2.conf* (per exemple, `Include=.\zabbix_agent2.d\plugins.d\*.conf`).<br>Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.<br>Veieu les [notes especials] (special_notes_include) sobre les limitacions.  Exemple:  Include=C:\Program Files\Zabbix Agent\zabbix_agentd.d\*.conf

en-us	##### Include  You may include individual files or all files in a directory in the configuration file. To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching.<br>See [special notes](special_notes_include) about limitations.  Example:      Include=/absolute/path/to/config/files/*.conf
ca	##### Include  Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració. Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.<br>Vegeu [special notes](special_notes_include) sobre les limitacions.  Exemple:      Include=/absolute/path/to/config/files/*.conf

en-us	##### Include You may include individual files or all files in a directory in the configuration file. To only include relevant files in the specified directory, the asterisk wildcard character is supported for pattern matching. See [special notes](special_notes_include) about limitations.  Example:      Include=/absolute/path/to/config/files/*.conf
ca	##### Include  Podeu incloure fitxers individuals o tots els fitxers d'un directori al fitxer de configuració. Per incloure només fitxers rellevants al directori especificat, el caràcter comodí d'asterisc és compatible per a la concordança de patrons.Veieu [special notes](special_notes_include) sobre les limitacions.  Exemple:      Include=/absolute/path/to/config/files/*.conf

en-us	##### Incoming connections  It is a bit more complicated with incoming connections because rules are specific for components and configuration.  For Zabbix **agent**:  |Agent connection setup|Cipher configuration| |----------------------|--------------------| |TLSConnect=cert|TLSCipherCert, TLSCipherCert13| |TLSConnect=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll, TLSCipherAll13|  For Zabbix **server** and **proxy**:  |Connection setup|Cipher configuration| |----------------|--------------------| |Outgoing connections using PSK|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using certificates|TLSCipherAll, TLSCipherAll13| |Incoming connections using PSK if server has no certificate|TLSCipherPSK, TLSCipherPSK13| |Incoming connections using PSK if server has certificate|TLSCipherAll, TLSCipherAll13|  Some pattern can be seen in the two tables above:  -   TLSCipherAll and TLSCipherAll13 can be specified only if a combined     list of certificate- **and** PSK-based ciphersuites is used. There     are two cases when it takes place: server (proxy) with a configured     certificate (PSK ciphersuites are always configured on server, proxy     if crypto library supports PSK), agent configured to accept both     certificate- and PSK-based incoming connections -   in other cases TLSCipherCert\* and/or TLSCipherPSK\* are sufficient  The following tables show the `TLSCipher*` built-in default values. They could be a good starting point for your own custom values.  |Parameter|GnuTLS 3.6.12| |--|--------| |TLSCipherCert|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |TLSCipherPSK|NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL| |TLSCipherAll|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509|  |Parameter|OpenSSL 1.1.1d ^**1**^| |--|--------| |TLSCipherCert13|<| |TLSCipherCert|EECDH+aRSA+AES128:RSA+aRSA+AES128| |TLSCipherPSK13|TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256| |TLSCipherPSK|kECDHEPSK+AES128:kPSK+AES128| |TLSCipherAll13|<| |TLSCipherAll|EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128|  ^**1**^ Default values are different for older OpenSSL versions (1.0.1, 1.0.2, 1.1.0), for LibreSSL and if OpenSSL is compiled without PSK support.  **Examples of user-configured ciphersuites**  See below the following examples of user-configured ciphersuites:  -   [Testing cipher strings and allowing only PFS     ciphersuites](#testing_cipher_strings_and_allowing_only_pfs_ciphersuites) -   [Switching from AES128 to AES256](#switching_from_aes128_to_aes256)
ca	##### Connexions entrants  És una mica més complicat amb les connexions entrants perquè les regles són específiques dels components i de la configuració.  Per a l'**agent** Zabbix:  |Configuració de connexió de l'agent|Configuració de xifrat| |----------------------|---------------------| |TLSConect=cert|TLSCipherCert,TLSCipherCert13| |TLSConect=psk|TLSCipherPSK,TLSCipherPSK13| |TLSAccept=cert|TLSCipherCert, TLSCipherCert13| |TLSAccept=psk|TLSCipherPSK, TLSCipherPSK13| |TLSAccept=cert,psk|TLSCipherAll,TLSCipherAll13|  Per al **servidor** i **proxy** Zabbix:  |Configuració de connexió|Configuració de xifrat| |----------------|---------------------| |Connexions sortints amb PSK|TLSCipherPSK, TLSCipherPSK13| |Connexions entrants amb certificats|TLSCipherAll, TLSCipherAll13| |Connexions entrants amb PSK si el servidor no té certificat|TLSCipherPSK, TLSCipherPSK13| |Connexions entrants amb PSK si el servidor té un certificat|TLSCipherAll, TLSCipherAll13|  Alguns patrons es poden veure a les dues taules anteriors:  - TLSCipherAll i TLSCipherAll13 només es poden especificar si s'empra una llista combinada de conjunts de xifrat **i** basats en PSK. Hi ha dos casos en què això passa: servidor (proxy) amb un certificat configurat (les suites de xifrat PSK sempre es configuren al servidor, i al proxy si la biblioteca de xifrat admet PSK), agent configurat per acceptar connexions entrants basades en certificat i PSK. - en altres casos TLSCipherCert\* i/o TLSCipherPSK\* són suficients  Les taules següents mostren els valors predeterminats integrats de `TLSCipher*`. Poden ser un bon punt de partida per als vostres propis valors personalitzats.  |Configuració|GnuTLS 3.6.12| |--|---------| |TLSCipherCert|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509| |TLSCipherPSK|NONE:+VERS-TLS1.2:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL| |TLSCipherAll|NONE:+VERS-TLS1.2:+ECDHE-RSA:+RSA:+ECDHE-PSK:+PSK:+AES-128-GCM:+AES-128-CBC:+AEAD:+SHA256:+SHA1:+CURVE-ALL:+COMP-NULL:+SIGN-ALL:+CTYPE-X.509|  |Paràmetre|OpenSSL 1.1.1d ^**1**^| |--|---------| |TLSCipherCert13|<| |TLSCipherCert|EECDH+aRSA+AES128:RSA+aRSA+AES128| |TLSCipherPSK13|TLS\_CHACHA20\_POLY1305\_SHA256:TLS\_AES\_128\_GCM\_SHA256| |TLSCipherPSK|kECDHEPSK+AES128:kPSK+AES128| |TLSCipherAll13|<| |TLSCipherAll|EECDH+aRSA+AES128:RSA+aRSA+AES128:kECDHEPSK+AES128:kPSK+AES128|  ^**1**^ Els valors per defecte són diferents per a les versions anteriors d'OpenSSL (1.0.1, 1.0.2, 1.1.0), per a LibreSSL i si OpenSSL es compila sense suport PSK.  **Exemples de suites de xifrat configurades per l'usuari**  Veieu els exemples següents de suites de xifrat configurades per l'usuari tot seguit:  - [Provant les cadenes de xifrat i només permetent les suites de xifrat PFS](#testing_cipher_strings_and_allowing_only_pfs_ciphersuites) - [Canvi d'AES128 a AES256](#switching_from_aes128_to_aes256)

en-us	##### In connecting-side log:  Linux:      ...In zbx_tls_init_child()     ...OpenSSL library (version OpenSSL 1.1.1  11 Sep 2018) initialized     ...     ...In zbx_tls_connect(): psk_identity:"PSK test sender"     ...End of zbx_tls_connect():FAIL error:'connection closed by peer'     ...send value error: TCP successful, cannot establish TLS to [[localhost]:10051]: connection closed by peer  Windows:      ...OpenSSL library (version OpenSSL 1.1.1a  20 Nov 2018) initialized     ...     ...In zbx_tls_connect(): psk_identity:"PSK test sender"     ...zbx_psk_client_cb() requested PSK identity "PSK test sender"     ...End of zbx_tls_connect():FAIL error:'SSL_connect() I/O error: [0x00000000] The operation completed successfully.'     ...send value error: TCP successful, cannot establish TLS to [[192.168.1.2]:10051]: SSL_connect() I/O error: [0x00000000] The operation completed successfully.
ca	##### Al registre del costat de la connexió:  Linux:  ...A zbx_tls_init_child()   ...Biblioteca OpenSSL (versió OpenSSL 1.1.1 11 de setembre de 2018) inicialitzada   ...   ...A zbx_tls_connect(): psk_identity:"Remitent de prova de PSK"   ...Final de zbx_tls_connect():Error FAIL: 'connexió tancada pel company'   ... error d'enviament del valor: TCP correcte, no es pot establir TLS a [[localhost]:10051]: connexió tancada pel company  Windows:    ...Biblioteca OpenSSL (versió OpenSSL 1.1.1a 20 de novembre de 2018) inicialitzada   ...   ...A zbx_tls_connect(): psk_identity:"Remitent de prova de PSK"   ...zbx_psk_client_cb() ha sol·licitat la identitat PSK "Remitent de prova PSK"   ...Fi de zbx_tls_connect():Error FAIL:'Error d'E/S SSL_connect(): [0x00000000] L'operació s'ha completat correctament.'   ... error d'enviament del valor: TCP correcte, no es pot establir TLS a [[192.168.1.2]:10051]: Error d'E/S SSL_connect(): [0x00000000] L'operació s'ha completat correctament.

en-us	#### Incorrect request method parameter in items  The request method parameter, used only in HTTP checks, may be incorrectly set to '1', a non-default value for all items as a result of upgrade from a pre-4.0 Zabbix version. For details on how to fix this situation, see [ZBX-19308](https://support.zabbix.com/browse/ZBX-19308).
ca	#### El paràmetre del mètode de petició és incorrecte als elements  El paràmetre del mètode de sol·petició, que només s'empra a les comprovacions HTTP, pot estar configurat incorrectament a "1", un valor no predeterminat per a tots els elements després d'una actualització d'una versió anterior a la versió 4.0 de Zabbix. Per obtindre més informació sobre com solucionar aquest problema, consulteu [ZBX-19308](https://support.zabbix.com/browse/ZBX-19308).