en-us	#### LLD rule filter condition  The LLD rule filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|  ::: notetip To better understand how to use filters with various types of expressions, see examples on the [discoveryrule.get](get#retrieving_filter_conditions) and [discoveryrule.create](create#using_a_custom_expression_filter) method pages. :::
ca	#### Condició de filtre de regla LLD  Aquest objecte defineix una comprovació separada per dur a terme el valor d'una macro LLD. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**macro**<br>(obligatori)|cadena|Macro LLD per comprovar-ho.| |**valor**<br>(obligatori)|cadena|Valor a comparar.| |formulaid|string|ID únic arbitrari emprat per fer referència a la condició d'una expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho demani més endavant.| |operator|integer|Operador de condició.<br><br>Valors possibles:<br>8 - *(per defecte)* coincideix amb l'expressió regular;<br>9 - no coincideix amb l'expressió regular; <br>12 - existeix;< br>13 - no existeix.|  ::: consell de notes Per entendre millor com emprar filtres amb diferents tipus d'expressions, consulteu els exemples a les pàgines del mètode [discoveryrule.get](get#retrieving_filter_conditions) i [discoveryrule.create](create#using_a_custom_expression_filter). :::

en-us	### LLD rule filter  The LLD rule filter object defines a set of conditions that can be used to filter discovered objects. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**conditions**<br>(required)|array|Set of filter conditions to use for filtering results.| |**evaltype**<br>(required)|integer|Filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating filter conditions. The expression contains IDs that reference specific filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of filters with a custom expression. The expression must contain IDs that reference specific filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression filters.|
ca	### Filtre de regla LLD  L'objecte de filtre de regles LLD defineix un conjunt de condicions que es poden emprar per filtrar objectes descoberts. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**conditions**<br>(obligatori)|matriu|Conjunt de condicions de filtre que s'empren per filtrar els resultats.| |**evaltype**<br>(obligatori)|integer|Mètode d'avaluació de la condició del filtre.<br><br>Valors possibles:<br>0 - i/o;<br>1 - i; <br> 2 - o ;<br>3 - expressió personalitzada.| |eval\_formula|string|*(només de lectura)* Expressió generada que s'emprarà per avaluar les condicions del filtre. L'expressió conté identificadors que fan referència a condicions de filtre específiques per la seva "fórmula". El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.| |formula|cadena|Expressió definida per l'usuari per avaluar les condicions del filtre amb una expressió personalitzada. L'expressió ha de contindre identificadors que facin referència a condicions de filtre específiques mitjançant la seva "fórmula". Els identificadors emprats a l'expressió han de coincidir exactament amb els definits a les condicions del filtre: no es pot pas deixar ni ometre cap condició.<br><br>Necessari per als filtres d'expressió personalitzats.|

en-us	# > LLD rule object  The following objects are directly related to the `discoveryrule` API.
ca	# > Objecte de regla LLD  Els següents objectes són relacionats amb l'API `discoveryrule`.

en-us	#### LLD rule override filter condition  The LLD rule override filter condition object defines a separate check to perform on the value of an LLD macro. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**macro**<br>(required)|string|LLD macro to perform the check on.| |**value**<br>(required)|string|Value to compare with.| |formulaid|string|Arbitrary unique ID that is used to reference the condition from a custom expression. Can only contain capital-case letters. The ID must be defined by the user when modifying filter conditions, but will be generated anew when requesting them afterward.| |operator|integer|Condition operator.<br><br>Possible values:<br>8 - *(default)* matches regular expression;<br>9 - does not match regular expression;<br>12 - exists;<br>13 - does not exist.|
ca	#### Condició del filtre de sobrecàrrega de la regla LLD  L'objecte defineix una comprovació independent per dur a terme el valor d'una macro LLD. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**macro**<br>(obligatori)|cadena|Macro LLD per realitzar la comprovació.| |**valor**<br>(obligatori)|cadena|Valor a comparar.| |formulaid|string|ID únic arbitrari emprat per fer referència a la condició d'una expressió personalitzada. Només pot contindre lletres majúscules. L'ID l'ha de configurar l'usuari en modificar les condicions del filtre, però es tornarà a generar quan ho sol·liciti més endavant.| |operador|enter|Operador de condició.<br><br>Valors possibles:<br>8 - *(per defecte)* coincideix amb l'expressió regular;<br>9 - no coincideix amb l'expressió regular; <br>12 - existeix;< br>13 - no existeix.|

en-us	#### LLD rule override filter  The LLD rule override filter object defines a set of conditions that if they match the discovered object the override is applied. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**evaltype**<br>(required)|integer|Override filter condition evaluation method.<br><br>Possible values:<br>0 - and/or;<br>1 - and;<br>2 - or;<br>3 - custom expression.| |**conditions**<br>(required)|array|Set of override filter conditions to use for matching the discovered objects.| |eval\_formula|string|*(readonly)* Generated expression that will be used for evaluating override filter conditions. The expression contains IDs that reference specific override filter conditions by its `formulaid`. The value of `eval_formula` is equal to the value of `formula` for filters with a custom expression.| |formula|string|User-defined expression to be used for evaluating conditions of override filters with a custom expression. The expression must contain IDs that reference specific override filter conditions by its `formulaid`. The IDs used in the expression must exactly match the ones defined in the override filter conditions: no condition can remain unused or omitted.<br><br>Required for custom expression override filters.|
ca	#### Filtre de sobrecàrrega de la regla LLD  L'objecte defineix un conjunt de condicions que, si coincideixen amb l'objecte descobert, s'aplica la sobrecàrrega. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**evaltype**<br>(obligatori)|integer|Substitueix el mètode d'avaluació de la condició de filtre.<br><br>Valors possibles:<br>0 - i/o;<br>1 - i ;< br>2 - o ;<br>3 - expressió personalitzada.| |**conditions**<br>(obligatori)|matriu|Conjunt de condicions de filtre de sobrecàrrega que s'empren per fer coincidir els objectes descoberts.| |eval\_formula|string|*(només de lectura)* Expressió generada que s'emprarà per avaluar les condicions del filtre de sobrecàrrega. L'expressió conté identificadors que fan referència a condicions específiques de filtre de sobrecàrrega mitjançant la seva "fórmula". El valor de `eval_formula` és igual al valor de `formula` per als filtres amb una expressió personalitzada.| |formula|cadena|Expressió definida per l'usuari per avaluar les condicions del filtre de sobrecàrrega amb una expressió personalitzada. L'expressió ha de contindre identificadors que facin referència a condicions específiques del filtre de sobrecàrrega mitjançant la seva "fórmula". Els ID emprats a l'expressió han de coincidir exactament amb els definits a les condicions del filtre de sobrecàrrega: cap condició no es pot deixar sense emprar ni ometre.<br><br>Necessari per als filtres de sobrecàrrega d'expressions personalitzats.| :::

en-us	##### LLD rule override operation discover  LLD rule override operation discover status that is set to discovered object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**discover**<br>(required)|integer|Override the discover status for selected object.<br><br>Possible values:<br>0 - Yes, continue discovering the objects;<br>1 - No, new objects will not be discovered and existing ones will be marked as lost.|
ca	##### Operació de sobrecàrrega de descobriment de regles LLD  Estat de l'operació de sobrecàrrega de descobriment de la regla LLD que s'estableix a l'objecte descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**discover**<br>(obligatori)|integer|Anul·la l'estat de descoberta de l'objecte triat.<br><br>Valors possibles:<br>0 - Sí, continuar descobrint objectes;< br>1 - No , els elements nous no es descobriran i els elements existents es marcaran com a perduts.|

en-us	##### LLD rule override operation history  LLD rule override operation history value that is set to discovered item. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**history**<br>(required)|string|Override the history of item prototype which is a time unit of how long the history data should be stored. Also accepts user macro and LLD macro.|
ca	##### Operació de sobrecàrrega de l'historial de regles LLD  Operació de sobrecàrrega de l'historial de regles LLD establerta a l'element descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**history**<br>(obligatori)|cadena|Substitueix l'històtic del prototip d'element, que és una unitat de temps de quant de temps s'han d'emmagatzemar les dades de l'històric. També accepta macro d'usuari i macro LLD.|

en-us	##### LLD rule override operation inventory  LLD rule override operation inventory mode value that is set to discovered host. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**inventory\_mode**<br>(required)|integer|Override the host prototype inventory mode.<br><br>Possible values are:<br>-1 - disabled;<br>0 - *(default)* manual;<br>1 - automatic.|
ca	##### LLD Rule Operació de sobrecàrrega d'inventari  Operació per anul·lar el valor del mode d'inventari de la regla LLD que s'estableix a l'equip descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**inventory\_mode**<br>(obligatori)|integer|Ignora el mode d'inventari del prototip de l'equip.<br><br>Els valors possibles són:<br>-1 - desactivat;< br>0 - *( per defecte)* manual;<br>1 - automàtic.|

en-us	##### LLD rule override operation period  LLD rule override operation period is an update interval value (supports custom intervals) that is set to discovered item. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**delay**<br>(required)|string|Override the update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d) as well as flexible and scheduling intervals and user macros or LLD macros. Multiple intervals are separated by a semicolon.|
ca	##### Període d'operació de sobrecàrrega de la regla LLD  El període d'operació de sobrecàrrega de la regla LLD és un valor d'interval d'actualització (admet intervals personalitzats) que s'estableix a l'element descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**retard**<br>(obligatori)|cadena|Anul·la l'interval d'actualització del prototip d'element. Accepta segons o una unitat de temps amb sufix (30s,1m,2h,1d), així com intervals flexibles i de programació i macros d'usuari o LLD. Els intervals múltiples són separats per un punt i coma.|

en-us	##### LLD rule override operation severity  LLD rule override operation severity value that is set to discovered trigger. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**severity**<br>(required)|integer|Override the severity of trigger prototype.<br><br>Possible values are: 0 - *(default)* not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.|
ca	##### Operació de sobrecàrrega de gravetat de la regla LLD  L'operació s'ha establert al trigger descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**severity**<br>(obligatori)|integer|Anul·la la gravetat del prototip de trigger.<br><br>Els valors possibles són: 0 - *(per defecte)* sense classificar;<br>1 - informació ;<br>2 - avís;<br>3 - mitjana;<br>4 - alta;<br>5 - desastre.|

en-us	##### LLD rule override operation status  LLD rule override operation status that is set to discovered object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**status**<br>(required)|integer|Override the status for selected object.<br><br>Possible values:<br>0 - Create enabled;<br>1 - Create disabled.|
ca	##### Estat de l'operació de sobrecàrrega de la regla LLD  Estat de l'operació de sobrecàrrega de la regla LLD que s'estableix com a objecte descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**status**<br>(obligatori)|integer|Anul·la l'estat de l'objecte seleccionat.<br><br>Valors possibles:<br>0 - Creació activada;<br>1 - Creació desactivada.|

en-us	##### LLD rule override operation tag  LLD rule override operation tag object contains tag name and value that are set to discovered object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|New tag name.| |value|string|New tag value.|
ca	##### Operació de sobrecàrrega d'etiquetes de regla LLD  L'operació conté el nom i el valor de l'etiqueta definit a l'objecte descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|string|Nom d'etiqueta nou.| |value|string|Valor d'etiqueta nou.|

en-us	##### LLD rule override operation template  LLD rule override operation template object that is linked to discovered host. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**templateid**<br>(required)|string|Override the template of host prototype linked templates.|
ca	##### Operació de sobrecàrrega del model de regles LLD  Objecte d'operació de sobrecàrrega del model vinculat a l'equip descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**templateid**<br>(obligatori)|string|Substitueix la plantilla de les plantilles vinculades al prototip de l'equip.|

en-us	#### LLD rule override operation  The LLD rule override operation is combination of conditions and actions to perform on the prototype object. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**operationobject**<br>(required)|integer|Type of discovered object to perform the action.<br><br>Possible values:<br>0 - Item prototype;<br>1 - Trigger prototype;<br>2 - Graph prototype;<br>3 - Host prototype.| |operator|integer|Override condition operator.<br><br>Possible values:<br>0 - *(default)* equals;<br>1 - does not equal;<br>2 - contains;<br>3 - does not contain;<br>8 - matches;<br>9 - does not match.| |value|string|Pattern to match item, trigger, graph or host prototype name depending on selected object.| |opstatus|object|Override operation status object for item, trigger and host prototype objects.| |opdiscover|object|Override operation discover status object (all object types).| |opperiod|object|Override operation period (update interval) object for item prototype object.| |ophistory|object|Override operation history object for item prototype object.| |optrends|object|Override operation trends object for item prototype object.| |opseverity|object|Override operation severity object for trigger prototype object.| |optag|array|Override operation tag object for trigger and host prototype objects.| |optemplate|array|Override operation template object for host prototype object.| |opinventory|object|Override operation inventory object for host prototype object.|
ca	#### Operació de sobrecàrrega de regles LLD  L'operació és una combinació d'accions i condicions que s'han de realitzar a l'objecte prototip. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**operationobject**<br>(obligatori)|entier|Tipus d'objecte descobert per dur a terme l'acció.<br><br>Valors possibles:<br>0 - Prototip d'element;<br>1 - Prototip de trigger;< br>2 - Prototip de gràfics;<br>3 - Prototip d'equip.| |operador|nter|Operador de condició de sobrecàrrega.<br><br>Valors possibles:<br>0 - *(per defecte)* és igual;<br>1 - no és igual;<br>2 - conté;<br> 3 - no conté; <br>8 - coincideix;<br>9 - no coincideix.| |valor|cadena|Patró per fer coincidir l'element, el trigger, el gràfic o el nom del prototip d'equip basat en l'objecte triat.| |opstatus|objecte|Objecte d'estat de l'operació de sobrecàrrega per a objectes d'element, trigger i prototip d'equip.| |opdiscover|objecte|Objecte d'estat de l'operació de sobrecàrrega de descobriment (qualsevol tipus d'objecte).| |opperiod|objecte|Objecte de període d'operació de sobrecàrrega (interval d'actualització) per a l'objecte prototip d'element.| |ohistory|object|Objecte de l'històric d'operacions de sobrecàrrega per a l'objecte prototip d'element.| |optrends|objecte|Objecte de tendències d'operació de sobrecàrrega per a l'objecte prototip d'element.| |opseverity|objecte|Objecte de gravetat de l'operació de sobrecàrrega per a l'objecte prototip del trigger.| |optag|array|Objecte d'etiqueta d'operació de sobrecàrrega per a l'objecte prototip de l'equip.| |optemplate|array|Objecte de plantilla d'operació de sobrecàrrega per a l'objecte prototip de l'equip.| |opinventory|objecte|Objecte d'inventari d'operacions de sobrecàrrega per a l'objecte prototip de l'equip.|

en-us	##### LLD rule override operation trends  LLD rule override operation trends value that is set to discovered item. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**trends**<br>(required)|string|Override the trends of item prototype which is a time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.|
ca	##### Operació de sobrecàrrega de tendència de la regla LLD  Operació establerta a l'element descobert. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**trends**<br>(obligatori)|cadena|Substitueix les tendències del prototip d'element, que és una unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendència. També admet macro d'usuari i macro LLD.|

en-us	### LLD rule overrides  The LLD rule overrides object defines a set of rules (filters, conditions and operations) that are used to override properties of different prototype objects. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**name**<br>(required)|string|Unique override name.| |**step**<br>(required)|integer|Unique order number of the override.| |stop|integer|Stop processing next overrides if matches.<br><br>Possible values:<br>0 - *(default)* don't stop processing overrides;<br>1 - stop processing overrides if filter matches.| |filter|object|Override filter.| |operations|array|Override operations.|
ca	### Sobrecàrrega de regles LLD  L'objecte de sobrecàrrega de regles LLD defineix un conjunt de regles (filtres, condicions i operacions) que s'empren per anul·lar les propietats de diversos objectes prototip. Té les següents propietats:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**nom**<br>(obligatori)|cadena|Nom únic de sobrecàrrega.| |**pas**<br>(obligatori)|nombre enter|Nombre de seqüència únic de la sobrecàrrega.| |stop|enter|Atura el processament de les sobrecàrregues futures si coincideix.<br><br>Valors possibles:<br>0 - *(per defecte)* no atura el processament de les sobrecàrregues;<br>1: atura el processament de les sobrecàrregues del procés si el filtre coincideix .| |filtre|objecte|Filtre de sobrecàrrega.| |operacions|matriu|Operacions de sobrecàrrega.| :::

en-us	### LLD rule preprocessing  The LLD rule preprocessing object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**type**<br>(required)|integer|The preprocessing option type.<br><br>Possible values:<br>5 - Regular expression matching;<br>11 - XML XPath;<br>12 - JSONPath;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>27 - XML to JSON.| |**params**<br>(required)|string|Additional parameters used by preprocessing option. Multiple parameters are separated by LF (\\n) character.| |**error\_handler**<br>(required)|integer|Action type used in case of preprocessing step failure.<br><br>Possible values:<br>0 - Error message is set by Zabbix server;<br>1 - Discard value;<br>2 - Set custom value;<br>3 - Set custom error message.| |**error\_handler\_params**<br>(required)|string|Error handler parameters. Used with `error_handler`.<br><br>Must be empty, if `error_handler` is 0 or 1.<br>Can be empty if, `error_handler` is 2.<br>Cannot be empty, if `error_handler` is 3.|  The following parameters and error handlers are supported for each preprocessing type.  |Preprocessing type|Name|Parameter 1|Parameter 2|Parameter 3|Supported error handlers| |------------------|----|-----------|-----------|-----------|------------------------| |5|Regular expression|pattern^1^|output^2^|<|0, 1, 2, 3| |11|XML XPath|path^3^|<|<|0, 1, 2, 3| |12|JSONPath|path^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^1^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^3^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^3^|<|<|0, 1, 2, 3| |20|Discard unchanged with heartbeat|seconds^4,\ 5^|<|<|<| |21|JavaScript|script^2^|<|<|<| |23|Prometheus to JSON|pattern^5,\ 6^|<|<|0, 1, 2, 3| |24|CSV to JSON|character^2^|character^2^|0,1|0, 1, 2, 3| |25|Replace|search string^2^|replacement^2^|<|<| |27|XML to JSON|<|<|<|0, 1, 2, 3|  ^1^ regular expression\ ^2^ string\ ^3^ JSONPath or XML XPath\ ^4^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^5^ user macro\ ^6^ Prometheus pattern following the syntax: `<metric name>{<label name>="<label value>", ...} == <value>`. Each Prometheus pattern component (metric, label name, label value and metric value) can be user macro.\
ca	### Preprocessament de regla LLD  L'objecte de preprocessament de regles LLD té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tipus**<br>(obligatori)|enter|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>5 - Coincidència d'expressió regular;<br>11 - XML ​​​​​​XPath ;<br>12 - JSONPath;<br>15 - No coincideix amb l'expressió regular;< br>16 - Comprovar si hi ha errors JSON;<br>17 - Comprovar si hi ha errors XML;<br>20 - Descartar sense canvis amb el heartbeat;<br>23 - Prometheus a JSON;<br>24 - CSV a JSON;< br>25 - Substituïu;<br>27 - XML ​​​​a JSON.| |**params**<br>(obligatori)|string|Paràmetres addicionals emprats per l'opció de preprocessament. Múltiples paràmetres separats per caràcter LF (\\n).| |**error\_handler**<br>(obligatori)|entier|Tipus d'acció que s'empra si el pas de preprocessament falla.<br><br>Valors possibles:<br>0 - El servidor Zabbix ha establert el missatge d'error del missatge. ;<br>1 - Elimina el valor;<br>2 - Estableix un valor personalitzat;< br>3 - Estableix un missatge d'error personalitzat.| |**error\_handler\_params**<br>(obligatori)|string|Paràmetres del gestor d'errors. S'empra amb `error_handler`.<br><br>Ha d'ésser buit, si `error_handler` és 0 o 1.<br>Pot ésser buit si `error_handler` és 2.<br>No pot ésser buit, si `error_handler ` és 3.|  Els següents paràmetres i gestors d'errors són compatibles per a cada tipus de preprocessament.  |Tipus de preprocessament|Nom|Paràmetre 1|Paràmetre 2|Paràmetre 3|Gestors d'errors admesos| |-------------------|----|-----------|------------|- ----------|----------| |5|Expressió regular|patró^1^|sortida^2^|<|0, 1, 2, 3| |11|XML XPath|camí^3^|<|<|0, 1, 2, 3| |12|JSONPath|camí^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular|patró^1^|<|<|0, 1, 2, 3| |16|Cerca un error en JSON |camí^3^|<|<|0, 1, 2, 3| |17|Cerca un error a XML|camí^3^|<|<|0, 1, 2, 3| |20|Descartar sense canvis amb el batec del cor|segons^4,\ 5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |23|Prometeu a JSON|patró^5,\7^|<|<|0, 1, 2, 3| |24|CSV a JSON|caràcter^2^|caràcter^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |27|XML a JSON|<|<|<|0, 1, 2, 3|  ^1^ expressió regular\ ^2^ cadena\ ^3^ JSONPath o XML XPath\ ^4^ nombre enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)\ ^5^ macro d'usuari\ ^6^ Patró de Prometheus seguint la sintaxi: `<nom mètric>{<nom de l'etiqueta>="<valor de l'etiqueta>", ...} == <valor>`. Cada component del patró de Prometheus (mètrica, nom d'etiqueta, valor d'etiqueta i valor de mètrica) pot ser una macro d'usuari. :::

en-us	### LLD rule  The low-level discovery rule object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the LLD rule.| |**delay**<br>(required)|string|Update interval of the LLD rule. Accepts seconds or time unit with suffix and with or without one or more [custom intervals](/manual/config/items/item/custom_intervals) that consist of either flexible intervals and scheduling intervals as serialized strings. Also accepts user macros. Flexible intervals could be written as two macros separated by a forward slash. Intervals are separated by a semicolon.<br><br>Optional for Zabbix trapper, dependent items and for Zabbix agent (active) with `mqtt.get` key.| |**hostid**<br>(required)|string|ID of the host that the LLD rule belongs to.| |**interfaceid**<br>(required)|string|ID of the LLD rule's host interface. Used only for host LLD rules.<br><br>Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, dependent, database monitor and script LLD rules. Optional for HTTP agent LLD rules.| |**key\_**<br>(required)|string|LLD rule key.| |**name**<br>(required)|string|Name of the LLD rule.| |**type**<br>(required)|integer|Type of the LLD rule.<br><br>Possible values:<br>0 - Zabbix agent;<br>2 - Zabbix trapper;<br>3 - simple check;<br>5 - Zabbix internal;<br>7 - Zabbix agent (active);<br>10 - external check;<br>11 - database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - TELNET agent;<br>16 - JMX agent;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script.| |**url**<br>(required)|string|URL string, required for HTTP agent LLD rule. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |allow\_traps|integer|HTTP agent LLD rule field. Allow to populate value as in trapper item type also.<br><br>0 - *(default)* Do not allow to accept incoming data.<br>1 - Allow to accept incoming data.| |authtype|integer|Used only by SSH agent or HTTP agent LLD rules.<br><br>SSH agent authentication method possible values:<br>0 - *(default)* password;<br>1 - public key.<br><br>HTTP agent authentication method possible values:<br>0 - *(default)* none<br>1 - basic<br>2 - NTLM| |description|string|Description of the LLD rule.| |error|string|*(readonly)* Error text if there are problems updating the LLD rule value.| |follow\_redirects|integer|HTTP agent LLD rule field. Follow response redirects while polling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent LLD rule field. Object with HTTP(S) request headers, where header name is used as key and header value as value.<br><br>Example:<br>{ "User-Agent": "Zabbix" }| |http\_proxy|string|HTTP agent LLD rule field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI LLD rules.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lifetime|string|Time period after which items that are no longer discovered will be deleted. Accepts seconds, time unit with suffix and user macro.<br><br>Default: `30d`.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 999 are allowed.<br>Discovery rule cannot be master item for another discovery rule.<br><br>Required for Dependent item.| |output\_format|integer|HTTP agent LLD rule field. Should response be converted to JSON.<br><br>0 - *(default)* Store raw.<br>1 - Convert to JSON.| |params|string|Additional parameters depending on the type of the LLD rule:<br>- executed script for SSH and Telnet LLD rules;<br>- SQL query for database monitor LLD rules;<br>- formula for calculated LLD rules.| |parameters|array|Additional parameters for script type LLD rule. Array of objects with 'name' and 'value' properties, where name must be unique.| |password|string|Password for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules.| |post\_type|integer|HTTP agent LLD rule field. Type of post data body stored in posts property.<br><br>0 - *(default)* Raw data.<br>2 - JSON data.<br>3 - XML data.| |posts|string|HTTP agent LLD rule field. HTTP(S) request body data. Used with post\_type.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent LLD rule field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent LLD rule field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent LLD rule field. What part of response should be stored.<br><br>0 - *(default)* Body.<br>1 - Headers.<br>2 - Both body and headers will be stored.<br><br>For request\_method HEAD only 1 is allowed value.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|HTTP agent LLD rule field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent LLD rule field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent LLD rule field. Password for SSL Key file.| |state|integer|*(readonly)* State of the LLD rule.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the LLD rule.<br><br>Possible values:<br>0 - *(default)* enabled LLD rule;<br>1 - disabled LLD rule.| |status\_codes|string|HTTP agent LLD rule field. Ranges of required HTTP status codes separated by commas. Also supports user macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template LLD rule.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script LLD rules. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper LLD rules or HTTP agent LLD rules.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent LLD rules.<br><br>Required by SSH and Telnet LLD rules.| |uuid|string|Universal unique identifier, used for linking imported LLD rules to already existing ones. Used only for LLD rules on templates. Auto-generated, if not given.| |verify\_host|integer|HTTP agent LLD rule field. Whether to validate that the host name for the connection matches the one in the host's certificate.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |verify\_peer|integer|HTTP agent LLD rule field. Whether to validate that the host's certificate is authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Regla LLD  L'objecte de regla de descobriment de baix nivell té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|cadena|*(només de lectura)* ID de regla LLD.| |**delay**<br>(obligatori)|cadena|Interval d'actualització de regles LLD. Accepta segons o unitat de temps amb sufix i amb o sense un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) que consisteixen en intervals flexibles i intervals de programació com a cadenes serialitzades. També accepta macros d'usuari. Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada. Els intervals són separats per un punt i coma.<br><br>Opcional per a Zabbix trapper, elements dependents i per a l'agent Zabbix (actiu) amb la clau `mqtt.get`.| |**hostid**<br>(obligatori)|cadena|ID de l'equip al que pertany la regla LLD.| |**interfaceid**<br>(obligatori)|cadena|ID de la interfície de l'equip de la regla LLD. S'empra només per a les regles de LLD de l'equip.<br><br>No es calen per a les regles de LLD de l'agent Zabbix (actiu), Zabbix intern, trapper de Zabbix, dependent, monitor de base de dades i scripts. Opcional per a les regles LLD de l'agent HTTP.| |**clau\_**<br>(obligatori)|cadena|clau de regla LLD.| |**nom**<br>(obligatori)|cadena|Nom de la regla LLD.| |**tipus**<br>(obligatori)|enter|Tipus de regla LLD..<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br> 3 - comprovació simple;<br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>10 - comprovació externa;<br>11 - Monitor de base de dades;<br>12 - Agent IPMI ;<br> 13 - Agent SSH;<br>14 - Agent TELNET;<br>16 - Agent JMX;<br>18 - Element dependent;< br>19 - Agent HTTP;<br>20 - Agent SNMP;< br>21 - Guió.| |**url**<br>(obligatori)|cadena|cadena d'URL, necessària per a la regla LLD de l'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |allow\_traps|enteger|Camp de regla LLD de l'agent HTTP. També permet l'ampliació de valors com en el tipus d'element trapper.<br><br>0 - *(per defecte)* No permet acceptar dades entrants.<br>1 - Permet acceptar dades entrants.| |authtype|enteger|Només l'empren l'agent SSH o les regles LLD de l'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - passa mot de pas *(per defecte)*;<br>1 - clau pública.<br><br> Valors possibles del mètode d'autenticació de l'agent HTTP:<br>0 - *(per defecte)* cap<br >1 - bàsic<br>2 - NTLM| |descripció|cadena|Descripció de la regla LLD.| |error|cadena|*(només de lectura)* Text d'error si hi ha problemes per actualitzar el valor de la regla LLD.| |follow\_redirects|enteger|Camp de regla LLD de l'agent HTTP. Seguiu les redireccions de resposta en afegir dades.<br><br>0: No seguiu les redireccions.<br>1: *(per defecte)* Seguiu les redireccions.| |capçaleres|objecte|Camp de política LLD de l'agent HTTP. Objecte amb capçaleres de sol·licitud HTTP(S), on el nom de la capçalera s'empra com a clau i el valor de la capçalera com a valor.<br><br>Exemple:<br>{ " User-Agent": "Zabbix" }| |http\_proxy|string|Camp de regla LLD de l'agent HTTP. Cadena de connexió del proxy HTTP(S).| |ipmi\_sensor|string|sensor IPMI. S'empra només per les regles IPMI LLD.| |jmx\_endpoint|cadena|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi| |lifetime|string|Període després del qual s'eliminaran els elements que ja no es descobreixen. Accepta segons, unitat de temps amb sufix i macro d'usuari.<br><br>Per defecte: `30d`.| |master\_itemid|enteger|Identificador de l'element principal.<br>Es permet la recursivitat fins a 3 elements dependents i un nombre màxim d'elements dependents igual a 999.<br>La regla de descobriment no pot ser l'element principal d'una altra regla de descobriment.<br ><br> Obligatori per a l'element dependent.| |output\_format|enteger|Camp de regla LLD de l'agent HTTP. la resposta s'ha de convertir a JSON.<br><br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.| |params|string|Paràmetres addicionals en funció del tipus de regla LLD:<br>- script executat per a regles LLD SSH i Telnet;<br>- Consulta SQL per a regles de supervisió de bases de dades LLD;<br>- fórmula per a regles LLD calculades.| |parameters|array|Paràmetres addicionals per a la regla LLD semblant a un script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha de ser únic.| |password|cadena|Mot de pas per a l'autenticació. S'empra per a Simple Check, SSH, Telnet, Database Monitor, JMX LLD Rules i HTTP Agent.| |post\_type|enteger|Camp de regla LLD de l'agent HTTP. Tipus de cos de dades de publicació emmagatzemat a la propietat de publicacions.<br><br>0 - *(per defecte)* Dades en brut.<br>2 - Dades JSON.<br>3 - Dades XML.| |posts|cadena|Camp de política LLD de l'agent HTTP. HTTP(S) sol·licita dades del cos. S'empra amb post\_type.| |privatekey|string|Nom del fitxer de clau privada.| |publickey|string|Nom del fitxer de clau pública.| |query\_fields|array|Camp de regla LLD de l'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ser una cadena buida.| |request\_method|enteger|Camp de regla LLD de l'agent HTTP. Tipus de mètode de sol·licitud.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|enteger|Camp de regla LLD de l'agent HTTP. Quina part de la resposta s'ha d'emmagatzemar.<br><br>0 - *(per defecte)* Cos.<br>1 - Capçaleres.<br>2 - S'emmagatzemaran el cos i les capçaleres.< br><br>Per request\_method HEAD només es permet el valor 1.| |snmp\_oid|cadena|SNMP OID.| |ssl\_cert\_file|string|camp de política LLD de l'agent HTTP. Camí al fitxer de clau SSL pública.| |ssl\_key\_file|string|camp de política LLD de l'agent HTTP. Camí al fitxer de clau SSL privada.| |ssl\_key\_password|string|camp de política LLD de l'agent HTTP. Contrasenya per al fitxer de clau SSL.| |state|entier|*(només de lectura)* Estat de la regla LLD.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - no compatible.| |state|entier|Estat de la regla LLD.<br><br>Valors possibles:<br>0 - *(per defecte)* Regla LLD activada;<br>1 - Regla LLD desactivada.| |state\_codis|cadena|Camp de regla LLD de l'agent HTTP. Intervals de codis d'estat HTTP obligatoris separats per comes. També admet macros d'usuari com a part d'una llista separada per comes.<br><br>Exemple: 200.200-{$M},{$M},200-400| |templateid|string|(només de lectura) ID de regla LLD de la plantilla principal.| |timeout|string|Temps d'espera de la sol·licitud de consulta de dades d'element. S'empra per a l'agent HTTP i les regles d'script LLD. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s| |trapper\_hosts|string|Equips permesos. Emprat per les regles Trapper LLD o les regles LLD de l'agent HTTP.| |username|cadena|Nom d'usuari per a l'autenticació. S'empra per les regles LLD de Simple Check, SSH, Telnet, Database Monitor, JMX i HTTP Agent LLD.<br><br>Requerit per les regles SSH i Telnet LLD.| |uuid|string|Identificador únic universal, emprat per enllaçar les regles LLD importades amb les existents. S'empra només per a regles LLD en models. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només de lectura*.| |verify\_host|enteger|Camp de regla LLD de l'agent HTTP. Valida que el nom d'equip a l'URL es troba al camp Nom comú o al camp Nom alternatiu de l'assumpte del certificat d'equip.<br><br>0 - *(per defecte)* No validar. <br>1 - Validar. | |verify\_peer|enteger|Camp de regla LLD de l'agent HTTP. Vàlid si el certificat d'equip és autèntic.<br><br>0 - *(per defecte)* No validar.<br>1 - Validar.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# LLD rule  This class is designed to work with low level discovery rules.  Object references:\  -   [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule)  Available methods:\  -   [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) -     copying LLD rules -   [discoveryrule.create](/manual/api/reference/discoveryrule/create) -     creating new LLD rules -   [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) -     deleting LLD rules -   [discoveryrule.get](/manual/api/reference/discoveryrule/get) -     retrieving LLD rules -   [discoveryrule.update](/manual/api/reference/discoveryrule/update) -     updating LLD rules
ca	# Regla  Aquesta classe s'ha dissenyat per treballar amb regles de descoberta de baix nivell.  Referències d'objectes:\  -   [LLD rule](/manual/api/reference/discoveryrule/object#lld_rule)  Mètodes disponibles:\  -   [discoveryrule.copy](/manual/api/reference/discoveryrule/copy) -     copiant regles LLD -   [discoveryrule.create](/manual/api/reference/discoveryrule/create) -     creant noves regles LLD -   [discoveryrule.delete](/manual/api/reference/discoveryrule/delete) -     esborrant regles LLD -   [discoveryrule.get](/manual/api/reference/discoveryrule/get) -     recuperant regles LLD -   [discoveryrule.update](/manual/api/reference/discoveryrule/update) -     actualitzant regles LLD

en-us	 ### Loadable MongoDB plugin  MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*.   Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change. 
ca	### Plugin de MongoDB carregable  El [plugin MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) ja no forma part de l'agent Zabbix 2 i ara és disponible com a plugin carregable. La llista de versions de MongoDB compatibles s'ha ampliat a *2.6-5.3*.  La funcionalitat del connector i tots els [elements] admesos (/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) no han canviat.

en-us	 ### Loadable MongoDB plugin  MongoDB [plugin](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) is no longer part of Zabbix agent 2 and is now available as  a loadable plugin instead. List of supported MongoDB versions has been extended to *2.6-5.3*.   Plugin functionality and set of supported [items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) haven't change.   The MongoDB plugin, along with other loadable plugins which may potentially be added in the future, is stored in the new repository  [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). The package *zabbix-release* now adds this repository to the user's system.   To continue monitoring MongoDB on the installations from official Zabbix packages, update *zabbix-release* package and install *zabbix-agent2-plugin-mongodb* package.   Sources are available on [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/).
ca	### Connector de MongoDB carregable  El [connector MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md) ja no forma part de l'agent Zabbix 2 i ara és disponible com a connector carregable al lloc. La llista de versions de MongoDB compatibles s'ha ampliat a *2.6-5.3*.  La funcionalitat del connector i tots els [elements] admesos (/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#mongodb) no han canviat.  El connector MongoDB, juntament amb altres connectors carregables que es podrien afegir en el futur, s'emmagatzemen al nou repositori [zabbix-agent2-plugins](http://repo.zabbix.com/zabbix-agent2-plugins/). El paquet *zabbix-release* ara afegeix aquest dipòsit al sistema de l'usuari.  Per continuar monitorant MongoDB a les instal·lacions dels paquets oficials de Zabbix, actualitzeu el paquet *zabbix-release* i instal·leu el paquet *zabbix-agent2-plugin-mongodb*.  Les fonts són disponibles a [CDN](https://cdn.zabbix.com/zabbix-agent2-plugins/sources/mongodb/).

en-us	 #### Loadable  ::: notetip Loadable plugins, when launched with:<br> -   *-V --version* - print plugin version and license information;<br> -   *-h --help* - print help information. :::  Click on the plugin name to go to the plugin repository with additional information.  |Plugin name|Description|Supported item keys|Comments| |--|--|--|----| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MongoDB servers and clusters (document-based, distributed database).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats,<br>mongodb.db.stats, mongodb.db.discovery, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery, mongodb.version|This plugin is loadable since Zabbix 6.0.6 (built-in previously). Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) parameters.<br>Supported in plugin versions 1.2.0, 6.0.13 and newer^[1](#footnotes)^.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MongoDB plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/mssql/browse?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of MSSQL database.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|This plugin is supported since Zabbix 6.0.27. Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.4/6.4.13/) and are compatible with 6.0.27 version.<br><br>To configure encrypted connection to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters. Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [MSSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoring of PostgreSQL and its forks.|pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, pgsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br> pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec, pgsql.uptime, pgsql.version, pgsql.wal.stat |This plugin is loadable since Zabbix 6.0.10 (built-in previously). Pre-compiled plugin binaries for Windows are available since [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) and are compatible with previous 6.0 versions.<br><br>To configure encrypted connections to the database, specify the TLS parameters in the agent configuration file as [named session](#named_sessions) or [default](#default-values) parameters.<br>Currently, TLS parameters cannot be passed as item key parameters.<br><br>See also [PostgreSQL plugin configuration parameters](/manual/appendix/config/zabbix_agent2_plugins/postgresql_plugin#parameters).|  See also: [Building loadable plugins](/manual/config/items/plugins/build).
ca	#### Carregable  ::: notetip Connectors carregables, quan s'inicien amb:<br> - *-V --version* - mostra la versió del connector i la informació de la llicència;<br> - *-h --help* - mostra informació d'ajuda. :::  Feu clic al nom del connector per accedir al repositori de connectors amb informació addicional.  |Nom del connector|Descripció|Claus d'elements admesos|Comentaris| |--|--|--|----| |[MongoDB](https://git.zabbix.com/projects/AP/repos/mongodb/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Servidor MongoDB i monitoratge del clúster (document distribuït base de dades basada en -).|mongodb.collection.stats, mongodb.collections.discovery, mongodb.collections.usage, mongodb.connpool.stats, mongodb.jumbo\_chunks.count, mongodb.oplog.stats,<br>mongodb.ping, mongodb.rs.config, mongodb.rs.status, mongodb.server.status,<br>mongodb.sh.discovery, mongodb.version|Aquest connector es pot carregar des de Zabbix 6.0.6 (anteriorment integrat). Els binaris de plugins precompilats per windows són disponibles des de [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) i són compatibles amb les versions anteriors a la 6.0.<br><br>Per configurar connexions de base de dades xifrades, empreu [named-sessions](#named-sessions) i especifiqueu els paràmetres TLS per a la sessió anomenada al fitxer de configuració de l'agent.<br>Admet les versions del connector 1.2.1, 6.0.13 i posteriors^ [1](mongodb_plugin#footnotes)^.<br>Actualment, els paràmetres TLS no es poden passar com a paràmetres clau d'element.<br><br>Veieu també el [fitxer de configuració del connector MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin#parameters).| |[MSSQL](https://git.zabbix.com/projects/AP/repos/zabbix/browse/src/go/plugins/mssql/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge d'una base de dades MSSQL.|mssql.availability.group.get, mssql.custom.query, mssql.db.get, mssql.job.status.get, mssql.last.backup.get, mssql.local.db.get, mssql.mirroring.get, mssql.nonlocal.db.get, mssql.perfcounter.get, mssql.ping, mssql.quorum.get, mssql.quorum.member.get, mssql.replica.get, mssql.version|Aquest plugin s'admet des de Zabbix 6.0.27. Els binaris de plugins precompilats per a Windows són disponibles des de [Zabbix 6.0.28](https://cdn.zabbix.com/zabbix/binaries/stable/6.4/6.4.13/) i són compatibles amb la versió 6.0.27.<br><br>Per configurar connexió xifrada a la base de dades, especifiqueu els paràmetres TLS a l'arxiu de configuració de l'agent, paràmetres [sessió anomenada](#named_sessions) o [per defecte](#default-values). Actualment, els paràmetres TLS no es poden passar com a paràmetres de clau d'element.<br><br>Veieu també els [paràmetres de configuració del plugin d'MSSQL](/manual/appendix/config/zabbix_agent2_plugins/mssql_plugin#parameters).| |[PostgreSQL](https://git.zabbix.com/projects/AP/repos/postgresql/browse/README.md?at=refs%2Fheads%2Frelease%2F6.0)|Monitoratge de PostgreSQL i les seves bifurcacions. | pgsql.autovacuum.count, pgsql.archive, pgsql.bgwriter, pgsql.cache.hit, pgsql.connections,<br> pgsql.custom.query, pgsql.dbstat, pgsql.dbstat.sum, pgsql.db.age, plsql.db.bloating\_tables, <br> pgsql.db.discovery, pgsql.db.size, pgsql.locks, pgsql.oldest.xid, pgsql.ping, pgsql.queries, <br>pgsql.replication.count, pgsql.replication.process, pgsql.replication.process.discovery, pgsql.replication.recovery\_role, pgsql.replication.status, <br> pgsql.replication\_lag.b, pgsql.replication\_lag.sec., pgsql.uptime, pgsql.version, pgsql.wal.stat |Aquest connector es pot carregar des de Zabbix 6.0.10 (anteriorment inclòs). Els binaris de plugins precompilats per a Windows són disponibles des de [Zabbix 6.0.19](https://cdn.zabbix.com/zabbix/binaries/stable/6.0/6.0.19/) i són compatibles amb les versions anteriors a la 6.0.<br><br>Per configurar connexions de base de dades xifrades, empreu [named-sessions](#named-sessions) i especifiqueu la configuració de TLS per la sessió anomenada al fitxer de configuració dels agents. Actualment, els paràmetres TLS no es poden passar com a paràmetres clau d'element.|   Veieu també: [Creació de connectors carregables](/manual/config/items/plugins/build).

en-us	### Loadable plugins  ##### Encrypted MongoDB plugin connection  MongoDB plugin now supports TLS encryption when connecting to MongoDB using named sessions.   Updated plugin (MongoDB plugin 1.2.1) is included into Zabbix official packages starting from Zabbix 6.0.14. Note that MongoDB is a loadable plugin and can be installed separately either from packages or from sources. The plugin will work with any minor version of Zabbix 6.0. For more details see [MongoDB plugin](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin).
ca	## Plugins carregables  ### Connexió xifrada del connector MongoDB  El connector MongoDB ara admet el xifrat TLS quan es connecta a MongoDB mitjançant sessions amb nom.  El connector actualitzat (connector MongoDB 1.2.1) s'inclou als paquets oficials de Zabbix a partir de Zabbix 6.0.14. Tingueu en compte que MongoDB és un connector carregable i es pot instal·lar per separat dels paquets o fonts. El connector funcionarà amb qualsevol versió menor de Zabbix 6.0. Per obtindre més informació, vegeu [Connector MongoDB](/manual/appendix/config/zabbix_agent2_plugins/mongodb_plugin).

en-us	##### Load on I/O  Item's persistent file is updated after successful sending of every batch of data \(containing item's data\) to server.  For example, default 'BufferSize' is 100.  If a log item has found 70 matching records then the first 50 records will be sent in one batch, persistent file will be updated, then remaining 20 records will be sent \(maybe with some delay when more data is accumulated\) in the 2nd batch, and the persistent file will be updated again.
ca	##### Càrrega d' E/S  L'arxiu persistent de l'element s'actualitza després de l'enviament correcte de cada lot de dades \(que contenen les dades de l'element\) cap al servidor. Per exemple, 'BufferSize' per defecte és 100. Si un element de registre ha trobat 0 registres corresponents, els primers 0 s'enviaran en un sol lot, l'arxiu persistent s'actualitzarà, i els 20 registres restants s'enviaran \(potser amb un cert endarreriment quan s'acumulin més dades\) al  segon lot, i l'arxiu persistent serà actualitzat de nou.

en-us	#### Locale  Note that the agent requires a UTF-8 locale so that some textual agent items can return the expected content. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically.
ca	#### Entorn Local  Veieu que a l'agent li cal un entorn local UTF-8 per tal que determinats elements d'agent textuals retornar el contingut esperat. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament.

en-us	#### Locale  Note that the proxy requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically.
ca	#### Entorn Local  Veieu que al proxy li cal un entorn local UTF-8 per tal que determinats elements textuals puguin ésser interpretats correctament. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament.

en-us	#### Locale  Note that the server requires a UTF-8 locale so that some textual items can be interpreted correctly. Most modern Unix-like systems have a UTF-8 locale as default, however, there are some systems where that may need to be set specifically.
ca	#### Entorn Local  Veieu que al servidor li cal un entorn local UTF-8 per tal que determinats elements textuals puguin ésser interpretats correctament. La majoria dels sistemes moderns de tipus Unix tenen un paràmetre regional UTF-8 per defecte; de tota manera, alguns sistemes poden haver d'ésser definits específicament.

en-us	 ##### Log data  See additional information on [log monitoring](log_items).  |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**log**\[file,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Monitoring of a log file.|Log|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (since version 2.0)- possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>If file is missing or permissions do not allow access, item turns unsupported.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> log\[/var/log/syslog\]<br>=> log\[/var/log/syslog,error\]<br>=> log\[/home/zabbix/logs/logfile,,,100\]<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> log\[/app1/app.log,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> log\[/app1/app.log,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server. | |**log.count**\[file,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Count of matched lines in a monitored log file.|Integer|**file** - full path and name of log file<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.4.7) - additional options:<br>*mtime-noreread* - non-unique records, reread only if the file size changes (ignore modification time change). (This parameter is deprecated since 5.0.2, because now mtime is ignored.)<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br><br><br>Matching lines are counted in the new lines since the last log check by the agent, and thus depend on the item update interval.<br>If the file is missing or permissions do not allow access, item turns unsupported. <br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.| |**logrt**\[file\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Monitoring of a log file that is rotated.|Log|**file\_regexp** - absolute path to file and the file name described by a regular [expression](/manual/regular_expressions#overview). *Note* that only the file name is a regular expression<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxlines** - maximum number of new lines per second the agent will send to Zabbix server or proxy. This parameter overrides the value of 'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (since version 2.0) - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**output** (since version 2.2) - an optional output formatting template. The **\\0** escape sequence is replaced with the matched part of text (from the first character where match begins until the character where match ends) while an **\\N** (where N=1...9) escape sequence is replaced with Nth matched group (or an empty string if the N exceeds the number of captured groups).<br>**maxdelay** (since version 3.2) - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br>Log rotation is based on the last modification time of files.<br><br>Note that logrt is designed to work with one currently active log file, with several other matching inactive files rotated. If, for example, a directory has many active log files, a separate logrt item should be created for each one. Otherwise if one logrt item picks up too many files it may lead to exhausted memory and a crash of monitoring.<br><br>If `output` is left empty - the whole line containing the matched text is returned. Note that all global regular expression types except 'Result is TRUE' always return the whole matched line and the `output` parameter is ignored.<br><br>Content extraction using the `output` parameter takes place on the agent.<br><br>Examples:<br>=> logrt\["/home/zabbix/logs/\^logfile\[0-9\]{1,3}$",,,100\] → will match a file like "logfile1" (will not match ".logfile1")<br>=> logrt\["/home/user/\^logfile\_.\*\_\[0-9\]{1,3}$","pattern\_to\_match","UTF-8",100\] → will collect data from files such "logfile\_abc\_1" or "logfile\_\_001".<br><br>*Using `output` parameter for extracting a number from log record:*<br>=> logrt\[/app1/\^test.\*log$,"task run \[0-9.\]+ sec, processed (\[0-9\]+) records, \[0-9\]+ errors",,,,\\1\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send only '6080' to server. Because a numeric value is being sent, the "Type of information" for this item can be set to "Numeric (unsigned)" and the value can be used in graphs, triggers etc.<br><br>*Using `output` parameter for rewriting log record before sending to server:*<br>=> logrt\[/app1/\^test.\*log$,"(\[0-9 :-\]+) task run (\[0-9.\]+) sec, processed (\[0-9\]+) records, (\[0-9\]+) errors",,,,"\\1 RECORDS: \\3, ERRORS: \\4, DURATION: \\2"\] → will match a log record "2015-11-13 10:08:26 task run 6.08 sec, processed 6080 records, 0 errors" and send a modified record "2015-11-13 10:08:26 RECORDS: 6080, ERRORS: 0, DURATION: 6.08" to server. | |**logrt.count**\[file\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>,\<persistent\_dir\>\]|<|<|<| |Count of matched lines in a monitored log file that is rotated.|Integer|**file\_regexp** - absolute path to file and regular [expression](/manual/regular_expressions#overview) describing the file name pattern<br>**regexp** - regular [expression](/manual/regular_expressions#overview) describing the required content pattern<br>**encoding** - code page [identifier](/manual/config/items/itemtypes/zabbix_agent#encoding_settings)<br>**maxproclines** - maximum number of new lines per second the agent will analyze (cannot exceed 10000). Default value is 10\*'MaxLinesPerSecond' in [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).<br>**maxdelay** - maximum delay in seconds. Type: float. Values: 0 - (default) never ignore log file lines; > 0.0 - ignore older lines in order to get the most recent lines analyzed within "maxdelay" seconds. Read the [maxdelay](log_items#using_maxdelay_parameter) notes before using it!<br>**options** (since version 4.0; *mtime-reread*, *mtime-noreread* options since 4.4.7) - type of log file rotation and other options. Possible values:<br>*rotate* (default),<br>*copytruncate* - note that *copytruncate* cannot be used together with *maxdelay*. In this case *maxdelay* must be 0 or not specified; see [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation) notes,<br>*mtime-reread* - non-unique records, reread if modification time or size changes (default),<br>*mtime-noreread* - non-unique records, reread only if the size changes (ignore modification time change).<br>**persistent\_dir** (since versions 5.0.18, 5.4.9, only in zabbix\_agentd on Unix systems; not supported in Agent2) - absolute pathname of directory where to store persistent files. See also additional notes on [persistent files](log_items#notes-on-persistent-files-for-log-items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br><br>Matching lines are counted in the new lines since the last log check by the agent, and thus depend on the item update interval.<br><br>Log rotation is based on the last modification time of files. <br><br>This item is not supported for Windows Event Log.<br><br>Supported since Zabbix 3.2.0.|
ca	##### Informació del registre  Veieu informació addicional sobre els [elements de registre](log_items).  |Clau d'element|<|<|<| |--|--|-------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |**log**\[fitxer,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\<options\ >,\<persistent\_dir\>\]|<|<|<| |Monitoratge d'un fitxer de registre.|Registre|**fitxer** - camí complet i nom del fitxer de registre<br>**regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el patró necessari< br >**encoding** - pàgina de codis [id](/manual/config/items/itemtypes/zabbix_agent#encoding_settings) <br>**maxlines** - nombre màxim de noves línies per segon que l'agent enviarà al servidor o al proxy Zabbix. Aquest paràmetre substitueix el valor de 'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (des de la versió 2.0)- valors possibles:<br>*tots* (per defecte), *skip* - Omet el processament de dades més antigues (només afecta els elements de creació recent).<br>**sortida** (des de la versió 2.2) - un patró de format de sortida opcional. La seqüència d'escapada **\\0** es substitueix per la part corresponent del text (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un **\\N** (on N=1 ...9) la seqüència d'escapada es substitueix per l'enèssim grup de concordança (o una cadena buida si la N supera el nombre de grups capturats).<br>**maxdelay** (des de la versió 3.2 ) - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; > 0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - opcions addicionals:<br>*mtime-noreread* - registres no únics, només reproduïts si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, ja que ara s'ignora mtime.)<br>**persistent\_dir** (des de 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2 ) - nom de camí absolut del directori on s'emmagatzemen els fitxers persistents. Vegeu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br>Si manca el fitxer o els permisos no permeten l'accés, l'element ja no s'admet.<br><br>Si "sortida" es deixa en blanc, es retorna tota la línia que conté el text coincident. Tingueu en compte que tots els tipus d'expressions regulars globals, excepte "El resultat és TRUE", sempre retornen tota la fila coincident i el paràmetre "output" s'ignora.<br><br>L'extracció de contingut per emprar el paràmetre "output" es fa a l'agent.< br <br>Exemples:<br>=> registre\[/var/log/syslog\]<br>=> registre\[/var/log /syslog,error\]<br>=> registre\[/home /zabbix/logs/logfile,,,100\]<br><br>*Emprar el paràmetre `output` per extreure un número del registre de registre:*<br>=> log\[/app1/app.log, "execució de la tasca \[0-9.\]+ seg, registres processats (\[0-9\]+), \[0 -9\]+ errors",,,,\\1\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processats 6080 registres, 0 errors" i només enviarà més de '6080' al servidor. Com que s'envia un valor numèric, el "Tipus d'informació" d'aquest element es pot establir en "Numèric (sense signe)" i el valor es pot emprar en gràfics, triggers, etc.<br>< br>*Emprant la "sortida" paràmetre per sobreescriure el registre de registre abans d'enviar-lo al servidor:*<br>=> log\[/app1/app.log,"(\[0-9 :-\ ]+) execució de la tasca (\[0-9 .\]+) segons, registres processats (\[0-9\]+), errors (\[0-9\]+),,,,"\\ 1 REGISTRES: \\3, ERRORS: \\ 4, DURADA: \\2"\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processats 6080 registres, 0 errors " i enviarà un registre modificat "2015-11- 13 10:08:26 REGISTRES: 6080, ERRORS: 0, DURADA: 6,08" al servidor.| |**log.count**\[fitxer,\<regexp\>,\<codificació\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<opcions\>,\< persistent\_dir\>\]|<|<|<| |Nombre de línies coincidents al fitxer de registre monitorat.|Enter|**fitxer** - camí complet i nom del fitxer de registre<br>**regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el patró necessari<br>**encoding** - [id](/manual/config/items/itemtypes/zabbix_agent#encoding_settings) de la pàgina de codi<br>**maxproclines** - nombre màxim de línies noves per segon que l'"agent escanejarà (no pot superar les 10.000). El valor per defecte és 10\*'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - valors possibles:<br>*all* (predeterminat), *skip* - Omet el processament de dades més antigues (només afecta els elements de nova creació). <br>**maxdelay** - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; >0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - opcions addicionals:<br>*mtime-noreread* - registres no únics, només reproduïts si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, ja que ara s'ignora mtime.)<br>**persistent\_dir** (des de 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2) - nom de camí absolut del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br><br><br>Les files coincidents es compten en fileres noves des que l'agent va comprovar el registre per darrer cop i, per tant, depenen de l'interval d'actualització de l'element.<br>Si manca el fitxer o els permisos no permeten l'accés, l'element queda sense suport.<br><br>Aquest element no és compatible amb el registre d'esdeveniments de Windows.<br><br>S'admet des de Zabbix 3.2.0.| |**logrt**\[fitxer\_regexp,\<regexp\>,\<encoding\>,\<maxlines\>,\<mode\>,\<output\>,\<maxdelay\>,\< opcions\>,\<persistent\_dir\>\]|<|<|<| |Monitoratge d'un fitxer de registre rotatiu.|Registre|**fitxer\_regexp** - camí absolut al fitxer i el nom del fitxer descrit per una [expressió regular](/manual/regular_expressions#overview). *Tingueu en compte* que només el nom del fitxer és una expressió regular<br>**regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el model de contingut necessari<br>**codificació** - [identificador] (/manual/config/items/itemtypes/zabbix_agent#encoding_settings) pàgina de codis <br>**maxlines** - nombre màxim de línies noves per segon que l'agent s'enviarà al servidor o al proxy Zabbix. Aquest paràmetre substitueix el valor de 'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd)<br>**mode** (des de la versió 2.0)- valors possibles:<br>*tots* (per defecte), *skip* - Omet el processament de dades més antigues (només afecta els elements de creació recent).<br>**sortida** (des de la versió 2.2) - un patró de format de sortida opcional. La seqüència d'escapada **\\0** es substitueix per la part corresponent del text (des del primer caràcter on comença la coincidència fins al caràcter on acaba la coincidència), mentre que un **\\N** (on N=1 ...9) la seqüència d'escapada es substitueix per l'enèssim grup de concordança (o una cadena buida si l'N supera el nombre de grups capturats).<br>**maxdelay** (des de la versió 3.2 ) - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; > 0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - opcions addicionals:<br>*mtime-noreread* - registres no únics, només reproduïts si la mida del fitxer canvia (ignora el canvi d'hora de modificació). (Aquest paràmetre és obsolet des de la 5.0.2, ja que ara s'ignora mtime.)<br>**persistent\_dir** (des de 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2) - nom de camí absolut del directori on s'emmagatzemen els fitxers persistents. Veieu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br>La rotació del registre es basa en l'hora en què es van modificar els fitxers per darrer cop.<br><br>Tingueu en compte que logrt és actualment dissenyat per funcionar amb un fitxer de registre actiu, juntament amb diversos altres fitxers que giren inactius corresponents. Si, per exemple, un directori conté molts fitxers de registre actius, s'hauria de crear un element logrt separat per cadascun. En cas contrari, si un element logrt recupera massa fitxers, pot provocar l'esgotament de la memòria i una fallada del monitor.<br><br>Si `output` es deixa buit, es retorna la línia sencera que conté el text coincident. Tingueu en compte que tots els tipus d'expressions de respostes regulars globals, excepte "El resultat és TRUE", sempre retornen tota la filera coincident i el paràmetre `output` s'ignora.<br><br>L'extracció de contingut mitjançant el `output parameter ` es fa a l'agent.<br <br>Exemples:<br>=> logrt\["/home/zabbix/logs/\^logfile\[0-9\]{1,3}\$", ,,100\] → coincidirà amb un fitxer com "logfile1" (no coincidirà amb ".logfile1")<br>=> logrt\["/home/user/\^logfile\_.\*\_\[ 0-9\]{1,3}\$"," pattern\_to\_match","UTF-8",100\] → recopilarà dades de fitxers com "logfile\_abc\_1" o "logfile\_\_001".<br><br>*Usant la sortida ` ` paràmetre per extreure un número del registre de registre:*<br>=> logrt\[/app1/\^test.\*log \$,"execució de la tasca \[0-9.\]+ s, processada (\ [0-9\]+) registres, \[0-9\]+ errors",,,,\\1\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, ha processat 6080 registres, 0 errors" i només envia '6080' al servidor. Com que s'envia un valor numèric, el "Tipus d'informació" d'aquest element es pot establir en "Numèric (sense signe)" i el valor es pot emprar en gràfics, triggers, etc.<br>< br>*Empreu el paràmetre `output` per reescriure el registre de registre abans d'enviar-lo al servidor:*<br>=> logrt\[/app1/\^test.\*log\$,"(\[0 -9 :-\]+) execució de la tasca (\[0 -9.\]+) segons, registres processats (\[0-9\]+), errors (\[0-9\]+),, ,,"\\1 REGISTRES: \\3, ERRORS: \\4, DURADA: \\2"\] → coincidirà amb un registre de registre "2015-11-13 10:08:26 tasca executada 6,08 segons, processat 6080 registres, 0 errors" i enviarà un registre editat "2015- 11-13 10:08:26 REGISTRES: 6080, ERRORS: 0, DURADA: 6,08" al servidor. | |**logrt.count**\[fitxer\_regexp,\<regexp\>,\<encoding\>,\<maxproclines\>,\<mode\>,\<maxdelay\>,\<options\>, \<persistent\_dir\>\]|<|<|<| |Nombre de línies coincidents en un fitxer de registre monitorat que s'és girant.|Enter|**fitxer\_regexp** - camí absolut al fitxer i [expressió regular](/manual/regular_expressions#overview) que descriu el patró del nom del fitxer<br> **regexp** - [expressió regular](/manual/regular_expressions#overview) que descriu el patró de contingut necessari<br>**encoding** - [id](/manual/config /items/itemtypes/zabbix_agent#encoding_settings) codi pàgina<br>**maxproclines** - nombre màxim de noves línies per segon que l'agent analitzarà (no pot superar les 10.000). El valor per defecte és 10\*'MaxLinesPerSecond' a [zabbix\_agentd.conf](/manual/appendix/config/zabbix_agentd).<br>**mode** - valors possibles:<br>*all* (per defecte), *skip* - Omet el processament de dades més antigues (només afecta els elements de creació recent).<br>**maxdelay** - retard màxim en segons. Tipus: flotant. Valors: 0 - (per defecte) no saltar mai les línies del fitxer de registre; > 0.0: saltar línies més antigues per analitzar línies més noves en "maxdelay" segons. Llegiu les notes [maxdelay](log_items#using_maxdelay_parameter) abans d'emprar-lo!<br>**opcions** (des de la versió 4.4.7) - tipus de rotació del fitxer de registre i altres opcions. Valors possibles:<br>*rotate* (per defecte),<br>*copytruncate*: tingueu en compte que *copytruncate* no es pot emprar amb *maxdelay*. En aquest cas, *maxdelay* ha d'ésser 0 o no especificat; veieu les notes de  [copytruncate](log_items#notes_on_handling_copytruncate_log_file_rotation),<br>*mtime-reread* - registres no únics, rellegir si el temps de modificació o la mida canvia (per defecte),<br>*mtime-noreread* - registres no únics, es reprodueix només si la mida canvia (ignora el canvi de temps de modificació).<br>**persistent\_dir** (des de les versions 5.0.18, 5.4.9, només a zabbix\_agentd en sistemes Unix; no és compatible amb Agent2) - camí absolut al directori on emmagatzemar els fitxers persistents. Veieu també notes addicionals sobre [fitxers persistents](log_items#notes-on-persistent-files-for-log-items).|L'element s'ha de configurar com a [comprovació activa](/manual/appendix/items /activepassive#active_checks). <br><br>Les fileres coincidents es compten en fileres noves des que l'agent va comprovar el registre per darrera vegada i, per tant, depenen de l'interval d'actualització de l'element.<br ><br>La rotació del registre es basa en la darrera modificació dels fitxers. <br><br>Aquest element no és compatible amb el registre d'esdeveniments de Windows.<br><br>S'admet des de Zabbix 3.2.0.|

en-us	### Log entry  The log entry object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |level|integer|Log level.| |ms|string|The time elapsed in milliseconds since the script was run before log entry was added.| |message|string|Log message.|
ca	### Entrada de registre  L'objecte d'entrada de registre té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |level|integer|Nivell de registre.| |ms|string|Temps transcorregut en mil·lisegons des que s'executa l'script abans que s'afegeix l'entrada de registre.| |message|string|Missatge de registre.|

en-us	 #### Log file monitoring  For `log[]`, `logrt[]`, `log.count[]`, `logrt.count[]` items, regular expression runtime errors are now logged in the Zabbix agent log file.  See [more details](/manual/config/items/itemtypes/log_items#handling-of-regular-expression-compilation-and-runtime-errors).
ca	 #### Monitoratge del fitxer de registre  Per als elements `log[]`, `logrt[]`, `log.count[]`, `logrt.count[]`, els errors d'execució d'expressions regulars ara es registren al fitxer de registre de l'agent Zabbix. Veieu [més detalls](/manual/config/items/itemtypes/log_items#handling-of-regular-expression-compilation-and-runtime-errors).

en-us	#### Log file monitoring  `log[]` and `logrt[]` items repeatedly reread log file from the beginning if file system is 100% full and the log file is being appended (see [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884) for more information).
ca	#### Monitoratge dels arxius de registre  Els elements `log[]` i `logrt[]` reprodueixen repetidament el fitxer de registre des del principi si el sistema de fitxers és ple al 100% i el fitxer de registre és en mode d'adjuntar (veieu [ZBX-10884](https://support.zabbix.com/browse/ZBX-10884) per obtindre més informació).

en-us	##### Logging  Add the "Log test" entry to the Zabbix server log and receive the item value "1" in return:  -   Create an item with type "Script". -   In the *Script* field, enter:  ```javascript Zabbix.log(3, 'Log test'); return 1; ```
ca	##### Registre  Afegir "Log test" a l'arxiu de registre del servidor Zabbix i rebre el valor de l'element "1" de tornada:  - Crear un element de tipus "Script".\ - Al camp *Script*, poseu-hi el codi següent:  ```javascript Zabbix.log(3, 'Log test'); return 1; ```

en-us	#### Logging out  Log out from the API.  Request:  ```json {     "jsonrpc": "2.0",     "method": "user.logout",     "params": [],     "id": 1,     "auth": "16a46baf181ef9602e1687f3110abf8a" } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```
ca	#### Desconnectar  Desconnectar de l'API.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "user.logout",     "params": [],     "id": 1,     "auth": "16a46baf181ef9602e1687f3110abf8a" } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": true,     "id": 1 } ```

en-us	### Log history  The log history object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the history entry.| |clock|timestamp|Time when that value was received.| |itemid|string|ID of the related item.| |logeventid|integer|Windows event log entry ID.| |ns|integer|Nanoseconds when the value was received.| |severity|integer|Windows event log entry level.| |source|string|Windows event log entry source.| |timestamp|timestamp|Windows event log entry time.| |value|text|Received value.|
ca	### Històric dels registres  L'objecte històric de registre té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |id|string|ID de l'entrada d'històric.| |clock|timestamp|Hora quan es va rebre el valor.| |itemid|string|ID de l'element relacionat.| |logeventid|integer|ID d'entrada al registre d'esdeveniments de Windows.| |ns|integer|Nanosegons de quan es va rebre el valor.| |severity|integer|Nivell d'entrada al registre d'esdeveniments de Windows.| |source|string|Font de l'entrada al registre d'esdeveniments de Windows.| |timestamp|timestamp|Hora d'entrada al registre d'esdeveniments de Windows.| |value|text|Valor rebut.|

en-us	#### Login and systemd  We recommend [creating](/manual/installation/install#create_user_account) a *zabbix* user as system user, that is, without ability to log in. Some users ignore this recommendation and use the same account to log in (e. g. using SSH) to host running Zabbix. This might crash Zabbix daemon on log out. In this case you will get something like the following in Zabbix server log:      zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument     zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument     zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument  and in Zabbix agent log:      zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument  This happens because of default systemd setting `RemoveIPC=yes` configured in `/etc/systemd/logind.conf`. When you log out of the system the semaphores created by Zabbix previously are removed which causes the crash.  A quote from systemd documentation:      RemoveIPC=      Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the     user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources     after the last of the user's sessions terminated. This covers System V semaphores, shared memory     and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the     root user and other system users are excluded from the effect of this setting. Defaults to "yes".  There are 2 solutions to this problem:  1.  (recommended) Stop using *zabbix* account for anything else than     Zabbix processes, create a dedicated account for other things. 2.  (not recommended) Set `RemoveIPC=no` in `/etc/systemd/logind.conf`     and reboot the system. Note that `RemoveIPC` is a system-wide     parameter, changing it will affect the whole system.
ca	#### Connexió i systemd  Recomanem [crear](/manual/installation/install#create_user_account) un usuari *zabbix* com a usuari del sistema, sense possibilitat de connectar-s'hi. Alguns usuaris ignoren la recomanació i empren el mateix compte per connectar-se (per exemple per SSH) a l'equip on hi ha el Zabbix. Això pot tombar el dimoni Zabbix després al desconnectar. En aquest cas, tindreu alguna cosa com això, al registre del servidor Zabbix:      zabbix_server [27730]: [file:'selfmon.c',line:375] lock failed: [22] Invalid argument     zabbix_server [27716]: [file:'dbconfig.c',line:5266] lock failed: [22] Invalid argument     zabbix_server [27706]: [file:'log.c',line:238] lock failed: [22] Invalid argument  i al registre de l'agent Zabbix:      zabbix_agentd [27796]: [file:'log.c',line:238] lock failed: [22] Invalid argument  Això passa per el paràmetre per defecte de systemd `RemoveIPC=yes` configurat a `/etc/systemd/logind.conf`. Quan sortiu del sistema, els semàfors creats per Zabbix s'esborren, i provoquen l'errada.  Una frase de la documentació de systemd:      RemoveIPC=      Controls whether System V and POSIX IPC objects belonging to the user shall be removed when the     user fully logs out. Takes a boolean argument. If enabled, the user may not consume IPC resources     after the last of the user's sessions terminated. This covers System V semaphores, shared memory     and message queues, as well as POSIX shared memory and message queues. Note that IPC objects of the     root user and other system users are excluded from the effect of this setting. Defaults to "yes".  Hi ha dues solucions per aquest problema:  1.  (recomanada) Deixeu d'emprar el compte *zabbix* per qualsevol cosa que no siguin els processos de Zabbix, i creeu un altre compte per fer qualsevol altra tasca. 2.  (no recomanada) Definiu `RemoveIPC=no` dans `/etc/systemd/logind.conf` i reinicieu el sistema. Fixeu-vos que `RemoveIPC` és un paràmetre de tot el sistema, modificar-lo afectarà a tot el sistema.

en-us	#### Login  ![](../../../assets/en/manual/quickstart/login.png){width="350"}  This is the Zabbix welcome screen. Enter the user name **Admin** with password **zabbix** to log in as a [Zabbix superuser](/manual/config/users_and_usergroups/permissions). Access to *Configuration* and *Administration* menus will be granted.
ca	#### Autenticació  ![](../../../assets/en/manual/quickstart/login.png){width="350"}  Aquesta és la pantalla \"Benvingut\" de Zabbix. Introduïu el nom d'usuari **Admin** amb el mot de pas **zabbix** per identificar-vos com a [superusuari de Zabbix](/manual/config/users_and_usergroups/permissions).  Quan hagueu iniciat la sessió, veureu "Heu iniciat sessió com a administrador" a l'extrem inferior dret de la pàgina. S'autoritzarà l'accés als menús de *Configuració* i *Administració*.

en-us	#### Log in  Zabbix frontend is ready! The default user name is **Admin**, password **zabbix**.  ![](../../../assets/en/manual/quickstart/login.png){width="350"}  Proceed to [getting started with Zabbix](/manual/quickstart/login).
ca	#### Connexió  La interfície de Zabbix és llesta! El nom d'usuari per defecte és **Admin**, i el mot de pas **zabbix**.  ![](../../../assets/en/manual/quickstart/login.png){width="350"}  I ara, [engegueu amb Zabbix](/manual/quickstart/login).

en-us	###      Log level control targets     *process-type*   All processes of specified type (active checks, collector, listener)     *process-type,N*   Process type and number (e.g., listener,3)     *pid*   Process identifier, up to 65535. For larger values specify target as "process-type,N"  ```{=html} <!-- --> ``` **-p**, **--print**   Print known items and exit. For each item either generic defaults are used, or specific defaults for testing are supplied. These defaults are listed in square brackets as item key parameters. Returned values are enclosed in square brackets and prefixed with the type of the returned value, separated by a pipe character. For user parameters type is always **t**, as the agent can not determine all possible return values. Items, displayed as working, are not guaranteed to work from the Zabbix server or zabbix\_get when querying a running agent daemon as permissions or environment may be different. Returned value types are:     d   Number with a decimal part.     m   Not supported. This could be caused by querying an item that only works in the active mode like a log monitoring item or an item that requires multiple collected values. Permission issues or incorrect user parameters could also result in the not supported state.     s   Text. Maximum length not limited.     t   Text. Same as **s**.     u   Unsigned integer.  **-t**, **--test** *item-key*   Test single item and exit. See **--print** for output description.  **-h**, **--help**   Display this help and exit.  **-V**, **--version**   Output version information and exit.  [ ]{#lbAH}
ca	###      Objectes de control del nivell de registre     *process-type*   Tots els processos especificats per tipus (checks actius, colectors, a l'escolta)     *process-type,N*   Tipus de procés i nombre (ex., listener,3)     *pid*   Identificador del procés; fins a 65535. Per a valors més grans, especifiqueu el destí com a "process-type,N"  ```{=html} <!-- --> ``` **-p**, **--print**   Mostra els elements coneguts i surt. Per cada element, s'usen els valors per defecte; o els valors que s'hagin especificat. Aquests valors per defecte es llisten entre parèntesi com a paràmetres de clau d'element. Retorna els valors entre claudàtors i prefixats amb el tipus del valor retornat, separat amb una pleca (|). Per paràmetres d'usuari, el tipus és sempre **t**, doncs l'agent no pot pas determinar tots els valors de retorn possibles. Els elements, mostrats engegats, no garanteix que funcionin des del servidor de Zabbix o zabbix\_get quan un dimoni d'agent en execució en fa la consulta, doncs els permisos de l'entorn podrien ésser diferents. Els valors que retorna són:     d   Nombre amb una part decimal.     m   No compatible. Això pot ser causat per la consulta d'un element que només funciona en el mode actiu, com un element de control de registre o un element que requereix múltiples valors recollits. Problemes de permís o usuari incorrecte els paràmetres també podrien donar lloc a l'estat no compatible.     s   Text. Longitud màxima no limitada.     t   Text. Igual que **s**.     u   Enter sense signe.  **-t**, **--test** *item-key*   Prova un sol element i surt. Vegeu **--print** per a la descripció de la sortida.  **-h**, **--help**   Mostra aquesta ajuda i surt.  **-V**, **--version**   Informació de la versió de sortida, i surt.  [ ]{#lbAH}

en-us	###      Log level control targets     *process-type*   All processes of specified type (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector)     *process-type,N*   Process type and number (e.g., poller,3)     *pid*   Process identifier, up to 65535. For larger values specify target as "process-type,N"  ```{=html} <!-- --> ```   [ ]{#lbAH}
ca	###      Fites de control del nivell de registre     *process-type*   Tots els processos del tipus especificat (alerter, alert manager, configuration syncer, discoverer, escalator, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, lld manager, lld worker, poller, preprocessing manager, preprocessing worker, proxy poller, self-monitoring, snmp trapper, task manager, timer, trapper, unreachable poller, vmware collector)     *process-type,N*   Tipus i nombre de procés (p.e., poller,3)     *pid*   Identificador de procés (fins a 65535). Per a valors més grans, especificar el destí com a "process-type,N"  ```{=html} <!-- --> ```   [ ]{#lbAH}

en-us	###      Log level control targets     *process-type*   All processes of specified type (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector)     *process-type,N*   Process type and number (e.g., poller,3)     *pid*   Process identifier, up to 65535. For larger values specify target as "process-type,N"  ```{=html} <!-- --> ``` **-h**, **--help**   Display this help and exit.  **-V**, **--version**   Output version information and exit.  [ ]{#lbAH}
ca	###      Fite de control del nivell de registre     *process-type*   Tots els processos del tipus especificat (configuration syncer, data sender, discoverer, heartbeat sender, history syncer, housekeeper, http poller, icmp pinger, ipmi manager, ipmi poller, java poller, poller, self-monitoring, snmp trapper, task manager, trapper, unreachable poller, vmware collector)     *process-type,N*   Tipus i nombre de procés (p.e., poller,3)     *pid*   Identificador del procés; fins a 65535. Per a valors superiors, especificar el destí com a "tipus de procés,N"  ```{=html} <!-- --> ``` **-h**, **--help**   Mostrar aqueseta ajuda i sortir.  **-V**, **--version**   Mostrar la informació de versió i sortir.  [ ]{#lbAH}

en-us	 ###### Log request  A request sent by a plugin to write a log message into the agent log file.  |   |   | |---|---| |direction|plugin → agent| |response|no|  Parameters specific to log requests:  |Name|Type|Comments| |---------|--------|----------| |severity|uint32|The message severity (log level).| |message|string|The message to log.|  *Example:*      {"id":0,"type":1,"severity":3,"message":"message"}
ca	###### Petició de registre  Petició enviada per un plug-in per escriure un missatge de registre a l'arxiu registre de l'agent.  |   |   | |---|---| |direction|plugin → agent| |response|no|  Paràmetres específics de les peticions de registre:  |Nom|Tipus|Comentaris| |---------|--------|----------| |severity|uint32|La gravetat del missatge (nivell de registre).| |message|string|El missatge a registrar.|  *Exemple:*      {"id":0,"type":1,"severity":3,"message":"message"}

en-us	#### Logrotate for Zabbix server and proxy  The logrotate utility is only included into packages for zabbix-agent, zabbix-agent2 and zabbix-web-service, but needs to be installed separately for Zabbix server and proxy. The logrotate dependency has been added to the server and proxy packages for RHEL and SUSE starting from Zabbix 6.4.4rc1.
ca	#### Logrotate per al servidor i proxy Zabbix  La utilitat de rotació de registres (logrotate) només s'inclou als paquets per a zabbix-agent, zabbix-agent2 i zabbix-web-service, però s'ha d'instal·lar per separat per al servidor Zabbix i al proxy. La dependència logrotate s'ha afegit als paquets de servidor i proxy per a RHEL i SUSE a partir de Zabbix 6.4.4rc1.

en-us	##### Log rotation  Zabbix does not provide any log rotation system - that should be handled by the user. The log rotation should first rename the old file and only later delete it so that no traps are lost:\  1.  Zabbix opens the trap file at the last known location and goes to     step 3 2.  Zabbix checks if the currently opened file has been rotated by     comparing the inode number to the defined trap file's inode number.     If there is no opened file, Zabbix resets the last location and goes     to step 1. 3.  Zabbix reads the data from the currently opened file and sets the     new location. 4.  The new data are parsed. If this was the rotated file, the file is     closed and goes back to step 2. 5.  If there was no new data, Zabbix sleeps for 1 second and goes back     to step 2.
ca	##### Rotació dels registres  Zabbix no proporciona cap sistema de rotació de registres: ha d'ésser gestionat per l'usuari. En rotar el registre, primer hauria de canviar el nom del fitxer antic i només esborrar-lo més tard perquè no es perdi cap informació:\  1. Obriu el fitxer Zabbix a la darrera ubicació coneguda i aneu a la passa 3 2. Zabbix comprova si el fitxer obert actualment s'ha rotat comparant el nombre d'inode amb el nombre d'inode del fitxer trap definit. Si no hi ha cap fitxer obert, Zabbix restableix la darrera ubicació i passa a la passa 1. 3. Zabbix llegeix les dades del fitxer actualment obert i estableix la nova ubicació. 4. S'analitzen les noves dades. Si aquest era el fitxer rotat, el fitxer es tanca i torna a la passa 2. 5. Si no hi ha dades noves, Zabbix s'atura durant 1 segon i torna a la passa 2.

en-us	#### Low-level discovery  Configure low-level discovery rules as well as item, trigger and graph prototypes to monitor dynamic entities.  [LLD rule API](/manual/api/reference/discoveryrule) | [Item prototype API](/manual/api/reference/itemprototype) | [Trigger prototype API](/manual/api/reference/triggerprototype) | [Graph prototype API](/manual/api/reference/graphprototype) | [Host prototype API](/manual/api/reference/hostprototype)
ca	#### Descoberta de baix nivell  Configurar les regles de descoberta a baix nivell, així com els prototipus d'elements, triggers i els prototipus de gràfics; per monitorar les entitats dinàmiques.  [API Regla de descoberta de baix nivell](/manual/api/reference/discoveryrule) |  [API Prototip d'element](/manual/api/reference/itemprototype) | [API Prototip de trigger](/manual/api/reference/triggerprototype) | [API Prototip de gràfic](/manual/api/reference/graphprototype) | [API Prototip d'equip](/manual/api/reference/hostprototype)

en-us	#### Low-level discovery  In a [low-level discovery rule](/manual/discovery/low_level_discovery#configuring_low-level_discovery), user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Key parameters|<|yes| |Update interval|<|no| |Custom interval|<|no| |Keep lost resources period|<|no| |Description|<|yes| |*SNMP agent*|<|<| | |SNMP OID|yes| |*SSH agent*|<|<| | |Username|yes| |^|Public key file|yes| |^|Private key file|yes| |^|Password|yes| |^|Script|yes| |*TELNET agent*|<|<| | |Username|yes| |^|Password|yes| |^|Script|yes| |*Zabbix trapper*|<|<| | |Allowed hosts|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*HTTP agent*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|yes| |^|Query fields|yes| |^|Timeout|no| |^|Request body|yes| |^|Headers (names and values)|yes| |^|Required status codes|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |*Filters*|<|<| | |Regular expression|yes| |*Overrides*|<|<| | |Filters: regular expression|yes| |^|Operations: update interval (for item prototypes)|no| |^|Operations: history storage period (for item prototypes)|no| |^|Operations: trend storage period (for item prototypes)|no|
ca	#### Descoberta de baix nivell  En una [regla de descoberta de baix nivell](/manual/discovery/low_level_discovery#configuring_low-level_discovery), les macros d'usuari es poden emprar als camps següents:  |Ubicació|<|Múltiples macros/barreja amb text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Paràmetres de clau|<|sí| |Interval d'actualització|<|no| |Intervals personalitzats|<|no| |Període d'emmagatzematge dels recursos perduts|<|no| |Descripció|<|sí| |*Agent SNMP*|<|<| | |OID SNMP|sí| |*Agent SSH*|<|<| | |Nom d'usuari|sí| |^|Arxiu de clau pública|sí| |^|Arxiu de clau privada|sí| |^|Paraula de pas|sí| |^|Script|sí| |*Agent TELNET*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Script|sí| |*Trap Zabbix*|<|<| | |Equips autoritzats|sí| |*Monitoratge de base de dades*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Petició SQL|sí| |*Agent JMX*|<|<| | |Punt d'acabament JMX|sí| |*Agent HTTP*|<|<| | |URL^[3](supported_by_location_user#footnotes)^|sí| |^|Camps de petició|sí| |^|Temps d'espera|no| |^|Cos de la petició|sí| |^|Capçalera (noms i valors)|sí| |^|Codis d'estat demanats|sí| |^|Nom d'usuari d'autenticació HTTP|sí| |^|Mot de pas d'autenticació HTTP|sí| |*Filtres*|<|<| | |Expressió regular|sí| |*Anul·lar*|<|<| | |Filtres: Expressió regular|sí| |^|Operacions: interval d'actualització (per als prototips d'elements)|no| |^|Operacions: període d'emmagatzematge de l'històric (per als prototips d'elements)|no| |^|Operacions: període d'emmagatzematge de les tendències (per als prototips d'elements)|no|

en-us	#### Low-level discovery macros  Even though no low-level discovery macros are created in the returned JSON, these macros can be defined by the user as an additional step, using the [custom LLD macro](/manual/discovery/low_level_discovery#custom_macros) functionality with JSONPath pointing to the discovered values in the returned JSON.  The macros then can be used to create item, trigger, etc prototypes.
ca	#### Macros de descoberta de baix nivell  Tot i que no es creen macros de descoberta de baix nivell al JSON retornat, l'usuari pot definir aquestes macros com a passa addicional, emprant [macros LLD personalitzades](/manual/discovery/low_level_discovery# custom_macros) amb un JSONPath que apunta a alors descoberts al JSON retornat.  Aleshores, les macros es poden emprar per crear prototips d'elements, triggers, etc.

en-us	 #### Macro functions  The range of the `fmtnum` [macro function](/manual/config/macros/macro_functions#supported-macro-functions) is now limited to 0-20.
ca	 #### Funcions de macro  L'interval de la [funció macro](/manual/config/macros/macro_functions#supported-macro-functions) `fmtnum`és ara limitat a 0-20.

en-us	 ## Macros
ca	## Macros

en-us	 #### Macros
ca	#### Macros

en-us	Macros for internal actions contain the reason why an item, an LLD-rule, or a trigger became unsupported:   - {ITEM.STATE.ERROR} - for item-based internal notifications;  - {LLDRULE.STATE.ERROR} -  for LLD-rule based internal notifications;  - {TRIGGER.STATE.ERROR} - for trigger-based internal notifications.  For more details, see [Supported macros](/manual/appendix/macros/supported_by_location).
ca	Les macros per a accions internes contenen el motiu pel qual ja no s'admet un element, una regla de LLD o un trigger:    - {ITEM.STATE.ERROR} - per a notificacions internes basades en articles;   - {LLDRULE.STATE.ERROR} - per a notificacions internes basades en regles LLD;   - {TRIGGER.STATE.ERROR} - per a notificacions internes basades en triggers.  Per obtindre més informació, veieu les [macros admeses](/manual/appendix/macros/supported_by_location).

en-us	#### - Macros  This section allows to define system-wide [user macros](/manual/config/macros/user_macros) as name-value pairs. Note that macro values can be kept as plain text, secret text or Vault secret. Adding a description is also supported.  ![](../../../../../assets/en/manual/web_interface/user_macros_global.png){width="600"}
ca	#### - Macros  Aquesta secció permet la definició a tot el sistema de [macros d'usuari](/manual/config/macros/user_macros) com a parells nom-valor. Tingueu en compte que els valors de macro es poden mantindre com a text sense format, text secret o caixa secreta. També s'admet afegir una descripció. ![](../../../../../assets/en/manual/web_interface/user_macros_global.png){width="600"}

en-us	#### Macro support  Built-in and user macros in tags are resolved at the time of the event. Until the event has occurred these macros will be shown in Zabbix frontend unresolved. Low-level discovery macros are resolved during discovery process.  The following macros may be used in trigger tags:  -   {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} and {HOST.ID}     macros can be used to populate the tag name or tag value. -   {INVENTORY.\*} [macros](/manual/appendix/macros/supported_by_location) can be used     to reference host inventory values from one or several hosts in a trigger expression. -   [User macros](/manual/config/macros/user_macros) and user macros with context are supported for the tag name/value;     context may include low-level discovery macros. -   Low-level discovery macros can be used for the tag name/value in     trigger prototypes.  The following macros may be used in trigger-based notifications:  -   {EVENT.TAGS} and {EVENT.RECOVERY.TAGS} macros will resolve to a     comma separated list of event tags or recovery event tags -   {EVENT.TAGSJSON} and {EVENT.RECOVERY.TAGSJSON} macros will resolve     to a JSON array containing event tag     [objects](/manual/api/reference/event/object#event_tag) or recovery     event tag objects  The following macros may be used in template, host, item and web scenario tags:  -   {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP},     {HOST.PORT} and {HOST.ID} macros -   {INVENTORY.\*}     [macros](/manual/appendix/macros/supported_by_location) -   [User macros](/manual/config/macros/user_macros) -   Low-level discovery macros can be used in item prototype tags  The following macros may be used in host prototype tags:  -   {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP},     {HOST.PORT} and {HOST.ID} macros -   {INVENTORY.\*}     [macros](/manual/appendix/macros/supported_by_location) -   [User macros](/manual/config/macros/user_macros) -   [Low-level discovery macros](/manual/config/macros/lld_macros) will     be resolved during discovery process and then added to the     discovered host  
ca	#### Suport de macros  Les macros integrades i d'usuari a les etiquetes es resolen en el moment de l'esdeveniment. Fins que no s'hagi produït l'esdeveniment, aquestes macros es veuran a la interfície de Zabbix sense resoldre. Les macros de descoberta de baix nivell es resolen durant el procés de descoberta.  Les macros següents es poden emprar a les etiquetes de triggers:  - {ITEM.VALUE}, {ITEM.LASTVALUE}, {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID}      Les macros es poden emprar per emplenar el nom de l'etiqueta o el valor de l'etiqueta. - Es poden emprar les [macros](/manual/appendix/macros/supported_by_location) {INVENTORY.\*} per fer referència als valors d'inventari d'equip d'un o diversos equips en una expressió trigger. - [Macros d'usuari](/manual/config/macros/user_macros) i el context de macro d'usuari són compatibles amb al nom/valor de l'etiqueta;      El context pot incloure macros de descoberta de baix nivell. - Es poden emprar macros de descoberta de baix nivell per al nom/valor de l'etiqueta de prototips de trigger.   Les macros següents es poden emprar a les notificacions basades en triggers:  - Les macros {EVENT.TAGS} i {EVENT.RECOVERY.TAGS} es resoldran en una llista separada per comes d'etiquetes d'esdeveniment o etiquetes d'esdeveniment de recuperació - Les macros {EVENT.TAGSJSON} i {EVENT.RECOVERY.TAGSJSON} es resoldran a una matriu JSON que conté una etiqueta d'esdeveniment amb [objectes](/manual/api/reference/event/object#event_tag) o objectes de recuperació d'etiquetes d'esdeveniment  Les macros següents es poden emprar en plantilla, equip, element i etiquetes d'escenari web:  - Macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} - [Macros](/manual/appendix/macros/supported_by_location) {INVENTARI.\*} - [Macros d'usuari](/manual/config/macros/user_macros) - Les macros de descoberta de baix nivell es poden emprar a les etiquetes de prototip d'elements  Les macros següents es poden emprar a les etiquetes de prototip d'equips:  - Macros {HOST.HOST}, {HOST.NAME}, {HOST.CONN}, {HOST.DNS}, {HOST.IP}, {HOST.PORT} i {HOST.ID} - [macros](/manual/appendix/macros/supported_by_location) {INVENTARI.\*} - [Macros d'usuari](/manual/config/macros/user_macros) - Les [macros de descoberta de baix nivell](/manual/config/macros/lld_macros) es resoldran durant el procés de descoberta i després s'afegirà al fitxer de l'equip descobert

en-us	#### maintenance  Changes:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: added strict validation of the methods parameters.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: dropped support for parameter `timeperiodid` of the timeperiod object.\
ca	#### manteniment  Canvis:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`,`maintenance.delete`: afegida la validació estricta dels paràmetres dels mètodes.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.get`,`maintenance.update`: suport descartat per al paràmetre `timeperiodid` de l'objecte del període de temps.\

en-us	#### maintenance  Changes:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `groupids` is now deprecated. Use `groups` instead.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: the parameter `hostids` is now deprecated. Use `hosts` instead.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: changed the type of parameters `groups`, `hosts`, `timeperiods` and `tags` from `array` to `object/array`.\
ca	#### manteniment  Canvis:\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: el paràmetre `groupids` és obsolet. En lloc d'aquest, empreu `groups`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: el paràmetre`hostids` és obsolet. En lloc d'aquest, empreu `hosts`.\ [ZBXNEXT-6890](https://support.zabbix.com/browse/ZBXNEXT-6890) `maintenance.create`, `maintenance.update`: s'ha canviat el tipus de paràmetre `groups`, `hosts`, `timeperiods` i `tags` d'`array` a `object/array`.\

en-us	# maintenance.create
ca	# maintenance.create

en-us	# maintenance.delete
ca	# maintenance.delete

en-us	# maintenance.get
ca	# maintenance.get

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

en-us	##### Maintenance periods  The maintenance period window is for scheduling time for a recurring or a one-time maintenance. The form is dynamic with available fields changing based on the *Period type* selected.  ![](../../assets/en/manual/maintenance/maintenance_period.png)  |Period type|Description| |--|--------| |*One time only*|Define the date and time, and the length of the maintenance period.| |*Daily*|*Every day(s)* - maintenance frequency: 1 (default) - every day, 2 - every two days, etc.<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| |*Weekly*|*Every week(s)* - maintenance frequency: 1 (default) - every week, 2 - every two weeks, etc.<br>*Day of week* - on which day the maintenance should take place.<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.| |*Monthly*|*Month* - select all months during which the regular maintenance is carried out.<br>*Date*: **Day of month** - Select this option if the maintenance takes place on the same date each month (for example, every 1st day of the month). Then, select the required day in the new field that appears.<br>*Date*: **Day of week** - Select this option if the maintenance takes place only on certain days (for example, every first Monday of the month). Then, in the drop-down select the required week of the month (first, second, third, fourth, or last) and mark the checkboxes for maintenance day(s).<br>*At (hour:minute)* - time of the day when maintenance starts.<br>*Maintenance period length* - for how long the maintenance will be active.|  When done, press *Add* to add the maintenance period to the *Periods* block.  Notes:  -   When *Every day/Every week* parameter is greater than 1, the     starting day or week is the day/week that the *Active since* time     falls on. For example:     -   with *Active since* set to January 1 at 12:00 and a one-hour         maintenance set for every two days at 23:00 will result in the         first maintenance period starting on January 1 at 23:00, while         the second maintenance period will start on January 3 at 23:00;     -   with the same *Active since* time and a one-hour maintenance set         for every two days at 01:00, the first maintenance period will         start on January 3 at 01:00, while the second maintenance period         will start on January 5 at 01:00. -   Daylight Saving Time (**DST**) changes do not affect how long the     maintenance will be.      - Let's say we have a two-hour maintenance that        usually starts at 01:00 and finishes at 03:00:      -   If after one hour of maintenance (at 02:00) a DST change happens          and current time changes from 02:00 to 03:00, the maintenance will          continue for one more hour till 04:00;      -   If after two hours of maintenance (at 03:00) a DST change happens          and current time changes from 03:00 to 02:00, the maintenance will          stop because two hours have passed.     -   If a maintenance period is set to 1 day it usually starts at 00:00       and finishes at 00:00 the next day:      -   Since Zabbix calculates days in hours, the actual period of the           maintenance is 24 hours.       - If current time changes forward one hour, the maintenance will           stop at 01:00 the next day.       - If current time changes back one hour, the maintenance will stop           at 23:00 that day.     - If a maintenance period starts during the hour, skipped by DST change:      - The maintenance will not start.
ca	##### Períodes de manteniment  La finestra del període de manteniment s'utilitza per programar el temps per al manteniment recurrent o únic. El formulari és dinàmic i els camps disponibles canvien en funció del *tipus de període* seleccionat.  ![](../../assets/en/manual/maintenance/maintenance_period.png)  |Tipus de període|Descripció| |--|---------| |*Només un cop*|Definiu la data i l'hora, així com la durada del període de manteniment.| |*Diari*|*Cada dia/dies* - freqüència de manteniment: 1 (per defecte) - cada dia, 2 - cada dos dies, etc.<br>*A (hora:minut)* - hora del dia en què comença el manteniment.<br> *Durada del període de manteniment* - quant de temps serà actiu el manteniment.| |*Semanal*|*Cada setmana/setmanes* - freqüència de manteniment: 1 (per defecte) - cada dia, 2 - cada dos dies, etc.<br>*Dia de la setmana* - el dia en què s'ha de fer el manteniment. <br>*A (hora:minut)* - hora del dia comença el manteniment.<br>*Durada del període de manteniment* - quant de temps serà actiu el manteniment.| |*Mensual*|*Mes* - trieu tots els mesos en què es realitza el manteniment habitual.<br>*Data*: **Dia del mes** - trieu aquesta opció si el manteniment es produeix la mateixa data cada mes (per exemple, 1r dia del mes). Tot seguit, trieu el dia requerit al camp nou que apareix.<br>*Data*: **Dia de la setmana** - trieu aquesta opció si el manteniment només es produeix en determinats dies (per exemple, cada primer dilluns de mes). A continuació, a la llista desplegable, trieu la setmana del mes requerida (primera, segona, tercera, quarta o darrera) i marqueu les caselles corresponents al(s) dia(s) de manteniment.<br>*A (hora:minut)* - hora d'inici del manteniment.<br>*Durada del període de manteniment* - quant de temps serà actiu el manteniment.|  Quan hagueu acabat, premeu *Afegir per afegir el període de manteniment al bloc *Períodes*.  Observacions:  - Quan el paràmetre *Diari/Setmanal* és superior a 1, el dia o la setmana d'inici és el dia/setmana en què cau l'hora *Activat des de*. Per exemple:      - amb *Activat des de* establert a l'1 de gener a les 12:00 i una hora de manteniment establerta cada dos dies a les 23:00, farà que la primera finestra de manteniment s'iniciï l'1 de gener a les 23:00, mentre que la segona finestra de manteniment començarà el 3 de gener a les 23:00h;      - amb la mateixa hora *Actiu des de* i un manteniment d'una hora establert cada dos dies a la 01:00, la primera finestra de manteniment començarà el 3 de gener a la 01:00, mentre que la segona finestra de manteniment començarà el 5 de gener a les 01:00. :00:00. - Els canvis de DST (**DST**) no afecten la durada del manteniment.      - Suposem que tenim un manteniment de dues hores que normalment comença a la 01:00 i acaba a les 03:00:      - Si després d'una hora de manteniment (a les 02:00 h) es produeix un canvi d'horari d'estiu i l'hora actual canvia de les 02:00 h a les 03:00 h, el manteniment continuarà una hora més fins a les 04:00 h;      - Si després de dues hores de manteniment (a les 03:00) es produeix un canvi de l'horari d'estiu i l'hora actual canvia de les 03:00 a les 02:00, el manteniment s'aturarà perquè hauran passat dues hores.      - Si un període de manteniment s'estableix en 1 dia, normalment comença a les 00:00 i finalitza a les 00:00 del dia següent:      - Com que Zabbix calcula els dies en hores, la durada real del manteniment és de 24 hores.      - Si l'hora actual avança una hora, el manteniment s'aturarà a la 01:00 de l'endemà.      - Si l'hora actual s'endarrereix una hora, el manteniment s'aturarà a les 23:00 hores d'aquell dia.      - Si s'inicia un període de manteniment durant l'hora, omès pel canvi d'horari d'estiu:      - El manteniment no començarà pas.

en-us	### Maintenance  The maintenance object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |maintenanceid|string|*(readonly)* ID of the maintenance.| |**name**<br>(required)|string|Name of the maintenance.| |**active\_since**<br>(required)|timestamp|Time when the maintenance becomes active.<br><br>The given value will be rounded down to minutes.| |**active\_till**<br>(required)|timestamp|Time when the maintenance stops being active.<br><br>The given value will be rounded down to minutes.| |description|string|Description of the maintenance.| |maintenance\_type|integer|Type of maintenance.<br><br>Possible values:<br>0 - *(default)* with data collection;<br>1 - without data collection.| |tags\_evaltype|integer|Problem tag evaluation method.<br><br>Possible values:<br>0 - *(default)* And/Or;<br>2 - Or.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Manteniment  L'objecte  manteniment té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |maintenanceid|string|*(només lectura)* ID de manteniment.| |**name**<br>(obligatori)|string|Nom del manteniment.| |**active\_since**<br>(obligatori)|marca de temps|Hora en què el manteniment s'activa.<br><br>El valor donat s'arrodonirà al minut inferior.| |**active\_till**<br>(obligatori)|timestamp|Hora en què el manteniment deixa d'ésser actiu.<br><br>El valor donat s'arrodonirà al minut inferior.| |description|string|Descripció del manteniment.| |maintenance\_type|integer|Tipus de manteniment.<br><br>Valors possibles:<br>0 - *(per defecte)* amb recollida de dades;<br>1 - sense recollida de dades.| |tags\_evaltype|integer|Mètode d'avaluació de l'etiqueta del problema.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Maintenance  This class is designed to work with maintenances.  Object references:\  -   [Maintenance](/manual/api/reference/maintenance/object#maintenance) -   [Time period](/manual/api/reference/maintenance/object#time_period)  Available methods:\  -   [maintenance.create](/manual/api/reference/maintenance/create) -     creating new maintenances -   [maintenance.delete](/manual/api/reference/maintenance/delete) -     deleting maintenances -   [maintenance.get](/manual/api/reference/maintenance/get) -     retrieving maintenances -   [maintenance.update](/manual/api/reference/maintenance/update) -     updating maintenances
ca	# Manteniment  Aquesta classe és dissenyada per treballar amb manteniements.  Referències d'objectes:\  -   [Manteniment](/manual/api/reference/maintenance/object#maintenance) -   [Període](/manual/api/reference/maintenance/object#time_period)  Mètodes disponibles:\  -   [maintenance.create](/manual/api/reference/maintenance/create) - crear nous manteniments -   [maintenance.delete](/manual/api/reference/maintenance/delete) - esborrar manteniments -   [maintenance.get](/manual/api/reference/maintenance/get) - recuperar manteniments -   [maintenance.update](/manual/api/reference/maintenance/update) - actualitzar manteniments

en-us	# maintenance.update
ca	# maintenance.update

en-us	 ### Makefile targets  Loadable plugins provided by Zabbix have simple makefiles with the following targets:  |Target|Description| |--|--------| |make|Build plugin.| |make clean|Delete all files that are normally created by building the plugin.| |make check|Perform self-tests. A real PostgreSQL database is required.| |make style|Check Go code style with 'golangci-lint'.| |make format|Format Go code with 'go fmt'.| |make dist|Create an archive containing the plugin sources and sources of all packages needed to build the plugin and its self-tests.|
ca	### Destins del Makefile  Els plugins carregables proporcionats per Zabbix tenen fitxers de creació senzills amb els objectius següents:  |Destí|Descripció| |--|--------| |make|Construeix el connector.| |make clean|Esborra tots els fitxers que es creen normalment en crear el connector.| |make check|Fa autoproves. Es requereix una base de dades PostgreSQL real.| |make style|Comprova l'estil del codi Go amb 'golangci-lint'.| |make format|Formata el codi Go amb 'go fmt'.| |make dist|Crea un arxiu que contingui les fonts del connector i les fonts de tots els paquets necessaris per crear el connector i les seves autoproves.|

en-us	### Managing HA cluster  The current status of the HA cluster can be managed using the dedicated [runtime control](/manual/concepts/server#runtime_control) options:  -   `ha_status` - log HA cluster status in the Zabbix server log (and to stdout) -   `ha_remove_node=target` - remove an HA node identified by its     \<target\> - number of the node in the list (the number can be     obtained from the output of running ha\_status), e.g.:  ``` zabbix_server -R ha_remove_node=2 ```  Note that active/standby nodes cannot be removed.  -   `ha_set_failover_delay=delay` - set HA failover delay (between 10 seconds and 15 minutes; time     suffixes are supported, e.g. 10s, 1m)  Node status can be monitored:  -   in *Reports* → *[System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix#status_of_ha_cluster_nodes)* -   in the *System information* dashboard widget -   using the `ha_status` runtime control option of the server (see     above).  The `zabbix[cluster,discovery,nodes]` internal item can be used for node discovery, as it returns a JSON with the high-availability node information.
ca	### Getió del cluster d'alta disponibilitat (HA)  L'estat actual del clúster HA es pot gestionar mitjançant les opcions dedicades [control en temps d'execució](/manual/concepts/server#runtime_control):  - `ha_status`: desa l'estat del clúster HA al registre del servidor Zabbix (i a stdout) - `ha_remove_node=target` - elimina un node HA identificat pel seu \<target\> - nombre de node a la llista (el nombre es pot obtindre a partir de la sortida de l'execució de ha\_status), per exemple: ``` zabbix_server -R ha_remove_node=2 ```  Tingueu en compte que els nodes actius/en espera no es poden pas esborrar.  - `ha_set_failover_delay=delay`: estableix l'endarreriment de la migració per error HA (entre 10 segons i 15 minuts; s'admeten sufixos de temps, per exemple, 10 s, 1 m)  L'estat del node es pot controlar:  - a *Informes* → *[Informació del sistema](/manual/web_interface/frontend_sections/reports/status_of_zabbix#status_of_ha_cluster_nodes)* - al giny del tauler *Informació del sistema* - emprant l'opció de control d'execució `ha_status` del servidor (veieu més amunt).  L'element intern `zabbix[cluster,discovery,nodes]` es pot emprar per a la descoberta de nodes, ja que retorna un JSON amb informació de nodes d'alta disponibilitat.

en-us	 **Mandatory and optional parameters**  Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional.  **Usage with command-line utilities**  Note that when testing or using item keys with zabbix_agentd or zabbix_get from the command line you should consider shell syntax too.  For example, if a certain parameter of the key has to be enclosed in double quotes you have to explicitly escape double quotes, otherwise they will be trimmed by the shell as special characters and will not be passed to the Zabbix utility.  Examples:      zabbix_agentd -t 'vfs.dir.count[/var/log,,,"file,dir",,0]'      zabbix_agentd -t vfs.dir.count[/var/log,,,\"file,dir\",,0]
ca	**Paràmetres obligatoris i opcionals**  Els paràmetres sense claudàtors són obligatoris. Els paràmetres entre claudàtors **<** **>** són opcionals.  **S'empra amb utilitats de línia d'ordres**  Tingueu en compte que quan proveu o empreu claus d'element amb zabbix_agentd o zabbix_get des de la línia d'ordres, també heu de tindre en compte la sintaxi de l'intèrpret d'ordres.  Per exemple, si un determinat paràmetre clau s'ha d'incloure entre cometes dobles, heu d'escapar explícitament de les cometes dobles; en cas contrari, seran retallades per l'intèrpret d'ordres com a caràcters especials i no es passaran a la utilitat Zabbix.  Exemples:       zabbix_agentd -t 'vfs.dir.count[/var/log,,,"fichier,dir",,0]'       zabbix_agentd -t vfs.dir.count[/var/log,,,\"fichier,dir\",,0]

en-us	##### - Mandatory interface  The only mandatory function is **zbx\_module\_api\_version()**:  ``` {.c} int zbx_module_api_version(void); ```  This function should return the API version implemented by this module and in order for the module to be loaded this version must match module API version supported by Zabbix. Version of module API supported by Zabbix is ZBX\_MODULE\_API\_VERSION. So this function should return this constant. Old constant ZBX\_MODULE\_API\_VERSION\_ONE used for this purpose is now defined to equal ZBX\_MODULE\_API\_VERSION to preserve source compatibility, but it's usage is not recommended.
ca	##### - Interfície obligatòria  L'única funció necessària és **zbx\_module\_api\_version()**:  ``` {.c} int zbx_module_api_version(void); ```  Aquesta funció ha de retornar la versió del mòdul de l'API implementada per aquest mòdul i perquè el mòdul carregui aquesta versió ha de coincidir amb la versió del mòdul de l'API suportada per Zabbix. La versió del mòdul API admesa per Zabbix és ZBX\_MODULE\_API\_VERSION. Per tant, aquesta funció ha de retornar aquesta constant. L'antiga constant ZBX\_MODULES\_API\_VERSION\_ONE que s'empra per a aquest propòsit ara s'estableix igual a ZBX\_MODULE\_API\_VERSION per preservar la compatibilitat de les fonts, però aquest és un ús no recomanat.

en-us	##### Manifest preparation  Each module is expected to have a manifest.json file with the following fields in JSON format:  |Parameter|Required|Type|Default|Description| |---------|---|----|--|-------------------| |manifest\_version|Yes|Double|\-|Manifest version of the module. Currently supported version is **1**.| |id|Yes|String|\-|Module ID. Only one module with given ID can be enabled at the same time.| |name|Yes|String|\-|Module name as displayed in the Administration section.| |version|Yes|String|\-|Module version as displayed in the Administration section.| |namespace|Yes|String|\-|PHP namespace for Module.php and action classes.| |author|No|String|""|Module author as displayed in the Administration section.| |url|No|String|""|Module URL as displayed in the Administration section.| |description|No|String|""|Module description as displayed in the Administration section.| |actions|No|Object|{}|Actions to register with this module. See Actions.| |config|No|Object|{}|Module configuration.|  For reference, please see an example of manifest.json in the [Reference](#reference) section.
ca	##### Preparació del manifest  Cada mòdul hauria de tindre un fitxer manifest.json amb els camps següents en format JSON:  |Paràmetre|Obligatori|Tipus|Predeterminat|Descripció| |---------|---|----|--|-----| |manifest\_version|Sí|Doble|\-|Versió manifest del mòdul. La versió admesa actualment és **1**.| |id|Sí|String|\-|ID del mòdul. Només es pot activar un mòdul amb un identificador donat alhora.| |nom|Sí|Cadena|\-|Nom del mòdul tal com es veu a la secció Administració.| |versió|Sí|String|\-|Versió del mòdul tal com es veu a la secció Administració.| |espai de noms|Sí|Cadena|\-|Espai de noms PHP per a les classes d'acció i Module.php.| |autor|No|String|""|Autor del mòdul tal com es veu a la secció Administració.| |url|No|String|""|URL del mòdul tal com es veu a la secció Administració.| |descripció|No|String|""|Descripció del mòdul tal com es veu a la secció Administració.| |accions|No|Objecte|{}|Accions per registrar-se en aquest mòdul. Veieu Accions.| |configuració|No|Objecte|{}|Configuració del mòdul.|  Per a referència, consulteu un exemple de manifest.json a la secció [Referència](#reference).

en-us	##### Manual mode  When [configuring a host](/manual/config/hosts/host), in the *Inventory* tab you can enter such details as the type of device, serial number, location, responsible person, etc., - the data that will populate inventory information.  If a URL is included in the host inventory information and it starts with 'http' or 'https', it will result in a clickable link in the *Inventory* section.
ca	##### Mode manual  Quan [configurem un equip](/manual/config/hosts/host), a la pestanya *Inventari*, podem entrar informació com el tipus de perifèric, el nombre de sèrie, ubicació, persona responsable, etc... - les dades que ompliran la informació de l'inventari.  Si una URL s'inclou a la informació de l'inventari d'equip i comença per `http` o `https`, apareixerà un enllaç clicable a la secció *Inventari*.

en-us	# map.create
ca	# map.create

en-us	# map.delete
ca	# map.delete

en-us	#### Map element Host group  The map element Host group object defines one host group element.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |groupid|string|Host group ID|
ca	#### Element de mapa grup d'equips  L'objecte element de mapa de grups d'equips defineix un o més elements de grups d'equips.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |groupid|string|ID del grup d'equips.|

en-us	#### Map element Host  The map element Host object defines one host element.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |hostid|string|Host ID|
ca	#### Element de mapa Equip  L'objecte element de mapa d'equips defineix un o més elements d'equips.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |hostid|string|ID del grup d'equips.|

en-us	#### Map element Map  The map element Map object defines one map element.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|Map ID|
ca	#### Element de mapa Mapa  L'objecte element de mapa Mapa defineix un o més elements de Mapes.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapid|string|ID del mapa.|

en-us	#### Map element tag  The map element tag object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**tag**<br>(required)|string|Map element tag name.| |operator|integer|Map element tag condition operator.<br><br>Possible values:<br>0 - *(default)* Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.| |value|string|Map element tag value.|
ca	#### Element del mapa Etiqueta  L'objecte d'element de mapa Etiqueta té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tag**<br>(obligatori)|cadena|Nom d'etiqueta de l'element del mapa.| |operator|enter|Operador de condició d'etiqueta d'element de mapa.<br><br>Valors possibles :<br>0 - *(per defecte)* Conté;<br>1 - Iguals;<br>2 - No en conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.| |value|cadena|Valor d'etiqueta d'element de mapa.|

en-us	### Map element  The map element object defines an object displayed on a map. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |selementid|string|*(readonly)* ID of the map element.| |**elements**<br>(required)|array|Element data object. Required for host, host group, trigger and map type elements.| |**elementtype**<br>(required)|integer|Type of map element.<br><br>Possible values:<br>0 - host;<br>1 - map;<br>2 - trigger;<br>3 - host group;<br>4 - image.| |**iconid\_off**<br>(required)|string|ID of the image used to display the element in default state.| |areatype|integer|How separate host group hosts should be displayed.<br><br>Possible values:<br>0 - *(default)* the host group element will take up the whole map;<br>1 - the host group element will have a fixed size.| |elementsubtype|integer|How a host group element should be displayed on a map.<br><br>Possible values:<br>0 - *(default)* display the host group as a single element;<br>1 - display each host in the group separately.| |evaltype|integer|Map element tag filtering condition evaluation method.<br><br>Possible values:<br>0 - *(default)* AND / OR;<br>2 - OR.| |height|integer|Height of the fixed size host group element in pixels.<br><br>Default: 200.| |iconid\_disabled|string|ID of the image used to display disabled map elements. Unused for image elements.| |iconid\_maintenance|string|ID of the image used to display map elements in maintenance. Unused for image elements.| |iconid\_on|string|ID of the image used to display map elements with problems. Unused for image elements.| |label|string|Label of the element.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>-1 - *(default)* default location;<br>0 - bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|*(readonly)* ID of the map that the element belongs to.| |urls|array|Map element URLs.<br><br>The map element URL object is [described in detail below](object#map_element_url).| |use\_iconmap|integer|Whether icon mapping must be used for host elements.<br><br>Possible values:<br>0 - do not use icon mapping;<br>1 - *(default)* use icon mapping.| |viewtype|integer|Host group element placing algorithm.<br><br>Possible values:<br>0 - *(default)* grid.| |width|integer|Width of the fixed size host group element in pixels.<br><br>Default: 200.| |x|integer|X-coordinates of the element in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the element in pixels.<br><br>Default: 0.|
ca	### Element de mapa  L'objecte d'element del mapa defineix un objecte que es mostra en un mapa. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |selementid|string|*(només lectura)* ID de l'element del mapa.| |**elements**<br>(obligatori)|array|Objecte de dades de l'element. Necessari per a elements d'equip, grup d'equips, trigger i tipus de mapa.| |**elementtype**<br>(obligatori)|integer|Tipus d'element del mapa.<br><br>Valors possibles:<br>0 - equip;<br>1 - mapa;<br>2 - trigger;< br>3 - grup d'equips;<br>4 - imatge.| |**iconid\_off**<br>(obligatori)|string|ID de la imatge emprada per ensenyar l'element en estat predeterminat.| |areatype|integer|Com s'han d'ensenyar diferents equips del grup d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* l'element del grup d'equips ocuparà tot el mapa;<br>1 - l'element del grup d'equips tindrà una mida fixa.| |elementsubtype|integer|Com s'ha d'ensenyar un element del grup d'equips al mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* mostra el grup d'equips com a element únic;<br>1 - mostra cada equip al grup per separat.| |evaltype|integer|Mètode per avaluar les condicions del filtre d'etiquetes d'elements del mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* I/O;<br>2 - O.| |height|integer|Alçada de l'element del grup d'equips de mida fixa en píxels.<br><br>Per defecte: 200.| |iconid\_disabled|string|ID de la icona emprada per ensenyar els elements del mapa desactivats. No s'empra per a elements de tipus d'imatge.| |iconid\_maintenance|string|Identificador de la icona que s'empra per ensenyar els elements del mapa en manteniment. No s'empra per a elements de tipus d'imatge.| |iconid\_on|string|Identificador de la icona que s'empra per ensenyar els elements del mapa amb problemes. No s'empra per a elements de tipus d'imatge.| |label|string|Etiqueta de l'element.| |label\_location|integer|Posició de l'etiqueta de l'element del mapa.<br><br>Valors possibles:<br>-1 - *(per defecte)* posició per defecte;<br>0 - sota;<br>1 - esquerra;<br>2 - dreta;<br>3 - dalt.| |permission|integer|Tipus de nivell de permís.<br><br>Valors possibles:<br>-1 - cap;<br>2 - només lectura;<br>3 - lectura-escriptura.| |sysmapid|string|*(només lectura)* ID del mapa al qual pertany l'element.| |urls|array|elements del mapa d'URL.<br><br>L'objecte de l'element del mapa d'URL és [descrit en detall a continuació](object#map_element_url).| |use\_iconmap|integer|Indica si s'ha d'emprar l'assignació d'icones per als elements de l'equip.<br><br>Valors possibles:<br>0 - no empreu pas l'assignació d'icones;<br>1 - *(per defecte)* empreu la icona cartografia.| |viewtype|integer|Algorisme d'ubicació d'elements del grup d'equips.<br><br>Valors possibles:<br>0 - *(per defecte)* quadrícula.| |width|integer|Amplada de l'element del grup d'equips de mida fixa en píxels.<br><br>Per defecte: 200.| |x|integer|Coordenada X de l'element en píxels.<br><br>Per defecte: 0.| |y|integer|Coordenada Y de l'element en píxels.<br><br>Per defecte: 0.|

en-us	#### Map element Trigger  The map element Trigger object defines one or more trigger elements.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |triggerid|string|Trigger ID|
ca	#### Element de mapa Trigger  L'objecte element de mapa Trigger defineix un o més triggers d'elements.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |triggerid|string|ID del trigger.|

en-us	#### Map element URL  The map element URL object defines a clickable link that will be available for a specific map element. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapelementurlid|string|*(readonly)* ID of the map element URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |selementid|string|ID of the map element that the URL belongs to.|
ca	#### Element de mapa URL  L'objecte element de mapa URL defineix un enllaç clicable que serà disponible per a un element de mapa concret. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapelementurlid|string|*(només lectura)* ID de l'element de mapa URL.| |**name**<br>(obligatori)|string|Llegenda d'enllaç.| |**url**<br>(obligatori)|string|URL de l'enllaç.| |selementid|string|ID de l'element de mapa on pertany l'URL.|

en-us	# map.get
ca	# map.get

en-us	#### Map lines  Create a map line.  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map API lines",         "width": 500,         "height": 500,         "lines": [             {                 "x1": 30,                 "y1": 10,                 "x2": 100,                 "y2": 50,                 "line_type": 1,                 "line_width": 10,                 "line_color": "009900"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "11"         ]     },     "id": 1 } ```
ca	#### Línies de mapes  Crear una línia de mapa.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map API lines",         "width": 500,         "height": 500,         "lines": [             {                 "x1": 30,                 "y1": 10,                 "x2": 100,                 "y2": 50,                 "line_type": 1,                 "line_width": 10,                 "line_color": "009900"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "11"         ]     },     "id": 1 } ```

en-us	### Map lines  The map line object defines a line displayed on a map. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |x1|integer|X-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |y1|integer|Y-coordinates of the line point 1 in pixels.<br><br>Default: 0.| |x2|integer|X-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |y2|integer|Y-coordinates of the line point 2 in pixels.<br><br>Default: 200.| |line\_type|integer|Type of the lines.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |line\_width|integer|Width of the lines in pixels.<br><br>Default: 0.| |line\_color|string|Line color.<br><br>Default: '000000'.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.|
ca	### Línies de mapes  L'objecte defineix una línia que es mostra en un mapa. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmap\_shapeid|string|*(només lectura)* ID de la forma del mapa.| |x1|integer|Coordenada X del punt 1 de la línia en píxels.<br><br>Per defecte: 0.| |y1|integer|Coordenada Y del punt 1 de la línia en píxels.<br><br>Per defecte: 0.| |x2|integer|Coordenada X del punt 2 de la línia en píxels.<br><br>Per defecte: 200.| |y2|integer|Coordenada Y del punt 2 de la línia en píxels.<br><br>Per defecte: 200.| |line\_type|integer|Tipus de línia.<br><br>Valors possibles:<br>0 - cap;<br>1 - `—————`;<br>2 - `···· · `;<br>3 - `- - -`.<br><br>Per defecte: 0.| |line\_width|integer|Amplada de línia en píxels.<br><br>Per defecte: 0.| |line\_color|string|Color de línia.<br><br>Per defecte: '000000'.| |zindex|integer|Valor emprat per ordenar totes les formes i línies (índex z).<br><br>Per defecte: 0.|

en-us	### Map link  The map link object defines a link between two map elements. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |linkid|string|*(readonly)* ID of the map link.| |**selementid1**<br>(required)|string|ID of the first map element linked on one end.| |**selementid2**<br>(required)|string|ID of the first map element linked on the other end.| |color|string|Line color as a hexadecimal color code.<br><br>Default: `000000`.| |drawtype|integer|Link line draw style.<br><br>Possible values:<br>0 - *(default)* line;<br>2 - bold line;<br>3 - dotted line;<br>4 - dashed line.| |label|string|Link label.| |linktriggers|array|Map link triggers to use as link status indicators.<br><br>The map link trigger object is [described in detail below](object#map_link_trigger).| |permission|integer|Type of permission level.<br><br>Possible values:<br>-1 - none;<br>2 - read only;<br>3 - read-write.| |sysmapid|string|ID of the map the link belongs to.|
ca	### Enllaç de mapa  L'objecte d'enllaç al mapa defineix un enllaç entre dos elements del mapa. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |linkid|string|*(només ectura)* ID de l'enllaç del mapa.| |**selementid1**<br>(obligatori)|string|ID del primer element del mapa enllaçat al final.| |**selementid2**<br>(obligatori)|string|ID del primer element del mapa enllaçat a l'altre extrem.| |color|string|Color de línia com a codi de color hexadecimal.<br><br>Per defecte: `000000`.| |drawtype|integer|Estil de línia d'enllaç.<br><br>Valors possibles:<br>0 - *(per defecte)* línia;<br>2 - línia en negreta;<br>3 - línia de punts; <br>4 - línia amb guions.| |label|string|Etiqueta d'enllaç.| |linktriggers|array|L'enllaç del mapa s'activa per emprar-lo com a indicadors d'estat de l'enllaç.<br><br>L'objecte trigger de l'enllaç del mapa és [descrit en detall a continuació](objecte#map_link_trigger). | |permission|integer|Tipus de nivell de permís.<br><br>Valors possibles:<br>-1 - cap;<br>2 - només lectura;<br>3 - lectura-escriptura.| |sysmapid|string|ID del mapa al qual pertany l'enllaç.|

en-us	#### Map link trigger  The map link trigger object defines a map link status indicator based on the state of a trigger. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |linktriggerid|string|*(readonly)* ID of the map link trigger.| |**triggerid**<br>(required)|string|ID of the trigger used as a link indicator.| |color|string|Indicator color as a hexadecimal color code.<br><br>Default: `DD0000`.| |drawtype|integer|Indicator draw style.<br><br>Possible values:<br>0 - *(default)* line;<br>2 - bold line;<br>3 - dotted line;<br>4 - dashed line.| |linkid|string|ID of the map link that the link trigger belongs to.|
ca	#### Trigger d'enllaç de mapa  L'objecte estableix un indicador d'estat d'enllaç de mapa en funció de l'estat d'un trigger. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |linktriggerid|string|*(només lectura)* ID del trigger de l'enllaç del mapa.| |**triggerid**<br>(obligatori)|string|ID del trigger emprat com a indicador d'enllaç.| |color|string|Color de l'indicador com a codi de color hexadecimal.<br><br>Per defecte: `DD0000`.| |tipus de dibuix|integer|Estil de dibuix de l'indicador.<br><br>Valors possibles:<br>0 - *(per defecte)* línia;<br>2 - línia en negreta;<br>3 - línia puntejada;<br>4 - línia amb guions.| |linkid|string|ID de l'enllaç del mapa al qual pertany el trigger de l'enllaç.|

en-us	#### Map listing  ![](../../../../../assets/en/manual/web_interface/map_list.png){width="600"}  Displayed data:  |Column|Description| |--|--------| |*Name*|Name of the map. Click on the name to [view](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) the map.| |*Width*|Map width is displayed.| |*Height*|Map height is displayed.| |*Actions*|Two actions are available:<br>**Properties** - edit general map [properties](/manual/config/visualization/maps/map#creating_a_map)<br>**Constructor** - access the grid for adding [map elements](/manual/config/visualization/maps/map#adding_elements)|  To [configure](/manual/config/visualization/maps/map#creating_a_map) a new map, click on the *Create map* button in the top right-hand corner. To import a map from a YAML, XML, or JSON file, click on the *Import* button in the top right-hand corner. The user who imports the map will be set as its owner.  Two buttons below the list offer some mass-editing options:  -   *Export* - export the maps to a YAML, XML, or JSON file -   *Delete* - delete the maps  To use these options, mark the checkboxes before the respective maps, then click on the required button.
ca	#### Llistat de mapes  ![](../../../../../assets/en/manual/web_interface/map_list.png){width="600"}  Dades mostrades:  |Columna|Descripció| |--|---------| |*Nom*|Nom de la tarja. Feu clic al nom per [veure](/manual/web_interface/frontend_sections/monitoring/maps#viewing_maps) el mapa.| |*Amplada*|Es mostra l'amplada del mapa.| |*Alçada*|Es mostra l'alçada del mapa.| |*Accions*|Hi ha dues accions disponibles:<br>**Propietats** - modificar les [propietats](/manual/config/visualization/maps/map#creating_a_map) generals del mapa<br>**Constructor** - quadrícula d'accés per afegir [elements del mapa](/manual/config/visualization/maps/map#adding_elements)|  Per [configurar](/manual/config/visualization/maps/map#creating_a_map) un mapa nou, feu clic al botó *Crear un mapa* a la cantonada superior dreta. Per importar un mapa des d'un fitxer YAML, XML o JSON, feu clic al botó *Importar* a l'extrem superior dret. L'usuari que importa el mapa s'establirà com a propietari.  Dos botons a sota de la llista ofereixen opcions d'edició massiva:  - *Exportar* - exporta mapes a un fitxer YAML, XML o JSON - *Esborrar* - esborra targes  Per emprar aquestes opcions, marqueu les caselles davant de les targes respectives i feu clic al botó requerit.

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

en-us	##### Mapping LLD macros  Next you have to go to the LLD macros tab and make the following mappings:      {#VOLUME}=$.labels['volume']     {#METRIC}=$['name']     {#HELP}=$['help']
ca	##### Mapatge de les macros LLD  Llavors, hem d'anar a la pestanya de Macros LLD i fer aquests mapatges:      {#VOLUME}=$.labels['volume']     {#METRIC}=$['name']     {#HELP}=$['help']

en-us	#### Maps  Configure maps to create detailed dynamic representations of your IT infrastructure.  [Map API](/manual/api/reference/map)
ca	#### Mapes  Configurar mapes per crear representacions dinàmiques de la infraestructura informàtica.  [API Mapes](/manual/api/reference/map)

en-us	#### Map shapes  Create a map with map name title.  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Host map",         "width": 600,         "height": 600,         "shapes": [             {                 "type": 0,                 "x": 0,                 "y": 0,                 "width": 600,                 "height": 11,                 "text": "{MAP.NAME}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "10"         ]     },     "id": 1 } ```
ca	#### Formes de mapa  Crear un mapa amb un títol.  Petició:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Host map",         "width": 600,         "height": 600,         "shapes": [             {                 "type": 0,                 "x": 0,                 "y": 0,                 "width": 600,                 "height": 11,                 "text": "{MAP.NAME}"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "10"         ]     },     "id": 1 } ```

en-us	### Map shapes  The map shape object defines a geometric shape (with or without text) displayed on a map. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmap\_shapeid|string|*(readonly)* ID of the map shape element.| |**type** (required)|integer|Type of map shape element.<br><br>Possible values:<br>0 - rectangle;<br>1 - ellipse.<br><br>Property is required when new shapes are created.| |x|integer|X-coordinates of the shape in pixels.<br><br>Default: 0.| |y|integer|Y-coordinates of the shape in pixels.<br><br>Default: 0.| |width|integer|Width of the shape in pixels.<br><br>Default: 200.| |height|integer|Height of the shape in pixels.<br><br>Default: 200.| |text|string|Text of the shape.| |font|integer|Font of the text within shape.<br><br>Possible values:<br>0 - Georgia, serif<br>1 - “Palatino Linotype”, “Book Antiqua”, Palatino, serif<br>2 - “Times New Roman”, Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - “Arial Black”, Gadget, sans-serif<br>5 - “Comic Sans MS”, cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Geneva, sans-serif<br>9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Geneva, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Monaco, monospace<br><br>Default: 9.| |font\_size|integer|Font size in pixels.<br><br>Default: 11.| |font\_color|string|Font color.<br><br>Default: '000000'.| |text\_halign|integer|Horizontal alignment of text.<br><br>Possible values:<br>0 - center;<br>1 - left;<br>2 - right.<br><br>Default: 0.| |text\_valign|integer|Vertical alignment of text.<br><br>Possible values:<br>0 - middle;<br>1 - top;<br>2 - bottom.<br><br>Default: 0.| |border\_type|integer|Type of the border.<br><br>Possible values:<br>0 - none;<br>1 - `—————`;<br>2 - `·····`;<br>3 - `- - -`.<br><br>Default: 0.| |border\_width|integer|Width of the border in pixels.<br><br>Default: 0.| |border\_color|string|Border color.<br><br>Default: '000000'.| |background\_color|string|Background color (fill color).<br><br>Default: `(empty)`.| |zindex|integer|Value used to order all shapes and lines (z-index).<br><br>Default: 0.|
ca	### Formes del mapa  L'objecte defineix una forma geomètrica (amb text o sense) que s'ensenya a un mapa. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmap\_shapeid|string|*(només lectura)* ID de la forma del mapa.| |**tipus** (obligatori)|integer|Tipus de la forma del mapa.<br><br>Valors possibles:<br>0 - rectangle;<br>1 - el·lipse.<br><br>Aquesta propietat és necessària quan es creen noves formes.| |x|integer|Coordenada X de la forma en píxels.<br><br>Per defecte: 0.| |y|integer|Coordenada Y de la forma en píxels.<br><br>Per defecte: 0.| |width|integer|Amplada de la forma en píxels.<br><br>Per defecte: 200.| |height|integer|Alçada de la forma en píxels.<br><br>Per defecte: 200.| |text|string|Formulari de text.| |font|integer|Tipus de lletra del text en forma.<br><br>Valors possibles:<br>0 - Geòrgia, serif<br>1 - "Palatino Linotype", "Book Antiqua", Palatino, serif<br> 2 - "Times New Roman", Times, serif<br>3 - Arial, Helvetica, sans-serif<br>4 - "Arial Black", Gadget, sans-serif<br>5 - "Comic Sans MS", cursive, sans-serif<br>6 - Impact, Charcoal, sans-serif<br>7 - “Lucida Sans Unicode”, “Lucida Grande”, sans-serif<br>8 - Tahoma, Ginebra, sans-serif<br> 9 - “Trebuchet MS”, Helvetica, sans-serif<br>10 - Verdana, Ginebra, sans-serif<br>11 - “Courier New”, Courier, monospace<br>12 - “Lucida Console”, Mònaco, monospace <br><br>Per defecte: 9.| |font\_size|integer|Mida del tipus de lletra en píxels.<br><br>Per defecte: 11.| |font\_color|string|color de la font.<br><br>Per defecte: '000000'.| |text\_halign|integer|Alineació de text horitzontal.<br><br>Valors possibles:<br>0 - centre;<br>1 - esquerra;<br>2 - dreta.<br><br>Per defecte: 0 .| |text\_valign|integer|Alineació vertical del text<br><br>Valors possibles:<br>0 - mig;<br>1 - superior;<br>2 - inferior.<br><br>Per defecte: 0. | |border\_type|integer|Tipus de vora.<br><br>Valors possibles:<br>0 - cap;<br>1 - `—————`;<br>2 - `···· · ` ;<br>3 - `- - -`.<br><br>Per defecte: 0.| |border\_width|integer|Amplada de la vora en píxels.<br><br>Per defecte: 0.| |border\_color|string|Color de la vora.<br><br>Per defecte: '000000'.| |background\_color|cadena|Color de fons (color de farcit).<br><br>Per defecte: `(buida)`.| |zindex|integer|Valor emprat per ordenar totes les formes i línies (índex z).<br><br>Per defecte: 0.|

en-us	#### Map sharing  Create a map with two types of sharing (user and user group).  Request:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map sharing",         "width": 600,         "height": 600,         "users": [             {                 "userid": "4",                 "permission": "3"             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": "2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Response:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 1 } ```
ca	#### compartir un mapa  Crear un mapa amb dos tipus de compartició (usuari i grup d'usuaris).  Petició:  ```json {     "jsonrpc": "2.0",     "method": "map.create",     "params": {         "name": "Map sharing",         "width": 600,         "height": 600,         "users": [             {                 "userid": "4",                 "permission": "3"             }         ],         "userGroups": [             {                 "usrgrpid": "7",                 "permission": "2"             }         ]     },     "auth": "038e1d7b1735c6a5436ee9eae095879e",     "id": 1 } ```  Resposta:  ```json {     "jsonrpc": "2.0",     "result": {         "sysmapids": [             "9"         ]     },     "id": 1 } ```

en-us	### Map  The map object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapid|string|*(readonly)* ID of the map.| |**height**<br>(required)|integer|Height of the map in pixels.| |**name**<br>(required)|string|Name of the map.| |**width**<br>(required)|integer|Width of the map in pixels.| |backgroundid|string|ID of the image used as the background for the map.| |expand\_macros|integer|Whether to expand macros in labels when configuring the map.<br><br>Possible values:<br>0 - *(default)* do not expand macros;<br>1 - expand macros.| |expandproblem|integer|Whether the problem trigger will be displayed for elements with a single problem.<br><br>Possible values:<br>0 - always display the number of problems;<br>1 - *(default)* display the problem trigger if there's only one problem.| |grid\_align|integer|Whether to enable grid aligning.<br><br>Possible values:<br>0 - disable grid aligning;<br>1 - *(default)* enable grid aligning.| |grid\_show|integer|Whether to show the grid on the map.<br><br>Possible values:<br>0 - do not show the grid;<br>1 - *(default)* show the grid.| |grid\_size|integer|Size of the map grid in pixels.<br><br>Supported values: 20, 40, 50, 75 and 100.<br><br>Default: 50.| |highlight|integer|Whether icon highlighting is enabled.<br><br>Possible values:<br>0 - highlighting disabled;<br>1 - *(default)* highlighting enabled.| |iconmapid|string|ID of the icon map used on the map.| |label\_format|integer|Whether to enable advanced labels.<br><br>Possible values:<br>0 - *(default)* disable advanced labels;<br>1 - enable advanced labels.| |label\_location|integer|Location of the map element label.<br><br>Possible values:<br>0 - *(default)* bottom;<br>1 - left;<br>2 - right;<br>3 - top.| |label\_string\_host|string|Custom label for host elements.<br><br>Required for maps with custom host label type.| |label\_string\_hostgroup|string|Custom label for host group elements.<br><br>Required for maps with custom host group label type.| |label\_string\_image|string|Custom label for image elements.<br><br>Required for maps with custom image label type.| |label\_string\_map|string|Custom label for map elements.<br><br>Required for maps with custom map label type.| |label\_string\_trigger|string|Custom label for trigger elements.<br><br>Required for maps with custom trigger label type.| |label\_type|integer|Map element label type.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing.| |label\_type\_host|integer|Label type for host elements.<br><br>Possible values:<br>0 - label;<br>1 - IP address;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_hostgroup|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_image|integer|Label type for host group elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>4 - nothing;<br>5 - custom.| |label\_type\_map|integer|Label type for map elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |label\_type\_trigger|integer|Label type for trigger elements.<br><br>Possible values:<br>0 - label;<br>2 - *(default)* element name;<br>3 - status only;<br>4 - nothing;<br>5 - custom.| |markelements|integer|Whether to highlight map elements that have recently changed their status.<br><br>Possible values:<br>0 - *(default)* do not highlight elements;<br>1 - highlight elements.| |severity\_min|integer|Minimum severity of the triggers that will be displayed on the map.<br><br>Refer to the [trigger "severity" property](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.| |show\_unack|integer|How problems should be displayed.<br><br>Possible values:<br>0 - *(default)* display the count of all problems;<br>1 - display only the count of unacknowledged problems;<br>2 - display the count of acknowledged and unacknowledged problems separately.| |userid|string|Map owner user ID.| |private|integer|Type of map sharing.<br><br>Possible values:<br>0 - public map;<br>1 - *(default)* private map.| |show\_suppressed|integer|Whether suppressed problems are shown.<br><br>Possible values:<br>0 - *(default)* hide suppressed problems;<br>1 - show suppressed problems.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Mapa  L'objecte mapa té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapid|string|*(només lectura)* ID del mapa.| |**height**<br>(obligatori)|integer|Alçada del mapa en píxels.| |**name**<br>(obligatori)|string|Nom de la tarja.| |**width**<br>(obligatori)|integer|Amplada del mapa en píxels.| |backgroundid|string|ID de la imatge emprada com a fons del mapa.| |expand\_macros|integer|Indica si s'han d'ampliar les macros a les etiquetes quan es configura el mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* no s'amplien; <br>1 - ampliar macros.| |expandproblem|integer|Indica si el trigger del problema es mostrarà per als elements amb un sol problema.<br><br>Valors possibles:<br>0 - sempre mostra el nombre de problemes;<br>1 - *(per defecte) * mostra el trigger del problema si només hi ha un problema.| |grid\_align|integer|Indica si s'ha d'activar l'alineació de la quadrícula.<br><br>Valors possibles:<br>0 - desactiva l'alineació de la quadrícula;<br>1 - *(per defecte)* activa l'encaix a la quadrícula.| |grid\_show|integer|Indica si s'ha de veure la graella al mapa.<br><br>Valors possibles:<br>0 - no mostra la graella;<br>1 - *(per defecte)* mostra la graella .| |grid\_size|integer|Mida de la quadrícula del mapa en píxels.<br><br>Valors admesos: 20, 40, 50, 75 i 100.<br><br>Per defecte: 50.| |highlight|integer|Indica si el ressaltat de les icones és habilitat.<br><br>Valors possibles:<br>0 - ressaltat desactivat;<br>1 - *(per defecte)* ressaltat activat.| |iconmapid|string|ID del mapa d'icones emprat al mapa.| |label\_format|integer|Indica si s'han d'activar les etiquetes avançades.<br><br>Valors possibles:<br>0 - *(per defecte)* desactiva les etiquetes avançades;<br>1 - activa-les.| |label\_location|integer|Ubicació de l'etiqueta de l'element del mapa.<br><br>Valors possibles:<br>0 - *(per defecte)* inferior;<br>1 - esquerra;<br >2 - dreta;< br>3 - a dalt.| |label\_string\_host|string|Etiqueta personalitzada per als elements d'equip.<br><br>Requerit per als mapes amb tipus d'etiqueta d'equip personalitzat.| |label\_string\_hostgroup|string|Etiqueta personalitzada per als elements del grup d'equips.<br><br>Requerit per als mapes amb tipus d'etiqueta de grup d'equips personalitzat.| |label\_string\_image|string|Etiqueta personalitzada per als elements d'imatge.<br><br>Requerit per als mapes amb tipus d'etiqueta d'imatge personalitzada.| |label\_string\_map|string|Etiqueta personalitzada per als elements del mapa.<br><br>Requerit per als mapes amb tipus d'etiqueta de mapa personalitzat.| |label\_string\_trigger|string|Etiqueta personalitzada per als elements trigger.<br><br>Obligatori per a targetes amb tipus d'etiqueta trigger personalitzat.| |label\_type|integer|Tipus d'etiqueta d'element del mapa.<br><br>Valors possibles:<br>0 - etiqueta;<br>1 - adreça IP;<br>2 - *(per defecte)* nom de l'element;< br>3 - només estat;<br>4 - res.| |label\_type\_host|integer|Tipus d'etiqueta per als elements de l'equip.<br><br>Valors possibles:<br>0 - etiqueta;<br>1 - adreça IP;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |label\_type\_hostgroup|integer|Tipus d'etiqueta per als elements del grup d'equips.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |label\_type\_image|integer|Tipus d'etiqueta per als elements de la imatge.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>4 - res;<br>5 - personalitzat.| |label\_type\_map|integer|Tipus d'etiqueta per als elements del mapa.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |label\_type\_trigger|integer|Tipus d'etiqueta per als triggers.<br><br>Valors possibles:<br>0 - etiqueta;<br>2 - *(per defecte)* nom de l'element;<br>3 - només estat;<br>4 - res;<br>5 - personalitzat.| |markelements|integer|Indica si cal ressaltar els elements del mapa que han canviat d'estat recentment.<br><br>Valors possibles:<br>0 - *(per defecte)* no ressalten els elements;<br>1 - ressalten els elements.| |severity\_min|integer|Gravetat mínima dels triggers que es mostraran al mapa.<br><br>Consulteu la [propietat "gravetat" d'un trigger](/manual/api/reference/trigger/object# trigger ) per obtindre un llistat de les gravetats admeses.| |show\_unack|integer|Com s'han de veure els problemes.<br><br>Valors possibles:<br>0 - *(per defecte)* ensenya el recompte de tots els problemes;<br>1 - ensenya només el nombre de problemes no reconeguts;<br>2 - ensenya el nombre de problemes reconeguts i no reconeguts per separat.| |userid|string|identificador de l'usuari propietari del mapa.| |private|integer|Tipus de compartició del mapa.<br><br>Valors possibles:<br>0 - mapa públic;<br>1 - *(per defecte)* mapa privat.| |show\_suppressed|integer|Indica si es mostren els problemes suprimits.<br><br>Valors possibles:<br>0 - *(per defecte)* amaga els problemes suprimits;<br>1 - ensenya els problemes suprimits.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Map  This class is designed to work with maps.  Object references:\  -   [Map](/manual/api/reference/map/object#map) -   [Map element](/manual/api/reference/map/object#map_element) -   [Map link](/manual/api/reference/map/object#map_link) -   [Map URL](/manual/api/reference/map/object#map_url) -   [Map user](/manual/api/reference/map/object#map_user) -   [Map user group](/manual/api/reference/map/object#map_user_group) -   [Map shape](/manual/api/reference/map/object#map_shapes) -   [Map line](/manual/api/reference/map/object#map_lines)  Available methods:\  -   [map.create](/manual/api/reference/map/create) - create new maps -   [map.delete](/manual/api/reference/map/delete) - delete maps -   [map.get](/manual/api/reference/map/get) - retrieve maps -   [map.update](/manual/api/reference/map/update) - update maps
ca	# Mapa  Aquesta classe és dissenyada per treballar amb mapes.  Referències d'objectes:\  -   [Mapa](/manual/api/reference/map/object#map) -   [Element de mapa](/manual/api/reference/map/object#map_element) -   [Enllaç de mapa](/manual/api/reference/map/object#map_link) -   [URL del mapa](/manual/api/reference/map/object#map_url) -   [Usuari del mapa](/manual/api/reference/map/object#map_user) -   [Grup d'usuaris del mapa](/manual/api/reference/map/object#map_user_group) -   [Forma de mapa](/manual/api/reference/map/object#map_shapes) -   [Línia de mapa](/manual/api/reference/map/object#map_lines)  Mètodes disponibles:\  -   [map.create](/manual/api/reference/map/create) - crear nous mapes -   [map.delete](/manual/api/reference/map/delete) - esborrar mapes -   [map.get](/manual/api/reference/map/get) - recuperar mapes -   [map.update](/manual/api/reference/map/update) - actualitzar mapes

en-us	# map.update
ca	# map.update

en-us	### Map URL  The map URL object defines a clickable link that will be available for all elements of a specific type on the map. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapurlid|string|*(readonly)* ID of the map URL.| |**name**<br>(required)|string|Link caption.| |**url**<br>(required)|string|Link URL.| |elementtype|integer|Type of map element for which the URL will be available.<br><br>Refer to the [map element "type" property](object#map_element) for a list of supported types.<br><br>Default: 0.| |sysmapid|string|ID of the map that the URL belongs to.|
ca	### URL de mapa  L'objecte defineix un enllaç on es pot fer clic que serà disponible per a tots els elements d'un tipus específic del mapa. Té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapurlid|string|*(només lectura)* ID de l'URL del mapa.| |**name**<br>(obligatori)|string|Títol de l'enllaç.| |**url**<br>(obligatori)|string|URL de l'enllaç.| |elementtype|integer|Tipus d'element de mapa per al qual l'URL serà disponible.<br><br>Consulteu [la propietat "elementtype" de l'element de mapa](object#map_element) per obtindre un llistat dels tipus admesos.<br> <br>Per defecte: 0.| |sysmapid|string|ID del mapa al qual pertany l'URL.|

en-us	### Map user group  List of map permissions based on user groups. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapusrgrpid|string|*(readonly)* ID of the map user group.| |**usrgrpid**<br>(required)|string|User group ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|
ca	### Grup d'usuaris del mapa  Llista dels permisos del mapa en funció del grup d'usuaris. L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapusergrpid|string|*(només lectura)* ID del grup d'usuaris del mapa.| |**usergrpid**<br>(obligatori)|string|ID del grup d'usuaris.| |**permission**<br>(obligatori)|integer|Nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;|

en-us	### Map user  List of map permissions based on users. It has the following properties:  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |sysmapuserid|string|*(readonly)* ID of the map user.| |**userid**<br>(required)|string|User ID.| |**permission**<br>(required)|integer|Type of permission level.<br><br>Possible values:<br>2 - read only;<br>3 - read-write;|
ca	### Usuari de mapa  Llista dels permisos del mapa en funció dels usuaris. L'objecte té les propietats següents:  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |sysmapuserid|string|*(només lectura)* ID del mapa d'usuari.| |**userid**<br>(obligatori)|string|ID d'usuari.| |**permission**<br>(obligatori)|integer|Nivell de permisos.<br><br>Valors possibles:<br>2 - només lectura;<br>3 - lectura i escriptura;|

en-us	 ### MariaDB 10.10 support  The maximum supported version for MariaDB is now 10.10.X.
ca	 ### Suport de la versió 10.10 de MariaDB  La versió més alta suportada de MariaDB és ara la 10.10.X.

en-us	### MariaDB 10.11 support  The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 10.11.X.
ca	### Suport de MariaDB 10.11  La [versió més nova suportada](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 10.11.X.

en-us	 ### MariaDB 10.7 support  The maximum supported version for MariaDB is now 10.7.X.
ca	 ### Suport de la versió 10.7 de MariaDB  La versió més alta suportada de MariaDB és ara la 10.7.X.

en-us	 ### MariaDB 10.8 support  The maximum supported version for MariaDB is now 10.8.X.
ca	 ### Suport de la versió 10.8 de MariaDB  La versió més alta suportada de MariaDB és ara la 10.8.X.

en-us	#### MariaDB 11.0 support  The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.0.X.
ca	#### Suport de MariaDB 11.10  La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 11.0.X.

en-us	#### MariaDB 11.2 support  The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.2.X.
ca	#### Suport de MariaDB 11.2  La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 11.2.X.

en-us	#### MariaDB 11.3 support  The maximum [supported version](/manual/installation/requirements#third-party-external-surrounding-software) for MariaDB is now 11.3.X.
ca	#### Suport de MariaDB 11.3  La [versió més nova admesa](/manual/installation/requirements#logiciel-denvironnement-externe-tiers) per MariaDB és la 11.3.X.

en-us	 #### MariaDB/MySQL 8.0+ without mysqlsh  This upgrade method takes more time and should be used only if an upgrade with *mysqlsh* is not possible.  ##### Table upgrade  * Log in to MySQL console as root (recommended) or any user with FILE privileges.   * Start MySQL with [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) variable enabled.  * Rename old tables and create new tables by running `history_pk_prepare.sql`:  ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ```  ##### Migration with stopped server  *max_execution_time* must be disabled before migrating data to avoid timeout during migration.  ``` {.sql} SET @@max_execution_time=0;  INSERT IGNORE INTO history SELECT * FROM history_old; INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old; INSERT IGNORE INTO history_str SELECT * FROM history_str_old; INSERT IGNORE INTO history_log SELECT * FROM history_log_old; INSERT IGNORE INTO history_text SELECT * FROM history_text_old; ```  Follow [post-migration instructions](#post-migration) to drop the old tables.  ##### Migration with running server  Check for which paths import/export is enabled:  ``` {.sql} mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv    | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ```  If *secure_file_priv* value is a path to a directory, export/import will be performed for  files in that directory. In this case, edit paths to files in queries accordingly or set the *secure_file_priv* value to an empty string for the upgrade time.   If *secure_file_priv* value is empty, export/import  can be performed from any location.    If *secure_file_priv* value is NULL, set it to the path that contains exported table data ('/var/lib/mysql-files/' in the example above).   For more information, see  [MySQL documentation](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_secure_file_priv).   *max_execution_time* must be disabled before exporting data to avoid timeout during export.  ``` {.sql} SET @@max_execution_time=0;  SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old; LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old; LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old; LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old; LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old; LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; ```  Follow [post-migration instructions](#post-migration) to drop the old tables.
ca	#### MariaDB/MySQL 8.0+ sense mysqlsh  Aquest mètode d'actualització pren més temps i s'ha d'emprar només si l'actualització amb *mysqlsh* no fos possible.  ##### Actualització de la taula  * Entreu a la consola de MySQL com a root (recomanat) o qualsevol altre usuari amb privilegis FILE.  * Engegueu MySQL amb la variable [local_infile](https://dev.mysql.com/doc/refman/8.0/en/server-system-variables.html#sysvar_local_infile) activa.  * Reanomeneu les taules antigues i creeu les noves executant `history_pk_prepare.sql`:  ``` {.bash} mysql -uzabbix -p<password> zabbix < /usr/share/zabbix-sql-scripts/mysql/history_pk_prepare.sql ```  ##### Migració amb el servidor aturat  S'ha de deshabilitar el *max_execution_time* abans de migrar la informació, per evitar que s'esgoti el temps d'espera durant la migració.  ``` {.sql} SET @@max_execution_time=0;  INSERT IGNORE INTO history SELECT * FROM history_old; INSERT IGNORE INTO history_uint SELECT * FROM history_uint_old; INSERT IGNORE INTO history_str SELECT * FROM history_str_old; INSERT IGNORE INTO history_log SELECT * FROM history_log_old; INSERT IGNORE INTO history_text SELECT * FROM history_text_old; ```  Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues.  ##### Migració amb el servidor en marxa  Reviseu per quines rutes import/export és activat:  ``` {.sql} mysql> SELECT @@secure_file_priv; +-----------------------+ | @@secure_file_priv    | +-----------------------+ | /var/lib/mysql-files/ | +-----------------------+ ```  Si el valor *secure_file_priv* és una ruta cap a un directori, export/import es farà per als arxius d'aquell directori. En aquest cas, editeu les rutes als arxius en consultes segons el valor *secure_file_priv* cap a una cadena buida per al temps d'actualització.  Si el valor *secure_file_priv* és buit, export/import pot fer-se des de qualsevol ubicació.  Si el valor *secure_file_priv* és NULL, establiu la ruta que conté la informació de la taula exportada ('/var/lib/mysql-files/' a l'exemple de més amunt).   Per tindre més informació, veieu la [documentació de MySQL](https://dev.mysql.com/doc/refman/5.7/en/server-system-variables.html#sysvar_secure_file_priv).  S'ha de deshabilitar el *max_execution_time* abans d'exportar informació, per evitar que s'esgoti el temps d'espera durant la exportació.  ``` {.sql} SET @@max_execution_time=0;  SELECT * INTO OUTFILE '/var/lib/mysql-files/history.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_old; LOAD DATA INFILE '/var/lib/mysql-files/history.csv' IGNORE INTO TABLE history FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_uint.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_uint_old; LOAD DATA INFILE '/var/lib/mysql-files/history_uint.csv' IGNORE INTO TABLE history_uint FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_str.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_str_old; LOAD DATA INFILE '/var/lib/mysql-files/history_str.csv' IGNORE INTO TABLE history_str FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_log.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_log_old; LOAD DATA INFILE '/var/lib/mysql-files/history_log.csv' IGNORE INTO TABLE history_log FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n';  SELECT * INTO OUTFILE '/var/lib/mysql-files/history_text.csv' FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n' FROM history_text_old; LOAD DATA INFILE '/var/lib/mysql-files/history_text.csv' IGNORE INTO TABLE history_text FIELDS TERMINATED BY ',' ESCAPED BY '"' LINES TERMINATED BY '\n'; ```  Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues.

en-us	##### Mass editing options  A button below the list offers one mass-editing option:  -   *Delete* - delete the maintenance periods  To use this option, mark the checkboxes before the respective maintenance periods and click on *Delete*.
ca	##### Opcions d'edició massiva  Un botó a sota de la llista ofereix una opció d'edició massiva:  - *Esborrar* - esborra els períodes de manteniment  Per emprar aquesta opció, marqueu les caselles davant dels períodes de manteniment respectius i feu clic a *Esborrar*.

en-us	##### Mass editing options  A button below the list offers one mass-editing option:  -   *Delete* - delete the scripts  To use this option, mark the checkboxes before the respective scripts and click on *Delete*.
ca	##### Opcions d'edició massiva  Un botó a sota de la llista ofereix una opció d'edició massiva:  - *Esborrar* - esborra scripts  Per emprar aquesta opció, marqueu les caselles davant dels scripts respectius i feu clic a *Esborrar*.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Copy* - copy the graphs to other hosts or templates -   *Delete* - delete the graphs  To use these options, mark the checkboxes before the respective graphs, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Copiar* - copia els gràfics a altres equips o models - *Esborrar* - esborra gràfics  Per emprar aquestes opcions, marqueu les caselles davant dels gràfics respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Copy* - copy the graphs to other hosts or templates -   *Delete* - delete the graphs  To use these options, mark the checkboxes before the respective graphs, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Copiar* - copia els gràfics a altres equips o models - *Esborrar* - esborra gràfics  Per emprar aquestes opcions, marqueu les caselles davant dels gràfics respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Create enabled* - create these hosts as *Enabled* -   *Create disabled* - create these hosts as *Disabled* -   *Delete* - delete these host prototypes  To use these options, mark the checkboxes before the respective host prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Crear activat* - crea aquests equips com a *Activat* - *Crear desactivat* - crea aquests equips com a *Desactivat* - *Esborrar* - esborra aquest prototip d'equips  Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'equips respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Create enabled* - create these hosts as *Enabled* -   *Create disabled* - create these hosts as *Disabled* -   *Delete* - delete these host prototypes  To use these options, mark the checkboxes before the respective host prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Crear activat* - crea aquests equips com a *Activat* - *Crear desactivat* - crea aquests equips com a *Desactivat* - *Esborrar* - esborra aquest prototip d'equips  Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'equips respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Create enabled* - create these items as *Enabled* -   *Create disabled* - create these items as *Disabled* -   *Mass update* - mass update these item prototypes -   *Delete* - delete these item prototypes  To use these options, mark the checkboxes before the respective item prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Crear activat* - crea aquests elements com a *Activat* - *Crear desactivat* - crea aquests elements com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips d'elements - *Esborrar* - esborra aquest prototip d'elements  Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'elements respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Create enabled* - create these items as *Enabled* -   *Create disabled* - create these items as *Disabled* -   *Mass update* - mass update these item prototypes -   *Delete* - delete these item prototypes  To use these options, mark the checkboxes before the respective item prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Crear activat* - crea aquests elements com a *Activat* - *Crear desactivat* - crea aquests elements com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips d'elements - *Esborrar* - esborra aquest prototip d'elements  Per emprar aquestes opcions, marqueu les caselles davant dels prototips d'elements respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Create enabled* - create these triggers as *Enabled* -   *Create disabled* - create these triggers as *Disabled* -   *Mass update* - mass update these trigger prototypes -   *Delete* - delete these trigger prototypes  To use these options, mark the checkboxes before the respective trigger prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Crear activat* - crea aquests triggers com a *Activat* - *Crear desactivat* - crea aquests triggers com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips de triggers - *Esborrar* - esborra aquest prototip de triggers   Per emprar aquestes opcions, marqueu les caselles davant dels prototips de triggers respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Create enabled* - create these triggers as *Enabled* -   *Create disabled* - create these triggers as *Disabled* -   *Mass update* - mass update these trigger prototypes -   *Delete* - delete these trigger prototypes  To use these options, mark the checkboxes before the respective trigger prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Crear activat* - crea aquests triggers com a *Activat* - *Crear desactivat* - crea aquests triggers com a *Desactivat* - *Actualització massiva* - actualitza en grup aquests prototips de triggers - *Esborrar* - esborra aquest prototip de triggers   Per emprar aquestes opcions, marqueu les caselles davant dels prototips de triggers respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Delete* - delete these graph prototypes  To use these options, mark the checkboxes before the respective graph prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Esborrar*: esborra aquests prototips de gràfics  Per emprar aquestes opcions, marqueu les caselles davant dels prototips de gràfics respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Delete* - delete these graph prototypes  To use these options, mark the checkboxes before the respective graph prototypes, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Esborrar*: esborra aquests prototips de gràfics  Per emprar aquestes opcions, marqueu les caselles davant dels prototips de gràfics respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change host status to *Monitored* -   *Disable* - change host status to *Not monitored* -   *Export* - export the hosts to a YAML, XML or JSON file -   *Mass update* - [update several     properties](/manual/config/hosts/hostupdate) for a number of hosts     at once -   *Delete* - delete the hosts  To use these options, mark the checkboxes before the respective hosts, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat de l'equip a *Monitorat* - *Desactivar* - canvia l'estat de l'equip a *No monitorat* - *Exportar* - exporta els equips a un fitxer YAML, XML o JSON - *Actualització massiva* - [actualitza diverses propietats](/manual/config/hosts/hostupdate) per a diversos equips alhora - *Esborrar* - esborra els equips  Per emprar aquestes opcions, marqueu les caselles davant dels equips respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change item status to *Enabled* -   *Disable* - change item status to *Disabled* -   *Check now* - execute a check for new item values immediately.     Supported for **passive** checks only (see [more     details](/manual/config/items/check_now)). Note that when checking     for values immediately, configuration cache is not updated, thus the     values will not reflect very recent changes to item configuration. -   *Clear history and trends* - delete history and trend data for items. -   *Copy* - copy the items to other hosts or templates. -   *Mass update* - [update several     properties](/manual/config/items/itemupdate) for a number of items     at once. -   *Delete* - delete the items.  To use these options, mark the checkboxes before the respective items, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat de l'element a *Activat* - *Desactivar* - canvia l'estat de l'element a *Desactivat* - *Comprovar ara* - executa tot seguit una comprovació dels valors d'elements nous. Només s'admet per a comprovacions **passives** (veieu [més detalls](/manual/config/items/check_now)). Tingueu en compte que quan comproveu els valors immediatament, la memòria cau de configuració no s'actualitza, de manera que els valors no reflectiran canvis molt recents a la configuració de l'element. - *Esborrar historial i tendències* - esborra l'historial d'elements i les dades de tendències. - *Copiar* - copia elements a altres equips o plantilles. - *Actualització massiva* - [actualitza diverses propietats](/manual/config/items/itemupdate) per a diversos elements alhora. - *Esborrar* - esborra elements.  Per emprar aquestes opcions, marqueu les caselles davant dels elements respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change item status to *Enabled*. -   *Disable* - change item status to *Disabled*. -   *Copy* - copy the items to other hosts or templates. -   *Mass update* - [update several     properties](/manual/config/items/itemupdate) for a number of items     at once. -   *Delete* - delete the items.  To use these options, mark the checkboxes before the respective items, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat de l'element a *Activat*. - *Desactivar* - canvia l'estat de l'element a *Desactivat*. - *Copiar* - copia els elements a altres equips o plantilles. - *Actualització massiva* - [actualitza diverses propietats](/manual/config/items/itemupdate) per a diversos elements alhora. - *Esborrar* - esborra els elements.  Per emprar aquestes opcions, marqueu les caselles davant dels elements respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the action status to *Enabled* -   *Disable* - change the action status to *Disabled* -   *Delete* - delete the actions  To use these options, mark the checkboxes before the respective actions, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat de l'acció a *Activat* - *Desactivar*: canvia l'estat de l'acció a *Desactivat* - *Esborrar*: esborra les accions  Per emprar aquestes opcions, marqueu les caselles davant de les accions respectives i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the correlation rule status to *Enabled* -   *Disable* - change the correlation rule status to *Disabled* -   *Delete* - delete the correlation rules  To use these options, mark the checkboxes before the respective correlation rules, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat de la regla de correlació a *Activada* - *Desactivar*: canvia l'estat de la regla de correlació a *Desactivada* - *Esborrar*: esborra les regles de correlació  Per emprar aquestes opcions, marqueu les caselles davant de les regles de correlació respectives i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the discovery rule status to *Enabled* -   *Disable* - change the discovery rule status to *Disabled* -   *Delete* - delete the discovery rules  To use these options, mark the checkboxes before the respective discovery rules, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat de la regla de descoberta a *Activada* - *Desactivar*: canvia l'estat de la regla de descoberta a *Desactivada* - *Esborrar*: esborra les regles de descoberta   Per emprar aquestes opcions, marqueu les caselles davant de les regles de descoberta respectives i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the low-level discovery rule status to *Enabled*. -   *Disable* - change the low-level discovery rule status to     *Disabled*. -   *Check now* - perform discovery based on the discovery rules     immediately. See [more details](/manual/config/items/check_now).     Note that when performing discovery immediately, the configuration     cache is not updated, thus the result will not reflect very recent     changes to discovery rule configuration. -   *Delete* - delete the low-level discovery rules.  To use these options, mark the checkboxes before the respective discovery rules, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat de la regla de descoberta de baix nivell a *Activat*. - *Desactivar* - canvia l'estat de la regla de descoberta de baix nivell a *Desactivat*. - *Verifica ara* - realitza immediatament la descoberta en funció de les regles de descoberta; veieu [més detalls](/manual/config/items/check_now). Tingueu en compte que quan s'executa la descoberta immediatament, la memòria cau de configuració no s'actualitza, de manera que el resultat no reflectirà els canvis molt recents a la configuració de la regla de descoberta. - *Esborra* - esborra les regles de descoberta de baix nivell.  Per emprar aquestes opcions, marqueu les caselles davant de les regles de descoberta respectives i, a continuació, feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the low-level discovery rule status to *Enabled* -   *Disable* - change the low-level discovery rule status to *Disabled* -   *Delete* - delete the low-level discovery rules  To use these options, mark the checkboxes before the respective discovery rules, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat de la regla de descoberta de baix nivell a *Activada* - *Desactivar*: canvia l'estat de la regla de descoberta de baix nivell a *Desactivada* - *Esborrar*: esborra les regles de descoberta de baix nivell  Per emprar aquestes opcions, marqueu les caselles davant de les regles de descoberta respectives i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the media type status to *Enabled* -   *Disable* - change the media type status to *Disabled* -   *Export* - export the media types to a YAML, XML or JSON file -   *Delete* - delete the media types  To use these options, mark the checkboxes before the respective media types, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat del tipus de suport a *Activat* - *Desactivar*: canvia l'estat del tipus de suport a *Desactivat* - *Exportar*: exporta els tipus de suport a un fitxer YAML, XML o JSON - *Esborrar*: esborra els tipus de suports  Per emprar aquestes opcions, marqueu les caselles davant dels tipus de suports respectius i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the scenario status to *Enabled* -   *Disable* - change the scenario status to *Disabled* -   *Clear history and trends* - clear history and trend data for the scenarios -   *Delete* - delete the web scenarios  To use these options, mark the checkboxes before the respective web scenarios, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat de l'escenari a *Activat* - *Desactivar* - canvia l'estat de l'escenari a *Desactivat* - *Esborrar historial i tendències* - esborra l'historial i les dades de tendències dels escenaris - *Esborrar* - esborra escenaris web  Per emprar aquestes opcions, marqueu les caselles davant dels escenaris web respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the scenario status to *Enabled* -   *Disable* - change the scenario status to *Disabled* -   *Delete* - delete the web scenarios  To use these options, mark the checkboxes before the respective web scenarios, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat de l'escenari a *Activat* - *Desactivar*: canvia l'estat de l'escenari a *Desactivat* - *Esborrar*: esborra els escenaris  Per emprar aquestes opcions, marqueu les caselles davant dels escenaris web respectius i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change the user group status to *Enabled* -   *Disable* - change the user group status to *Disabled* -   *Enable debug mode* - enable debug mode for the user groups -   *Disable debug mode* - disable debug mode for the user groups -   *Delete* - delete the user groups  To use these options, mark the checkboxes before the respective user groups, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilitar*: canvia l'estat del grup d'usuaris a *Activat* - *Desactivar*: canvia l'estat del grup d'usuaris a *Desactivat* - *Habilitar mode de depuració*: habilita el mode de depuració per als grups d'usuaris - *Deshabilitar mode de depuració*: deshabilita el mode de depuració per als grups d'usuaris - *Esborrar*: esborra els grups d'usuaris  Per emprar aquestes opcions, marqueu les caselles davant dels grups d'usuaris respectius i feu clic al botó necessari.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change trigger status to *Enabled*. -   *Disable* - change trigger status to *Disabled*. -   *Copy* - copy the triggers to other hosts or templates. -   *Mass update* - update several properties for a number of triggers     at once. -   *Delete* - delete the triggers.  To use these options, mark the checkboxes before the respective triggers, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat d'activació a *Activat*. - *Desactivar* - canvia l'estat d'activació a *Desactivat*. - *Copiar* - copia els triggers a altres equips o plantilles. - *Actualització massiva* - actualitza diverses propietats per a diversos triggers alhora. - *Esborrar* - esborra els triggers.  Per emprar aquestes opcions, marqueu les caselles davant dels triggers respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable* - change trigger status to *Enabled* -   *Disable* - change trigger status to *Disabled* -   *Copy* - copy the triggers to other hosts or templates -   *Mass update* - update several properties for a number of triggers     at once -   *Delete* - delete the triggers  To use these options, mark the checkboxes before the respective triggers, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Activar* - canvia l'estat d'activació a *Activat* - *Desactivar* - canvia l'estat d'activació a *Desactivat* - *Copiar* - copia els triggers a altres equips o plantilles - *Actualització massiva* - actualitza diverses propietats per a diversos triggers alhora - *Esborrar* - esborra els triggers  Per emprar aquestes opcions, marqueu les caselles davant dels triggers respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable hosts* - change the status of all hosts in the group to     "Monitored" -   *Disable hosts* - change the status of all hosts in the group to     "Not monitored" -   *Delete* - delete the host groups  To use these options, mark the checkboxes before the respective host groups, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista ofereixen opcions d'edició col·lectiva:  - *Activa els equips*: canvia l'estat de tots els equips del grup a "Monitorat" - *Desactiva els equips*: canvia l'estat de tots els equips del grup a "Sense monitorar". - *Esborra* - esborra els grups d'equips  Per emprar aquestes opcions, marqueu les caselles davant dels grups d'equips respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Enable hosts* - change the status of hosts monitored by the proxy     to *Monitored* -   *Disable hosts* - change the status of hosts monitored by the proxy     to *Not monitored* -   *Delete* - delete the proxies  To use these options, mark the checkboxes before the respective proxies, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Habilita els equips*: canvieu l'estat dels equips monitorats pel proxy a *Monitorat* - *Desactiva els equips*: canvia l'estat dels equips monitorats pel proxy a *No monitorat* - *Esborrar* - esborra proxys  Per emprar aquestes opcions, marqueu les caselles davant dels proxys respectius i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Export* - export the template to a YAML, XML or JSON file -   *Mass update* - [update several     properties](/manual/config/templates/mass) for a number of templates     at once -   *Delete* - delete the template while leaving its linked entities     (items, triggers etc.) with the hosts -   *Delete and clear* - delete the template and its linked entities     from the hosts  To use these options, mark the checkboxes before the respective templates, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Exportar* - exporta el model a un fitxer YAML, XML o JSON - *Actualització massiva* - [actualitza diverses propietats](/manual/config/templates/mass) per a diverses plantilles alhora - *Esborrar* - esborra el model deixant les seves entitats relacionades (elements, triggers, etc.) als equips - *Esborrar i netejar* - esborra el model i les entitats relacionades dels equips  Per emprar aquestes opcions, marqueu les caselles davant de les plantilles respectives i feu clic al botó requerit.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Mass update* - update the selected problems by navigating to the     [problem update](/manual/acknowledges#updating_problems) screen  To use this option, mark the checkboxes before the respective problems, then click on the *Mass update* button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Actualització massiva* - actualitzeu els problemes triats anant a la pantalla [problemes d'actualització](/manual/acknowledges#updating_problems)  Per emprar aquesta opció, marqueu les caselles davant dels problemes respectius i feu clic al botó *Actualització massiva*.

en-us	##### Mass editing options  Buttons below the list offer some mass-editing options:  -   *Unblock* - re-enable system access to blocked users -   *Delete* - delete the users  To use these options, mark the check-boxes before the respective users, then click on the required button.
ca	##### Opcions d'edició massiva  Els botons de sota de la llista proporcionen opcions d'edició massiva:  - *Desbloca*: torna a habilitar l'accés al sistema per als usuaris blocats - *Esborra* - esborra usuaris  Per emprar aquestes opcions, marqueu les caselles davant dels respectius usuaris i feu clic al botó requerit.

en-us	##### Mass update  Sometimes you may want to delete or change the status of a number of reports at once. Instead of opening each individual report for editing, you may use the mass update function for that.  To mass-update some reports, do the following:  -   Mark the checkboxes of the reports to update in the list -   Click the required button below the list to make the changes (*Enable*, *Disable*, or *Delete*)
ca	##### Actualització massiva  De vegades, és possible que vulgueu esborrar o canviar l'estat de diversos informes. En lloc d'obrir cada informe individual per editar-lo, podeu emprar la funció d'actualització massiva per a això.  Per actualitzar de manera massiva determinats informes, seguiu aquestes passes:  - Marqueu les caselles dels informes a actualitzar a la llista - Feu clic al botó necessari a sota de la llista per fer canvis (*Activar*, *Desactivar* o *Esborrar*).

en-us	##### Master item  Create an IPMI item using the following key:      ipmi.get  ![](../../../../../assets/en/manual/discovery/low_level_discovery/ipmi_get_item.png)  Set the type of information to "Text" for possibly big JSON data.
ca	##### Element principal  Creeu un element IPMI amb la clau següent:       ipmi.get  ![](../../../../../assets/en/manual/discovery/low_level_discovery/ipmi_get_item.png)  Estableix el tipus d'informació a "Text" per a dades JSON possiblement grans.

en-us	##### Master item  Create a Zabbix agent item using the following key:      vfs.fs.get  ![](../../../../../assets/en/manual/discovery/low_level_discovery/fs_get_item.png)  Set the type of information to "Text" for possibly big JSON data.  The data returned by this item will contain something like the following for a mounted filesystem:  ``` {.java} {   "fsname": "/",   "fstype": "rootfs",   "bytes": {     "total": 1000,     "free": 500,     "used": 500,     "pfree": 50.00,     "pused": 50.00   },   "inodes": {     "total": 1000,     "free": 500,     "used": 500,     "pfree": 50.00,     "pused": 50.00   } } ```
ca	##### Element mestre  Creeu un element d'agent Zabbix amb la clau següent:       vfs.fs.get  ![](../../../../../assets/en/manual/discovery/low_level_discovery/fs_get_item.png)  Estableix el tipus d'informació a "Text" per a dades JSON possiblement grans.  Les dades que retorna aquest element contindran alguna cosa com el següent per a un sistema de fitxers muntat:  ``` {.java} {   "fsname": "/",   "fstype": "rootfs",   "bytes": {     "total": 1000,     "free": 500,     "used": 500,     "pfree": 50.00,     "pused": 50.00   },   "inodes": {     "total": 1000,     "free": 500,     "used": 500,     "pfree": 50.00,     "pused": 50.00   } } ```

en-us	#### Maximum JSON depth  The maximum allowed JSON depth has been set to 64 to improve security and performance during JSON parsing.
ca	#### Profunditat màxima de JSON  La profunditat JSON màxima permesa s'ha establert en 64 per millorar la seguretat i el rendiment durant l'anàlisi JSON.

en-us	### Media  The media object has the following properties.  |Property|Type|Description| |--------|----|-----------| |**mediatypeid**<br>(required)|string|ID of the media type used by the media.| |**sendto**<br>(required)|string/array|Address, user name or other identifier of the recipient.<br><br>If type of [Media type](/manual/api/reference/mediatype/object#mediatype) is e-mail, values are represented as array. For other types of [Media types](/manual/api/reference/mediatype/object#mediatype), value is represented as a string.| |**active**|integer|Whether the media is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |**severity**|integer|Trigger severities to send notifications about.<br><br>Severities are stored in binary form with each bit representing the corresponding severity. For example, 12 equals 1100 in binary and means, that notifications will be sent from triggers with severities warning and average.<br><br>Refer to the [trigger object page](/manual/api/reference/trigger/object#trigger) for a list of supported trigger severities.<br><br>Default: 63| |**period**|string|Time when the notifications can be sent as a [time period](/manual/appendix/time_period) or user macros separated by a semicolon.<br><br>Default: 1-7,00:00-24:00|
ca	### Suport  L'objecte suport té les propietats següents.  |Propietat|Tipus|Descripció| |--------|----|-----------| |**mediatypeid**<br>(obligatori)|string|ID del tipus de suport emprat per el suport.| |**sendto**<br>(obligatori)|string/array|L'adreça, el nom d'usuari o un altre identificador del destinatari.<br><br>Si el [tipus de suport](/en/manual/api/reference/mediatype /object#type_de_media) és un correu electrònic, els valors es representen com una matriu. Per a altres [tipus de suport](/en/manual/api/reference/mediatype/object#type_de_media), el valor es representa amb una cadena.| |**active**|integer|Indica si el suport és habilitat.<br><br>Valors possibles:<br>0 - *(per defecte)* activat;<br>1 - desactivat.| |**severity**|integer|Activa les gravetats per enviar notificacions.<br><br>Les gravetats s'emmagatzemen en forma binària, amb cada bit que representa la gravetat corresponent. Per exemple, 12 és igual a 1100 en binari i vol dir que s'enviaran notificacions des de triggers d'advertiment i de gravetat mitjana.<br><br>Consulteu la [pàgina d'objecte trigger](/en/manual/api/reference/trigger/object# trigger) per obtindre una llista de gravetats del trigger admeses.<br><br>Per defecte: 63| |**period**|string|Hora en què les notificacions es poden enviar com a [període](/ca/manual/appendix/time_period) o macros d'usuari separades per punt i coma.<br><br> Per defecte: 1-7.00: 00-24:00|

en-us	#### mediatype  Changes:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) message template object: added support of `conditiontype` value: 4 - *(event created on service status update)*.\
ca	#### mediatype  Canvis:\ [ZBXNEXT-6755](https://support.zabbix.com/browse/ZBXNEXT-6755) objecte de plantilla de missatge: al valor `conditiontype` se li ha afegit el suport: 4 - *(esdeveniment creat en actualitzar l'estat del servei)*.\

en-us	#### mediatype  Changes:\ [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: added strict validation of the methods parameters.\
ca	#### tipus de mitjà  Canvis:\ [ZBXNEXT-6885](https://support.zabbix.com/browse/ZBXNEXT-6885) `mediatype.create`, `mediatype.update`: afegida la validació estricta dels paràmetres dels mètodes.\

en-us	# mediatype.create
ca	# mediatype.create

en-us	# mediatype.delete
ca	# mediatype.delete

en-us	# mediatype.get
ca	# mediatype.get

en-us	# > Media type object  The following objects are directly related to the `mediatype` API.
ca	# > Objecte de tipus de suport  Els següents objectes són relacionats amb l'API `mediatype`.

en-us	#### Media type testing  It is possible to test if a configured media type works.  **Email**  For example, to test an email media type:  -   Locate the relevant email in the [list](#overview) of media types -   Click on *Test* in the last column of the list (a testing window     will open) -   Enter a *Send to* recipient address and with body and optional     subject -   Send a test message by clicking on *Test*  Test success or failure message will be displayed in the same window:  |<|![](../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"}| |-|-----------------------------------------------------------------------------------------|  **Webhook**  To test a webhook media type:  -   Locate the relevant webhook in the [list](#overview) of media types -   Click on *Test* in the last column of the list (a testing window     will open) -   Edit the webhook parameter values, if needed -   Click on *Test*  By default, webhook tests are performed with parameters entered during configuration. However, it is possible to change attribute values for testing. Replacing or deleting values in the testing window affects the test procedure only, the actual webhook attribute values will remain unchanged.  |<|![](../../../../assets/en/manual/config/webhook_test1.png){width="600"}| |-|-----------------------------------------------------------------------|  To view media type test log entries without leaving the test window:  -   Click on *Open log* (a new popup window will open).  |<|![](../../../../assets/en/manual/config/mediatype_test2.png){width="600"}| |-|-------------------------------------------------------------------------|
ca	#### Test de tipus de suport  Es pot provar si un tipus de suport configurat funciona.  **Correu electrònic**  Per exemple, per provar un tipus de suport de correu electrònic:  - Feu clic a *Provar* a la darrera columna de la llista (s'obrirà una finestra de prova) - Introduïu una adreça de destinatari *Enviar a* i el cos i l'assumpte opcionals - Envieu un missatge de prova fent clic a *Provar*  El missatge d'aprovat o no de la prova es veurà a la mateixa finestra:  |<|![](../../../../assets/en/manual/config/notifications/media/test_email0.png){width="600"}| |-|------------------------------------------------ --------------------------------------------|  **Webhook**  Per provar un tipus de suport de webhook:  - Localitzeu el webhook rellevant a la [llista](#vista general) de tipus de suport - Feu clic a *Provar* a la darrera columna de la llista (s'obrirà una finestra de prova) - Modifiqueu els valors dels paràmetres del webhook, si cal - Feu clic a *Provar*  Per defecte, les proves de webhook es fan amb els paràmetres introduïts durant la configuració. Tanmateix, és possible modificar els valors dels atributs de les proves. La substitució o la supressió de valors a la finestra de prova només afecta el procediment de prova, els valors reals dels atributs del webhook es mantindran sense canvis.  |<|![](../../../../assets/en/manual/config/webhook_test1.png){width="600"}| |-|------------------------------------------------ -------------------------|  Per veure les entrades del registre de prova de tipus de suport sense sortir de la finestra de prova:  - Feu clic a *Obre el registre* (s'obrirà una nova finestra emergent).  |<|![](../../../../assets/en/manual/config/mediatype_test2.png){width="600"}| |-|------------------------------------------------ --------------------------|

en-us	### Media type  The media type object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |mediatypeid|string|*(readonly)* ID of the media type.| |**name**<br>(required)|string|Name of the media type.| |**type**<br>(required)|integer|Transport used by the media type.<br><br>Possible values:<br>0 - email;<br>1 - script;<br>2 - SMS;<br>4 - Webhook.| |exec\_path|string|For script media types `exec_path` contains the name of the executed script.<br><br>Required for script media types.| |gsm\_modem|string|Serial device name of the GSM modem.<br><br>Required for SMS media types.| |passwd|string|Authentication password.<br><br>Used for email media types.| |smtp\_email|string|Email address from which notifications will be sent.<br><br>Required for email media types.| |smtp\_helo|string|SMTP HELO.<br><br>Required for email media types.| |smtp\_server|string|SMTP server.<br><br>Required for email media types.| |smtp\_port|integer|SMTP server port to connect to.| |smtp\_security|integer|SMTP connection security level to use.<br><br>Possible values:<br>0 - None;<br>1 - STARTTLS;<br>2 - SSL/TLS.| |smtp\_verify\_host|integer|SSL verify host for SMTP.<br><br>Possible values:<br>0 - No;<br>1 - Yes.| |smtp\_verify\_peer|integer|SSL verify peer for SMTP.<br><br>Possible values:<br>0 - No;<br>1 - Yes.| |smtp\_authentication|integer|SMTP authentication method to use.<br><br>Possible values:<br>0 - None;<br>1 - Normal password.| |status|integer|Whether the media type is enabled.<br><br>Possible values:<br>0 - *(default)* enabled;<br>1 - disabled.| |username|string|User name.<br><br>Used for email media types.| |exec\_params|string|Script parameters.<br><br>Each parameter ends with a new line feed.| |maxsessions|integer|The maximum number of alerts that can be processed in parallel.<br><br>Possible values for SMS:<br>1 - *(default)*<br><br>Possible values for other media types:<br>0-100| |maxattempts|integer|The maximum number of attempts to send an alert.<br><br>Possible values:<br>1-100<br><br>Default value:<br>3| |attempt\_interval|string|The interval between retry attempts. Accepts seconds and time unit with suffix.<br><br>Possible values:<br>0-1h<br><br>Default value:<br>10s| |content\_type|integer|Message format.<br><br>Possible values:<br>0 - plain text;<br>1 - *(default)* html.| |script|string|Media type webhook script javascript body.| |timeout|string|Media type webhook script timeout. Accepts seconds and time unit with suffix.<br><br>Possible values:<br>1-60s<br><br>Default value:<br>30s| |process\_tags|integer|Defines should the webhook script response to be interpreted as tags and these tags should be added to associated event.<br><br>Possible values:<br>0 - *(default)* Ignore webhook script response.<br>1 - Process webhook script response as tags.| |show\_event\_menu|integer|Show media type entry in `problem.get` and `event.get` property `urls`.<br><br>Possible values:<br>0 - *(default)* Do not add `urls` entry.<br>1 - Add media type to `urls` property.| |event\_menu\_url|string|Define `url` property of media type entry in `urls` property of `problem.get` and `event.get`.| |event\_menu\_name|string|Define `name` property of media type entry in `urls` property of `problem.get` and `event.get`.| |parameters|array|Array of [webhook input parameters](/manual/api/reference/mediatype/object#webhook-parameters).| |description|string|Media type description.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Tipus de suport  L'objecte de tipus de suport té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data-types)|Descripció| |--|--|------| |mediatypeid|string|*(només lectura)* ID del tipus de suport.| |**name**<br>(obligatori)|string|Nom del tipus de suport.| |**type**<br>(obligatori)|integer|Transport emprat pel tipus de suport.<br><br>Valors possibles:<br>0 - correu-e;<br>1 - script;<br>2 - SMS;<br>4 - Webhook.| |exec\_path|string|Per als tipus de suport d'script, `exec_path` conté el nom de l'script executat.<br><br>Requerit per als tipus de suport d'script.| |gsm\_modem|string|Nom del dispositiu sèrie del mòdem GSM.<br><br>Requerit per als tipus de suports SMS.| |passwd|string|Mot de pas d'autenticació.<br><br>S'empra per als tipus de mitjans de correu-e.| |smtp\_email|string|Adreça de correu-e des de la que s'enviaran les notificacions.<br><br>Requerit per als tipus de mitjans de correu-e.| |smtp\_helo|string|SMTP HELO.<br><br>Requerit per als tipus de suports de correu-e.| |smtp\_server|string|Servidor SMTP.<br><br>Requerit per als tipus de mitjans de correu-e.| |smtp\_port|integer|Port del servidor SMTP per connectar-se.| |smtp\_security|integer|Nivell de seguretat de la connexió SMTP que cal emprar.<br><br>Valors possibles:<br>0 - Cap;<br>1 - STARTTLS;<br>2 - SSL/TLS.| |smtp\_verify\_host|integer|SSL verifica l'equip per a SMTP.<br><br>Valors possibles:<br>0 - No;<br>1 - Sí.| |smtp\_verify\_peer|integer|SSL verifica el parell per a SMTP.<br><br>Valors possibles:<br>0 - No;<br>1 - Sí.| |smtp\_authentication|integer|Mètode d'autenticació SMTP que cal emprar.<br><br>Valors possibles:<br>0 - Cap;<br>1 - Mot de pas normal.| |status|integer|Si el tipus de suport és habilitat.<br><br>Valors possibles:<br>0 - *(per defecte)* activat;<br>1 - desactivat.| |username|integer|Nom d'usuari.<br><br>S'empra per als tipus de mitjans de correu-e.| |exec\_params|string|Paràmetres d'script.<br><br>Cada paràmetre acaba amb un salt de línia nova.| |maxsessions|integer|El nombre màxim d'alertes que es poden processar en paral·lel.<br><br>Valors possibles per a SMS:<br>1 - *(per defecte)*<br><br>Valors possibles ​​per a altres tipus de suports:<br>0-100| |maxattempts|integer|El nombre màxim d'intents per enviar una alerta.<br><br>Valors possibles:<br>1-100<br><br>Per defecte:<br>3| |attempt\_interval|string|L'interval de reintent. Accepta segons i unitat de temps amb sufix.<br><br>Valors possibles:<br>0-1h<br><br>Valor per defecte:<br>10s| |content\_type|integer|Format del missatge.<br><br>Valors possibles:<br>0 - text sense format;<br>1 - *(per defecte)* html.| |script|string|Cos de JavaScript de l'script del tipus de suport webhook.| |timeout|string|Temps d'espera de l'script del tipus de suport Webhook. Accepta segons i unitat de temps amb sufix.<br><br>Valors possibles:<br>1-60s<br><br>Valor per defecte:<br>30s| |process\_tags|integer|Defineix si la resposta de l'script webhook s'ha d'interpretar com a etiquetes i aquestes etiquetes s'han d'afegir a l'esdeveniment associat.<br><br>Valors possibles:<br>0 - *(per defecte) * Ignora la resposta de l'script webhook.<br>1 - Tracta la resposta de l'script webhook com a etiquetes.| |show\_event\_menu|integer|Mostra l'entrada del tipus de suport a `problem.get` i `event.get` a la propietat `urls`.<br><br>Valors possibles:<br>0 - *(per defecte)* No afegiu l'entrada `urls`.<br>1 - Afegeix un tipus de suport a la propietat `urls`.| |event\_menu\_url|string|Defineix la propietat `url` de l'entrada del tipus de suport a la propietat `urls` de `problem.get` i `event.get`.| |event\_menu\_name|string|Defineix la propietat `name` de l'entrada del tipus de suport a la propietat `urls` de `problem.get` i `event.get`.| |parameters|array|Matriu de [paràmetres d'entrada del webhook](/manual/api/reference/mediatype/object#webhook-parameters).| |description|string|Descripció del tipus de suport.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Media type  This class is designed to work with media types.  Object references:\  -   [Media type](/manual/api/reference/mediatype/object#media_type)  Available methods:\  -   [mediatype.create](/manual/api/reference/mediatype/create) -     creating new media types -   [mediatype.delete](/manual/api/reference/mediatype/delete) -     deleting media types -   [mediatype.get](/manual/api/reference/mediatype/get) - retrieving     media types -   [mediatype.update](/manual/api/reference/mediatype/update) -     updating media types
ca	# Tipus de suport  Aquesta classe és dissenyada per treballar amb tipus de suport.  Referències d'objectes:\  -   [Tipus de suport](/manual/api/reference/mediatype/object#media_type)  Mètodes disponibles:\  -   [mediatype.create](/manual/api/reference/mediatype/create) - crear nous tipus de suport -   [mediatype.delete](/manual/api/reference/mediatype/delete) - esborrar tipus de suport -   [mediatype.get](/manual/api/reference/mediatype/get) - recuperar tipus de suport -   [mediatype.update](/manual/api/reference/mediatype/update) - actualitzar tipus de suport

en-us	# mediatype.update
ca	# mediatype.update

en-us	### Media type URL  The media type URL object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Media type defined URL name.| |url|string|Media type defined URL value.|  Results will contain entries only for active media types with enabled event menu entry. Macro used in properties will be expanded, but if one of the properties contains an unexpanded macro, both properties will be excluded from results. For supported macros, see [*Supported macros*](/manual/appendix/macros/supported_by_location).
ca	### URL dels tipus de suport  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|string|nom d'URL definit pel tipus de suport.| |url|string|valor d'URL definit pel tipus de suport.|  Els resultats contindran entrades només per als tipus de suport actius amb una entrada de menú d'esdeveniments activada. La macro emprada a les propietats s'ampliarà, però si una de les propietats conté una macro no ampliada, ambdues propietats s'exclouran dels resultats. Les macros compatibles són descrites en aquesta [pàgina](/manual/appendix/macros/supported_by_location).

en-us	### Media type URL  The media type URL object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |name|string|Media type defined URL name.| |url|string|Media type defined URL value.|  Results will contain entries only for active media types with enabled event menu entry. Macro used in properties will be expanded, but if one of the properties contains an unexpanded macro, both properties will be excluded from results. For supported macros, see [*Supported macros*](/manual/appendix/macros/supported_by_location).
ca	### URL dels tipus de suport  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |name|string|nom d'URL definit pel tipus de suport.| |url|string|valor d'URL definit pel tipus de suport.|  Els resultats contindran entrades només per als tipus de suport actius amb una entrada de menú d'esdeveniments activada. La macro emprada a les propietats s'ampliarà, però si una de les propietats conté una macro no ampliada, ambdues propietats s'exclouran dels resultats. Les macros compatibles són descrites en aquesta [pàgina](/manual/appendix/macros/supported_by_location).

en-us	 ### Memcached  |Key|<|<|<| |--|--|------|------| |**Description**|**Return value**|**Parameters**|**Comments**| |memcached.ping\[connString,<user>,<password>\]|<|<|<| |Test if a connection is alive or not.|1 - connection is alive<br><br>0 - connection is broken (if there is any error presented including AUTH and configuration issues)|**connString** - URI or session name.| | |memcached.stats\[connString,<user>,<password>,<type>\]|<|<|<| |Gets the output of the STATS command.|JSON - output is serialized as JSON|**connString** - URI or session name.<br>**user, password** - Memcached login credentials.<br>**type** - stat type to be returned: *items*, *sizes*, *slabs* or *settings* (empty by default, returns general statistics).| |
ca	### Memcached  |Clau|<|<|<| |--|--|------|------| |**Descripció**|**Valor de retorn**|**Paràmetres**|**Comentaris**| |memcached.ping\[connString,\<usuari\>,\<mot de pas\>\]|<|<|<| |Prova si una connexió és activa o no.|1 - la connexió és activa<br><br>0 - la connexió s'ha avortat (en cas d'error, inclosos problemes d'AUTH i de configuració)|**connString** - URI o nom de sessió.| | |memcached.stats\[connString,\<usuari\>,\<mot de pas\>,\<tipus\>\]|<|<|<| |Obté la sortida de l'ordre STATS.|JSON - la sortida es serialitza com a JSON|**connString** - URI o nom de sessió.<br>**usuari, mot de pas** - credencials d'inici de sessió Memchached.<br>**tipus** - tipus d'estadístiques a retornar: *elements*, *mida*, *lloses* o *configuració* (buit per defecte, retorna estadístiques generals).| |

en-us	#### Memory suffixes  Memory size suffixes are supported in:  -   trigger [expression](/manual/config/triggers/expression) constants     and function parameters -   constants of [calculated     item](/manual/config/items/itemtypes/calculated) formulas  For memory size you can use:  -   **K** - kilobyte -   **M** - megabyte -   **G** - gigabyte -   **T** - terabyte
ca	#### Sufixos de memòria  Els sufixos de mida de memòria s'admeten a:  - les [expressions](/manual/config/triggers/expression) de les constants i els paràmetres de funció de triggers. - les fòrmules de les constants dels [elements calculats](/manual/config/items/itemtypes/calculated)  Per la mida de la memòria, podeu emprar:  - **K** - kilooctet - **M** - megaoctet - **G** - gigaoctet - **T** - teraoctet

en-us	**Memory**  Zabbix requires both physical and disk memory. The amount of required  disk memory obviously depends on the number of hosts and parameters that are being monitored. If you're planning to keep a long history of monitored parameters, you should be thinking of at least a couple of gigabytes to have enough space to store the history in the database. Each Zabbix daemon process requires several connections to a database server. The amount of memory allocated for the connection depends on the configuration of the database engine.   ::: noteclassic The more physical memory you have, the faster the database (and therefore Zabbix) works.  :::
ca	**Memòria**  Zabbix requereix memòria física i memòria de disc. 128 Mo de memòria física i 256 Mo d'espai lliure en disc poden ser un bon punt de partida. No obstant això, la quantitat de memòria de disc necessària, òbviament, depèn del nombre d'equips i paràmetres que es controlen. Si teniu previst mantindre un gran historial de paràmetres monitorats, hauríeu de considerar almenys uns quants gigaoctets per tindre prou espai per emmagatzemar l'historial a la base de dades. Cada procés de dimoni Zabbix requereix diverses connexions a un servidor de bases de dades. La quantitat de memòria assignada a la connexió depèn de la configuració del motor de base de dades.  :::noteclassic Com més memòria física tingui, més ràpid s'executarà la base de dades (i, per tant, Zabbix). :::

en-us	### Message template  The message template object defines a template that will be used as a default message for action operations to send a notification. It has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |**eventsource**<br>(required)|integer|Event source.<br><br>Possible values:<br>0 - triggers;<br>1 - discovery;<br>2 - autoregistration;<br>3 - internal;<br>4 - services.| |**recovery**<br>(required)|integer|Operation mode.<br><br>Possible values:<br>0 - operations;<br>1 - recovery operations;<br>2 - update operations.| |subject|string|Message subject.| |message|string|Message text.|
ca	### Plantilla de missatge  L'objecte defineix una plantilla que s'emprarà com a missatge predeterminat per a les operacions d'acció per enviar una notificació. Té les següents propietats.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**eventsource**<br>(obligatori)|integer|Font de l'esdeveniment.<br><br>Valors possibles:<br>0 - triggers;<br>1 - descobriment;<br>2 - enregistrament automàtic;< br>3 - intern;<br>4 - serveis.| |**recovery**<br>(obligatori)|integer|Mode d'operació.<br><br>Valors possibles:<br>0 - operacions;<br>1 - operacions de recuperació;<br>2 - operacions d'actualització.| |subject|string|Assumpte del missatge.| |message|string|Text del missatge.|

en-us	# Method reference  This section provides an overview of the functions provided by the Zabbix API and will help you find your way around the available classes and methods.
ca	# Referència dels mètodes  Aquesta secció proporciona una vista general de les funcions de l'API Zabbix i ens ajuda a trobar les classes i mètodes disponibles.