en-us	##### Item configuration  Configure a log monitoring [item](/manual/config/items/item#overview).  ![](../../../../../assets/en/manual/config/items/itemtypes/logfile_item.png)  All mandatory input fields are marked with a red asterisk.  Specifically for log monitoring items you enter:  |   |   | |--|--------| |*Type*|Select **Zabbix agent (active)** here.| |*Key*|Use one of the following item keys:<br>**log\[\]** or **logrt\[\]**:<br>These two item keys allow to monitor logs and filter log entries by the content regexp, if present.<br>For example: `log[/var/log/syslog,error]`. Make sure that the file has read permissions for the 'zabbix' user otherwise the item status will be set to 'unsupported'.<br>**log.count\[\]** or **logrt.count\[\]**:<br>These two item keys allow to return the number of matching lines only.<br>See supported [Zabbix agent item](zabbix_agent#supported_item_keys) key section for details on using these item keys and their parameters.| |*Type of information*|Prefilled automatically:<br>For log\[\] or logrt\[\] items - `Log`;<br>For log.count\[\] or logrt.count\[\] items - `Numeric (unsigned)`.<br>If optionally using the `output` parameter, you may manually select the appropriate type of information other than `Log`.<br>Note that choosing a non-Log type of information will lead to the loss of local timestamp.| |*Update interval (in sec)*|The parameter defines how often Zabbix agent will check for any changes in the log file. Setting it to 1 second will make sure that you get new records as soon as possible.| |*Log time format*|In this field you may optionally specify the pattern for parsing the log line timestamp.<br>If left blank the timestamp will not be parsed.<br>Supported placeholders:<br>\* **y**: *Year (0001-9999)*<br>\* **M**: *Month (01-12)*<br>\* **d**: *Day (01-31)*<br>\* **h**: *Hour (00-23)*<br>\* **m**: *Minute (00-59)*<br>\* **s**: *Second (00-59)*<br>For example, consider the following line from the Zabbix agent log file:<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>It begins with six character positions for PID, followed by date, time, and the rest of the line.<br>Log time format for this line would be "pppppp:yyyyMMdd:hhmmss".<br>Note that "p" and ":" chars are just placeholders and can be anything but "yMdhms".|
ca	##### Configuració d'un element  Configurar un [element](/manual/config/items/item#overview) de  supervisió d'arxiu de registre:  ![](../../../../../assets/en/manual/config/items/itemtypes/logfile_item.png)  Tots els camps obligatoris són marcats amb un asterisc vermell.  Específicament per els elements de supervisió d'arxius de registre, heu d'entrar:  | · | · | |--|--------| |*Tipus*|Trieu **agent Zabbix (actiu)** aquí.| |*Clau*|Empreu una de les següents claus:<br>**log\[\]** o **logrt\[\]** :<br>Aquestes dues claus d'element permeten monitorar els arxius de registre i filtrar el contingut de les entrades de registre via una expressió regular (si és present).<br>Per exemple: `log[/var/log/syslog,error]`. Assegureu-vos que l'usuari 'zabbix' té permisos de lectura sobre l'arxiu, o l'estat de l'element serà definit com a 'no admès'.<br><br>**log.count\[\]** o **logrt.count\[\]** :<br>Aquestes dues claus d'element permeten tornar només el nombre de línies que correspongui.<br>Veieu la secció relativa a les claus d'[elements d'agent Zabbix](zabbix_agent#supported_item_keys) admeses, per més detalls sobre com emprar les claus d'elements i els seus paràmetres.| |*Tipus d'informació*|Omplir automàticament:<br>Per els elements log\[\] o logrt\[\] - `Registre` ; per els elements log.count\[\] o logrt.count\[\] - `Numèric (sense signe)`.<br>Si empreu eventualment el paràmetre `output`, podeu triar manualment el tipus d'informació adequat enlloc de "Registre".<br>Veieu que triar un tipus d'informació diferent que "Registre"  es perdrà la marca de temps local.| |*Interval d'actualització*|El paràmetre defineix la freqüència (en segons) en la que l'agent Zabbix verificarà les modificacions de l'arxiu de registre. Establir-ho a 1 segon farà que tinguem nous registres tan aviat com sigui possible.| |*Format de marca de temps del registre*|En aquest camp, podem especificar el model per l'anàlisi de marca de temps de la línia de registre.<br>Si és buida, la marca de temps no s'analitzarà pas.<br>Espais reservats admesos:<br>\* **y**: *Any (0001-9999)*<br>\* **M**: *Mes (01-12)*<br>\* **d**: *Dia (01-31)*<br>\* **h**: *Hora (00-23)*<br>\* **m**: *Minut (00-59)*<br>\* **s**: *Segon (00-59)*<br>Per exemple, considereu la línia següent de l'arxiu de registre de l'agent Zabbix :<br>" 23480:20100328:154718.045 Zabbix agent started. Zabbix 1.8.2 (revision 11211)."<br>Comença per sis posicions de caràcters del PID, segueix la data, l'hora i la resta de la línia.<br>El format de l'hora de registre d'aquesta línia és “pppppp:yyyyMMdd:hhmmss”.<br>Veieu que els caràcters "p" i ":" no són més que espais reservats i poden ésser qualsevol cosa excepte "yMdhms".|

en-us	#### Item configuration in Zabbix frontend  Configure a database monitoring [item](/manual/config/items/item#overview).  ![](../../../../../assets/en/manual/config/items/itemtypes/db_monitor.png)  All mandatory input fields are marked with a red asterisk.  Specifically for database monitoring items you must enter:  |   |   | |--|--------| |*Type*|Select *Database monitor* here.| |*Key*|Enter one of the two supported item keys:<br>**db.odbc.select**\[<unique short description>,<dsn>,<connection string>\] - this item is designed to return one value, i.e. the first column of the first row of the SQL query result. If a query returns more than one column, only the first column is read. If a query returns more than one line, only the first line is read.<br>**db.odbc.get**\[<unique short description>,<dsn>,<connection string>\] - this item is capable of returning multiple rows/columns in JSON format. Thus it may be used as a master item that collects all data in one system call, while JSONPath preprocessing may be used in dependent items to extract individual values. For more information, see an [example](/manual/discovery/low_level_discovery/examples/sql_queries#using-db.odbc.get) of the returned format, used in low-level discovery. This item is supported since Zabbix 4.4.<br>The unique description will serve to identify the item in triggers, etc.<br>Although `dsn` and `connection string` are optional parameters, at least one of them should be present. If both data source name (DSN) and connection string are defined, the DSN will be ignored.<br>The data source name, if used, must be set as specified in odbc.ini.<br>The connection string may contain driver-specific arguments.<br><br>Example (connection for MySQL ODBC driver 5):<br>=> db.odbc.get\[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"\]| |*User name*|Enter the database user name<br>This parameter is optional if user is specified in odbc.ini.<br>If connection string is used, and *User name* field is not empty, it is appended to the connection string as `UID=<user>`| |*Password*|Enter the database user password<br>This parameter is optional if password is specified in odbc.ini.<br>If connection string is used, and *Password* field is not empty, it is appended to the connection string as `PWD=<password>`.<br> If a password contains semicolon, it should be wrapped in curly brackets, for example: <br> *Password*: {P?;)\*word}  (if an actual password is `P?;)*word`) <br><br> The password will be appended to connection string after the username as:<br>` UID=<username>;PWD={P?;)*word} `<br><br> To test the resulting string, run: <br>` isql -v -k 'Driver=libmaodbc.so;Database=zabbix;UID=zabbix;PWD={P?;)*word}'`| |*SQL query*|Enter the SQL query.<br>Note that with the `db.odbc.select[]` item the query must return one value only.| |*Type of information*|It is important to know what type of information will be returned by the query, so that it is selected correctly here. With an incorrect *type of information* the item will turn unsupported.|
ca	#### Configuració dels elements a la interfície Zabbix  Configureu un [element](/manual/config/items/item#overview) de monitoratge de base de dades.  ![](../../../../../assets/en/manual/config/items/itemtypes/db_monitor.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Específicament per als elements de monitoratge de bases de dades, heu d'introduir:  | | | |--|---------| |*Tipus*|Trieu *Monitoratge de bases de dades* aquí.| |*Clau*|Introduïu una de les dues claus d'element admeses:<br>**db.odbc.select**\[\<descripció curta única\>,\<dsn\>,\<cadena de connexió\>\] - aquest element és dissenyat per retornar un valor, és a dir, la primera columna de la primera filera del resultat de la consulta SQL. Si una consulta retorna diverses columnes, només es llegeix la primera columna. Si una consulta retorna diverses fileres, només es llegeix la primera filera.<br>**db.odbc.get**\[\<descripció curta única\>,\<dsn\>,\<cadena de connexió\>\] - aquest element és capaç de retornar diverses fileres/columnes en format JSON. Així, es pot emprar com a element principal que recull totes les dades en una única crida al sistema, mentre que el preprocessament JSONPath es pot emprar en elements dependents per extreure valors individuals. Per obtindre més informació, consulteu un [exemple](/manual/discovery/low_level_discovery/examples/sql_queries#using_dbodbcget) del format retornat emprat a la descoberta de baix nivell. Aquest element és compatible des de Zabbix 4.4.<br>La descripció única s'emprarà per identificar l'element a triggers, etc.<br>Tot i que "dsn" i "cadena de connexió" són paràmetres opcionals, almenys un d'ells ha d'ésser present. Si s'estableixen el nom de la font de dades (DSN) i la cadena de connexió, el DSN s'ignorarà.<br>El nom de la font de dades, si s'empra, s'ha d'establir tal com s'especifica a odbc.ini .<br>La cadena de connexió pot contindre un controlador amb arguments específics.<br><br>Exemple (connexió per al controlador ODBC MySQL 5):<br>=> db.odbc.get\[MySQL example,,"Driver=/usr/local/lib/libmyodbc5a.so;Database=master;Server=127.0.0.1;Port=3306"\]| |*Nom d'usuari*|Introduïu el nom d'usuari de la base de dades<br>Aquest paràmetre és opcional si l'usuari s'especifica a odbc.ini.<br>Si s'empra la cadena de connexió i el camp *Nom d'usuari* no és pas buit, s'afegeix al cadena de connexió com a `UID=<usuari>`| |*Mot de pas*|Introduïu el mot de pas de l'usuari de la base de dades<br>Aquest paràmetre és opcional si el mot de pas s'especifica a odbc.ini.<br>Si s'empra la cadena de connexió i el camp *Mot de pas* no és pas buit, s'adjunta a la cadena de connexió com a `PWD= <mot de pas>`.<br> Si un mot de pas conté un punt i coma, s'ha d'adjuntar entre claus, per exemple: <br> *Mot de pas*: {P?;)\*paraula} (si el mot de pas real és `P?;)*word`) <br>< br> El mot de pas s'afegirà a la cadena de connexió després del nom d'usuari com aquesta:<br>` UID=<user>;PWD={P?;) *word} `<br>< br> Per provar la cadena resultant, executeu: <br>` isql -v -k 'Driver=libmaodbc.so;Database=zabbix;UID=zabbix;PWD={P?;) *paraula}'`| |*Consulta SQL*|Introduïu la consulta SQL.<br>Tingueu en compte que amb l'element `db.odbc.select[]`, la consulta només ha de retornar un valor.| |*Tipus d'informació*|És important sapiguer quin tipus d'informació retornarà la consulta, perquè aquí estigui correctament seleccionada. Amb un *Tipus d'informació* incorrecte, l'element no s'admetrà pas.|

en-us	##### Item configuration  To configure a trapper item:  -   Go to: *Configuration* → *Hosts* -   Click on *Items* in the row of the host -   Click on *Create item* -   Enter parameters of the item in the form  ![](../../../../../assets/en/manual/config/items/itemtypes/trapper_item.png)  All mandatory input fields are marked with a red asterisk.  The fields that require specific information for trapper items are:  |   |   | |--|--------| |*Type*|Select **Zabbix trapper** here.| |*Key*|Enter a key that will be used to recognize the item when sending in data.| |*Type of information*|Select the type of information that will correspond the format of data that will be sent in.| |*Allowed hosts*|List of comma delimited IP addresses, optionally in CIDR notation, or DNS names.<br>If specified, incoming connections will be accepted only from the hosts listed here.<br>If IPv6 support is enabled then '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' are treated equally and '::/0' will allow any IPv4 or IPv6 address.<br>'0.0.0.0/0' can be used to allow any IPv4 address.<br>Note, that "IPv4-compatible IPv6 addresses" (0000::/96 prefix) are supported but deprecated by [RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Example: 127.0.0.1, 192.168.1.0/24, 192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32, mysqlserver1, zabbix.example.com, {HOST.HOST}<br>Spaces and [user macros](/manual/config/macros/user_macros) are allowed in this field since Zabbix 2.2.0.<br>Host macros {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} are allowed in this field since Zabbix 4.0.2.|  ::: noteclassic You may have to wait up to 60 seconds after saving the item until the server picks up the changes from a configuration cache update, before you can send in values. :::
ca	##### Configuració de l'element  Per configurar un element trapper:  -   Aneu a: *Configuració* → *Equips* -   Feu clic a *Elements* al rang de l'equip -   Cliqueu*Crear un element* -   Poseu els paràmetres de l'element al formulari  ![](../../../../../assets/en/manual/config/items/itemtypes/trapper_item.png)  Tots els camps obligatoris són marcats amb un asterisc vermell.  Els camps que necessiten informació específica per els elements Trapper són:  |   |   | |---|---| |*Tipus*|Trieu **Zabbix trapper** aquí.| |*Clau*|Poseu la clau que s'emprarà per reconèixer l'element quan s'enviïn les dades.| |*Tipus d'informació*|Trieu el tipus d'informació que correspon al format de dades que s'enviaran.| |*Equips autoritzats*|Llistat d'adreces IP delimitades per comes, opcionalment en notació CIDR, o noms d'equips.<br>Si s'especifica, les connexions entrants només s'acceptaran per els equips llistats aquí.<br>Si el suport IPv6 és actiu, '127.0.0.1', '::127.0.0.1', '::ffff:127.0.0.1' es tracten de la mateixa manera i '::/0' autoritzarà qualsevol adreça IPv4 o IPv6.<br>'0.0.0.0/0' es pot emprar per autoritzar qualsevol adreça IPv4.<br>Veieu que "les adreces IPv6 compatibles amb IPv4" (prefix 0000::/96) s'admeten però es desaconsellen per l'[RFC4291](https://tools.ietf.org/html/rfc4291#section-2.5.5).<br>Exemple: Server=127.0.0.1,192.168.1.0/24,192.168.3.1-255, 192.168.1-10.1-255, ::1,2001:db8::/32,zabbix.domain<br>Els espais i [les macros d'usuari](/manual/config/macros/user_macros) sóno autoritzades al camp des de Zabbix 2.2.0.<br>Les macros d'equips: {HOST.HOST}, {HOST.NAME}, {HOST.IP}, {HOST.DNS}, {HOST.CONN} s'autoritzen dins del camp des de Zabbix 4.0.2.|  ::: noteclassic És possible que hàgiu d'esperar fins a 60 segons després de desar l'element fins que el servidor prengui els canvis d'una actualització de la memòria cau de configuració, abans de poder enviar valors. :::

en-us	##### Item configuration  When [configuring an item](/manual/config/items/item) on a host level:  -   Select 'IPMI agent' as the *Type* -   Enter an item [key](/manual/config/items/item/key) that is unique     within the host (say, ipmi.fan.rpm) -   For *Host interface* select the relevant IPMI interface (IP and     port). Note that an IPMI interface must exist on the host. -   Specify the *IPMI sensor* (for example 'FAN MOD 1A RPM' on Dell     Poweredge) to retrieve the metric from. By default, the sensor ID     should be specified. It is also possible to use prefixes before the     value:     -   `id:` - to specify sensor ID;     -   `name:` - to specify sensor full name. This can be useful in         situations when sensors can only be distinguished by specifying         the full name. -   Select the respective type of information ('Numeric (float)' in this     case; for discrete sensors - 'Numeric (unsigned)'), units (most     likely 'rpm') and any other required item attributes
ca	##### Configuració de l'element  Quan fem la [configuració d'un element](/manual/config/items/item) a nivell d'equip:   - Trieu 'IPMI agent' com a *Tipus* - Entre una [clau](/manual/config/items/item/key) única sobre l'equip (com ara ipmi.fan.rpm) - Per la *interfície de l'equip*, trieu la interfície IPMI adequada (IP i port). Veieu que la interfície IPMI ha d'existir a l'equip. - Especifiqueu el *sensor IPMI* (per exemple 'FAN MOD 1A RPM' de Dell Poweredge) sobre quin recuperar el valor. Per defecte, l'ID del sensor s'ha d'especificar. També es poden emprar prefixes davant del valor:     -   `id:` - per especificar l'ID del sensor;     -   `name:` - per especificar el nom sencer del sensor. Pot ésser útil a determinades situacions quan els sensors només es puguin distingir amb el nom sencer. -   Trieu el tipus d'informació corresponent ('Numèrica (flotant)' en aquest cas, per tots els sensors discrets - 'Numèric (sense signe)'), unitats (probablement 'rpm') i qualsevol altre atribut d'elements necessaris

en-us	# item.create
ca	# item.create

en-us	# item.delete
ca	# item.delete

en-us	##### Item filter syntax  The item filter:      /host/key[parameters]?[conditions]  consists of four parts, where:  *   host - host name *   key - item key (without parameters) *   parameters - item key parameters *   conditions - host group and/or item tag based conditions (as expression)  Spaces are allowed only inside the conditions expression.  **Wildcard usage**  *   Wildcard can be used to replace the host name, item key or an individual item key parameter. *   Either the host or item key must be specified without wildcard. So `/host/*` and `/*/key` are valid filters, but `/*/*` is invalid. *   Wildcard cannot be used for a *part* of host name, item key, item key parameter. *   Wildcard does not match more than a single item key parameter. So a wildcard must be specified for each parameter in separation (i.e. `key[abc,*,*]`).  **Conditions expression**  The conditions expression supports:  *   operands:     *   group - host group     *   tag - item tag     *   `"<text>"` - string constant, with the `\` escape character to escape `"` and `\` *   case-sensitive string comparison operators: `=`, `<>` *   logical operators: `and`, `or`, `not` *   grouping with parentheses: `(` `)`  Quotation of string constants is mandatory. Only case-sensitive full string comparison is supported.  :::notewarning When specifying tags in the filter (i.e. `tag="tagname:value"`), the colon ":" is used as a delimiter.  Everything after it is considered the tag value. Thus it is currently not supported to specify a tag name containing ":" in it. :::    **Examples**  A complex filter may be used, referencing the item key, host group and tags, as illustrated by the examples:  |Syntax example|Description| |--|--| |`/host/key[abc,*]`|Matches similar items on this host.| |`/*/key`|Matches the same item of any host.| |`/*/key?[group="ABC" and tag="tagname:value"]`|Matches the same item of any host from the ABC group having 'tagname:value' tags.| |`/*/key[a,*,c]?[(group="ABC" and tag="Tag1") or (group="DEF" and (tag="Tag2" or tag="Tag3:value"))]`|Matches similar items of any host from the ABC or DEF group with the respective tags.|  All referenced items must exist and collect data. Only enabled items on enabled hosts are included in the calculations.  ::: noteimportant If the item key of a referenced item is changed, the filter must be updated manually. :::  Specifying a parent host group includes the parent group and all nested host groups with their items.
ca	##### Sintaxi del filtre d'elements  El filtre d'elements:       /host/key[parameters]?[conditions]  consta de quatre parts, on:  * host - nom d'equip * key - clau d'element (sense paràmetres) * parameters - paràmetres clau de l'element * conditions - condicions basades en el grup d'equips i/o l'etiqueta d'element (com a expressió)  Els espais només es permeten dins de l'expressió de condicions.  **Ús del comodí**  * El comodí es pot emprar per substituir el nom d'equip, la clau d'element o un paràmetre de clau d'element individual. * S'ha d'especificar l'equip o la clau de l'element sense comodí. Per tant, `/host/*` i `/*/key` són filtres vàlids, però `/*/*` no és vàlid. * El comodí no es pot emprar per a una *part* del nom d'equip, la clau d'element o el paràmetre de la clau d'element. * El comodí no ha de coincidir amb més d'un paràmetre clau d'element. Per tant, s'ha d'especificar un comodí per a cada paràmetre separat (és a dir, `key[abc,*,*]`).  **Expressió de condicions**  L'expressió de condicions admet:  * operands:      * group - grup d'equips      * tag - etiqueta d'element      * `"<text>"` - constant de cadena, amb el caràcter d'escapada `\` per escapar `"` i `\` * Operadors de comparació de cadenes que distingeixen entre majúscules i minúscules: `=`, `<>` * operadors lògics: `i`, `o`, `no` * agrupació amb parèntesis: `(` `)`  La citació de les constants de cadena és obligatòria. Només s'admet la comparació de cadenes completes que distingeix entre majúscules i minúscules.  :::notewarning Quan especifiquem les etiquetes al filtre, (p.e. `tag="tagname:value"`), s'empra com a delimitador els dos punts ":". Qualsevol cosa després d'aquest es considera el valor d'etiqueta. Per això, no s'admet cap nom d'etiqueta que contingui ":". :::  **Exemples**  Es pot emprar un filtre complex, fent referència a la clau de l'element, el grup d'equips i etiquetes, tal com ho il·lustren els exemples:  |Exemple de sintaxi|Descripció| |--|--| |`/host/key[abc,*]`|Coincideix amb elements similars en aquest equip.| |`/*/key`|Coincideix amb el mateix element de qualsevol equip.| |`/*/key?[group="ABC" and tag="tagname:value"]`|Coincideix amb el mateix element de qualsevol equip del grup ABC que tingui etiquetes 'tagname:value'.| |`/*/key[a,*,c]?[(group="ABC" i tag="Tag1") o (group="DEF" i (tag="Tag2" o tag="Tag3:value" ))]`|Fa coincidir elements similars de qualsevol equip del grup ABC o DEF amb les etiquetes respectives.|  Tots els elements referenciats han d'existir i recollir dades. Només els elements activats dels hosts habilitats s'inclouran als càlculs.  ::: noteimportant Si es canvia la clau d'element d'un element de referència, el filtre s'ha d'actualitzar manualment. :::  L'especificació d'un grup d'equips principal inclou el grup principal i tots els grups descendents amb els seus articles.

en-us	# item.get
ca	# item.get

en-us	#### Item key  In [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) configuration, select **JMX agent** in the *Type* field.  Two item keys are supported for JMX object discovery - jmx.discovery\[\] and jmx.get\[\]:  |**Item key**|<|<|<| |-|--------|--------|----------| |<|Return value|Parameters|Comment| |**jmx.discovery**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|This item returns a JSON array with LLD macros describing MBean objects or their attributes.|**discovery mode** - one of the following: *attributes* (retrieve JMX MBean attributes, default) or *beans* (retrieve JMX MBeans)<br>**object name** - object name pattern (see [documentation](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identifying the MBean names to be retrieved (empty by default, retrieving all registered beans)<br>**unique short description** - a unique description that allows multiple JMX items with the same discovery mode and object name on the host (optional)|Examples:<br>→ jmx.discovery - retrieve all JMX MBean attributes<br>→ jmx.discovery\[beans\] - retrieve all JMX MBeans<br>→ jmx.discovery\[attributes,"\*:type=GarbageCollector,name=\*"\] - retrieve all garbage collector attributes<br>→ jmx.discovery\[beans,"\*:type=GarbageCollector,name=\*"\] - retrieve all garbage collectors<br><br>There are some [limitations](#limitations) to what MBean properties this item can return based on limited characters that are supported in macro name generation (supported characters can be described by the following regular expression: `A-Z0-9_\.`). So, for example, to discover MBean properties with a hyphenated word or non-ASCII characters, you need to use `jmx.get[]`.<br><br>Supported since Zabbix Java gateway 3.4.| |**jmx.get**\[<discovery mode>,<object name>,<unique short description>\]|<|<|<| |<|This item returns a JSON array with MBean objects or their attributes.<br><br>Compared to `jmx.discovery[]` it does not define LLD macros.|**discovery mode** - one of the following: *attributes* (retrieve JMX MBean attributes, default) or *beans* (retrieve JMX MBeans)<br>**object name** - object name pattern (see [documentation](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identifying the MBean names to be retrieved (empty by default, retrieving all registered beans)<br>**unique short description** - a unique description that allows multiple JMX items with the same discovery mode and object name on the host (optional)|When using this item, it is needed to define custom low-level discovery macros, pointing to values extracted from the returned JSON using JSONPath.<br><br>Supported since Zabbix Java gateway 4.4.|  ::: noteimportant If no parameters are passed, all MBean attributes from JMX are requested. Not specifying parameters for JMX discovery or trying to receive all attributes for a wide range like `*:type=*,name=*` may lead to potential performance problems. :::
ca	#### Clau d'element  A la configuració de la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule), trieu **agent JMX** al camp *Tipus*.  S'admeten dues claus d'element per a la descoberta d'objectes JMX: jmx.discovery\[\] i jmx.get\[\]:  |**Clau d'element**|<|<|<| |------------|-|-|-| |<|Valor de retorn|Paràmetres|Comentari| |**jmx.discovery**\[\<mode de descoberta\>,\<nom de l'objecte\>,\<descripció breu única\>\]|<|<|<| |<|Aquest element retorna una matriu JSON amb macros LLD que descriuen objectes MBean o els seus atributs.|**mode de descoberta** - un dels següents: *atributs* (obtinguent els atributs MBean JMX, per defecte) o *beans* (obtinguent JMX). MBeans)<br>**nom de l'objecte** - patró de nom d'objecte (veieu la [documentació](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) que identifica el Noms de MBean per recuperar (buit per defecte, recuperant tots els beans registrats)<br>**descripció curta única** - una descripció única que permet diversos elements JMX amb el mateix mode de descoberta i el mateix nom d'objecte a l'equip (opcional)|Exemples: <br>→ jmx.discovery - recupera tots els atributs JMX MBean<br>→ jmx.discovery\[beans\] - recupera tots els MBeans JMX<br>→ jmx.discovery\[atributs,"\*:type=GarbageCollector,nom =\*"\] - recupera tots els atributs del col·lector d'escombraries<br>→ jmx.discovery\[beans,"\ *:type=GarbageCollector,name=\*"\] - recupera tots els col·lectors d'escombraries<br><br> Hi ha algunes [limitacions](#limitations) pel que fa a les propietats de MBean que aquest element pot retornar en funció dels caràcters limitats admesos en la generació de noms de macro (els caràcters admesos es poden descriure amb la següent expressió regular: `A-Z0-9_\.`). Així, per exemple, per descobrir propietats de MBean amb paraules amb guionet o caràcters no ASCII, hauríeu d'emprar `jmx.get[]`.<br><br>Admès des de la passarel·la Java de Zabbix 3.4 .| |**jmx.get**\[\<mode de descoberta\>,\<nom de l'objecte\>,\<descripció curta única\>\]|<|<|<| |<|Aquest element retorna una matriu JSON amb objectes MBean o els seus atributs.<br><br>En comparació amb `jmx.discovery[]` no defineix macros LLD.|**mode de descoberta** - un dels següents: *atributs* (obté els atributs JMX MBean, per defecte) o *beans* (obté els MBeans JMX)<br>**nom de l'objecte** - patró de nom d'objecte (veieu [documentació](https://docs.oracle.com/javase/7/docs/api/javax/management/ObjectName.html)) identificant els noms MBean que cal recuperar (buit per defecte, recuperant tots els beans registrats)<br>**descripció curta única** - una descripció única que permet diversos elements JMX amb el mateix mode de descoberta i el mateix nom d'objecte a l'equip (opcional)|Quan s'empra aquest element, cal definir macros de descoberta de baix nivell personalitzades, que apunten als valors extrets de JSON retornat mitjançant JSONPath.<br><br>Admès des de Zabbix Java Gateway 4.4.|  ::: noteimportant Si no es passa cap paràmetre, es demanen tots els atributs JMX MBean. No especificar paràmetres per a la descoberta de JMX o intentar rebre tots els atributs d'una àmplia gamma com ara `*:type=*,name=*` pot provocar problemes de rendiment potencials. :::

en-us	#### Item key  SQL queries are performed using a "Database monitor" item type. Therefore, most of the instructions on [ODBC monitoring](/manual/config/items/itemtypes/odbc_checks) page apply in order to get a working "Database monitor" discovery rule.  Two item keys may be used in "Database monitor" discovery rules:  -   **db.odbc.discovery**\[<unique short     description>,<dsn>,<connection string>\] - this item     transforms the SQL query result into a JSON array, turning the     column names from the query result into low-level discovery macro     names paired with the discovered field values. These macros can be     used in creating item, trigger, etc prototypes. See also: [Using     db.odbc.discovery](#using_dbodbcdiscovery).  ```{=html} <!-- --> ``` -   **db.odbc.get**\[<unique short     description>,<dsn>,<connection string>\] - this item     transforms the SQL query result into a JSON array, keeping the     original column names from the query result as a field name in JSON     paired with the discovered values. Compared to     `db.odbc.discovery[]`, this item does not create low-level discovery     macros in the returned JSON, therefore there is no need to check if     the column names can be valid macro names. The low-level discovery     macros can be defined as an additional step as required, using the     [custom LLD     macro](/manual/discovery/low_level_discovery#custom_macros)     functionality with JSONPath pointing to the discovered values in the     returned JSON. See also: [Using db.odbc.get](#using_dbodbcget).
ca	#### clau d'element  Les consultes SQL es realitzen mitjançant un element de tipus "Monitoratge de bases de dades". Per tant, la majoria de les instruccions de la pàgina [monitoratge ODBC](/manual/config/items/itemtypes/odbc_checks) s'apliquen per obtindre una regla de descoberta de "monitoratge de bases de dades" que funcioni.  Es poden emprar dues claus d'elements a les regles de descoberta "Monitoratge de bases de dades":  - **db.odbc.discovery**\[<descripció curta única>,<dsn>,<cadena de connexió>\] - aquest element transforma el resultat de la consulta SQL en una matriu JSON, transformant els noms de columna de la consulta donant lloc a noms de macro de descoberta de baix nivell associats amb valors de camp descoberts. Aquestes macros es poden emprar per crear prototips d'elements, triggers, etc. Veieu també: [emprar odb.odbc.discovery](#using_dbodbcdiscovery).  ```{=html} <!-- --> ``` - **db.odbc.get**\[<descripció curta única>,<dsn>,<cadena de connexió>\] - aquest element transforma el resultat de la consulta SQL en una matriu JSON, conservant l'origen dels noms de columna de la resultat de la consulta com el nom del camp en JSON associat amb els valors descoberts. En comparació amb `db.odbc.discovery[]`, aquest element no crea macros de descoberta de baix nivell al JSON retornat, de manera que no cal comprovar si els noms de columnes poden ser noms de macro vàlids . Les macros de descoberta de baix nivell es poden definir com una passa addicional si cal, emprant la funció [macro LLD personalitzada](/manual/discovery/low_level_discovery#custom_macros) amb JSONPath apuntant als valors descoberts al JSON retornat. Veieu també: [emprant db.odbc.get](#using_dbodbcget).

en-us	### Item keys  The table provides details on the item keys that you can use with Zabbix Windows agent only.  See also: [Minimum permission level for Windows agent items](/manual/appendix/items/win_permissions)  |Key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |eventlog\[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>\]|<|<|<| |Event log monitoring.|Log|**name** - name of event log<br>**regexp** - regular expression describing the required pattern<br>**severity** - regular expression describing severity (case-insensitive).<br>This parameter accepts a regular expression based on the following values: "Information", "Warning", "Error", "Critical", "Verbose" (since Zabbix 2.2.0 running on Windows Vista or newer)<br>**source** - regular expression describing source identifier (case-insensitive; regular expression is supported since Zabbix 2.2.0)<br>**eventid** - regular expression describing the event identifier(s)<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_win)<br>**mode** - possible values:<br>*all* (default), *skip* - skip processing of older data (affects only newly created items).|The item must be configured as an [active check](/manual/appendix/items/activepassive#active_checks).<br><br>Examples:<br>=> eventlog\[Application\]<br>=> eventlog\[Security,,"Failure Audit",,\^(529\|680)$\]<br>=> eventlog\[System,,"Warning\|Error"\]<br>=> eventlog\[System,,,,\^1$\]<br>=> eventlog\[System,,,,\@TWOSHORT\] - here a [custom regular expression](/manual/regular_expressions) named `TWOSHORT` is referenced (defined as a *Result is TRUE* type, the expression itself being `^1$\|^70$`).<br><br>*Note* that the agent is unable to send in events from the "Forwarded events" log.<br><br>The `mode` parameter is supported since Zabbix 2.0.0.<br>"Windows Eventing 6.0" is supported since Zabbix 2.2.0.<br><br>Note that selecting a non-Log [type of information](/manual/config/items/item#configuration) for this item will lead to the loss of local timestamp, as well as log severity and source information.<br><br>See also additional information on [log monitoring](/manual/config/items/itemtypes/log_items).| |net.if.list|<|<|<| |Network interface list (includes interface type, status, IPv4 address, description).|Text| |Supported since Zabbix agent version 1.8.1. Multi-byte interface names supported since Zabbix agent version 1.8.6. Disabled interfaces are not listed.<br><br>Note that enabling/disabling some components may change their ordering in the Windows interface name.<br><br>Some Windows versions (for example, Server 2008) might require the latest updates installed to support non-ASCII characters in interface names.| |perf\_counter\[counter,<interval>\]|<|<|<| |Value of any Windows performance counter.|Integer, float, string or text (depending on the request)|**counter** - path to the counter<br>**interval** - last N seconds for storing the average value.<br>The `interval` must be between 1 and 900 seconds (included) and the default value is 1.|Performance Monitor can be used to obtain list of available counters. Until version 1.6 this parameter will return correct value only for counters that require just one sample (like \\System\\Threads). It will not work as expected for counters that require more than one sample - like CPU utilization. Since 1.6, `interval` is used, so the check returns an average value for last "interval" seconds every time.<br><br>See also: [Windows performance counters](/manual/config/items/perfcounters).| |perf\_counter\_en\[counter,<interval>\]|<|<|<| |Value of any Windows performance counter in English.|Integer, float, string or text (depending on the request)|**counter** - path to the counter in English<br>**interval** - last N seconds for storing the average value.<br>The `interval` must be between 1 and 900 seconds (included) and the default value is 1.|This item is only supported on **Windows Server 2008/Vista** and above.<br><br>You can find the list of English strings by viewing the following registry key: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.<br><br>Supported since Zabbix agent versions 4.0.13 and 4.2.7.| |perf\_instance.discovery\[object\]|<|<|<| |List of object instances of Windows performance counters. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|JSON object|**object** - object name (localized)|Supported since Zabbix agent version 5.0.1.| |perf\_instance\_en.discovery\[object\]|<|<|<| |List of object instances of Windows performance counters, discovered using object names in English. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|JSON object|**object** - object name (in English)|Supported since Zabbix agent version 5.0.1.| |proc\_info\[process,<attribute>,<type>\]|<|<|<| |Various information about specific process(es).|Float|**process** - process name<br>**attribute** - requested process attribute<br>**type** - representation type (meaningful when more than one process with the same name exists)|The following `attributes` are supported:<br>*vmsize* (default) - size of process virtual memory in Kbytes<br>*wkset* - size of process working set (amount of physical memory used by process) in Kbytes<br>*pf* - number of page faults<br>*ktime* - process kernel time in milliseconds<br>*utime* - process user time in milliseconds<br>*io\_read\_b* - number of bytes read by process during I/O operations<br>*io\_read\_op* - number of read operation performed by process<br>*io\_write\_b* - number of bytes written by process during I/O operations<br>*io\_write\_op* - number of write operation performed by process<br>*io\_other\_b* - number of bytes transferred by process during operations other than read and write operations<br>*io\_other\_op* - number of I/O operations performed by process, other than read and write operations<br>*gdiobj* - number of GDI objects used by process<br>*userobj* - number of USER objects used by process<br><br>Valid `types` are:<br>*avg* (default) - average value for all processes named <process><br>*min* - minimum value among all processes named <process><br>*max* - maximum value among all processes named <process><br>*sum* - sum of values for all processes named <process><br><br>Examples:<br>=> proc\_info\[iexplore.exe,wkset,sum\] - to get the amount of physical memory taken by all Internet Explorer processes<br>=> proc\_info\[iexplore.exe,pf,avg\] - to get the average number of page faults for Internet Explorer processes<br><br>Note that on a 64-bit system, a 64-bit Zabbix agent is required for this item to work correctly.<br><br>Note: *io\_\**, *gdiobj* and *userobj* attributes are available only on Windows 2000 and later versions of Windows, not on Windows NT 4.0.| |service.discovery|<|<|<| |List of Windows services. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_services).|JSON object| |Supported since Zabbix agent version 3.0.| |service.info\[service,<param>\]|<|<|<| |Information about a service.|Integer - with `param` as *state*, *startup*<br><br>String - with `param` as *displayname*, *path*, *user*<br><br>Text - with `param` as *description*<br><br>Specifically for *state*:<br>0 - running,<br>1 - paused,<br>2 - start pending,<br>3 - pause pending,<br>4 - continue pending,<br>5 - stop pending,<br>6 - stopped,<br>7 - unknown,<br>255 - no such service<br><br>Specifically for *startup*:<br>0 - automatic,<br>1 - automatic delayed,<br>2 - manual,<br>3 - disabled,<br>4 - unknown,<br>5 - automatic trigger start,<br>6 - automatic delayed trigger start,<br>7 - manual trigger start|**service** - a real service name or its display name as seen in MMC Services snap-in<br>**param** - *state* (default), *displayname*, *path*, *user*, *startup* or *description*|Examples:<br>=> service.info\[SNMPTRAP\] - state of the SNMPTRAP service<br>=> service.info\[SNMP Trap\] - state of the same service, but with display name specified<br>=> service.info\[EventLog,startup\] - startup type of the EventLog service<br><br>Items service.info\[service,state\] and service.info\[service\] will return the same information.<br><br>Note that only with `param` as *state* this item returns a value for non-existing services (255).<br><br>This item is supported since Zabbix 3.0.0. It should be used instead of the deprecated service\_state\[service\] item.| |services\[<type>,<state>,<exclude>\]|<|<|<| |Listing of services.|0 - if empty<br><br>Text - list of services separated by a newline|**type** - *all* (default), *automatic*, *manual* or *disabled*<br>**state** - *all* (default), *stopped*, *started*, *start\_pending*, *stop\_pending*, *running*, *continue\_pending*, *pause\_pending* or *paused*<br>**exclude** - services to exclude from the result. Excluded services should be listed in double quotes, separated by comma, without spaces.|Examples:<br>=> services\[,started\] - list of started services<br>=> services\[automatic, stopped\] - list of stopped services, that should be run<br>=> services\[automatic, stopped, "service1,service2,service3"\] - list of stopped services, that should be run, excluding services with names service1, service2 and service3<br><br>The `exclude` parameter is supported since Zabbix 1.8.1.| |wmi.get\[<namespace>,<query>\]|<|<|<| |Execute WMI query and return the first selected object.|Integer, float, string or text (depending on the request)|**namespace** - WMI namespace<br>**query** - WMI query returning a single object<br>|WMI queries are performed with [WQL](https://en.wikipedia.org/wiki/WQL).<br><br>Example:<br>=> wmi.get\[root\\cimv2,select status from Win32\_DiskDrive where Name like '%PHYSICALDRIVE0%'\] - returns the status of the first physical disk<br><br>This key is supported since Zabbix 2.2.0.| |wmi.getall\[<namespace>,<query>\]|<|<|<| |Execute WMI query and return the whole response.<br><br>Can be used for [low-level discovery](/manual/discovery/low_level_discovery/examples/wmi).|JSON object|**namespace** - WMI namespace<br>**query** - WMI query<br>|WMI queries are performed with [WQL](https://en.wikipedia.org/wiki/WQL).<br><br>Example:<br>=> wmi.getall\[root\\cimv2,select \* from Win32\_DiskDrive where Name like '%PHYSICALDRIVE%'\] - returns status information of physical disks<br><br>JSONPath [preprocessing](/manual/config/items/item#item_value_preprocessing) can be used to point to more specific values in the returned JSON.<br><br>This key is supported since Zabbix 4.4.0.| |vm.vmemory.size\[<type>\]|<|<|<| |Virtual memory size in bytes or in percentage from total.|Integer - for bytes<br><br>Float - for percentage|**type** - possible values:<br>*available* (available virtual memory), *pavailable* (available virtual memory, in percent), *pused* (used virtual memory, in percent), *total* (total virtual memory, default), *used* (used virtual memory)|Example:<br>=> vm.vmemory.size\[pavailable\] → available virtual memory, in percentage<br><br>Monitoring of virtual memory statistics is based on:<br>\* Total virtual memory on Windows (total physical + page file size);<br>\* The maximum amount of memory Zabbix agent can commit;<br>\* The current committed memory limit for the system or Zabbix agent, whichever is smaller.<br><br>This key is supported since Zabbix 3.0.7 and 3.2.3.|
ca	#### Claus d'element  La taula té els detalls de les claus d'element que podem emprar només amb l'agent Zabbix Windows.  Veieu també: [Nivell d'autorització mínim per als elements de l'agent Windows](/manual/appendix/items/win_permissions)  |Clau|<|<|<| |--|--|------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |eventlog\[name,<regexp>,<severity>,<source>,<eventid>,<maxlines>,<mode>\]|<|<|<| |Monitoratge del registre d'esdeveniments.|Registre|**name** - nom del registre d'esdeveniments<br>**regexp** - expressió regular descrivint el model demanat<br>**severity** - expressió regular descrivint la gravetat (insensible a majúscules i minúscules)<br>Aquest paràmetre admet els valors següents: "Information", "Warning", "Error", "Critical", "Verbose" (des de Zabbix 2.2.0 funciona sota Windows Vista o posterior)<br>**source** - expressió regular descrivint l'identificador de la font (insensible a majúscules i minúscules; l'expressió regular s'admet des de Zabbix 2.2.0)<br>**eventid** - expressió regular descrivint el o les identificadors d'esdeveniment<br>**maxlines** - màxim nombre 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.win.conf](/manual/appendix/config/zabbix_agentd_win)<br>**mode** - valors possibles:<br>*all* (per defecte) , *skip* - ignora el tractament de les dades més antigues(només afecta els elements nous creats).|L'element s'ha de configurar com a [verificació activa](/manual/appendix/items/activepassive#active_checks).<br><br>Exemples:<br>=> eventlog\[Application\]<br>=> eventlog\[Security,,"Failure Audit",,\^(529\|680)\$\]<br>=> eventlog\[System,,"Warning\|Error"\]<br>=> eventlog\[System,,,,\^1\$\]<br>=> eventlog\[System,,,,\@TWOSHORT\] - aquí una [expressió regular personalitzada](/manual/regular_expressions) anomenada `TWOSHORT` és referenciada (definida com un tipus *Resultat és CERT*, l'expressió pròpia essent `^1$\|^70$`).<br><br>*Veieu* que l'agent no pot pas enviar els esdeveniments a partir del registre "Esdeveniments transferits".<br><br>El paràmetre `mode` s'admet des de Zabbix 2.0.0.<br>"Windows Eventing 6.0" s'admet des de Zabbix 2.2.0.<br><br>Veieu que la secció d'un [tipus d'informacions](/manual/config/items/item#configuration) no-registre d'aquest element provocarà la pèrdua de la marca de temps local, així com la gravetat del registre i la informació d'origen.<br><br>Veieu també les informacions addicionals a [monitoratge dels registres](/manual/config/items/itemtypes/log_items).| |net.if.list|<|<|<| |Llista de les interfícies de xarxa (conté el tipus interfície, estat, adreça IPv4, descripció).|Text| |A més des de la versió 1.8.1 de l'agent Zabbix. Noms d'interfície multi-octets admesos des de la versió 1.8.6 de l'agent Zabbix. Les interfícies desactivades no són pas llistades.<br><br>Veieu que l'activació/desactivació d'alguns components pot modificar el seu ordre dins el nom de la interfície Windows.<br><br>Algunes versions de Windows (per exemple, Server 2008) poden requerir les darreres actualitzacions instal·lades per admetre caràcters no ASCII als noms d'interfície.| |perf\_counter\[counter,\<interval\>\]|<|<|<| |Valor de qualsevol comptador de rendiment de Windows.|Enter, flotant, cadena o text (segons la petició)|**counter** - ruta cap al comptador <br>**interval** - darrers N segons per emmagatzemar la mitjana.<br>L'interval ha d'estar entre 1 i 900 segons (inclosos) i el valor per defecte és 1.|Monitor de Rendiment es pot emprar per obtindre la llista de comptadors disponibles. Fins la versió 1.6, aquest paràmetre tornarà un valor correcte només per els comptadors que necessiten només una sola mostra (com ara \\System\\Threads). No funcionarà pas com és previst per els comptadors que necessiten més d'una mostra, com l'ús del processador. Des de la versió 1.6, `interval` s'empra, doncs la verificació torna un valor mitjà per els darrers "intervals" cada vegada.<br><br>Veieu també: [Comptadors de rendiment Windows](/manual/config/items/perfcounters). | |perf\_counter\_en\[counter,\<interval\>\]|<|<|<| |Valor de qualsevol comptador de rendiment de Windows en anglès.|Enter, flotant, cadena o text (segons la petició)|**counter** - camí cap al comptador en anglès<br>**interval** - darrers N segons per emmagatzemar la mitjana.<br>L'interval ha d'ésser entre 1 i 900 segons (inclosos) i el valor per defecte és 1.|Aques element només s'admet a **Windows Server 2008/Vista** i superiors.<br><br>Podeu trobar una llista de les cadenes en anglès afegint la clau de registre següent: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.<br><br>Admès des de les versions 4.0.13 de l'agent Zabbix i 4.2.7.| |perf\_instance.discovery\[object\]|<|<|<| |Llista de les instàncies d'objectes dels comptadors de rendiment Windows. Emprat per la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|Objecte JSON|**object** - nom de l'objecte (localitzat)|Admès des de la versió 5.0.1 de l'agent Zabbix.| |perf\_instance\_en.discovery\[object\]|<|<|<| |Llista d'instàncies d'objectes de comptadors de rendiment de Windows, descobertes amb noms d'objectes en anglès. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_perf_instances).|Objecte JSON|**object** - nom de l'objecte (en anglès)|Admès des de la versió 5.0.1 de l'agent Zabbix.| |proc\_info\[process,\<attribute\>,\<type\>\]|<|<|<| |Informacions diverses dels processos específics.|Flotant|**process** - nom del procés<br>**attribut** - atribut de procés demanat<br>**type** - tipus de representació (significatiu quan existeixen diversos processos amb el mateix nom)|Els `atributs` següents s'admeten:<br>*vmsize* (per defecte) - mida de la memòria virtual dels processos, en Ko<br>*wkset* - mida del conjunt de treball dels processos (quantitat de memòria física emprada per els processos) en Ko<br>*pf* - nombre d'errors de pàgina<br>*ktime* - temps de tractament del nucli, en mil·lisegons<br>*utime* - temps de tractament de l'usuari, en mil·lisegons<br>*io\_read\_b* - nombre d'octets llegits per el procés durant les operacions d'E/S<br>*io\_read\_op* - nombre d'operacions de lectura fetes per el procés<br>*io\_write\_b* - nombre d'octets escrits per el procés durant les operacions d'E/S<br>*io\_write\_op* - nombre d'operacions d'escriptura fetes per el procés<br>*io\_other\_b* - nombre de bytes transferits pel procés durant operacions diferents de les operacions de lectura i escriptura<br>*io\_other\_op* - nombre d'operacions d'E/S fetes per el procés, excepte les operacions de lectura i escriptura<br>*gdiobj* - nombre d'objectes GDI emprats per el procés<br>*userobj* - nombre d'objectes USER emprats per el procés<br><br>Els `types` vàlids són:<br>*avg* (per defecte) - valor mitjà per tots els processos nomenats\<process\><br>*min* - valor mínim  per tots els processos nomenats\<process\><br>*max* - valor màxim  per tots els processos nomenats\<process\><br>*sum* - alguns dels valors de tots els processos nomenats\<process\><br><br>Exemples:<br>=> proc\_info\[iexplore.exe,wkset,sum\] - per obtindre la quantitat de memòria física emprada per tots els processos d'Internet Explorer<br>=> proc\_info\[iexplore.exe,pf,avg\] - per obtindre la mitjana d'errades de pàgina per els processos d'Internet Explorer<br><br>Veieu que en un sistema de 64 bits, un agent Zabbix de 64 bits és obligatori per tal que aquest element funcioni correctament.<br><br>Nota important: els atributs *io\_\**, *gdiobj* i *userobj* només són disponibles sota Windows 2000 i les versions posteriors de Windows, (no funciona amb Windows NT 4.0).| |service.discovery|<|<|<| |Llista de serveis Windows. Emprat per la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_services).|Objecte JSON| |Admès des de la versió 3.0 de l'agent Zabbix.| |service.info\[service,\<param\>\]|<|<|<| |Informacions d'un servei.|Enter - amb `param` definit a *state*, *startup*<br><br>Cadena - amb `param` definit a *displayname*, *path*, *user*<br><br> Test - amb `param` definit a *description*<br><br>Específicament per *state* :<br>0 - executant-se,<br>1 - pausat,<br>2 - pendent d'inici,<br>3 - pausat d'inici,<br>4 - continuar d'inici,<br>5 - aturar en inici,<br>6 - aturat,<br>7 - desconegut,<br>255 - cap servei d'aquest tipus<br><br>Específicament per *startup* :<br>0 - automàtic,<br>1 - automàtic endarrerit,<br>2 - manual,<br>3 - desactivat,<br>4 - desconegut,<br>5 - trigger automàtic,<br>6 - inici automàtic del trigger endarrerit,<br>7 - inici manual del trigger|**service** - un nom de servei real o el seu nom de visualització tal com apareix al complement de Serveis MMC<br>**param** - *state * (per defecte), *displayname*, *path*, *user*, *startup* o *description*|Exemples:<br>=> service.info\[SNMPTRAP\] - estat del servei SNMPTRAP<br>=> service.info\[SNMP Trap\] - estat del mateix servei, però amb el nom de visualització especificat<br>=> service.info\[EventLog,startup\ ] - tipus d'inici del servei EventLog<br><br>Els elements service.info\[service,state\] i service.info\[service\] tornaran la mateixa informació.<br><br>Veieu que només amb `param` definit a *state* aquest element retorna un valor per els serveis inexistents (255).<br><br>S'admet aquest element des de Zabbix 3.0.0. S'ha d'emprar en lloc de l'element obsolet service\_state\[service\].| |services\[\<type\>,\<state\>,\<exclude\>\]|<|<|<| |Llistat dels serveis.|0 - si vide<br><br>Texte - llista dels serveis separats per una nova línia|**type** - *all* (per defecte), *automatic*, *manual* ou *disabled* <br>**state** - *all* (per defecte), *stopped*, *started*, *start\_pending*, *stop\_pending*, *running*, *continue\_pending*, *pause\_pending* o *paused*<br>**exclude** - serveix a excloure del resultat. Els serveis exclosos s'han de llistat entre cometes dobles, separades per una coma, sense espais.|Exemples:<br>=> services\[,started\] - llista dels serveis engegats<br>=> services\[automatic, stopped\] - llista dels serveis aturats, que s'han d'engegar<br>=> services\[automatic, stopped, "service1,service2,service3"\]  - llista dels serveis aturats, que s'han d'engegar, excloent els serveis anomenats service1, service2 i service3 <br><br>El paràmetre `exclude` s'admet es de Zabbix 1.8.1.| |wmi.get\[\<namespace\>,\<query\>\]|<|<|<| |Executa la petició WMI i retorna el primer objecte trobat.|Enter, flotant, cadena o text (segons la petició)|**namespace** - Espai de noms WMI<br>**query** - Petció WMI retornant un sol objecte<br>|Les peticions WMI es fan amb [WQL](https://ca.wikipedia.org/wiki/WQL).<br><br>Exemple:<br>=> wmi.get\[root\\cimv2,select status from Win32\_DiskDrive where Name like '%PHYSICALDRIVE0%'\] - retorna l'estat del primer disc físic<br><br>Auesta clau s'admet des de Zabbix 2.2.0.| |wmi.getall\[\<namespace\>,\<query\>\]|<|<|<| |Executa la petició WMI i retorna la resposta sencera.<br><br>Es pot emprar per la [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/wmi).|Objecte JSON|**namespace** - Espai de noms WMI<br>**query** - Petició WMI<br>|Les peticions WMI es fan via [WQL](https://ca.wikipedia.org/wiki/WQL).<br><br>Exemple:<br>=> wmi.getall\[root\\cimv2,select \* from Win32\_DiskDrive where Name like '%PHYSICALDRIVE%'\] - retorna la informació d'estat dels discs físics<br><br>Le [tractament previ](/manual /config/items/item#item_value_preprocessing) JSON es pot emprar per apuntar a valors més específics al JSON retornat.<br><br>Aquesta clau s'admet des de Zabbix 4.4.0.| |vm.vmemory.size\[\<type\>\]|<|<|<| |Mida de la memòria virtual en octets o en percentatge del total.|Enter - per els octets<br><br>Flotant - per el percentatge|**type** - valors possibles :<br>*available* (memòria virtual disponible), * pavailable* (memòria virtual disponible, en percentatge), *pused* (memòria virtual emprada, en percentatge), *total* (memòria virtual total, per defecte), *used* (memòria virtual emprada)|Exemple:<br>=> vm.vmemory.size\[pavailable\] → memòria virtual disponible, en percentatge<br><br>El monitoratge de les estadístiques de la memòria virtual es basa en:<br>\* Memòria virtual total sota Windows (física total + mida de l'arxiu d'intercanvi) ;<br>\* La quantitat màxima de memòria que l'agent Zabbix pot validar;<br>\* El límit actual de memòria validada per el sistema o l'agent Zabbix, segons el valor més petit.<br><br>Aquesta clau s'admet des de Zabbix 3.0.7 i 3.2.3.|

en-us	#### Item keys  The table provides details on the simple checks that can be used to monitor [VMware environments](/manual/vm_monitoring).  Parameters without angle brackets are mandatory. Parameters marked with angle brackets **<** **>** are optional.  |Key|<|<|<|<| |-|------|--|------|------| |<|Description|Return value|Parameters|Comments| |vmware.cl.perfcounter\[url,id,path,<instance>\]|<|<|<|<| |<|VMware cluster performance counter metrics.|Integer|**url** - VMware service URL<br>**id** - VMware cluster ID<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance|`id` can be received from vmware.cluster.discovery\[\] as {\#CLUSTER.ID}| |vmware.cluster.discovery\[url\]|<|<|<|<| |<|Discovery of VMware clusters.|JSON object|**url** - VMware service URL|<| |vmware.cluster.status\[url,name\]|<|<|<|<| |<|VMware cluster status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**name** - VMware cluster name|<| |vmware.datastore.discovery\[url\]|<|<|<|<| |<|Discovery of VMware datastores.|JSON object|**url** - VMware service URL|<| |vmware.datastore.hv.list\[url,datastore\]|<|<|<|<| |<|List of datastore hypervisors.|JSON object|**url** - VMware service URL<br>**datastore** - datastore name|<| |vmware.datastore.read\[url,datastore,<mode>\]|<|<|<|<| |<|Amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.datastore.size\[url,datastore,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.datastore.write\[url,datastore,<mode>\]|<|<|<|<| |<|Amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**datastore** - datastore name<br>**mode** - latency (average value, default), maxlatency (maximum value)|<| |vmware.dc.discovery\[url\]|<|<|<|<| |<|Discovery of VMware datacenters.|JSON object|**url** - VMware service URL|<| |vmware.eventlog\[url,<mode>\]|<|<|<|<| |<|VMware event log.|Log|**url** - VMware service URL<br>**mode** - *all* (default), *skip* - skip processing of older data|There must be only one vmware.eventlog\[\] item key per URL.<br><br>See also: [example of filtering](/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records) VMware event log records.| |vmware.fullname\[url\]|<|<|<|<| |<|VMware service full name.|String|**url** - VMware service URL|<| |vmware.hv.cluster.name\[url,uuid\]|<|<|<|<| |<|VMware hypervisor cluster name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.cpu.usage\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.cpu.usage.perf\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.cpu.utilization\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor usage as a percentage during the interval, depends on power management or HT.|Float|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datacenter.name\[url,uuid\]|<|<|<|<| |<|VMware hypervisor datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.list\[url,uuid\]|<|<|<|<| |<|List of VMware hypervisor datastores.|JSON object|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.datastore.multipath\[url,uuid,<datastore>,<partitionid>\]|<|<|<|<| |<|Number of available datastore paths.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore name<br>**partitionid** - internal ID of physical device from vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[url,uuid,datastore,<mode>\]|<|<|<|<| |<|Average amount of time for a read operation from the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore name<br>**mode** - latency (default)|<| |vmware.hv.datastore.size\[url,uuid,datastore,<mode>\]|<|<|<|<| |<|VMware datastore space in bytes or in percentage from total.|Integer - for bytes<br>Float - for percentage|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore name<br>**mode** - possible values:<br>total (default), free, pfree (free, percentage), uncommitted|<| |vmware.hv.datastore.write\[url,uuid,datastore,<mode>\]|<|<|<|<| |<|Average amount of time for a write operation to the datastore (milliseconds).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**datastore** - datastore name<br>**mode** - latency (default)|<| |vmware.hv.discovery\[url\]|<|<|<|<| |<|Discovery of VMware hypervisors.|JSON object|**url** - VMware service URL|<| |vmware.hv.fullname\[url,uuid\]|<|<|<|<| |<|VMware hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.freq\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor frequency (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.model\[url,uuid\]|<|<|<|<| |<|VMware hypervisor processor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.num\[url,uuid\]|<|<|<|<| |<|Number of processor cores on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.cpu.threads\[url,uuid\]|<|<|<|<| |<|Number of processor threads on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.memory\[url,uuid\]|<|<|<|<| |<|VMware hypervisor total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.model\[url,uuid\]|<|<|<|<| |<|VMware hypervisor model.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.uuid\[url,uuid\]|<|<|<|<| |<|VMware hypervisor BIOS UUID.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.hw.vendor\[url,uuid\]|<|<|<|<| |<|VMware hypervisor vendor name.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.maintenance\[url,uuid\]|<|<|<|<| |<|VMware hypervisor maintenance status.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|Returns '0' - not in maintenance or '1' - in maintenance| |vmware.hv.memory.size.ballooned\[url,uuid\]|<|<|<|<| |<|VMware hypervisor ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.memory.used\[url,uuid\]|<|<|<|<| |<|VMware hypervisor used memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.network.in\[url,uuid,<mode>\]|<|<|<|<| |<|VMware hypervisor network input statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**mode** - bps (default)|<| |vmware.hv.network.out\[url,uuid,<mode>\]|<|<|<|<| |<|VMware hypervisor network output statistics (bytes per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**mode** - bps (default)|<| |vmware.hv.perfcounter\[url,uuid,path,<instance>\]|<|<|<|<| |<|VMware hypervisor performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.hv.power\[url,uuid,<max>\]|<|<|<|<| |<|VMware hypervisor power usage (W).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier<br>**max** - maximum allowed power usage|<| |vmware.hv.sensor.health.state\[url,uuid\]|<|<|<|<| |<|VMware hypervisor health state rollup sensor.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|The item might not work in the VMware vSphere 6.5 and newer, because VMware has deprecated the *VMware Rollup Health State* sensor. | |vmware.hv.sensors.get\[url,uuid\]|<|<|<|<| |<|VMware hypervisor HW vendor state sensors.|JSON|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.status\[url,uuid\]|<|<|<|<| |<|VMware hypervisor status.|Integer:<br>0 - gray;<br>1 - green;<br>2 - yellow;<br>3 - red|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|Uses the host system overall status property.| |vmware.hv.uptime\[url,uuid\]|<|<|<|<| |<|VMware hypervisor uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.version\[url,uuid\]|<|<|<|<| |<|VMware hypervisor version.|String|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.hv.vm.num\[url,uuid\]|<|<|<|<| |<|Number of virtual machines on VMware hypervisor.|Integer|**url** - VMware service URL<br>**uuid** - VMware hypervisor global unique identifier|<| |vmware.version\[url\]|<|<|<|<| |<|VMware service version.|String|**url** - VMware service URL|<| |vmware.vm.cluster.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.latency\[url,uuid\]|<|<|<|<| |<|Percentage of time the virtual machine is unable to run because it is contending for access to the physical CPU(s).|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.num\[url,uuid\]|<|<|<|<| |<|Number of processors on VMware virtual machine.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.readiness\[url,uuid,<instance>\]|<|<|<|<| |<|Percentage of time that the virtual machine was ready, but could not get scheduled to run on the physical CPU.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - CPU instance|<| |vmware.vm.cpu.ready\[url,uuid\]|<|<|<|<| |<|Time (in milliseconds) that the virtual machine was ready, but could not get scheduled to run on the physical CPU. CPU ready time is dependent on the number of virtual machines on the host and their CPU loads (%).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.swapwait\[url,uuid,<instance>\]|<|<|<|<| |<|Percentage of CPU time spent waiting for swap-in.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - CPU instance|<| |vmware.vm.cpu.usage\[url,uuid\]|<|<|<|<| |<|VMware virtual machine processor usage (Hz).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.cpu.usage.perf\[url,uuid\]|<|<|<|<| |<|VMware virtual machine processor usage as a percentage during the interval.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.datacenter.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine datacenter name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.discovery\[url\]|<|<|<|<| |<|Discovery of VMware virtual machines.|JSON object|**url** - VMware service URL|<| |vmware.vm.guest.memory.size.swapped\[url,uuid\]|<|<|<|<| |<|Amount of guest physical memory that is swapped out to the swap space (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.guest.osuptime\[url,uuid\]|<|<|<|<| |<|Total time elapsed since the last operating system boot-up (in seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.hv.name\[url,uuid\]|<|<|<|<| |<|VMware virtual machine hypervisor name.|String|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size\[url,uuid\]|<|<|<|<| |<|VMware virtual machine total memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.ballooned\[url,uuid\]|<|<|<|<| |<|VMware virtual machine ballooned memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.compressed\[url,uuid\]|<|<|<|<| |<|VMware virtual machine compressed memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.consumed\[url,uuid\]|<|<|<|<| |<|Amount of host physical memory consumed for backing up guest physical memory pages (KB).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.private\[url,uuid\]|<|<|<|<| |<|VMware virtual machine private memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.shared\[url,uuid\]|<|<|<|<| |<|VMware virtual machine shared memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.swapped\[url,uuid\]|<|<|<|<| |<|VMware virtual machine swapped memory size (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.usage.guest\[url,uuid\]|<|<|<|<| |<|VMware virtual machine guest memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.size.usage.host\[url,uuid\]|<|<|<|<| |<|VMware virtual machine host memory usage (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.memory.usage\[url,uuid\]|<|<|<|<| |<|Percentage of host physical memory that has been consumed.|Float|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.net.if.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware virtual machine network interfaces.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.net.if.in\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface input statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.out\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine network interface output statistics (bytes/packets per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - network interface instance<br>**mode** - bps (default)/pps - bytes/packets per second|<| |vmware.vm.net.if.usage\[url,uuid,<instance>\]|<|<|<|<| |<|VMware virtual machine network utilization (combined transmit-rates and receive-rates) during the interval (KBps).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - network interface instance|<| |vmware.vm.perfcounter\[url,uuid,path,<instance>\]|<|<|<|<| |<|VMware virtual machine performance counter value.|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**path** - performance counter path ^**[1](vmware_keys#footnotes)**^<br>**instance** - performance counter instance. Use empty instance for aggregate values (default)|<| |vmware.vm.powerstate\[url,uuid\]|<|<|<|<| |<|VMware virtual machine power state.|Integer:<br>0 - poweredOff;<br>1 - poweredOn;<br>2 - suspended|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.committed\[url,uuid\]|<|<|<|<| |<|VMware virtual machine committed storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.readoio\[url,uuid,instance\]|<|<|<|<| |<|Average number of outstanding read requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalreadlatency\[url,uuid,instance\]|<|<|<|<| |<|The average time a read from the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.totalwritelatency\[url,uuid,instance\]|<|<|<|<| |<|The average time a write to the virtual disk takes (milliseconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.storage.uncommitted\[url,uuid\]|<|<|<|<| |<|VMware virtual machine uncommitted storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.unshared\[url,uuid\]|<|<|<|<| |<|VMware virtual machine unshared storage space (bytes).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.storage.writeoio\[url,uuid,instance\]|<|<|<|<| |<|Average number of outstanding write requests to the virtual disk during the collection interval.|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance (mandatory)|<| |vmware.vm.uptime\[url,uuid\]|<|<|<|<| |<|VMware virtual machine uptime (seconds).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.vfs.dev.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware virtual machine disk devices.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|<| |vmware.vm.vfs.dev.read\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device read statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.dev.write\[url,uuid,instance,<mode>\]|<|<|<|<| |<|VMware virtual machine disk device write statistics (bytes/operations per second).|Integer ^**[2](vmware_keys#footnotes)**^|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**instance** - disk device instance<br>**mode** - bps (default)/ops - bytes/operations per second|<| |vmware.vm.vfs.fs.discovery\[url,uuid\]|<|<|<|<| |<|Discovery of VMware virtual machine file systems.|JSON object|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier|VMware Tools must be installed on the guest virtual machine.| |vmware.vm.vfs.fs.size\[url,uuid,fsname,<mode>\]|<|<|<|<| |<|VMware virtual machine file system statistics (bytes/percentages).|Integer|**url** - VMware service URL<br>**uuid** - VMware virtual machine global unique identifier<br>**fsname** - file system name<br>**mode** - total/free/used/pfree/pused|VMware Tools must be installed on the guest virtual machine.|
ca	#### Claus d'element  La taula proporciona detalls de comprovacions senzilles que es poden emprar per monitorar [entorns VMware](/manual/vm_monitoring).  Els paràmetres sense claudàtors angulars són obligatoris. Els paràmetres marcats amb claudàtors angulars **<** **>** són opcionals.  |Clau|<|<|<|<| |-|------|--|------|------| |<|Descripció|Valor de retorn|Paràmetres|Comentaris| |vmware.cl.perfcounter\[\<url\>,\<id\>,\<camí\>,\<instància\>\]|<|<|<|<| |<|Mètriques del comptador de rendiment del clúster de VMware.|Enter|**url** - URL del servei de VMware<br>**id** - identificador del clúster de VMware<br>**camí** - camí del comptador <br>**instància** - la instància del comptador de rendiment|`id` es pot rebre des de vmware.cluster.discovery\[\] com a {\#CLUSTER.ID}| |vmware.cluster.discovery\[\<url\>\]|<|<|<|<| |<|Es descobreixen clústers de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.cluster.status\[\<url\>, \<nom\>\]|<|<|<|<| |<|Estat del clúster de VMware.|Enter:<br>0 - gris;<br>1 - verd;<br>2 - groc;<br>3 - vermell|**url** - URL del servei de VMware< br> **nom** - nom del clúster de VMware|<| |vmware.datastore.discovery\[\<url\>\]|<|<|<|<| |<|Es descobreixen magatzems de dades de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.datastore.hv.list\[\<url\>,\<datastore\>\]|<|<|<|<| |<|Llista d'hipervisors del magatzem de dades.|Objecte JSON|**url** - URL del servei VMware<br>**datastore** - nom del magatzem de dades|<| |vmware.datastore.read\[\<url\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Durada d'una operació de lectura des del magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br> **datastore** - nom del magatzem de dades<br>**mode** - latència (valor mitjà, predeterminat), latència màxima (valor màxim)|<| |vmware.datastore.size\[\<url\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Espai del magatzem de dades VMware en octets o percentatge del total.|Enter - per octets<br>Flotant - per percentatge|**url** - URL del servei VMware<br>**datastore** - nom del magatzem de dades<br> **mode** - valors possibles:<br>total (predeterminat), lliure, pfree (lliure, percentatge), no compromès|<| |vmware.datastore.write\[\<url\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Durada d'una operació d'escriptura al magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br> **datastore** - nom del magatzem de dades<br>**mode** - latència (valor mitjà, predeterminat), latència màxima (valor màxim)|<| |vmware.dc.discovery\[\<url\>\]|<|<|<|<| |<|Descobrint centres de dades de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.eventlog\[\<url\>,\<mode\>\]|<|<|<|<| |<|Registre d'esdeveniments de VMware.|Registre|**url** - URL del servei de VMware<br>**mode** - *tot* (per defecte), *omet* - omet el processament de dades més antigues| Només hi hauria d'haver un vmware.eventlog\[\] element vle per URL.<br><br>Veieu també: [exemple de filtrat](/manual/config/items/preprocessing/examples#filtering_vmware_event_log_records) Registres del registre d'esdeveniments de VMware.| |vmware.fullname\[\<url\>\]|<|<|<|<| |<|Nom complet del servei VMware.|String|**url** - URL del servei VMware|<| |vmware.hv.cluster.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del clúster de l'hipervisor VMware.|String|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.cpu.usage\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de la CPU de VMware Hypervisor (Hz).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor|<| |vmware.hv.cpu.usage.perf\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de la CPU de l'hipervisor VMware en percentatge durant l'interval.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware| <| |vmware.hv.cpu.utilization\[\<url\>,\<uuid\>\]|<|<|<|<| |<|L'ús de la CPU de l'hipervisor VMware en percentatge durant l'interval, depèn de la gestió d'energia o de l'HT.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datacenter.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del centre de dades de l'hipervisor VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datastore.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Es descobreixenmagatzems de dades de l'hipervisor de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datastore.list\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Llista de magatzems de dades de l'hipervisor de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.datastore.multipath\[\<url\>,\<uuid\>,\<datastore\>,\<partitionid\>\]|<|<|<|<| |<|Nombre de camins de magatzem de dades disponibles.|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor de VMware<br>**magatzem de dades** - Nom del magatzem de dades<br>**partitionid** - Identificador intern del dispositiu físic de vmware.hv.datastore.discovery|<| |vmware.hv.datastore.read\[\<url\>,\<uuid\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Temps mitjà per a una operació de lectura des del magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br >**uuid** - Nom d'equip de l'hipervisor VMware<br>**magatzem de dades** - Nom del magatzem de dades<br>**mode** - latència (per defecte)|<| |vmware.hv.datastore.size\[\<url\>,\<uuid\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Espai del magatzem de dades de VMware en octets o percentatge del total.|Enter - per octets<br>Flotant - per percentatge|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware<br> **datastore** - nom del magatzem de dades<br>**mode** - valors possibles:<br>total (predeterminat), lliure, pfree (gratuït, percentatge), no compromès|<| |vmware.hv.datastore.write\[\<url\>,\<uuid\>,\<datastore\>,\<mode\>\]|<|<|<|<| |<|Durada mitjana d'una operació d'escriptura de magatzem de dades (mil·lisegons).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>* *uuid** - VMware nom d'equip de l'hipervisor<br>**magatzem de dades** - nom del magatzem de dades<br>**mode** - latència (per defecte)|<| |vmware.hv.discovery\[\<url\>\]|<|<|<|<| |<|Descoberta d'hipervisors de VMware.|Objecte JSON|**url** - URL del servei de VMware|<| |vmware.hv.nom complet\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom de l'hipervisor VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.cpu.freq\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Freqüència de CPU de VMware Hypervisor (Hz).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor|<| |vmware.hv.hw.cpu.model\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Model de CPU de l'hipervisor VMware.|String|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.cpu.num\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de nuclis de CPU a l'hipervisor VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.cpu.threads\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de fils de processador a l'hipervisor VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.memory\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida total de la memòria de l'hipervisor VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|< | |vmware.hv.hw.model\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Model d'hipervisor VMware.|String|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.hv.hw.uuid\[\<url\>,\<uuid\>\]|<|<|<|<| |<|VMware Hypervisor BIOS UUID.|String|**url** - URL del servei VMware<br>**uuid** - VMware Hypervisor Hostname|<| |vmware.hv.hw.vendor\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del proveïdor de l'hipervisor VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.maintenance\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Estat de manteniment de VMware Hypervisor.|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor|Retorna '0' - no és en manteniment o '1' - és en manteniment| |vmware.hv.memory.size.ballooned\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria inflada de l'hipervisor VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.memory.used\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria emprada de l'hipervisor VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware| <| |vmware.hv.network.in\[\<url\>,\<uuid\>,\<mode\>\]|<|<|<|<| |<|Estadístiques d'entrada a la xarxa d'hipervisor VMware (octets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br>* *uuid** - nom d'equip de l'hipervisor de VMware<br>**mode** - bps (per defecte)|<| |vmware.hv.network.out\[\<url\>,\<uuid\>,\<mode\>\]|<|<|<|<| |<|Estadístiques de sortida de la xarxa de l'hipervisor VMware (octets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>* *uuid** - VMware nom d'equip de l'hipervisor<br>**mode** - bps (per defecte)|<| |vmware.hv.perfcounter\[\<url\>,\<uuid\>,\<camí\>,\<instància\>\]|<|<|<|<| |<|Valor del comptador de rendiment de l'hipervisor VMware.|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware<br >**path** - camí del comptador de rendiment ^**[1](vmware_keys#footnotes)**^<br>**instància** - rendiment de la instància del comptador de rendiment. Empreu una instància buida per als valors afegits (per defecte)|<| |vmware.hv.power\[\<url\>,\<uuid\>,\<max\>\]|<|<|<|<| |<|Consum d'energia de VMware Hypervisor (W).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware Hypervisor<br> **max** - Consum d'energia màxim permès| << |vmware.hv.sensor.health.state\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Sensor acumulatiu de salut de l'hipervisor VMware.|Enter:<br>0 - gris;<br>1 - verd;<br>2 - groc;<br>3 - vermell|* *url** - URL del servei VMware < br>**uuid** - Nom d'equip de VMware Hypervisor|És possible que l'element no funcioni a VMware vSphere 6.5 i posterior perquè VMware ha deixat obsolet el sensor * VMware Rollup HealthState*.| |vmware.hv.sensors.get\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Sensors d'estat del proveïdor de maquinari de l'hipervisor VMware.|JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de l'hipervisor de VMware|<| |vmware.hv.status\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Estat de l'hipervisor VMware.|Enter:<br>0 - gris;<br>1 - verd;<br>2 - groc;<br>3 - vermell|**url** - URL del servei VMware<br> **uuid** - nom d'equip de l'hipervisor VMware|Empra la propietat d'estat general del sistema equip.| |vmware.hv.uptime\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Temps d'activitat de l'hipervisor VMware (segons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor VMware|<| |vmware.hv.version\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Versió de l'hipervisor de VMware.|String|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de l'hipervisor de VMware|<| |vmware.hv.vm.num\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de màquines virtuals a l'hipervisor VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de l'hipervisor VMware|<| |vmware.version\[\<url\>\]|<|<|<|<| |<|Versió del servei VMware.|String|**url** - URL del servei VMware|<| |vmware.vm.cluster.name\[\<url\>,\<uuid>\]|<|<|<|<| |<|Nom de VMware VM.|String|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.cpu.latency\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Percentatge de temps que la màquina virtual no es pot executar perquè està en disputa per accedir a les CPU físiques.|Flotant|**url** - URL del servei de VMware<br> **uuid** - nom d'equip de la màquina virtual VMware|<| |vmware.vm.cpu.num\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nombre de processadors a la màquina virtual VMware.|Enter|**url** - URL del servei VMware<br>**uuid** - nom d'equip de la màquina virtual VMware|<| |vmware.vm.cpu.readiness\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Percentatge de temps que la VM va estar a punt, però no s'ha pogut programar per executar-se a la CPU física.|Flotant|**url** - URL del servei de VMware<br>**uuid ** - Nom d'equip de la màquina virtual de VMware< br>**instància** - instància de CPU|<| |vmware.vm.cpu.ready\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Durada (en mil·lisegons) que la màquina virtual estava preparada, però no s'ha pogut programar per executar-se a la CPU física. El temps d'activitat de la CPU depèn del nombre de màquines virtuals de l'equip i de les seves càrregues de CPU (%).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL VMware Service<br >**uuid** - Nom d'equip de la màquina virtual de VMware|<| |vmware.vm.cpu.swapwait\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Percentatge de temps de CPU dedicat a l'espera del canvi.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància de CPU|<| |vmware.vm.cpu.usage\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de la CPU de VMware VM (Hz).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.cpu.usage.perf\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de CPU de VMware VM en percentatge durant l'interval.|Flotant|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM| <| |vmware.vm.datacenter.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom del datacenter de VMware VM.|String|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.discovery\[\<url\>\]|<|<|<|<| |<|Descoberta de màquines virtuals VMware.|Objecte JSON|**url** - URL del servei VMware|<| |vmware.vm.guest.memory.size.swapped\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Quantitat de memòria física convidada que s'intercanvia per espai d'intercanvi (Ko).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom de l'equip de la màquina virtual de vmware|<| |vmware.vm.guest.osuptime\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Temps total transcorregut des de la darrera engegada del sistema operatiu (en segons).|Enter|**url** - URL del servei VMware<br>**uuid** - Nom d'equip de la màquina virtual vmware|<| |vmware.vm.hv.name\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Nom de l'hipervisor de la màquina virtual VMware.|Cadena|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware|<| |vmware.vm.memory.size\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida total de la memòria de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.memory.size.ballooned\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria inflada de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.memory.size.compressed\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria comprimida de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|< | |vmware.vm.memory.size.consumed\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Quantitat de memòria física de l'equip consumida per fer còpies de seguretat de pàgines de memòria física convidada (KB).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware|<| |vmware.vm.memory.size.private\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria privada de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|< | |vmware.vm.memory.size.shared\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria compartida de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|< | |vmware.vm.memory.size.swapped\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Mida de memòria bescanviada de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|< | |vmware.vm.memory.size.usage.guest\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de memòria convidada de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VM vmware|<| |vmware.vm.memory.size.usage.host\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Ús de memòria de l'equip de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom de l'equip de la màquina vmware virtual|<| |vmware.vm.memory.usage\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Percentatge de memòria física de l'equip que s'ha consumit.|Flotant|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.net.if.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Descoberta d'interfícies de xarxa de màquines virtuals VMware.|Objecte JSON|**url** - URL del servei VMware<br>**uuid** - nom d'equip de la màquina virtual VMware|<| |vmware.vm.net.if.in\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques d'entrada de la interfície de xarxa de la màquina virtual de VMware (octets/paquets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei vmware<br>* *uuid** - nom d'equip de VM de vmware<br>**instància** - instància de la interfície de xarxa<br>**mode** - bps (per defecte)/pps - octets/paquets per segon|<| |vmware.vm.net.if.out\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques de sortida de la interfície de xarxa VMware VM (octets/paquets per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància de la interfície de xarxa<br>**mode** - bps (per defecte)/pps - octets/paquets per segon|<| |vmware.vm.net.if.usage\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Ús de la xarxa de VMware VM (taxes combinades de transmissió i recepció) durant l'interval (Kops).|Enter|**url** - URL del servei de VMware<br>**uuid* * - Nom d'equip de la màquina virtual de VMware<br> **instància** - instància de la interfície de xarxa|<| |vmware.vm.perfcounter\[\<url\>,\<uuid\>,\<camí\>,\<instància\>\]|<|<|<|<| |<|Valor del comptador de rendiment de la màquina virtual VMware.|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware < br>**path** - camí del comptador de rendiment ^**[1](vmware_keys#footnotes)**^<br>**instància** - rendiment de la instància del comptador de rendiment. Empreu una instància buida per als valors afegits (per defecte)|<| |vmware.vm.powerstate\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Estat d'alimentació de VMware VM.|Enter:<br>0 - apagat;<br>1 - engegat;<br>2 - suspès|**url** - URL del servei de VMware <br>**uuid** - Nom d'equip de la màquina virtual VMware|<| |vmware.vm.storage.committed\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Emmagatzematge dedicat de la màquina virtual VMware (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.storage.readoio\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Nombre mitjà de peticions de lectura pendents al disc virtual durant l'interval de recollida.|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip del servei de VMware Màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatòria)|<| |vmware.vm.storage.totalreadlatency\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Temps mig d'una lectura del disc virtual (mil·lisegons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatori)|<| |vmware.vm.storage.totalwritelatency\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Durada mitjana d'una escriptura al disc virtual (mil·lisegons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de la màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatori)|<| |vmware.vm.storage.uncommitted\[<url>,<uuid>\]|<|<|<|<| |<|Espai d'emmagatzematge no compromès de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.storage.unshared\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Espai d'emmagatzematge no compartit de VMware VM (octets).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.storage.writeoio\[\<url\>,\<uuid\>,\<instància\>\]|<|<|<|<| |<|Nombre mitjà de peticions d'escriptura pendents al disc virtual durant l'interval de recollida.|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip del servei de VMware la màquina virtual de VMware<br>**instància** - instància del dispositiu de disc (obligatori)|<| |vmware.vm.uptime\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Temps d'activitat de VMware VM (segons).|Enter|**url** - URL del servei de VMware<br>**uuid** - Nom d'equip de VMware VM|<| |vmware.vm.vfs.dev.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Descoberta de dispositius de disc de la màquina virtual de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|<| |vmware.vm.vfs.dev.read\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques de lectura del dispositiu de disc VMware VM (octets/operacions per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware <br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància del dispositiu de disc<br>**mode** - bps (per defecte)/ops - octets/operacions per segon|<| |vmware.vm.vfs.dev.write\[\<url\>,\<uuid\>,\<instància\>,\<mode\>\]|<|<|<|<| |<|Estadístiques d'escriptura del dispositiu de disc VMware VM (octets/operacions per segon).|Enter ^**[2](vmware_keys#footnotes)**^|**url** - URL del servei VMware<br>**uuid** - Nom d'equip de VMware VM<br>**instància** - instància del dispositiu de disc<br>**mode** - bps (per defecte)/ops - octets/operacions per segon|<| |vmware.vm.vfs.fs.discovery\[\<url\>,\<uuid\>\]|<|<|<|<| |<|Descoberta dels sistemes de fitxers de la màquina virtual de VMware.|Objecte JSON|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de la màquina virtual de VMware|VMware Tools s'ha d'instal·lar a la màquina virtual convidada.| |vmware.vm.vfs.fs.size\[\<url\>,\<uuid\>,\<fsname\>,\<mode\>\]|<|<|<|<| |<|Estadístiques del sistema de fitxers de VMware VM (octets/percentatge).|Enter|**url** - URL del servei de VMware<br>**uuid** - nom d'equip de VMware VM <br>**fsname** - nom del sistema de fitxers< br>**mode** - total/free/used/pfree/pused|VMware Tools s'ha d'instal·lar a la màquina virtual convidada.|

en-us	#### Item key  The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is      net.if.discovery  This item is supported since Zabbix agent 2.0.
ca	#### Clau d'element  La clau de l'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és   net.if.discovery   Aquest element és compatible des de l'agent Zabbix 2.0.

en-us	#### Item key  The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is      system.cpu.discovery  This item is supported since Zabbix agent 2.4.
ca	#### Clau d'element  La clau de l'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és   system.cpu.discovery   Aquest element és compatible des de l'agent Zabbix 2.4.

en-us	#### Item key  The item key to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is      vfs.dev.discovery  This item is supported on Linux platforms only, since Zabbix agent 4.4.  You may create discovery rules using this discovery item and:  -   filter: **{\#DEVNAME} matches `sd[\D]$`** - to discover devices     named "sd0", "sd1", "sd2", ... -   filter: **{\#DEVTYPE} matches `disk` AND {\#DEVNAME} does not match     `^loop.*`** - to discover disk type devices whose name does not     start with "loop"
ca	#### Clau d'element  La clau de l'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és       vfs.dev.discovery   Aquest element només és compatible amb plataformes Linux, des de l'agent Zabbix 4.4.  Podeu crear regles de descoberta mitjançant aquest element de descoberta i:  - filtre: **{\#DEVNAME} coincideix amb `sd[\D]$`** - per descobrir dispositius anomenats "sd0", "sd1", "sd2",... - filtre: **{\#DEVTYPE} coincideix amb `disk` I {\#DEVNAME} no coincideix amb `^loop.*`** - per descobrir dispositius de tipus disc el nom dels quals no comenci per "bucle"

en-us	#### Item key  The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is      perf_instance.discovery[object]  or, to be able to provide the object name in English only, independently of OS localization:      perf_instance_en.discovery[object]  For example:      perf_instance.discovery[Processador]     perf_instance_en.discovery[Processor]  These items are supported since Zabbix Windows agent 5.0.1.
ca	#### Clau d'element  L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és       perf_instance.discovery[objecte]  o, per poder proporcionar el nom de l'objecte només en anglès, independentment de la localització del sistema operatiu:       perf_instance_en.discovery[objecte]  Per exemple:       perf_instance.discovery[Processador]      perf_instance_en.discovery[Processador]  Aquests elements són compatibles des de l'agent de Windows Zabbix 5.0.1.

en-us	#### Item key  The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is      service.discovery  This item is supported since Zabbix Windows agent 3.0.
ca	#### Clau d'element  L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és   service.discovery   Aquest element és compatible des de l'agent Zabbix 3.0 per a Windows.

en-us	### Item key  The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is the      systemd.unit.discovery  ::: noteimportant This [item](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) key is only supported in Zabbix agent 2. :::  This item returns a JSON with information about systemd units, for example:      [{         "{#UNIT.NAME}": "mysqld.service",         "{#UNIT.DESCRIPTION}": "MySQL Server",         "{#UNIT.LOADSTATE}": "loaded",         "{#UNIT.ACTIVESTATE}": "active",         "{#UNIT.SUBSTATE}": "running",         "{#UNIT.FOLLOWED}": "",         "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice",         "{#UNIT.JOBID}": 0,         "{#UNIT.JOBTYPE}": "",         "{#UNIT.JOBPATH}": "/",         "{#UNIT.UNITFILESTATE}": "enabled"     }, {         "{#UNIT.NAME}": "systemd-journald.socket",         "{#UNIT.DESCRIPTION}": "Journal Socket",         "{#UNIT.LOADSTATE}": "loaded",         "{#UNIT.ACTIVESTATE}": "active",         "{#UNIT.SUBSTATE}": "running",         "{#UNIT.FOLLOWED}": "",         "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket",         "{#UNIT.JOBID}": 0,         "{#UNIT.JOBTYPE}": "",         "{#UNIT.JOBPATH}": "/",         "{#UNIT.UNITFILESTATE}": "enabled"     }]
ca	### Clau d'element  L'element a emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és       systemd.unit.discovery  ::: noteimportant Aquesta clau d'[element](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) només s'admet amb l'agent Zabbix 2. :::  Aquest element retorna un JSON amb la informació de les unitats systemd, per exemple:      [{         "{#UNIT.NAME}": "mysqld.service",         "{#UNIT.DESCRIPTION}": "MySQL Server",         "{#UNIT.LOADSTATE}": "loaded",         "{#UNIT.ACTIVESTATE}": "active",         "{#UNIT.SUBSTATE}": "running",         "{#UNIT.FOLLOWED}": "",         "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/mysqld_2eservice",         "{#UNIT.JOBID}": 0,         "{#UNIT.JOBTYPE}": "",         "{#UNIT.JOBPATH}": "/",         "{#UNIT.UNITFILESTATE}": "enabled"     }, {         "{#UNIT.NAME}": "systemd-journald.socket",         "{#UNIT.DESCRIPTION}": "Journal Socket",         "{#UNIT.LOADSTATE}": "loaded",         "{#UNIT.ACTIVESTATE}": "active",         "{#UNIT.SUBSTATE}": "running",         "{#UNIT.FOLLOWED}": "",         "{#UNIT.PATH}": "/org/freedesktop/systemd1/unit/systemd_2djournald_2esocket",         "{#UNIT.JOBID}": 0,         "{#UNIT.JOBTYPE}": "",         "{#UNIT.JOBPATH}": "/",         "{#UNIT.UNITFILESTATE}": "enabled"     }]

en-us	#### Item key  The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is the      zabbix[host,discovery,interfaces]  internal item. This item is supported since Zabbix server 3.4.  This item returns a JSON with the description of interfaces, including:  -   IP address/DNS hostname (depending on the “Connect to” host setting) -   Port number -   Interface type (Zabbix agent, SNMP, JMX, IPMI) -   If it is the default interface or not -   If the bulk request feature is enabled - for SNMP interfaces only.  For example:      [{"{#IF.CONN}":"192.168.3.1","{#IF.IP}":"192.168.3.1","{#IF.DNS}":"","{#IF.PORT}":"10050","{#IF.TYPE}":"AGENT","{#IF.DEFAULT}":1}]    With multiple interfaces their records in JSON are ordered by:  -   Interface type, -   Default - the default interface is put before non-default     interfaces, -   Interface ID (in ascending order).
ca	#### Clau d'element  L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery-rule) és l'element intern  zabbix[equip,descoberta,interfícies]  Aquest element és compatible des del servidor Zabbix 3.4.  Aquest element retorna un JSON amb la descripció de les interfícies, que inclou:  - Adreça IP/nom d'equip DNS (segons la configuració de l'equip "Connexió a") - Nombre de port - Tipus d'interfície (agent Zabbix, SNMP, JMX, IPMI) - Si és la interfície predeterminada o no - Si la funcionalitat de consulta massiva és habilitada, només per a interfícies SNMP.  Per exemple:  {"data":[{"{#IF.CONN}":"192.168.3.1","{#IF.IP}":"192.168.3.1","{#IF.DNS}":"","{#IF.PORT}":"10050","{#IF.TYPE}":"AGENT","{#IF.DEFAULT}":1}]}  Amb diverses interfícies, els seus registres JSON estan ordenats per:  - tipus d'interfície, - Per defecte: la interfície predeterminada es col·loca abans que les interfícies no predeterminades, - ID de la interfície (en ordre ascendent).

en-us	#### Item key  The item to use in the [discovery rule](/manual/discovery/low_level_discovery#discovery_rule) is      wmi.getall[<namespace>,<query>]  This [item](/manual/config/items/itemtypes/zabbix_agent/win_keys) transforms the query result into a JSON array. For example:      select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%'  may return something like this:  ``` {.java} [     {         "DeviceID" : "\\.\PHYSICALDRIVE0",         "BytesPerSector" : 512,         "Capabilities" : [             3,             4         ],         "CapabilityDescriptions" : [             "Random Access",             "Supports Writing"         ],         "Caption" : "VBOX HARDDISK ATA Device",         "ConfigManagerErrorCode" : "0",         "ConfigManagerUserConfig" : "false",         "CreationClassName" : "Win32_DiskDrive",         "Description" : "Disk drive",         "FirmwareRevision" : "1.0",         "Index" : 0,         "InterfaceType" : "IDE"     },     {         "DeviceID" : "\\.\PHYSICALDRIVE1",         "BytesPerSector" : 512,         "Capabilities" : [             3,             4         ],         "CapabilityDescriptions" : [             "Random Access",             "Supports Writing"         ],         "Caption" : "VBOX HARDDISK ATA Device",         "ConfigManagerErrorCode" : "0",         "ConfigManagerUserConfig" : "false",         "CreationClassName" : "Win32_DiskDrive",         "Description" : "Disk drive",         "FirmwareRevision" : "1.0",         "Index" : 1,         "InterfaceType" : "IDE"     } ] ```  This item is supported since Zabbix Windows agent 4.4.
ca	#### Clau d'element  L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és      wmi.getall[<namespace>,<query>]  L'element que cal emprar a la [regla de descoberta](/manual/discovery/low_level_discovery#discovery_rule) és      select * from Win32_DiskDrive where Name like '%PHYSICALDRIVE%'  pot retornar quelcom com ara:  ``` {.java} [     {         "DeviceID" : "\\.\PHYSICALDRIVE0",         "BytesPerSector" : 512,         "Capabilities" : [             3,             4         ],         "CapabilityDescriptions" : [             "Random Access",             "Supports Writing"         ],         "Caption" : "VBOX HARDDISK ATA Device",         "ConfigManagerErrorCode" : "0",         "ConfigManagerUserConfig" : "false",         "CreationClassName" : "Win32_DiskDrive",         "Description" : "Disk drive",         "FirmwareRevision" : "1.0",         "Index" : 0,         "InterfaceType" : "IDE"     },     {         "DeviceID" : "\\.\PHYSICALDRIVE1",         "BytesPerSector" : 512,         "Capabilities" : [             3,             4         ],         "CapabilityDescriptions" : [             "Random Access",             "Supports Writing"         ],         "Caption" : "VBOX HARDDISK ATA Device",         "ConfigManagerErrorCode" : "0",         "ConfigManagerUserConfig" : "false",         "CreationClassName" : "Win32_DiskDrive",         "Description" : "Disk drive",         "FirmwareRevision" : "1.0",         "Index" : 1,         "InterfaceType" : "IDE"     } ] ```  Aquest element s'admet des de l'agent Zabbix Windows 4.4.

en-us	#### Item key  Unlike with file system and network interface discovery, the item does not necessarily has to have an "snmp.discovery" key - item type of SNMP agent is sufficient.  To configure the discovery rule, do the following:  -   Go to: *Configuration* → *Templates* -   Click on *Discovery* in the row of an appropriate template  ![](../../../../../assets/en/manual/discovery/low_level_discovery/templates_snmp.png)  -   Click on *Create discovery rule* in the upper right corner of the     screen -   Fill in the discovery rule form with the required details as in the     screenshot below  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_snmp.png)  All mandatory input fields are marked with a red asterisk.  The OIDs to discover are defined in SNMP OID field in the following format: `discovery[{#MACRO1}, oid1, {#MACRO2}, oid2, …,]`  where *{\#MACRO1}*, *{\#MACRO2}* … are valid lld macro names and *oid1*, *oid2*... are OIDs capable of generating meaningful values for these macros. A built-in macro *{\#SNMPINDEX}* containing index of the discovered OID is applied to discovered entities. The discovered entities are grouped by *{\#SNMPINDEX}* macro value.  To understand what we mean, let us perform few snmpwalks on our switch:      $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr     IF-MIB::ifDescr.1 = STRING: WAN     IF-MIB::ifDescr.2 = STRING: LAN1     IF-MIB::ifDescr.3 = STRING: LAN2      $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifPhysAddress     IF-MIB::ifPhysAddress.1 = STRING: 8:0:27:90:7a:75     IF-MIB::ifPhysAddress.2 = STRING: 8:0:27:90:7a:76     IF-MIB::ifPhysAddress.3 = STRING: 8:0:27:2b:af:9e  And set SNMP OID to: `discovery[{#IFDESCR}, ifDescr, {#IFPHYSADDRESS}, ifPhysAddress]`  Now this rule will discover entities with {\#IFDESCR} macros set to **WAN**, **LAN1** and **LAN2**, {\#IFPHYSADDRESS} macros set to **8:0:27:90:7a:75**, **8:0:27:90:7a:76**, and **8:0:27:2b:af:9e**, {\#SNMPINDEX} macros set to the discovered OIDs indexes **1**, **2** and **3**:  ``` {.java} [     {         "{#SNMPINDEX}": "1",         "{#IFDESCR}": "WAN",         "{#IFPHYSADDRESS}": "8:0:27:90:7a:75"     },     {         "{#SNMPINDEX}": "2",         "{#IFDESCR}": "LAN1",         "{#IFPHYSADDRESS}": "8:0:27:90:7a:76"     },     {         "{#SNMPINDEX}": "3",         "{#IFDESCR}": "LAN2",         "{#IFPHYSADDRESS}": "8:0:27:2b:af:9e"     } ] ```  If an entity does not have the specified OID, then the corresponding macro will be omitted for this entity. For example if we have the following data:      ifDescr.1 "Interface #1"     ifDescr.2 "Interface #2"     ifDescr.4 "Interface #4"      ifAlias.1 "eth0"     ifAlias.2 "eth1"     ifAlias.3 "eth2"     ifAlias.5 "eth4"  Then in this case SNMP discovery `discovery[{#IFDESCR}, ifDescr, {#IFALIAS}, ifAlias]` will return the following structure:  ``` {.java} [     {         "{#SNMPINDEX}": 1,         "{#IFDESCR}": "Interface #1",         "{#IFALIAS}": "eth0"     },     {         "{#SNMPINDEX}": 2,         "{#IFDESCR}": "Interface #2",         "{#IFALIAS}": "eth1"     },     {         "{#SNMPINDEX}": 3,         "{#IFALIAS}": "eth2"     },     {         "{#SNMPINDEX}": 4,         "{#IFDESCR}": "Interface #4"     },     {         "{#SNMPINDEX}": 5,         "{#IFALIAS}": "eth4"     } ] ```
ca	#### Clau d'element  A diferència del sistema de fitxers i la descoberta de la interfície de xarxa, l'element no necessita necessàriament una clau "snmp.discovery"; amb el tipus d'element de l'agent SNMP n'hi ha prou.  Per configurar la regla de descoberta, feu el següent:  - Aneu a: *Configuració* → *Models* - Feu clic a *Descoberta* a la línia del model adequat  ![](../../../../../assets/en/manual/discovery/low_level_discovery/templates_snmp.png)  - Feu clic a *Crear una regla de descoberta* a la cantonada superior dreta de la pantalla. - Ompliu el formulari de regles de descoberta amb els detalls necessaris com a la captura de pantalla següent  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_rule_snmp.png)  Tots els camps d'entrada obligatoris són marcats amb un asterisc vermell.  Els OID per descobrir es defineixen al camp OID SNMP amb el format següent: `discovery[{#MACRO1}, oid1, {#MACRO2}, oid2, ...,]`  on *{#MACRO1}*, *{#MACRO2}* ... són noms de macro lld vàlids i *oid1*, *oid2*... són OID capaços de generar valors significatius per a aquestes macros. A les entitats descobertes s'hi aplica una macro integrada *{#SNMPINDEX}* que conté l'índex de l'OID descobert. Les entitats descobertes s'agrupen per valor de macro *{#SNMPINDEX}*.  Per entendre què volem dir, executem unes quantes ordres snmpwalks al nostre switch:      $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifDescr     IF-MIB::ifDescr.1 = STRING: WAN     IF-MIB::ifDescr.2 = STRING: LAN1     IF-MIB::ifDescr.3 = STRING: LAN2      $ snmpwalk -v 2c -c public 192.168.1.1 IF-MIB::ifPhysAddress     IF-MIB::ifPhysAddress.1 = STRING: 8:0:27:90:7a:75     IF-MIB::ifPhysAddress.2 = STRING: 8:0:27:90:7a:76     IF-MIB::ifPhysAddress.3 = STRING: 8:0:27:2b:af:9e  I configureu l'OID SNMP a: `discovery[{#IFDESCR}, ifDescr, {#IFPHYSADDRESS}, ifPhysAddress]`  Aquesta regla ara detecta entitats amb {#IFDESCR} macros establertes a **WAN**, **LAN1** i **LAN2**, les macros {#IFPHYSADDRESS} s'estableixen a **8:0:27: 90:7a :75**, **8:0:27:90:7a:76** i **8:0:27:2b:af:9e** Les macros {#SNMPINDEX} són configurades per a índexs OID descoberts **1**, **2** i **3**:  ``` {.java} [     {         "{#SNMPINDEX}": "1",         "{#IFDESCR}": "WAN",         "{#IFPHYSADDRESS}": "8:0:27:90:7a:75"     },     {         "{#SNMPINDEX}": "2",         "{#IFDESCR}": "LAN1",         "{#IFPHYSADDRESS}": "8:0:27:90:7a:76"     },     {         "{#SNMPINDEX}": "3",         "{#IFDESCR}": "LAN2",         "{#IFPHYSADDRESS}": "8:0:27:2b:af:9e"     } ] ```  Si una entitat no té l'OID especificat, s'ometrà la macro corresponent per a aquesta entitat. Per exemple, si tenim les dades següents:      ifDescr.1 "Interface #1"     ifDescr.2 "Interface #2"     ifDescr.4 "Interface #4"      ifAlias.1 "eth0"     ifAlias.2 "eth1"     ifAlias.3 "eth2"     ifAlias.5 "eth4"  En aquest cas, la descoberta SNMP de `discovery[{#IFDESCR}, ifDescr, {#IFALIAS}, ifAlias]` retornarà l'estructura següent:  ``` {.java} [     {         "{#SNMPINDEX}": 1,         "{#IFDESCR}": "Interface #1",         "{#IFALIAS}": "eth0"     },     {         "{#SNMPINDEX}": 2,         "{#IFDESCR}": "Interface #2",         "{#IFALIAS}": "eth1"     },     {         "{#SNMPINDEX}": 3,         "{#IFALIAS}": "eth2"     },     {         "{#SNMPINDEX}": 4,         "{#IFDESCR}": "Interface #4"     },     {         "{#SNMPINDEX}": 5,         "{#IFALIAS}": "eth4"     } ] ```

en-us	#### Item net.tcp.service parameters  **ftp**  Creates a TCP connection and expects the first 4 characters of the response to be "220 ", then sends "QUIT\\r\\n". Default port 21 is used if not specified.  **http**  Creates a TCP connection without expecting and sending anything. Default port 80 is used if not specified.  **https**  Uses (and only works with) libcurl, does not verify the authenticity of the certificate, does not verify the host name in the SSL certificate, only fetches the response header (HEAD request). Default port 443 is used if not specified.  **imap**  Creates a TCP connection and expects the first 4 characters of the response to be "\* OK", then sends "a1 LOGOUT\\r\\n". Default port 143 is used if not specified.  **ldap**  Opens a connection to an LDAP server and performs an LDAP search operation with filter set to (objectClass=\*). Expects successful retrieval of the first attribute of the first entry. Default port 389 is used if not specified.  **nntp**  Creates a TCP connection and expects the first 3 characters of the response to be "200" or "201", then sends "QUIT\\r\\n". Default port 119 is used if not specified.  **pop**  Creates a TCP connection and expects the first 3 characters of the response to be "+OK", then sends "QUIT\\r\\n". Default port 110 is used if not specified.  **smtp**  Creates a TCP connection and expects the first 3 characters of the response to be "220", followed by a space, the line ending or a dash. The lines containing a dash belong to a multiline response and the response will be re-read until a line without the dash is received. Then sends "QUIT\\r\\n". Default port 25 is used if not specified.  **ssh**  Creates a TCP connection. If the connection has been established, both sides exchange an identification string (SSH-major.minor-XXXX), where major and minor are protocol versions and XXXX is a string. Zabbix checks if the string matching the specification is found and then sends back the string "SSH-major.minor-zabbix\_agent\\r\\n" or "0\\n" on mismatch. Default port 22 is used if not specified.  **tcp**  Creates a TCP connection without expecting and sending anything. Unlike the other checks requires the port parameter to be specified.  **telnet**  Creates a TCP connection and expects a login prompt (':' at the end). Default port 23 is used if not specified.
ca	#### Paràmetres de l'element net.tcp.service  **ftp**  Crea una connexió TCP i espera que els 4 primer caràcters de la resposta siguin "220 ", llavors envia "QUIT\\r\\n". S'empra per defecte el port 21 si no se n'especifica cap.  **http**  Crea una connexió TCP sense esperar ni rebre res. S'empra per defecte el port 80 si no se n'especifica cap.  **https**  Empra (i funciona únicament amb) libcurl, no verifica pas l'autenticitat del certificat, no verifica pas el nom d'equip dins el certificat SSL, recupera només la capçalera de la resposta (petició HEAD). S'empra per defecte el port 443 si no se n'especifica cap.  **imap**  Crea una connexió TCP i espera que els primers 4 caràcters de la resposta siguin "\* OK", després envia "a1 LOGOUT\\r\\n". S'empra per defecte el port 143 si no se n'especifica cap.  **ldap**  Obre una connexió a un servidor LDAP i fa una operació de recerca LDAP amb el filtre definit sobre (objectClass=\*). Espera una resposta correcta del primer atribut de la primera entrada. S'empra per defecte el port 389 si no se n'especifica cap.  **nntp**  Crea una connexió TCP i s'espera a que els 3 primer caràcters de la resposta siguin "200" o "201", després envia "QUIT\\r\\n". S'empra per defecte el port 119 si no se n'especifica cap.  **pop**  Crea una connexió TCP i s'espera a que els 3 primer caràcters de la resposta siguin "+OK", després envia "QUIT\\r\\n". S'empra per defecte el port 110 si no se n'especifica cap.  **smtp**  Crea una connexió TCP i s'espera a que els 3 primer caràcters de la resposta siguin "220", seguits d'un espai, la línia final o un guió. Les línies que tinguin un guió pertanyen a una resposta multilínia i la resposta es rellegeix fins que es rebi una línia sense guió. Després envia "QUIT\\r\\n". S'empra per defecte el port 25 si no se n'especifica cap.  **ssh**  Crea una connexió TCP. Si la connexió s'ha establert, les dues bandes bescanvien una cadena d'identificació (SSH-major.minor-XXXX), on major i menor són les versions del protocol i XXXX és una cadena. Zabbix verifica si la cadena corresponent a l'especificació és present, llavors envia la cadena "SSH-major.minor-zabbix\_agent\\r\\n" o "0\\n" en cas de no trobar-la. S'empra per defecte el port 22 si no se n'especifica cap.  **tcp**  Crea una connexió TCP sense esperar ni enviar res. al contrari que les altres verificacions, el paràmetre de port s'ha d'especificar.  **telnet**  Crea una connexió TCP i espera un convit de connexió (':' al final). S'empra per defecte el port 23 si no se n'especifica cap.

en-us	#### Item net.udp.service parameters  **ntp**  Sends an SNTP packet over UDP and validates the response according to [RFC 4330, section 5](http://tools.ietf.org/html/rfc4330#section-5). Default port 123 is used if not specified.
ca	#### Paràmetres de l'element net.udp.service  **ntp**  Envia un paquet SNTP sobre UDP i valida la resposta segons l'[RFC 4330, secció 5](http://tools.ietf.org/html/rfc4330#section-5). El port per defecte 123 s'empra si no se n'especifica cap.

en-us	### Item  ::: noteclassic Web items cannot be directly created, updated or deleted via the Zabbix API. :::  The item object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the item.| |**delay**<br>(required)|string|Update interval of the item. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<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 or template that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item's host interface.<br><br>Used only for host items. Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, calculated, dependent, database monitor and script items. Optional for HTTP agent items.| |**key\_**<br>(required)|string|Item key.| |**name**<br>(required)|string|Name of the item.| |**type**<br>(required)|integer|Type of the item.<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>9 - Web item;<br>10 - External check;<br>11 - Database monitor;<br>12 - IPMI agent;<br>13 - SSH agent;<br>14 - Telnet agent;<br>15 - Calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script| |**url**<br>(required)|string|URL string, required only for HTTP agent item type. Supports user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item 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 items or HTTP agent items.<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<br>3 - Kerberos| |description|string|Description of the item.| |error|string|*(readonly)* Error text if there are problems updating the item value.| |flags|integer|*(readonly)* Origin of the item.<br><br>Possible values:<br>0 - a plain item;<br>4 - a discovered item.| |follow\_redirects|integer|HTTP agent item field. Follow response redirects while polling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item 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" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item field. HTTP(S) proxy connection string.| |inventory\_link|integer|ID of the host inventory field that is populated by the item.<br><br>Refer to the [host inventory page](/manual/api/reference/host/object#host_inventory) for a list of supported host inventory fields and their IDs.<br><br>Default: 0.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI items.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |lastclock|timestamp|*(readonly)* Time when the item value was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastns|integer|*(readonly)* Nanoseconds when the item value was last updated.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |lastvalue|string|*(readonly)* Last value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |logtimefmt|string|Format of the time in log entries. Used only by log items.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and maximum count of dependent items equal to 29999 are allowed.<br><br>Required by dependent items.| |output\_format|integer|HTTP agent item 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 item:<br>- executed script for SSH and Telnet items;<br>- SQL query for database monitor items;<br>- formula for calculated items;<br>- the script for script item.| |parameters|array|Additional parameters for script items. 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 items.<br>When used by JMX, username should also be specified together with password or both properties should be left blank.| |post\_type|integer|HTTP agent item 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 item field. HTTP(S) request body data. Used with post\_type.| |prevvalue|string|*(readonly)* Previous value of the item.<br><br>By default, only values that fall within the last 24 hours are displayed. You can extend this time period by changing the value of *Max history display period* parameter in the *[Administration → General](/manual/web_interface/frontend_sections/administration/general#gui)* menu section.| |privatekey|string|Name of the private key file.| |publickey|string|Name of the public key file.| |query\_fields|array|HTTP agent item field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item 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 item field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item field. Password for SSL Key file.| |state|integer|*(readonly)* State of the item.<br><br>Possible values:<br>0 - *(default)* normal;<br>1 - not supported.| |status|integer|Status of the item.<br><br>Possible values:<br>0 - *(default)* enabled item;<br>1 - disabled item.| |status\_codes|string|HTTP agent item 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 item.<br><br>*Hint*: Use the `hostid` property to specify the template that the item belongs to.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script items. Supports user macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper items or HTTP agent items.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent items.<br><br>Required by SSH and Telnet items.<br>When used by JMX, password should also be specified together with username or both properties should be left blank.| |uuid|string|Universal unique identifier, used for linking imported item to already existing ones. Used only for items on templates. Auto-generated, if not given.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item 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 item 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	### Element  ::: noteclassic Els elements web no es poden crear, actualitzar o esborrar directament mitjançant l'API de Zabbix. :::  L'objecte element té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|string|*(només lectura)* ID de l'element.| |**delay**<br>(obligatori)|string|Interval d'actualització de l'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com una programació.<br>Múltiples intervals estan separats per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).<br><br >Opcional per a Zabbix trapper, elements dependents i per a agent Zabbix (actiu) amb la clau `mqtt.get`.| |**hostid**<br>(obligatori)|string|ID de l'equip o del model al qual pertany l'element.<br><br>Per a les operacions d'actualització, aquest camp és *només lectura*.| |**interfaceid**<br>(obligatori)|string|Id de la interfície d'equip de l'element.<br><br>Només s'empra per als elements de l'equip. No és necessari per a l'agent Zabbix (actiu), Zabbix intern, Zabbix trapper, calculat, dependent, monitor de base de dades i elements d'script. Opcional per als elements de l'agent HTTP.| |**key\_**<br>(obligatori)|string|clau d'element.| |**name**<br>(obligatori)|string|Nom de l'element.| |**type**<br>(obligatori)|integer|Tipus d'element<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br>3 - Verificació simple; <br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>9 - Element web;<br>10 - Verificació externa;<br>11 - Monitor de base de dades;< 12 - Agent IPMI;< br>13 - Agent SSH;<br>14 - Agent Telnet;<br>15 - Calculat;<br>16 - Agent JMX;<br>17 - Trampa SNMP;<br>18 - Element dependent;<br>19 - Agent HTTP;<br>20 - Agent SNMP;<br>21 - Script| |**url**<br>(obligatori)|string|cadena d'URL, necessària només per al tipus d'element d'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(obligatori)|integer|Tipus d'informació de l'element.<br><br>Valors possibles:<br>0 - nombre flotant;<br>1 - caràcter; <br> 2 - diari;<br>3 - digital sense signe;<br>4 - text.| |allow\_traps|integer|camp d'element 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|integer|Només l'empren els elements de l'agent SSH o els elements de l'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - 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<br>3 - Kerberos| |description|string|Descripció de l'element.| |error|string|*(només lectura)* Text d'error si hi ha problemes per actualitzar el valor de l'element.| |flags|integer|*(només lectura)* Origen de l'objecte.<br><br>Valors possibles:<br>0 - Objecte normal;<br>4 - Objecte descobert.| |follow\_redirects|integer|Camp d'element de l'agent HTTP. Seguiu les redireccions de respostes mentre afegiu dades.<br><br>0 - No seguiu les redireccions.<br>1 - *(per defecte)* Seguiu les redireccions.| |headers|object|Camp d'element de l'agent HTTP. Objecte amb capçaleres de petició 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" }| |history|string|Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'històric. També accepta macros d'usuari.<br><br>Per defecte: 90d.| |http\_proxy|string|camp d'element de l'agent HTTP. Cadena de connexió del proxy HTTP(S).| |inventory\_link|integer|ID del camp d'inventari de l'equip emplenat per l'element.<br><br>Consulteu la [pàgina d'inventari d'equip](/manual/api/reference/host/object#host_inventory) per obtindre una llista de camps d'inventari d'equip admesos i els seus identificadors.<br><br>Per defecte: 0.| |ipmi\_sensor|string|sensor IPMI. Emprat només per elements IPMI.| |jmx\_endpoint|string|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi| |lastclock|timestamp|*(només lectura)* Hora en què el valor de l'element es va actualitzar per darrer cop.<br><br>Per defecte, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastns|integer|*(només lectura)* Nanosegons de la darrera actualització del valor de l'element.<br><br>De manera predeterminada, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |lastvalue|string|*(només lectura)* Darrer valor de l'element.<br><br>Per defecte, només es mostren els valors de les darreres 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |logtimefmt|string|Format d'hora a les entrades de registre. Emprat només per elements de registre.| |master\_itemid|integer|Identificador d'element principal.<br>Es permet la recurrència de fins a 3 elements dependents i el nombre màxim d'elements dependents de 29.999.<br><br>Obligatori per elements dependents.| |output\_format|integer|Camp d'element de l'agent HTTP. En cas de convertir la resposta a JSON.<br><br>0 - *(per defecte)* Emmagatzema en brut.<br>1 - Converteix a JSON.| |params|string|Paràmetres addicionals en funció del tipus d'element:<br>- script executat per a elements SSH i Telnet;<br>- consulta SQL per a elements de supervisió de la base de dades;<br>- fórmula per als elements calculats;<br>- l'script per a un element d'script.| |parameters|array|Paràmetres addicionals per als elements de l'script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha d'ésser únic.| |password|string|Mot de pas per a l'autenticació. S'empra per simple comprovació, SSH, Telnet, monitor de base de dades, elements de l'agent JMX i HTTP.<br>Quan s'empra per JMX, el nom d'usuari també s'ha d'especificar amb mot de pas o ambdues propietats s'han de deixar buides.| |post\_type|integer|camp d'element 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|string|camp d'element de l'agent HTTP. HTTP(S) demana dades del cos. S'empra amb post\_type.| |prevvalue|string|*(només lectura)* Valor anterior de l'element.<br><br>Per defecte, només es veuen els valors de les últimes 24 hores. Podeu ampliar aquest període canviant el valor del paràmetre *Període màxim de visualització de l'historial* a la secció del menú *[Administració → General](/manual/web_interface/frontend_sections/administration/general#gui)*.| |privatekey|string|Nom del fitxer de clau privada.| |publickey|string|Nom del fitxer de clau pública.| |query\_camps|array|Camp d'element de l'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ésser una cadena buida.| |request\_method|integer|Camp d'element de l'agent HTTP. Tipus de mètode de petició.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|camp d'element 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 only 1 és el valor permès.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|Camp d'element de l'agent HTTP. Camí al fitxer de clau SSL pública.| |ssl\_key\_file|string|Camp d'element de l'agent HTTP. Camí al fitxer de clau SSL privada.| |ssl\_key\_password|string|Camp d'element de l'agent HTTP. Mot de pas per al fitxer de clau SSL.| |state|integer|*(només lectura)* Estat de l'element.<br><br>Valors possibles:<br>0 - *(per defecte)* normal;<br>1 - no compatible.| |state|integer|Estat de l'element.<br><br>Valors possibles:<br>0 - element activat *(per defecte)*;<br>1 - element desactivat.| |status\_codes|string|camp d'element 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 lectura) ID de l'element de la plantilla principal.<br><br>*Consell*: Empreu la propietat `hostid` per especificar la plantilla a la qual pertany l'element.| |timeout|string|Temps d'espera de la petició de consulta de dades d'element. S'empra per a agents HTTP i elements d'script. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s| |trapper\_hosts|string|Equips permesos. Emprat per elements trapper o elements d'agent HTTP.| |trends|string|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendències. També accepta macros d'usuari.<br><br>Per defecte: 365d.| |units|string|Unitats de valor.| |username|string|Nom d'usuari per a l'autenticació. Emprat per elements de Simple Check, SSH, Telnet, Database Monitor, JMX i Agent HTTP.<br><br>Obligatori per elements SSH i Telnet.<br>Quan empra JMX, el mot de pas també s'ha d'especificar amb el nom d'usuari o ambdues les propietats s'han de deixar en blanc.| |uuid|string|Identificador únic universal, emprat per enllaçar un element importat amb elements ja existents. S'empra només per a articles de model. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només lectura*.| |valuemapid|string|ID de la taula. coincidència de valors associats.| |verify\_host|integer|camp d'element d'agent HTTP. Valideu que el nom d'equip a l'URL estigui al camp Nom comú o Nom alternatiu del subjecte del certificat d'equip.<br><br>0 - *(per defecte)* No valida. <br>1 - Valida.| |verify\_peer|integer|camp d'element de l'agent HTTP. Valida si el certificat de l'equip és autèntic.<br><br>0 - *(per defecte)* No valida.<br>1 - Valida.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# > Item object  The following objects are directly related to the `item` API.
ca	# > Element objecte  Els següents objectes tenen relació directa amb l'API `item`.

en-us	### Item preprocessing  The item 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>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<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| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|`value`, `label`, `function`|output^8,\ 9^|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|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^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3|  ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro\ ^7^ 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.\ ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro) if `label` is selected as the second parameter.\ ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter.
ca	### Preprocessament de l'element  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**tipus**<br>(obligatori)|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Retalla a la dreta;< br>3 - Retalla a l'esquerra;<br>4 - Retalla;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br> 9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;< br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha errors en JSON;<br>17 - Comprova si hi ha errors en XML;<br>18 - Comprova si hi ha errors mitjançant una expressió regular;<br>19 - Descartar sense canvis;<br>20 - Descartar sense canvis amb un heartbeat;<br>21 - JavaScript;<br>22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br>24 - CSV a JSON;<br> 25 - Substituïu;<br> >26 - No s'admet la verificació;<br>27 - XML ​​​​a JSON.| |**params**<br>(obligatori)|string|Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats pel caràcter LF (\\n).| |**error\_handler**<br>(obligatori)|integer|Tipus d'acció que s'empra quan falla el pas de preprocessament.<br><br>Valors possibles:<br>0 - Zabbix defineix 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| |------------------|----|------------|-----------|-- ---------|---------| |1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3| |2|Retalla a la dreta|llista de caràcters^2^|<|<|<| |3|Retalla a l'esquerra|llista de caràcters^2^|<|<|<| |4|Retalla|llista de caràcters^2^|<|<|<| |5|Expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |6|Booleà a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi únic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|camí^4^|<|<|0, 1, 2, 3| |12|JSONPath|camí^4^|<|<|0, 1, 2, 3| |13|Dins de l'interval|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |16|Comprova l'error a JSON|camí^4^|<|<|0, 1, 2, 3| |17|Comprova l'error en XML|camí^4^|<|<|0, 1, 2, 3| |18|Comprova si hi ha errors emprant l'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |19|Descarta el que no ha canviat|<|<|<|<| |20|Descarta el no canviat amb un heartbeat|segons^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Patró de Prometheus|patró^6,\7^|`valor`, `etiqueta`, `funció`|sortida^8,\9^|0, 1, 2, 3| |23|Prometheus a JSON|patró^6,\7^|<|<|0, 1, 2, 3| |24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |26|La verificació no és compatible|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3|  ^1^ nombre enter o coma flotant\ ^2^ cadena\ ^3^ expressió regular\ ^4^ JSONPath o XML XPath\ ^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)\ ^6^ macro d'usuari\ ^7^ El model de Prometheus segueix 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. ^8^ Prometheus mostra la següent sintaxi: `<nom de l'etiqueta>` (pot ser una macro d'usuari) si `etiqueta` està seleccionada com a segon paràmetre.\ ^9^ Una de les funcions agregades: `sum`, `min`, `max`, `avg`, `count` si `function` està seleccionat com a segon paràmetre.

en-us	#### itemprototype  Bug fixes:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: property `interfaceid` is no longer required to create/update a HTTP agent type item prototype.\
ca	#### prototip d'element Correcció d'errades:\ [ZBX-19118](https://support.zabbix.com/browse/ZBX-19118) `itemprototype.create`, `itemprototype.update`: Ja no cal pas fer ús de la propietat `interfaceid` per a crear o actualitzar un prototip d'element del tipus agent HTTP.\

en-us	#### item prototype  Changes:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: added the third parameter to the Prometheus pattern preprocessing step. The second parameter will now determine an aggregation method: `value`, `label`, `function`. The third parameter will now contain Prometheus output for the aggregation method `label` or an aggregation function for the aggregation method `function`.\
ca	#### prototipus d'element  Canvis:\ [ZBXNEXT-7049](https://support.zabbix.com/browse/ZBXNEXT-7049) `itemprototype.get`, `itemprototype.create`, `itemprototype.update`: afegit un tercer paràmetre a l'etapa de pretractament del patró Prometheus. El segon paràmetre determinarà ara un mètode d'agregació: : `value`, `label`, `function`. El tercer paràmetre tindrà la sortida de Prometheus per el mètode `label` o una funció d'afegir per al mètode d'agregació `function`.\

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

en-us	# itemprototype.create
ca	# itemprototype.create

en-us	# itemprototype.delete
ca	# itemprototype.delete

en-us	# itemprototype.get
ca	# itemprototype.get

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

en-us	### Item prototype preprocessing  The item prototype 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>1 - Custom multiplier;<br>2 - Right trim;<br>3 - Left trim;<br>4 - Trim;<br>5 - Regular expression matching;<br>6 - Boolean to decimal;<br>7 - Octal to decimal;<br>8 - Hexadecimal to decimal;<br>9 - Simple change;<br>10 - Change per second;<br>11 - XML XPath;<br>12 - JSONPath;<br>13 - In range;<br>14 - Matches regular expression;<br>15 - Does not match regular expression;<br>16 - Check for error in JSON;<br>17 - Check for error in XML;<br>18 - Check for error using regular expression;<br>19 - Discard unchanged;<br>20 - Discard unchanged with heartbeat;<br>21 - JavaScript;<br>22 - Prometheus pattern;<br>23 - Prometheus to JSON;<br>24 - CSV to JSON;<br>25 - Replace;<br>26 - Check unsupported;<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| |------------------|----|-----------|-----------|-----------|------------------------| |1|Custom multiplier|number^1,\ 6^|<|<|0, 1, 2, 3| |2|Right trim|list of characters^2^|<|<|<| |3|Left trim|list of characters^2^|<|<|<| |4|Trim|list of characters^2^|<|<|<| |5|Regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |6|Boolean to decimal|<|<|<|0, 1, 2, 3| |7|Octal to decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal to decimal|<|<|<|0, 1, 2, 3| |9|Simple change|<|<|<|0, 1, 2, 3| |10|Change per second|<|<|<|0, 1, 2, 3| |11|XML XPath|path^4^|<|<|0, 1, 2, 3| |12|JSONPath|path^4^|<|<|0, 1, 2, 3| |13|In range|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Matches regular expression|pattern^3^|<|<|0, 1, 2, 3| |15|Does not match regular expression|pattern^3^|<|<|0, 1, 2, 3| |16|Check for error in JSON|path^4^|<|<|0, 1, 2, 3| |17|Check for error in XML|path^4^|<|<|0, 1, 2, 3| |18|Check for error using regular expression|pattern^3^|output^2^|<|0, 1, 2, 3| |19|Discard unchanged|<|<|<|<| |20|Discard unchanged with heartbeat|seconds^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Prometheus pattern|pattern^6,\ 7^|`value`, `label`, `function`|output^8,\ 9^|0, 1, 2, 3| |23|Prometheus to JSON|pattern^6,\ 7^|<|<|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^|<|<| |26|Check unsupported|<|<|<|1, 2, 3| |27|XML to JSON|<|<|<|0, 1, 2, 3|  ^1^ integer or floating-point number\ ^2^ string\ ^3^ regular expression\ ^4^ JSONPath or XML XPath\ ^5^ positive integer (with support of time suffixes, e.g. 30s, 1m, 2h, 1d)\ ^6^ user macro, LLD macro\ ^7^ 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 or LLD macro.\ ^8^ Prometheus output following the syntax: `<label name>` (can be a user macro or an LLD macro) if `label` is selected as the second parameter.\ ^9^ One of the aggregation functions: `sum`, `min`, `max`, `avg`, `count` if `function` is selected as the second parameter.
ca	### Preprocessament del prototip d'element  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |**type**<br>(obligatori)|integer|El tipus d'opció de preprocessament.<br><br>Valors possibles:<br>1 - Multiplicador personalitzat;<br>2 - Elimina els espais finals;<br> 3 - Eliminació d'espais inicials;<br>4 - Eliminació d'espais finals i posteriors;<br>5 - Coincidència d'expressió regular;<br>6 - Booleà a decimal;<br>7 - Octal a decimal;<br>8 - Hexadecimal a decimal;<br>9 - Canvi únic;<br>10 - Canvi per segon;<br>11 - XML ​​​​XPath;<br>12 - JSONPath;<br>13 - Dins l'interval;<br>14 - Coincideix amb l'expressió regular;<br>15 - No coincideix amb l'expressió regular;<br>16 - Comprova si hi ha un error a JSON;<br>17 - Comprova si hi ha un error a XML;<br>18 - Troba un error emprant una expressió regular;<br>19 - Esborra sense modificacions;<br>20 - Esborra sense modificacions amb heartbeat;<br>21 - JavaScript;< 22 - Patró de Prometheus;<br>23 - Prometheus a JSON;<br> 24 - CSV a JSON; <br>25 - Substitueix;<br>26 - Comprova si hi ha valors no admesos;<br>27 - XML ​​​​a JSON. | |**params**<br>(obligatori)|string|Paràmetres addicionals emprats per l'opció de preprocessament. Diversos paràmetres són separats pel caràcter LF (\\n).| |**error\_handler**<br>(obligatori)|integer|Tipus d'acció emprat en cas d'error del pas de preprocessament:<br>0 - El servidor Zabbix ha establert el missatge d'error ;<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 pas é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| |-------------------|----|-----------|------------|- ----------|----------| |1|Multiplicador personalitzat|nombre^1,\6^|<|<|0, 1, 2, 3| |2|Eliminació d'espais finals|llista de caràcters^2^|<|<|<| |3|Eliminació dels espais inicials|llista de caràcters^2^|<|<|<| |4|Eliminació dels espais inicials i finals|llista de caràcters^2^|<|<|<| |5|Concordança d'expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |6|Booleà a decimal|<|<|<|0, 1, 2, 3| |7|Octal a decimal|<|<|<|0, 1, 2, 3| |8|Hexadecimal a decimal|<|<|<|0, 1, 2, 3| |9|Canvi únic|<|<|<|0, 1, 2, 3| |10|Canvi per segon|<|<|<|0, 1, 2, 3| |11|XML XPath|camí^4^|<|<|0, 1, 2, 3| |12|JSONPath|camí^4^|<|<|0, 1, 2, 3| |13|Dins de l'interval|min^1,\ 6^|max^1,\ 6^|<|0, 1, 2, 3| |14|Coincideix amb l'expressió regular|patró^3^|<|<|0, 1, 2, 3| |15|No coincideix amb l'expressió regular^3^|<|<|0, 1, 2, 3| |16|Cerca un error a JSON|camí^4^|<|<|0, 1, 2, 3| |17|Cerca un error a XML|camí^4^|<|<|0, 1, 2, 3| |18|Cerca un error emprant una expressió regular|patró^3^|sortida^2^|<|0, 1, 2, 3| |19|Esborra sense modificacions|<|<|<|<| |20|Esborra sense canvis amb el heratbeat|segons^5,\ 6^|<|<|<| |21|JavaScript|script^2^|<|<|<| |22|Patró de Prometheus|patró^6,\7^|`valor`, `etiqueta`, `funció`|sortida^8,\9^|0, 1, 2, 3| |23|Prometheus a JSON|patró^6,\7^|<|<|0, 1, 2, 3| |24|CSV a JSON|char^2^|char^2^|0,1|0, 1, 2, 3| |25|Substitueix|cadena de cerca^2^|substitueix^2^|<|<| |26|Comprova si hi ha valors no admesos|<|<|<|1, 2, 3| |27|XML a JSON|<|<|<|0, 1, 2, 3|  ^1^ nombre enter o coma flotant\ ^2^ cadena\ ^3^ expressió regular\ ^4^ JSONPath o XML XPath\ ^5^ enter positiu (amb suport per a sufixos de temps, per exemple, 30s, 1m, 2h, 1d)\ ^6^ macro d'usuari, macro LLD\ ^7^ Patró Prometheus següent 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 ésser una macro d'usuari o una macro LLD.\ ^8^ Prometheus dóna la següent sintaxi: `<nom de l'etiqueta>` (pot ésser una macro d'usuari o una macro LLD) si `label` és seleccionada com a segon paràmetre.\ ^9^ Una de les funcions d'agregació: `sum`, `min`, `max`, `avg`, `count` si `function` és seleccionada com a segon paràmetre.

en-us	### Item prototypes  Item prototypes that can be created based on systemd service discovery include, for example:  -   Item name: `{#UNIT.DESCRIPTION} active state info`; item key:     `systemd.unit.info["{#UNIT.NAME}"]` -   Item name: `{#UNIT.DESCRIPTION} load state info`; item key:     `systemd.unit.info["{#UNIT.NAME}",LoadState]`  `systemd.unit.info` [agent items](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) are supported since Zabbix 4.4.
ca	### Prototipus d'elements  Els prototips d'elements que es poden crear basant-se en la descoberta de serveis de systemd inclouen, per exemple:  - Nom de l'element: `{#UNIT.DESCRIPTION} active stat info`; Clau d'element: `systemd.unit.info["{#UNIT.NAME}"]` - Nom de l'element: `{#UNIT.DESCRIPTION} active stat info`; Clau d'element: `systemd.unit.info["{#UNIT.NAME}",LoadState]`  Els [elements de l'agent](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2) `systemd.unit.info` són compatibles des de Zabbix 4.4.

en-us	#### Item prototypes  The following screenshot illustrates how we can use these macros in item prototypes:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_snmp.png)  You can create as many item prototypes as needed:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototypes_snmp.png){width="600"}
ca	#### Prototips d'elements  La següent captura de pantalla il·lustra com podem emprar aquestes macros en prototips d'elements:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototype_snmp.png)  Podeu crear tants prototips d'article com us calgui:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/item_prototypes_snmp.png){width="600"}

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

en-us	### Item prototype  The item prototype object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |itemid|string|*(readonly)* ID of the item prototype.| |**delay**<br>(required)|string|Update interval of the item prototype. Accepts seconds or a time unit with suffix (30s,1m,2h,1d).<br>Optionally one or more [custom intervals](/manual/config/items/item/custom_intervals) can be specified either as flexible intervals or scheduling.<br>Multiple intervals are separated by a semicolon.<br>User macros and LLD macros may be used. A single macro has to fill the whole field. Multiple macros in a field or macros mixed with text are not supported.<br>Flexible intervals may be written as two macros separated by a forward slash (e.g. `{$FLEX_INTERVAL}/{$FLEX_PERIOD}`).<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 item prototype belongs to.<br><br>For update operations this field is *readonly*.| |**ruleid**<br>(required)|string|ID of the LLD rule that the item belongs to.<br><br>For update operations this field is *readonly*.| |**interfaceid**<br>(required)|string|ID of the item prototype's host interface. Used only for host item prototypes.<br><br>Not required for Zabbix agent (active), Zabbix internal, Zabbix trapper, calculated, dependent, database monitor and script item prototypes. Optional for HTTP agent item prototypes.| |**key\_**<br>(required)|string|Item prototype key.| |**name**<br>(required)|string|Name of the item prototype.| |**type**<br>(required)|integer|Type of the item prototype.<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>15 - calculated;<br>16 - JMX agent;<br>17 - SNMP trap;<br>18 - Dependent item;<br>19 - HTTP agent;<br>20 - SNMP agent;<br>21 - Script.| |**url**<br>(required)|string|URL string required only for HTTP agent item prototypes. Supports LLD macros, user macros, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**value\_type**<br>(required)|integer|Type of information of the item prototype.<br><br>Possible values:<br>0 - numeric float;<br>1 - character;<br>2 - log;<br>3 - numeric unsigned;<br>4 - text.| |allow\_traps|integer|HTTP agent item prototype 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 item prototypes or HTTP agent item prototypes.<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<br>3 - Kerberos| |description|string|Description of the item prototype.| |follow\_redirects|integer|HTTP agent item prototype field. Follow response redirects while polling data.<br><br>0 - Do not follow redirects.<br>1 - *(default)* Follow redirects.| |headers|object|HTTP agent item prototype 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" }| |history|string|A time unit of how long the history data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 90d.| |http\_proxy|string|HTTP agent item prototype field. HTTP(S) proxy connection string.| |ipmi\_sensor|string|IPMI sensor. Used only by IPMI item prototypes.| |jmx\_endpoint|string|JMX agent custom connection string.<br><br>Default value:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN}:{HOST.PORT}/jmxrmi| |logtimefmt|string|Format of the time in log entries. Used only by log item prototypes.| |master\_itemid|integer|Master item ID.<br>Recursion up to 3 dependent items and item prototypes and maximum count of dependent items and item prototypes equal to 29999 are allowed.<br><br>Required by Dependent items.| |output\_format|integer|HTTP agent item prototype 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 item prototype:<br>- executed script for SSH and Telnet item prototypes;<br>- SQL query for database monitor item prototypes;<br>- formula for calculated item prototypes.| |parameters|array|Additional parameters for script item prototypes. 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 item prototypes.| |post\_type|integer|HTTP agent item prototype 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 item prototype 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 item prototype field. Query parameters. Array of objects with 'key':'value' pairs, where value can be empty string.| |request\_method|integer|HTTP agent item prototype field. Type of request method.<br><br>0 - *(default)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|HTTP agent item prototype 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 item prototype field. Public SSL Key file path.| |ssl\_key\_file|string|HTTP agent item prototype field. Private SSL Key file path.| |ssl\_key\_password|string|HTTP agent item prototype field. Password for SSL Key file.| |status|integer|Status of the item prototype.<br><br>Possible values:<br>0 - *(default)* enabled item prototype;<br>1 - disabled item prototype;<br>3 - unsupported item prototype.| |status\_codes|string|HTTP agent item prototype field. Ranges of required HTTP status codes separated by commas. Also supports user macros or LLD macros as part of comma separated list.<br><br>Example: 200,200-{$M},{$M},200-400| |templateid|string|(readonly) ID of the parent template item prototype.| |timeout|string|Item data polling request timeout. Used for HTTP agent and script item prototypes. Supports user macros and LLD macros.<br><br>default: 3s<br>maximum value: 60s| |trapper\_hosts|string|Allowed hosts. Used by trapper item prototypes or HTTP item prototypes.| |trends|string|A time unit of how long the trends data should be stored. Also accepts user macro and LLD macro.<br><br>Default: 365d.| |units|string|Value units.| |username|string|Username for authentication. Used by simple check, SSH, Telnet, database monitor, JMX and HTTP agent item prototypes.<br><br>Required by SSH and Telnet item prototypes.| |uuid|string|Universal unique identifier, used for linking imported item prototypes to already existing ones. Used only for item prototypes on templates. Auto-generated, if not given.| |valuemapid|string|ID of the associated value map.| |verify\_host|integer|HTTP agent item prototype 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.<br>| |verify\_peer|integer|HTTP agent item prototype field. Whether to validate that the host's certificate is authentic.<br><br>0 - *(default)* Do not validate.<br>1 - Validate.| |discover|integer|Item prototype discovery status.<br><br>Possible values:<br>0 - *(default)* new items will be discovered;<br>1 - new items will not be discovered and existing items will be marked as lost.|  Note that for some methods (update, delete) the required/optional parameter combination is different.
ca	### Prototip d'element  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |itemid|string|*(només lectura)* ID del prototip d'element.| |**delay**<br>(obligatori)|string|Interval d'actualització del prototip d'element. Accepta segons o una unitat de temps amb sufix (30s, 1m, 2h, 1d).<br>Opcionalment, un o més [intervals personalitzats](/manual/config/items/item/custom_intervals) es poden especificar com a intervals flexibles o com una programació.<br>Múltiples intervals estan separats per un punt i coma.<br>Es poden emprar macros d'usuari. Una sola macro hauria d'omplir tot el camp. No s'admeten pas diverses macros en un camp o macros barrejades amb text.<br>Els intervals flexibles es poden escriure com a dues macros separades per una barra inclinada (p. ex., `{$FLEX_INTERVAL}/ {$FLEX_PERIOD}`).<br><br >Opcional per a Zabbix trapper, elements dependents i per a agent Zabbix (actiu) amb la clau `mqtt.get`.| |**hostid**<br>(obligatori)|string|Id de l'equip o de la plantilla a la qual pertany el prototip d'element.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*.| |**ruleid**<br>(obligatori)|string|ID de la regla LLD a la qual pertany l'element.<br><br>Per a les operacions d'actualització, aquest camp és de *només lectura*. |**interfaceid**<br>(obligatori)|string|Identificador d'interfície equip del prototip d'element.<br><br>Només s'empra per als prototips d'element equip. No és necessari per a l'agent Zabbix (actiu), Zabbix intern, Zabbix trapper, calculat, dependent, monitor de base de dades i prototips d'elements d'script. Opcional per als elements de prototip d'agent HTTP.| |**key\_**<br>(obligatori)|string|Clau del prototip d'element.| |**name**<br>(obligatori)|string|Nom del prototip de l'element.| |**type**<br>(obligatori)|entier|Tipus de prototip d'element<br><br>Valors possibles:<br>0 - Agent Zabbix;<br>2 - Trapper Zabbix;<br>3 - Verificació simple;<br>5 - Zabbix intern;<br>7 - Agent Zabbix (actiu);<br>9 - Element web;<br>10 - Verificació externa;<br>11 - Monitor de base de dades; <br>12 - IPMI Agent;<br>13 - Agent SSH;<br>14 - Agent Telnet;<br>15 - Calculat;<br>16 - Agent JMX;<br>17 - Trampa SNMP;<br> 18 - Element dependent;< br>19 - Agent HTTP;<br>20 - Agent SNMP;<br>21 - Script| |**url**<br>(obligatori)|string|cadena d'URL, necessària només per al tipus de prototip d'element d'agent HTTP. Admet macros d'usuari, {HOST.IP}, {HOST.CONN}, {HOST.DNS}, {HOST.HOST}, {HOST.NAME}, {ITEM.ID}, {ITEM.KEY}.| |**valor\_tipus**<br>(obligatori)|entier|Tipus d'informació del prototip d'element.<br><br>Valors possibles:<br>0 - nombre flotant;<br>1 - caràcter ;<br >2 - diari;<br>3 - digital sense signar;<br>4 - text.| |allow\_traps|integer|camp de prototip d'element d'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|integer|Només s'empren per elements d'agent SSH prototip o elements d'agent HTTP.<br><br>Valors possibles per al mètode d'autenticació de l'agent SSH:<br>0 - 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<br>3 - Kerberos| |description|string|Descripció del prototip d'element.| |follow\_redirects|integer|Prototip de camp d'element d'agent HTTP. Seguiu les redireccions de respostes mentre aegiu dades.<br><br>0 - No seguir les redireccions.<br>1 - *(per defecte)* Seguir les redireccions.| |headers|object|Camp de prototip d'element d'agent HTTP. Objecte amb capçaleres de petició 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" }| |history|string|Unitat de temps que indica quant de temps s'han d'emmagatzemar les dades de l'històric. També admet macros d'usuari.<br><br>Per defecte: 90d.| |http\_proxy|string|Camp de prototip d'element d'agent HTTP. Cadena de connexió del proxy HTTP(S).| |ipmi\_sensor|string|sensor IPMI. Emprat només pels prototips d'elements IPMI.| |jmx\_endpoint|string|Cadena de connexió de l'agent JMX personalitzada.<br><br>Per defecte:<br>service:jmx:rmi:///jndi/rmi://{HOST.CONN} :{HOST.PORT} /jmxrmi| |logtimefmt|string|Format d'hora a les entrades de registre. S'empren només per prototips d'elements de diari.| |master\_itemid|integer|Identificador d'element principal.<br>Es permet la recursivitat fins a 3 elements dependents i el nombre màxim d'elements i prototips d'elements dependents de 29.999.<br>< br>Requerit per elements dependents.| |output\_format|integer|Camp d'element de prototip d'agent HTTP. En cas de convertir la resposta 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 prototip d'element:<br>- script executat per a prototips d'elements SSH i Telnet;<br>- Consulta SQL per a dades de prototips d'elements de supervisió bàsica;<br>- fórmula per a prototips d'elements calculats.| |parameters|array|Paràmetres addicionals per a prototips d'elements de script. Matriu d'objectes amb propietats "nom" i "valor", on el nom ha d'ésser únic.| |password|string|Mot de pas per a l'autenticació. Emprat per Simple Check, SSH, Telnet, Database Monitor, JMX i HTTP Agent Item Prototypes.| |post\_type|integer|Camp de prototip d'element d'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|string|Camp de prototip d'element d'agent HTTP. HTTP(S) demana 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 prototip d'element d'agent HTTP. Paràmetres de consulta. Matriu d'objectes amb parells 'clau':'valor', on el valor pot ésser una cadena buida.| |request\_method|integer|Camp de prototip d'element d'agent HTTP. Tipus de mètode de petició.<br><br>0 - *(per defecte)* GET<br>1 - POST<br>2 - PUT<br>3 - HEAD| |retrieve\_mode|integer|Camp de prototip d'element d'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 s'admet el valor 1.| |snmp\_oid|string|SNMP OID.| |ssl\_cert\_file|string|Camp de prototip d'element d'agent HTTP. Camí al fitxer de clau SSL pública.| |ssl\_key\_file|string|Camp de prototip d'element d'agent HTTP. Camí al fitxer de clau SSL privada.| |ssl\_key\_password|string|Camp de prototip d'element d'agent HTTP. Mot de pas per al fitxer de clau SSL.| |status|integer|Estat del prototip d'element.<br><br>Valors possibles:<br>0 - prototip d'element habilitat *(per defecte)*;<br>1 - prototip d'element desactivat;< br>2 - prototip d'element no compatible.| |status\_codes|string|Camp de prototip d'element d'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 lectura) ID del prototip d'element de plantilla principal.| |timeout|string|Temps d'espera de la consulta de dades d'element. S'empra per a l'agent HTTP i els prototips d'elements d'script. Admet macros d'usuari.<br><br>valor per defecte: 3s<br>valor màxim: 60s| |trapper\_hosts|string|Equips permesos. Emprat per prototips d'elements trapper o prototips d'elements d'agent HTTP.| |trends|string|Unitat de temps de quant de temps s'han d'emmagatzemar les dades de tendències. També admet macros d'usuari.<br><br>Per defecte: 365d.| |units|string|Unitats de valor.| |username|string|Nom d'usuari per a l'autenticació. S'empra per simple verificació, SSH, Telnet, monitor de base de dades, prototips d'elements d'agent JMX i HTTP.<br><br>Requerit pels prototips d'elements SSH i Telnet.| |uuid|string|Identificador únic universal, que s'empra per enllaçar un prototip d'element importat amb prototips d'element ja existents. S'empra només per a prototips d'elements de model. Es genera automàticament, si no es proporciona.<br><br>Per a les operacions d'actualització, aquest camp és *només lectura*.| |valuemapid|string|ID de la taula. coincidència de valors associats.| |verify\_host|integer|Camp de prototip d'element d'agent HTTP. Valida que el nom d'equip a l'URL sigui al camp Nom comú o Nom alternatiu del subjecte del certificat d'equip.<br><br>0 - *(per defecte)* No valideu. <br>1 - Valida.| |verify\_peer|integer|Camp de prototip d'element d'agent HTTP. Valideu si el certificat d'equip és autèntic.<br><br>0 - *(per defecte)* No validar.<br>1 - Validar.| |discover|integer|Estat de descobriment del prototip d'element.<br><br>Valors possibles:<br>0 - *(per defecte)* es descobriran nous elements;<br>1 - no es descobriran elements nous i els elements existents es marcaran com a perduts.|  Tingueu en compte que per a alguns mètodes (actualitzar, esborrar) la combinació de paràmetres obligatoris/opcionals és diferent.

en-us	# Item prototype  This class is designed to work with item prototypes.  Object references:\  -   [Item     prototype](/manual/api/reference/itemprototype/object#item_prototype)  Available methods:\  -   [itemprototype.create](/manual/api/reference/itemprototype/create) -     creating new item prototypes -   [itemprototype.delete](/manual/api/reference/itemprototype/delete) -     deleting item prototypes -   [itemprototype.get](/manual/api/reference/itemprototype/get) -     retrieving item prototypes -   [itemprototype.update](/manual/api/reference/itemprototype/update) -     updating item prototypes
ca	# Prototipus d'element  Aquesta classe és dissenyada per treballar amb prototipus d'elements.  Referències d'objectes:\  -   [Element     prototipus](/manual/api/reference/itemprototype/object#item_prototype)  Mètodes disponibles:\  -   [itemprototype.create](/manual/api/reference/itemprototype/create) -     crear nous prototipus d'elements -   [itemprototype.delete](/manual/api/reference/itemprototype/delete) -     esborrar prototips d'elements -   [itemprototype.get](/manual/api/reference/itemprototype/get) -     recuperar prototipus d'elements -   [itemprototype.update](/manual/api/reference/itemprototype/update) -     actualitzar prototipus d'elements

en-us	# itemprototype.update
ca	# itemprototype.update

en-us	##### Item prototype  You may want to create an item prototype like this:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom.png)  with preprocessing options:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom_b.png)
ca	##### Prototip d'element  És possible que vulgueu crear un prototip d'element com aquest:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom.png)  amb opcions de preprocessament:  ![](../../../../../assets/en/manual/discovery/low_level_discovery/lld_item_prototype_prom_b.png)

en-us	## Items
ca	## Elements

en-us	## Items
ca	## Elements

en-us	## Items
ca	## Elements

en-us	## Items
ca	## Elements

en-us	#### Items  Define items to monitor.  [Item API](/manual/api/reference/item)
ca	#### Elements  Defineix els elements a monitorar.  [API Element](/manual/api/reference/item)

en-us	### Items  ##### docker.container_stats  The [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) item on Zabbix agent 2 now also returns a `pids_stats` property with the current number of processes/threads on the container.
ca	### Elements  ##### docker.container_stats  L'element [docker.container_stats](/manual/config/items/itemtypes/zabbix_agent/zabbix_agent2#docker) a l'agent 2 de Zabbix ara retorna la propietat `pids_stats` amb el nombre de processos/fils actuals del contenidor.

en-us	#### Items / item prototypes  In an [item](/manual/config/items/item) or an [item prototype](/manual/discovery/low_level_discovery/item_prototypes) configuration, user macros can be used in the following fields:  |Location|<|Multiple macros/mix with text^[1](supported_by_location_user#footnotes)^| |-|------------------------------|----------| |Item key parameters|<|yes| |Update interval|<|no| |Custom intervals|<|no| |History storage period|<|no| |Trend storage period|<|no| |Description|<|yes| |*Calculated item*|<|<| | |Formula|yes| |*Database monitor*|<|<| | |Username|yes| |^|Password|yes| |^|SQL query|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 proxy|yes| |^|HTTP authentication username|yes| |^|HTTP authentication password|yes| |^|SSl certificate file|yes| |^|SSl key file|yes| |^|SSl key password|yes| |^|Allowed hosts|yes| |*JMX agent*|<|<| | |JMX endpoint|yes| |*Script item*|<|<| | |Parameter names and values|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| |*Tags*^[2](supported_by_location_user#footnotes)^|<|<| | |Tag names|yes| |^|Tag values|yes| |*Preprocessing*|<|<| | |Step parameters (including custom scripts)|yes|
ca	#### Elements / prototips d'elements  En una configuració d'[element](/manual/config/items/item) o [prototips d'elements](/manual/discovery/low_level_discovery/item_prototypes), 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 d'element|<|sí| |Intèrval d'actualització|<|no| |Intèrvals personalitzats|<|no| |Període d'emmagatzematge de l'històric|<|no| |Període d'emmagatzematge de les tendències|<|no| |Descripció|<|sí| |*element calculat*|<|<| | |Fórmula|sí| |*Monitoratge de base de dades*|<|<| | |Nom d'usuari|sí| |^|Mot de pas|sí| |^|Petició SQL|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í| |^|Proxy HTTP|sí| |^|Nom d'usuari d'autenticació HTTP|sí| |^|Mot de pas d'autenticació HTTP|sí| |^|Arxiu de certificat SSL|sí| |^|Arxiu de clau SSL|sí| |^|Mot de pas de la clau SSL|sí| |^|Equips autoritzats|sí| |*Agent JMX*|<|<| | |Punt d'acabament JMX|sí| |*Element Script*|<|<| | |Noms i valors dels paràmetres|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í| |*Etiquetes*^[2](supported_by_location_user#footnotes)^|<|<| | |Noms d'etiquetes|sí| |^|Valors d'etiquetes|sí| |*Preprocés*|<|<| | |Paràmetres d'etapa (inclosos els scripts personalitzats)|sí|

en-us	#### Items  To configure querying of internal stats on another Zabbix instance, you may use two items:  -   `zabbix[stats,<ip>,<port>]` internal item - for direct remote     queries of Zabbix server/proxy. <ip> and <port> are used     to identify the target instance. -   `zabbix.stats[<ip>,<port>]` agent item - for agent-based remote     queries of Zabbix server/proxy. <ip> and <port> are used     to identify the target instance.  See also: [Internal items](/manual/config/items/itemtypes/internal), [Zabbix agent items](/manual/config/items/itemtypes/zabbix_agent)  The following diagram illustrates the use of either item depending on the context.  ![](../../../../assets/en/manual/appendix/items/ext_stats.png)  -   ![](../../../../assets/en/manual/appendix/items/green.png) - Server     → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/pink.png) - Server →     proxy → external Zabbix instance (`zabbix[stats,<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/blue.png) - Server →     agent → external Zabbix instance (`zabbix.stats[<ip>,<port>]`) -   ![](../../../../assets/en/manual/appendix/items/red.png) - Server →     proxy → agent → external Zabbix instance     (`zabbix.stats[<ip>,<port>]`)  To make sure that the target instance allows querying it by the external instance, list the address of the external instance in the 'StatsAllowedIP' parameter on the target instance.
ca	#### Elements  Per configurar la consulta de les estadístiques internes sobre una altra instància Zabbix, podeu emprar dos elements:  - L'element intern `zabbix[stats,<ip>,<port>]` - per les peticions directes a distància del servidor/proxy Zabbix. <ip> i <port> són emprades per indentificar la instància destí. - L'element agent `zabbix.stats[<ip>,<port>]` - per les peticions basades en l'agent del servidor/proxy Zabbix. <ip> i<port> són emprades per identificar la instància destí.  Veieu també: [Elements interns](/manual/config/items/itemtypes/internal), [Elements d'agent Zabbix](/manual/config/items/itemtypes/zabbix_agent)  L'sequema següent mostra l'ús d'un o altre element en funció del context.  ![](../../../../assets/en/manual/appendix/items/ext_stats.png)  - ![](../../../../assets/en/manual/appendix/items/green.png) - Servidor → instància Zabbix externa (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/pink.png) - Servidor → proxy → instància Zabbix externa (`zabbix[stats,<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/blue.png) - Servidor → agent → instància Zabbix externa (`zabbix.stats[<ip>,<port>]`) - ![](../../../../assets/en/manual/appendix/items/red.png) - Servidor → proxy → agent → instància Zabbix externa (`zabbix.stats[<ip>,<port>]`)  Per assegurar-vos que la instància destí permet ésser consultada per la instància externa, especifiqueu l'adreça externa al paràmetre 'StatsAllowedIP' de la instància destí.

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

en-us	# Item  This class is designed to work with items.  Object references:\  -   [Item](/manual/api/reference/item/object#item)  Available methods:\  -   [item.create](/manual/api/reference/item/create) - creating new     items -   [item.delete](/manual/api/reference/item/delete) - deleting items -   [item.get](/manual/api/reference/item/get) - retrieving items -   [item.update](/manual/api/reference/item/update) - updating items
ca	# Element  Aquesta classe és dissenyada per treballar amb elements.  Referències d'objectes:\  -   [Element](/manual/api/reference/item/object#item)  Available methods:\  -   [item.create](/manual/api/reference/item/create) - crear nous elements -   [item.delete](/manual/api/reference/item/delete) - esborrar elements -   [item.get](/manual/api/reference/item/get) - recuperar elements -   [item.update](/manual/api/reference/item/update) - actualitzar elements

en-us	##### Item  To begin with, you may want to set up an item that monitors a log file, for example:      log[/var/log/syslog]  ![](../../../../assets/en/manual/config/event_correlation/correlation_item.png)  With the item set up, wait a minute for the configuration changes to be picked up and then go to [Latest data](/manual/web_interface/frontend_sections/monitoring/latest_data) to make sure that the item has started collecting data.
ca	##### Element  Per començar, voleu poder configurar un element que monitora un arxiu de registre, per exemple:      log[/var/log/syslog]  ![](../../../../assets/en/manual/config/event_correlation/correlation_item.png)  Una vegada l'element és configurat, espereu un minut que les modificacions de configuració siguin recuperades, i accediu a les [Darreres dades](/manual/web_interface/frontend_sections/monitoring/latest_data) per assegurar-vos que l'element comença a recollir dades.

en-us	# item.update
ca	# item.update

en-us	#### Item value  An *Item value* widget has been added to dashboard widgets.  This type of widget is useful for displaying values of single items prominently. Different visual styles of display are possible:  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_widgets_new.png)  For more information, see [Item value widget](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value).
ca	##### Valor de l'element  S'ha afegit el giny *Valor de l'element* als ginys del tauler.  Aquest tipus de giny és útil per ressaltar valors d'elements únics. Són possibles diferents estils de visualització:  ![](../../../assets/en/manual/web_interface/frontend_sections/monitoring/item_value_widgets_new.png)  Per obtindre més informació, consulteu el [giny valor d'element](/manual/web_interface/frontend_sections/monitoring/dashboard/widgets/item_value).

en-us	##### Item value preprocessing  The **Preprocessing** tab allows to define [transformation rules](/manual/config/items/preprocessing) for the received values.
ca	##### Preprocessament del valor de l'element  La pestanya **Preprocessament** permet definir [regles de transformació](/manual/config/items/preprocessing) per als valors rebuts.

en-us	#### Item value preprocessing  To visualize the data preprocessing process, we can use the following simplified diagram:  ![](../../../../../assets/en/manual/appendix/items/preprocessing_simplified.png)  The diagram above shows only processes, objects and main actions related to item value preprocessing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. Only one preprocessing worker is shown on this diagram (multiple preprocessing workers can be used in real-life scenarios), only one item value is being processed and we assume that this item requires to execute at least one preprocessing step. The aim of this diagram is to show the idea behind item value preprocessing pipeline.  -   Item data and item value is passed to preprocessing manager using     socket-based IPC mechanism. -   Item is placed in the preprocessing queue.  ::: noteclassic Item can be placed at the end or at the beginning of the preprocessing queue. Zabbix internal items are always placed at the beginning of preprocessing queue, while other item types are enqueued at the end. :::  -   At this point data flow stops until there is at least one unoccupied     (that is not executing any tasks) preprocessing worker. -   When preprocessing worker is available, preprocessing task is being     sent to it. -   After preprocessing is done (both failed and successful execution of     preprocessing steps), preprocessed value is being passed back to     preprocessing manager. -   Preprocessing manager converts result to desired format (defined by     item value type) and places result in preprocessing queue. If there     are dependent items for current item, then dependent items are added     to preprocessing queue as well. Dependent items are enqueued in     preprocessing queue right after the master item, but only for master     items with value set and not in NOT SUPPORTED state.
ca	#### Preprocessament del valor de l'element  Per visualitzar el procés de preprocessament de dades, podem emprar el següent diagrama simplificat:  ![](../../../../../assets/en/manual/appendix/items/preprocessing_simplified.png)  El diagrama anterior només mostra els principals processos, objectes i accions relacionades amb el preprocessament del valor de l'element de manera **simplificada**. El diagrama no mostra canvis de direcció condicionals, tractament d'errades ni bucles. En aquest diagrama només es mostra un preprocessador (es poden emprar diversos preprocessadors en escenaris del món real), només s'és processant un valor d'element i suposem que aquest element requereix almenys un per executar la passa de preprocessament. L'objectiu d'aquest diagrama és mostrar què hi ha darrera de la canalització de preprocessament del valor de l'article.  - Les dades i el valor de l'element es passen al controlador de preprocessament mitjançant el mecanisme IPC basat en socket. - L'element es posa a la cua de preprocessament.  :::noteclassic L'element es pot posar al final o al començament de la cua de preprocessament. Els elements interns de Zabbix sempre es posen al principi de la cua de preprocessament, mentre que altres tipus d'elements es posen a la cua al final. :::  - En aquest punt, el flux de dades s'atura fins que hi hagi almenys un agent de preprocessament inactiu (no realitza cap tasca). - Quan el treballador de preprocessament és disponible, se li envia la tasca de preprocessament. - Un cop finalitzat el preprocessament (error i execució correcta de les passes de preprocessament), el valor preprocessat es retorna al controlador de preprocessament. - El controlador de preprocessament converteix el resultat al format desitjat (definit pel tipus de valor de l'element) i col·loca el resultat a la cua de preprocessament. Si hi ha elements dependents per a l'element actual, els elements dependents també s'afegeixen a la cua de preprocessament. Els elements dependents es posen a la cua de preprocessament just després de l'element principal, però només per als elements principals amb un valor definit i no en l'estat NO ADMÈS.

en-us	#### Item value processing  To visualize the data flow from data source to the Zabbix database, we can use the following simplified diagram:  ![](../../../../../assets/en/manual/appendix/items/overall_pic.png)  The diagram above shows only processes, objects and actions related to item value processing in a **simplified** form. The diagram does not show conditional direction changes, error handling or loops. Local data cache of preprocessing manager is not shown either because it doesn't affect data flow directly. The aim of this diagram is to show processes involved in item value processing and the way they interact.  -   Data gathering starts with raw data from a data source. At this     point, data contains only ID, timestamp and value (can be multiple     values as well) -   No matter what type of data gatherer is used, the idea is the same     for active or passive checks, for trapper items and etc, as it only     changes the data format and the communication starter (either data     gatherer is waiting for a connection and data, or data gatherer     initiates the communication and requests the data). Raw data is     validated, item configuration is retrieved from configuration cache     (data is enriched with the configuration data). -   Socket-based IPC mechanism is used to pass data from data gatherers     to preprocessing manager. At this point data gatherer continue to     gather data without waiting for the response from preprocessing     manager. -   Data preprocessing is performed. This includes execution of     preprocessing steps and dependent item processing.  ::: noteclassic Item can change its state to NOT SUPPORTED while preprocessing is performed if any of preprocessing steps fail. :::  -   History data from local data cache of preprocessing manager is being     flushed into history cache. -   At this point data flow stops until the next synchronization of     history cache (when history syncer process performs data     synchronization). -   Synchronization process starts with data normalization storing data     in Zabbix database. Data normalization performs conversions to     desired item type (type defined in item configuration), including     truncation of textual data based on predefined sizes allowed for     those types (HISTORY\_STR\_VALUE\_LEN for string,     HISTORY\_TEXT\_VALUE\_LEN for text and HISTORY\_LOG\_VALUE\_LEN for     log values). Data is being sent to Zabbix database after     normalization is done.  ::: noteclassic Item can change its state to NOT SUPPORTED if data normalization fails (for example, when textual value cannot be converted to number). :::  -   Gathered data is being processed - triggers are checked, item     configuration is updated if item becomes NOT SUPPORTED, etc. -   This is considered the end of data flow from the point of view of     item value processing.
ca	#### Processament del valor de l'element  Per visualitzar el flux de dades de la font de dades a la base de dades Zabbix, podem emprar el següent diagrama simplificat:  ![](../../../../../assets/en/manual/appendix/items/overall_pic.png)  El diagrama anterior només mostra els processos, objectes i accions relacionades amb el processament del valor de l'element en una forma **simplificada**. El diagrama no mostra canvis de direcció condicionals, tractament d'errors ni bucles. Tampoc es mostra la memòria cau de dades locals del gestor de preprocessament perquè no afecta directament el flux de dades. L'objectiu d'aquest diagrama és mostrar els processos implicats en el processament del valor dels elements i com interactuen.  - La recollida de dades comença amb dades en brut d'una font de dades. En aquest moment, les dades només contenen ID, marca de temps i valor (també poden ser diversos valors) - Independentment del tipus de col·lector de dades emprat, la idea és la mateixa per a controls actius o passius, per a elements trapper, etc., ja que només canvia el format de les dades i l'inici de la comunicació (o el col·lector de dades és esperant una connexió i dades, o el recollidor de dades inicia la comunicació i demana les dades). Les dades en brut es validen, la configuració de l'element es recupera de la memòria cau de configuració (les dades s'enriqueixen amb dades de configuració). - El mecanisme IPC basat en socket s'empra per passar dades dels col·lectors de dades al gestor de preprocessament. En aquest punt, el recopilador de dades continua recopilant dades sense esperar la resposta del gestor de preprocessament. - Es fa un pretractament de dades. Això inclou fer passes de preprocessament i processar elements dependents.  :::noteclassic L'element pot canviar d'estat a NO SOPORTAT durant el preprocessament si alguna de les passes de preprocessament falla. :::  - Les dades de l'historial de la memòria cau de dades local del gestor de preprocessament s'envien a la memòria cau de l'historial. - En aquest punt, el flux de dades s'atura fins a la següent sincronització de la memòria cau de l'historial (quan el procés de sincronització de l'historial realitza la sincronització de dades). - El procés de sincronització comença amb la normalització de dades emmagatzemant dades a la base de dades Zabbix. La normalització de dades realitza conversions al tipus d'element esperat (tipus definit a la configuració de l'element), inclòs el truncament de les dades textuals segons les mides predefinides permeses per a aquests tipus (HISTORY\_STR\_VALUE\_LEN per a la cadena, HISTORY\_TEXT\_VALUE\_LEN per a text i HISTORY\_LOG\_VALUE\_LEN per als valors de registre). Les dades s'envien a la base de dades Zabbix després de la normalització.  :::noteclassic L'element pot canviar d'estat a NO SOPORTAT si la normalització de dades falla (per exemple, quan el valor del text no es pot convertir a nombre). :::  - S'estan processant les dades recollides: es comproven els triggers, s'actualitza la configuració de l'element si l'element no és compatible, etc. - Es considera el final del flux de dades des del punt de vista del processament del valor de l'element.

en-us	#### Item values  The following information is exported for a collected item value:  |Field|<|Type|Description| |-|---------|---------|---------------------------| |*host*|<|object|Host name of the item host.| | |host|string|Host name.| |^|name|string|Visible host name.| |*groups*|<|array|List of host groups of the item host; there should be at least one element in array.| | |\-|string|Host group name.| |*itemid*|<|number|Item ID.| |*name*|<|string|Visible item name.| |*clock*|<|number|Number of seconds since Epoch to the moment when value was collected (integer part).| |*ns*|<|number|Number of nanoseconds to be added to `clock` to get a precise value collection time.| |*timestamp*<br>(*Log* only)|<|number|0 if not available.| |*source*<br>(*Log* only)|<|string|Empty string if not available.| |*severity*<br>(*Log* only)|<|number|0 if not available.| |*eventid*<br>(*Log* only)|<|number|0 if not available.| |*value*|<|number (for numeric items) or<br>string (for text items)|Collected item value.| |*type*|<|number|Collected value type:<br>0 - numeric float, 1 - character, 2 - log, 3 - numeric unsigned, 4 - text|
ca	#### Valors d'element  S'exporta la informació següent per al valor d'un element recollit:  |Camp|<|Tipus|Descripció| |-|----------|----------|----------------------------- | |*host*|<|object|Nom d'equip de l'equip de l'element.| | |host|string|Nom de l'equip.| |^|nom|string|Nom visible de l'equip.| |*groups*|<|array|Llista de grups d'equips de l'element equip; hi ha d'haver almenys un element a la matriu.| | |\-|string|Nom del grup d'equips.| |*itemid*|<|number|ID de l'element.| |*nom*|<|string|Nom de l'element visible.| |*clock*|<|number|Nombre de segons des de l'Època fins que es va recopilar el valor (part entera).| |*ns*|<|number|Nombre de nanosegons que cal afegir a `clock` per obtindre un temps de recollida de valors precís.| |*timestamp*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*font*<br>(només *Journal*)|<|string|Cadena buida si no és pas disponible.| |*severity*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*eventid*<br>(només *Journal*)|<|number|0 si no és pas disponible.| |*value*|<|number (per a elements numèrics) o<br>string (per a elements de text)|Valor de l'element recollit.| |*types*|<|number|Tipus de valor recollit:<br>0 - nombre flotant, 1 - caràcter, 2 - registre, 3 - numèric sense signe, 4 - text|

en-us	##### Item value  The following parameters are supported if *Data* is set to "Item value".  ::: noteclassic The first number in the *Thresholds* property name (e.g. columnsthresholds.color.0.0) references the column for which thresholds are configured, while the second number references threshold place in a list, sorted in ascending order. However, if thresholds are configured in a different order, the values will be sorted in ascending order after updating widget configuration in Zabbix frontend (e.g. `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold.1": "5"`). :::  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Item*|<|1 |columns.item.0|Valid item name.| |***Time shift***<br>(required)|<|1|columns.timeshift.0|Valid numeric or time string value (e.g. `3600` or `1h`).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes). Negative values are allowed.| |*Aggregation function*|<|0|columns.aggregate_function.0|0 - *(default)* none;<br>1 - min;<br>2 - max;<br>3 - avg;<br>4 - count;<br>5 - sum;<br>6 - first;<br>7 - last.| |*Aggregation interval*|<|1|columns.aggregate_interval.0|Valid time string (e.g. `3600`, `1h`, etc.).<br>You may use [time suffixes](/manual/appendix/suffixes#time-suffixes).<br><br>Parameter *Aggregation interval* not available if *Aggregation function* is set to *none*.<br><br>Default: `1h`.| |*Display*|<|0|columns.display.0|1 - *(default)* As is;<br>2 - Bar;<br>3 - Indicators.| |*Min*|<|1|columns.min.0|Any numeric value.<br><br>Parameter *Min* not available if *Display* is set to "As is".| |*Max*|<|1|columns.max.0|Any numeric value.<br><br>Parameter *Max* not available if *Display* is set to "As is".| |*History data*|<|0|columns.history.0|1 - *(default)* Auto;<br>2 - History;<br>3 - Trends.| |*Thresholds*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Threshold*|1|columnsthresholds.threshold.0.0|Any string value.|
ca	##### Valor de l'element  Els paràmetres següents són compatibles si *Data* s'estableix a "Valor de l'element".  ::: noteclassic El primer nombre del nom de propietat *Llindars* (p. ex. columnsthresholds.color.0.0) fa referència a la columna per a la qual es configuren els llindars, mentre que el segon nombre fa referència al lloc llindar en una llista, ordenada en ordre ascendent. Tanmateix, si els llindars es configuren en un ordre diferent, els valors s'ordenaran en ordre ascendent després d'actualitzar la configuració del giny a la interfície de Zabbix (p. ex., `"threshold.threshold.0":"5"` → `"threshold.threshold.0":"1"`; `"threshold.threshold.1":"1"` → `"threshold.threshold. 1": "5"`). :::  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Element*|<|1 |columns.item.0|Nom d'element vàlid.| |***Desplaçament de temps***<br>(obligatori)|<|1|columns.timeshift.0|Valor numèric o de cadena de temps vàlid (p. ex., `3600` o `1h`).<br>Podeu emprar [sufixos de temps](/manual/appendix/sufixes#time-suffixes). Es permeten valors negatius.| |*Funció d'agregació*|<|0|columns.aggregate_function.0|0 - *(per defecte)* cap;<br>1 - mín;<br>2 - màxim;<br>3 - mitjana;<br>4 - recompte;<br>5 - suma;<br>6 - primer;<br>7 - darrer.| |*Interval d'agregació*|<|1|columns.aggregate_interval.0|Cadena de temps vàlida (per exemple, `3600`, `1h`, etc.).<br>Podeu emprar [sufixos de temps](/manual/appendix/suffixes #time-sufixes).<br><br>El paràmetre *Interval d'agregació* no és pas disponible si la *funció d'agregació* és establerta a *cap*.<br><br>Per defecte: `1h`.| |*Vista*|<|0|columns.display.0|1 - *(per defecte)* Tal com és;<br>2 - Barra;<br>3 - Indicadors.| |*Min*|<|1|columns.min.0|Qualsevol valor numèric.<br><br>El paràmetre *Min* no és disponible si *Vista* s'estableix a "Tal com és".| |*Max*|<|1|columns.max.0|Qualsevol valor numèric.<br><br>El paràmetre *Max* no és disponible si *Vista* és establert a "Tal com és".| |*Dades de l'historial*|<|0|columns.history.0|1 - *(per defecte)* Automàtic;<br>2 - Historial;<br>3 - Tendències.| |*Llindars*|<|<|<|<| |<|*Color*|1|columnsthresholds.color.0.0|Codi de color hexadecimal (per exemple, `FF0000`).<br><br>Per defecte: `""` (buida).| |^|*Llindar*|1|columnsthresholds.threshold.0.0|Qualsevol valor de cadena.|

en-us	It is possible to zoom in and out the map by using the plus and minus buttons in the widget's upper left corner or by using the mouse scroll wheel or touchpad. To set the current view as default, right-click anywhere on the map and select *Set this view as default*. This setting will override *Initial view* widget parameter for the current user. To undo this action, right-click anywhere on the map again and select *Reset the initial view*.  When *Initial view* or *Default view* is set, you can return to this view at any time by pressing on the home icon on the left.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget3.png)
ca	És possible ampliar i allunyar el mapa emprant els botons més i menys a la cantonada superior esquerra del giny o emprant la roda del ratolí o el touchpad. Per establir la vista actual com a predeterminada, feu clic amb el botó dret a qualsevol lloc del mapa i seleccioneu *Establir aquesta vista com a predeterminada*. Aquesta configuració anul·larà la configuració del giny *Vista inicial* per a l'usuari actual. Per desfer aquesta acció, torneu a fer clic amb el botó dret a qualsevol lloc del mapa i trieu *Restablir la vista inicial*.  Quan s'estableix *Visualització inicial* o *Visualització per defecte*, podeu tornar a aquesta vista en qualsevol moment tocant la icona d'inici a l'esquerra.  ![](../../../../../../../assets/en/manual/web_interface/frontend_sections/monitoring/geomap_widget3.png)

en-us	##### Java gateway  If you obtained Zabbix from the source repository or an archive, then the necessary dependencies are already included in the source tree.  If you obtained Zabbix from your distribution's package, then the necessary dependencies are already provided by the packaging system.  In both cases above, the software is ready to be used and no additional downloads are necessary.  If, however, you wish to provide your versions of these dependencies (for instance, if you are preparing a package for some Linux distribution), below is the list of library versions that Java gateway is known to work with. Zabbix may work with other versions of these libraries, too.  The following table lists JAR files that are currently bundled with Java gateway in the original code:  |Library|Mandatory status|Comments| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Yes|Version 4.3r1 or higher.<br>JSON (JavaScript Object Notation) is a lightweight data-interchange format. This is the org.json compatible Android implementation extracted from the Android SDK.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|Version 1.2.9 or higher.| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|Version 1.2.9 or higher.| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|Version 1.7.32 or higher.|  Java gateway can be built using either Oracle Java or open-source OpenJDK (version 1.6 or newer). Packages provided by Zabbix are compiled using OpenJDK. The table below provides information about OpenJDK versions used for building Zabbix packages by distribution:  |Distribution|OpenJDK version| |------------|---------------| |RHEL 8|1.8.0| |RHEL 7|1.8.0| |SLES 15|11.0.4| |SLES 12|1.8.0| |Debian 10|11.0.8| |Ubuntu 20.04|11.0.8| |Ubuntu 18.04|11.0.8|
ca	##### Passerel·la Java  Si heu obtingut Zabbix del repositori font o d'un arxiu, les dependències necessàries ja s'inclouen a la font.  Si teniu Zabbix del paquet de la vostra distribució, el sistema de paquets ja proporciona les dependències necessàries.  En els dos casos anteriors, el programari és llest per usar-lo i no cal descarregar-lo.  Tanmateix, si voleu proporcionar les vostres versions d'aquestes dependències (per exemple, si sou preparant un paquet per a determinades distribucions de Linux), a continuació es mostra el llistat de versions de biblioteca amb les quals se sap que la passarel·la de Java pot funcionar. Zabbix també pot treballar amb altres versions d'aquestes biblioteques.  La taula següent llista els fitxers JAR que s'envien actualment amb Java Gateway al codi original:  |Biblioteca|Obligatori|Comentaris| |--|-|-------| |[android-json](https://mvnrepository.com/artifact/com.vaadin.external.google/android-json)|Sí|Versió 4.3r1 o superior.<br>JSON (JavaScript Object Notation) és un format intercanvi de dades lleuger. Aquesta és la implementació d'Android compatible amb org.json extreta de l'SDK d'Android.| |[logback-classic](https://mvnrepository.com/artifact/ch.qos.logback/logback-classic)|^|Versió 1.2.9 o superior.| |[logback-core](https://mvnrepository.com/artifact/ch.qos.logback/logback-core)|^|Versió 1.2.9 o superior.| |[slf4j-api](https://mvnrepository.com/artifact/org.slf4j/slf4j-api)|^|Versió 1.7.32 o superior.|  La passarel·la de Java es pot crear amb Oracle Java o OpenJDK de codi obert (versió 1.6 o posterior). Els paquets proporcionats per Zabbix es compilen mitjançant OpenJDK. La taula següent proporciona informació sobre les versions d'OpenJDK emprades per crear paquets Zabbix per distribució:  |Distribució|Versió OpenJDK| |-----------|---------------| |RHEL 8|1.8.0| |RHEL 7|1.8.0| |SLES 15|11.0.4| |SLES 12|1.8.0| |Debian 10|11.0.8| |Ubuntu 20.04|11.0.8| |Ubuntu 18.04|11.0.8|

en-us	### Java gateway installation  It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.  Once the required repository is added, you can install Zabbix Java gateway by running:      apt install zabbix-java-gateway  Proceed to [setup](/manual/concepts/java/from_debian_ubuntu) for more details on configuring and running Java gateway.
ca	###Instal·lació de la passarel·la Java  Cal instal·lar la [passarel·la de Java](/manual/concepts/java) només si voleu monitorar les aplicacions JMX. La passarel·la de Java és lleugera i no li cal una base de dades.  Un cop afegit el dipòsit necessari, podeu instal·lar Zabbix Java Gateway executant:       apt install zabbix-java-gateway  Aneu a [configuració](/manual/concepts/java/from_debian_ubuntu) per obtindre detalls sobre la configuració i l'execució de la passarel·la Java.

en-us	### Java gateway installation  It is required to install [Java gateway](/manual/concepts/java) only if you want to monitor JMX applications. Java gateway is lightweight and does not require a database.  Once the required repository is added, you can install Zabbix Java gateway by running:      dnf install zabbix-java-gateway  Proceed to [setup](/manual/concepts/java/from_rhel) for more details on configuring and running Java gateway.
ca	###Instal·lació de la passarel·la Java  Cal instal·lar la [passarel·la de Java](/manual/concepts/java) només si voleu monitorar les aplicacions JMX. La passarel·la de Java és lleugera i no li cal una base de dades.  Un cop afegit el dipòsit necessari, podeu instal·lar Zabbix Java Gateway executant:       dnf install zabbix-java-gateway  Aneu a [configuració](/manual/concepts/java/from_rhel) per obtindre detalls sobre la configuració i l'execució de la passarel·la Java.

en-us	#### JavaScript methods  HTTP methods PATCH, HEAD, OPTIONS, TRACE, CONNECT have been added to the JavaScript engine. Also, the engine now allows sending custom HTTP method requests with the new JS method HttpRequest.customRequest.  See also: [Additional JavaScript objects](/manual/config/items/preprocessing/javascript/javascript_objects).
ca	### Mètodes JavaScript  Els mètodes HTTP PATCH, HEAD, OPTIONS, TRACE, CONNECT s'han afegit al motor de JavaScript. A més, el motor permet enviar peticions personalitzades de mètode HTTP amb el nou mètode JS HttpRequest.customRequest.  Veieu també: [Objectes addicionals de JavaScript](/manual/config/items/preprocessing/javascript/javascript_objects).

en-us	#### JavaScript preprocessing  JavaScript preprocessing is done by invoking JavaScript function with a single parameter 'value' and user provided function body. The preprocessing step result is the value returned from this function, for example, to perform Fahrenheit to Celsius conversion user must enter:      return (value - 32)  * 5 / 9  in JavaScript preprocessing parameters, which will be wrapped into a JavaScript function by server:  ``` {.java} function (value) {    return (value - 32) * 5 / 9 } ```  The input parameter 'value' is always passed as a string. The return value is automatically coerced to string via ToString() method (if it fails then the error is returned as string value), with a few exceptions:  -   returning undefined value will result in an error -   returning null value will cause the input value to be discarded,     much like 'Discard value' preprocessing on 'Custom on fail' action.  Errors can be returned by throwing values/objects (normally either strings or Error objects).  For example:  ``` {.java} if (value == 0)     throw "Zero input value" return 1/value ```  Each script has a 10 second execution timeout (depending on the script it might take longer for the timeout to trigger); exceeding it will return error. A 512-megabyte heap limit is enforced (64 megabytes before Zabbix 6.0.19).  The JavaScript preprocessing step bytecode is cached and reused when the step is applied next time. Any changes to the item's preprocessing steps will cause the cached script to be reset and recompiled later.  Consecutive runtime failures (3 in a row) will cause the engine to be reinitialized to mitigate the possibility of one script breaking the execution environment for the next scripts (this action is logged with DebugLevel 4 and higher).  JavaScript preprocessing is implemented with Duktape (<https://duktape.org/>) JavaScript engine.  See also: [Additional JavaScript objects and global functions](/manual/config/items/preprocessing/javascript/javascript_objects)
ca	#### Preprocessament de JavaScript  El preprocessament de JavaScript es realitza invocant la funció JavaScript amb un únic paràmetre "valor" i un cos de funció subministrat per l'usuari. El resultat de la passa de preprocessament és el valor que retorna aquesta funció, per exemple, per fer una conversió de Fahrenheit a Celsius, l'usuari introduiria:      return (value - 32) * 5 / 9  als paràmetres de preprocessament de JavaScript, que s'embolcallen en una funció JavaScript per servidor:  ``` {.java} function (value) {    return (value - 32) * 5 / 9 } ```  El paràmetre d'entrada "valor" sempre es passa com a cadena. El valor de retorn es converteix automàticament a una cadena mitjançant el mètode ToString() (si falla, l'error es retorna com a valor de cadena), amb algunes excepcions:  - retornar un valor no definit donarà lloc a un error - retornar un valor nul farà que el valor d'entrada s'esborri, de la mateixa manera que el preprocessament "Esborra el valor" a l'acció "Personalitzar en cas d'error".  Els errors es poden retornar iniciant valors/objectes (normalment cadenes o objectes d'error).  Per exemple:  ``` {.java} if (value == 0)     throw "Zero input value" return 1/value ```  Cada script té un temps d'espera d'execució de 10 segons (depenent de l'script, el temps d'espera pot trigar més a activar-se); superar-lo retornarà un error. S'aplica un límit d'emmagatzematge dinàmic de 64 Mo.  El bytecode de la passa de preprocessament de JavaScript s'emmagatzema a la memòria cau i es reutilitza la propera vegada que s'aplica el pas. Qualsevol canvi als passos de preprocessament de l'element farà que l'script desat a la memòria cau es restableixi i es torni a compilar posteriorment.  Els errors d'execució consecutius (3 de seguits) faran que el motor es restableixi per esmorteir la possibilitat que un script trenqui l'entorn d'execució per als scripts posteriors (aquesta acció es registra amb DebugLevel a 4 i posteriors).  El preprocessament de JavaScript s'implementa amb el motor JavaScript de Duktape (<https://duktape.org/>).  Veieu també: [Objectes JavaScript addicionals i funcions globals](/manual/config/items/preprocessing/javascript/javascript_objects)

en-us	### JavaScript preprocessing  The heap limit for scripts has been upped from 64 to 512 megabytes.
ca	### Preprocessament JavaScript  El límit dels scripts s'ha augmentat de 64 a 512 megaoctets.

en-us	#### Jira webhook (custom)  ![](../../../../../../assets/en/manual/config/notifications/media/media_webhook_jira.png)  This script will create a JIRA issue and return some info on the created issue.  ``` {.java} try {     Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value);      var result = {             'tags': {                 'endpoint': 'jira'             }         },         params = JSON.parse(value),         req = new HttpRequest(),         fields = {},         resp;      if (params.HTTPProxy) {         req.setProxy(params.HTTPProxy);     }      req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic ' + params.authentication);      fields.summary = params.summary;     fields.description = params.description;     fields.project = {key: params.project_key};     fields.issuetype = {id: params.issue_id};      resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );      if (req.getStatus() != 201) {         throw 'Response code: ' + req.getStatus();     }      resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key;      return JSON.stringify(result); } catch (error) {     Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields}));     Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error);      throw 'Failed with error: ' + error; } ```
ca	#### Jira webhook (personalitzat)  ![](../../../../../../assets/en/manual/config/notifications/media/media_webhook_jira.png)  Aquest script crearà un problema JIRA i retornarà la informació del problema creat.  ``` {.java} try {     Zabbix.log(4, '[ Jira webhook ] Started with params: ' + value);      var result = {             'tags': {                 'endpoint': 'jira'             }         },         params = JSON.parse(value),         req = new HttpRequest(),         fields = {},         resp;      if (params.HTTPProxy) {         req.setProxy(params.HTTPProxy);     }      req.addHeader('Content-Type: application/json');     req.addHeader('Authorization: Basic ' + params.authentication);      fields.summary = params.summary;     fields.description = params.description;     fields.project = {key: params.project_key};     fields.issuetype = {id: params.issue_id};      resp = req.post('https://jira.example.com/rest/api/2/issue/',         JSON.stringify({"fields": fields})     );      if (req.getStatus() != 201) {         throw 'Response code: ' + req.getStatus();     }      resp = JSON.parse(resp);     result.tags.issue_id = resp.id;     result.tags.issue_key = resp.key;      return JSON.stringify(result); } catch (error) {     Zabbix.log(4, '[ Jira webhook ] Issue creation failed json : ' + JSON.stringify({"fields": fields}));     Zabbix.log(3, '[ Jira webhook ] issue creation failed : ' + error);      throw 'Failed with error: ' + error; } ```

en-us	#### JMX item keys in more detail
ca	#### Claus de l'element JMX detallats

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	#### JMX monitoring  See [JMX monitoring](/manual/config/items/itemtypes/jmx_monitoring) page for more details.
ca	#### Monitoratge JMX  Veieu la pàgina [Supervisió JMX](/manual/config/items/itemtypes/jmx_monitoring) per tindre més detalls.

en-us	 ### JMX monitoring  The template *Generic Java JMX* now contains discovery rules for low-level discovery of memory pools and garbage collectors. 
ca	### Monitoratge JMX  La plantilla *Generic Java JMX* ara conté regles de descoberta per a la descoberta de baix nivell d'agrupacions de memòria i col·lectors d'escombraries.

en-us	#### JSON format  The JSON export format contains the following objects:  -   Root object for Zabbix JSON export -   Export version -   Date when export was created in ISO 8601 long format  ```json {     "zabbix_export": {         "version": "6.0",         "date": "2020-04-22T06:20:11Z"     } } ```  Other objects are dependent on exported objects.
ca	#### Format de base JSON  El format d'exportació JSON conté els objectes següents:  - Objecte arrel per l'exportació Zabbix JSON. - Versió de l'exportació. Data en que l'exportació s'ha creat, en format llarg ISO 8601.  ```json {      "zabbix_export": {      "version": "6.0",      "date": "2020-04-22T06:20:11Z"      } } ```  La resta d'objectes depenen dels objectes exportats.

en-us	 ### JSONPath parsing errors  JSONPath parsing errors occur in this version in case of leading whitespace and empty array/object. Fixed in Zabbix 6.0.12.
ca	 ### Errors d'anàlisi JSONPath  Els errors d'anàlisi de JSONPath es produeixen en aquesta versió en cas d'espai d'encapçalament i de taula/objecte buit. Corregit a Zabbix 6.0.12.

en-us	#### Keeping history  You can set for how many days history will be kept:  -   in the item properties [form](/manual/config/items/item) -   when mass-updating items -   when [setting     up](/manual/web_interface/frontend_sections/administration/general#housekeeper)     housekeeper tasks  Any older data will be removed by the housekeeper.  The general strong advice is to keep history for the smallest possible number of days and that way not to overload the database with lots of historical values.  Instead of keeping a long history, you can keep longer data of trends. For example, you could keep history for 14 days and trends for 5 years.  You can get a good idea of how much space is required by history versus trends data by referring to the [database sizing page](/manual/installation/requirements#database_size).  While keeping shorter history, you will still be able to review older data in graphs, as graphs will use trend values for displaying older data.  ::: noteimportant If history is set to '0', the item will update only dependent items and inventory. No trigger functions will be evaluated because trigger evaluation is based on history data only. :::   ::: notetip As an alternative way to preserve history consider to use [history export](/manual/config/items/loadablemodules#providing_history_export_callbacks) functionality of loadable modules. :::
ca	#### Conservar l'històric  Podeu definir durant quant de temps s'ha de conservar l'històric:  -   al formulari de propietats de l'[element](/manual/config/items/item) -   quan s'actualitzen elements de forma massiva -   quan es fa la [configuració](/manual/web_interface/frontend_sections/administration/general#housekeeper) de les tasques de neteja  Totes les dades més antigues s'esborraran per la neteja.  El consell general és conservar l'històric durant el mínim de dies possibles i no sobrecarregar la basse de dades amb nombrosos valors històrics.  En lloc de conservar un històric llarg, podeu configurar dates més llargues a les tendències. Per exemple, podeu conservar l'històric de 14 dies i les tendències durant 5 anys.  Podeu tindre una bona ideia de l'espai que cal per les dades d'històric segons l'informe de les dades de tendències, veient la [pàgina de dimensionament de la base de dades](/manual/installation/requirements#database_size).  Conservant l'històric més curt, podeu veure les dades més antigues als gràfics, doncs els gràfics empren els valors de tendències per mostrar les dades més antigues.  ::: noteimportant Si l'històric es defineix a '0', l'element actualitzarà només elements dependents i inventari. Cap funció de trigger s'avaluarà, doncs l'avaluació del trigger es basa només en les dades d'històric. :::   ::: notetip Una altra manera de preservar l'històric ésemprar la funcionalitat [exportar l'històric](/manual/config/items/loadablemodules#providing_history_export_callbacks) dels mòduls carregables. :::

en-us	#### Keeping trends  Trends is a built-in historical data reduction mechanism which stores minimum, maximum, average and the total number of values per every hour for numeric data types.  You can set for how many days trends will be kept:  -   in the item properties [form](/manual/config/items/item) -   when mass-updating items -   when setting up Housekeeper tasks  Trends usually can be kept for much longer than history. Any older data will be removed by the housekeeper.  Zabbix server accumulates trend data in runtime in the trend cache, as the data flows in. Server flushes **previous hour** trends of every item into the database (where frontend can find them) in these situations:  -   server receives the first current hour value of the item -   5 or less minutes of the current hour left and still no current hour     values of the item -   server stops  To see trends on a graph you need to wait at least to the beginning of the next hour (if item is updated frequently) and at most to the end of the next hour (if item is updated rarely), which is 2 hours maximum.  When server flushes trend cache and there are already trends in the database for this hour (for example, server has been restarted mid-hour), server needs to use update statements instead of simple inserts. Therefore on a bigger installation if restart is needed it is desirable to stop server in the end of one hour and start in the beginning of the next hour to avoid trend data overlap.  History tables do not participate in trend generation in any way.  ::: noteimportant If trends are set to '0', Zabbix server does not calculate or store trends at all. :::  ::: noteclassic The trends are calculated and stored with the same data type as the original values. As a result the average value calculations of unsigned data type values are rounded and the less the value interval is the less precise the result will be. For example if item has values 0 and 1, the average value will be 0, not 0.5.  Also restarting server might result in the precision loss of unsigned data type average value calculations for the current hour. :::
ca	#### Desar les tendències  Les tendències són un mecanisme de reducció de dades de l'històric integrat que emmagatzema valors horaris mínims, màxims, mitjans i totals per a tipus de dades numèriques.  Podeu definir durant quants dies es mantindran les tendències:  - al [formulari](/manual/config/items/item) de les propietats de l'element - quan s'actualitzen elements a comptagotes - en configurar tasques de neteja  Les tendències normalment es poden mantindre molt més temps que l'històric. Totes les dades més antigues s'esborraran amb la neteja.  El servidor Zabbix acumula dades de tendències en temps d'execució a la memòria cau de tendències a mesura que arriben les dades. El servidor aboca les tendències de l'**hora anterior** de cada element a la base de dades (on la interfície les pot trobar) en aquestes situacions:  - el servidor rep el primer valor de temps actual de l'element - Queden 5 minuts o menys de l'hora actual i encara no hi ha valor de temps actual per a l'element - el servidor s'atura  Per veure les tendències en un gràfic, hauríeu d'esperar almenys fins a l'inici de l'hora següent (si l'element s'actualitza amb freqüència) i com a màxim fins al final de l'hora següent (si l'element s'actualitza amb poca freqüència); és a dir, 2 hores com a màxim.  Quan el servidor esborra la memòria cau de tendències i ja hi ha tendències a la base de dades per a aquesta hora (per exemple, el servidor s'ha reiniciat fa mitja hora), el servidor hauria d'emprar declaracions d'actualització en lloc d'insercions simples. Per tant, en una instal·lació més gran, si es requereix un reinici, és desitjable aturar el servidor després d'una hora i començar al principi de l'hora següent per evitar la superposició de dades de tendència.  Les taules històriques no participen de cap manera en la generació de tendències.  ::: noteimportant Si les tendències s'estableixen a "0", el servidor Zabbix no calcula ni emmagatzema tendències en absolut. :::  :::noteclassic Les tendències es calculen i s'emmagatzemen amb el mateix tipus de dades que els valors originals. Com a resultat, els càlculs de valors mitjans dels valors de tipus de dades sense signar s'arrodoneixen i com més petit sigui el rang de valors, menys precís serà el resultat. Per exemple, si l'element té els valors 0 i 1, el valor mitjà serà 0 i no 0,5.  Reiniciar el servidor també pot provocar que els càlculs del valor mitjà dels tipus de dades sense signar per a l'hora actual siguin inexactes. :::

en-us	 ##### Kernel data  |Item key|<|<|<| |--|--|------|------| |Description|Return value|Parameters|Comments| |**kernel.maxfiles**|<|<|<| |Maximum number of opened files supported by OS.|Integer| | | |**kernel.maxproc**|<|<|<| |Maximum number of processes supported by OS.|Integer| | | |**kernel.openfiles**|<|<|<| |Return the number of currently open file descriptors.|Integer| |This item is supported since Zabbix 6.0.|
ca	##### Dades del kernel  |Clau de l'element|<|<|<| |--|--|------|------| |Descripció|Valor de retorn|Paràmetres|Comentaris| |**kernel.maxfiles**|<|<|<| |Nombre màxim de fitxers oberts compatibles amb el sistema operatiu.|Enter| | | |**kernel.maxproc**|<|<|<| |Nombre màxim de processos compatibles amb el sistema d'explotació.|Enter| | | |**kernel.openfiles**|<|<|<| |Retorna el nombre de descriptors de fitxers oberts actualment.|Enter| |Aquest element s'admet des de Zabbix 6.0.|

en-us	 ### Keyboard navigation  Keyboard control has been implemented for info icons in the frontend. Thus it is now  possible to focus on info icons, and open the hints, using the keyboard.
ca	### Navegació amb teclat  S'ha implementat el control del teclat per a les icones d'informació a la interfície. Així, ara és possible centrar-se en les icones d'informació i obrir consells emprant el teclat.

en-us	##### Key file authentication  To use key based authentication for SSH items, certain changes to the server configuration are required.  Open the Zabbix server configuration file ([*zabbix\_server.conf*](/manual/appendix/config/zabbix_server)) as `root` and look for the following line:  ```ini # SSHKeyLocation= ```  Uncomment it and set the full path to the folder where the public and private keys will be located:  ```ini SSHKeyLocation=/home/zabbix/.ssh ```  Save the file and restart Zabbix server afterwards.  The path */home/zabbix* here is the home directory for the *zabbix* user account, and *.ssh* is a directory where by default public and private keys will be generated by an [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) command inside the home directory.  Usually installation packages of Zabbix server from different OS distributions create the *zabbix* user account with a home directory elsewhere, for example, */var/lib/zabbix* (as for system accounts).  Before generating the keys, you could reallocate the home directory to */home/zabbix*, so that it corresponds with the `SSHKeyLocation` Zabbix server configuration parameter mentioned above.  ::: noteclassic The following steps can be skipped if *zabbix* account has been added manually according to the [installation section](/manual/installation/install#create_user_account). In such a case the home directory for the *zabbix* account is most likely already */home/zabbix*. :::  To change the home directory of the *zabbix* user account, all working processes which are using it have to be stopped:  ```bash service zabbix-agent stop service zabbix-server stop ```  To change the home directory location with an attempt to move it (if it exists) the following command should be executed:  ```bash usermod -m -d /home/zabbix zabbix ```  It is also possible that a home directory did not exist in the old location, so it should be created at the new location. A safe attempt to do that is:  ```bash test -d /home/zabbix || mkdir /home/zabbix ```  To be sure that all is secure, additional commands could be executed to set permissions to the home directory:  ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ```  Previously stopped processes can now be started again:  ```bash service zabbix-agent start service zabbix-server start ```  Now, the steps to generate the public and private keys can be performed with the following commands (for better readability, command prompts are commented out):  ```bash sudo -u zabbix ssh-keygen -t rsa # Generating public/private rsa key pair. # Enter file in which to save the key (/home/zabbix/.ssh/id_rsa): /home/zabbix/.ssh/id_rsa # Enter passphrase (empty for no passphrase): <Leave empty> # Enter same passphrase again:  <Leave empty> # Your identification has been saved in /home/zabbix/.ssh/id_rsa. # Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. # The key fingerprint is: # 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 # The key's randomart image is: # +--[ RSA 2048]----+ # |                 | # |       .         | # |      o          | # | .     o         | # |+     . S        | # |.+   o =         | # |E .   * =        | # |=o . ..* .       | # |... oo.o+        | # +-----------------+ ```  ::: noteclassic The public and private keys (*id\_rsa.pub* and *id\_rsa*) have been generated by default in the */home/zabbix/.ssh* directory, which corresponds to the Zabbix server `SSHKeyLocation` configuration parameter. :::  ::: noteimportant Key types other than "rsa" may be supported by the ssh-keygen tool and SSH servers but they may not be supported by libssh2 used by Zabbix. :::
ca	##### Autenticació d'arxiu de clau  Per emprar una autenticació basada en clau per elements SSH, s'han de fer alguns canvis a la configuració del servidor.  Obriu l'arxiu de configuració del servidor Zabbix ([zabbix\_server.conf](/manual/appendix/config/zabbix_server)) com a `root`, i cerqueu la línia següent:  ```ini # SSHKeyLocation= ```  Traieu-li el comentari i poseu-hi la ruta sencera cap a la carpeta on hi haurà les claus públiques i privades:  ```ini SSHKeyLocation=/home/zabbix/.ssh ```  Deseu l'arxiu i reinicieu el zabbix\_server.  */home/zabbix* aquest és el directori arrel de l'usuari *zabbix*, i *.ssh* és el directori on s'hi generen per defecte les claus públiques i privades amb la comanda [ssh-keygen](http://en.wikipedia.org/wiki/Ssh-keygen) dins del directori de l'usuari.  Generalment, els paquets d'instal·lació del zabbix-server de diferents distribucions de Sistema Operatiu creen el compte d'usuari *zabbix* amb un directori arrel en un lloc no gaire habitual (com per a comptes del sistema; per exemple, */var/lib/zabbix*).  Abans de generar les claus, estaria bé moure el directori base de l'usuari a un lloc més intuïtiu. Aquest hauria de correspondre amb el paràmetre de configuració *SSHKeyLocation* del servidor Zabbix, tal com s'ha dit més amunt.  ::: noteclassic Les passes poden saltar-se si el compte *zabbix* s'ha afegit manualment d'acord amb la [secció d'instal·lació](/manual/installation/install#create_user_account), doncs en aquest cas el directori base sigui a */home/zabbix*. :::  Per canviar aquest paràmetre del compte d'usuari *zabbix*, tots els processos que sigui emprant s'han d'aturar:  ```bash service zabbix-agent stop service zabbix-server stop ```  Per canviar el directori base movent-lo, la comanda hauria d'ésser:  ```bash usermod -m -d /home/zabbix zabbix ```  És possible que el directori base no existeixi al lloc antic, pel que s'hauria de crear a la nova ubicació. Una manera de fer-ho és:  ```bash test -d /home/zabbix || mkdir /home/zabbix ```  Per assegurar-vos que és segur, exxecuteu comandes addicionals per establir els permisos al directori base:  ```bash chown zabbix:zabbix /home/zabbix chmod 700 /home/zabbix ```  Com hem aturat els processos abans, ara els hauríem d'engegar:  ```bash service zabbix-agent start service zabbix-server start ```  Ara, les passes per generar les claus públiques i privades es poden fer amb aquesta comand:  ```bash # sudo -u zabbix ssh-keygen -t rsa Generating public/private rsa key pair. Enter file in which to save the key (/home/zabbix/.ssh/id_rsa):  # <enter the created directory '/home/zabbix/.ssh'> Enter passphrase (empty for no passphrase):  Enter same passphrase again:  Your identification has been saved in /home/zabbix/.ssh/id_rsa. Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub. The key fingerprint is: 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0 The key's randomart image is: +--[ RSA 2048]----+ |                 | |       .         | |      o          | | .     o         | |+     . S        | |.+   o =         | |E .   * =        | |=o . ..* .       | |... oo.o+        | +-----------------+ ```  :::noteclassic Nota: les claus públiques i privades (*id\_rsa.pub* i *id\_rsa* respectivament) s'han generat per defecte al directori */home/zabbix/.ssh*, que correspon al paràmetre de configuració *SSHKeyLocation* del servidor Zabbix. :::  ::: noteimportant Els tipus de claus diferents d'"rsa" es poden admetre per l'eina ssh-keygen i els servidors SSH però no seran suportades per libssh2, que és la que empra el Zabbix. :::

en-us	#### Key name  The key name itself has a limited range of allowed characters, which just follow each other. Allowed characters are:      0-9a-zA-Z_-.  Which means:  -   all numbers; -   all lowercase letters; -   all uppercase letters; -   underscore; -   dash; -   dot.  ![](../../../../../assets/en/manual/config/key_name.png)
ca	#### Nom de la clau  El nom de la clau té una limitació de caràcters permesos, que es segueixen els uns als altres. Els caràcters permesos són:      0-9a-zA-Z_-.  Que vol dir:  -   tots les nombres ; -   totes les lletres minúscules; -   totes les lletres majúscules; -   guió baix; -   guió; -   punt.  ![](../../../../../assets/fr/manual/config/items/item/key_name.png)

en-us	#### Key parameters  An item key can have multiple parameters that are comma separated.  ![](../../../../../assets/en/manual/config/key_parameters.png)  Each key parameter can be either a quoted string, an unquoted string or an array.  ![](../../../../../assets/en/manual/config/item_parameter.png)  The parameter can also be left empty, thus using the default value. In that case, the appropriate number of commas must be added if any further parameters are specified. For example, item key **icmpping\[,,200,,500\]** would specify that the interval between individual pings is 200 milliseconds, timeout - 500 milliseconds, and all other parameters are left at their defaults.  It is possible to include macros in the parameters. Those can be [user macros](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) or some of the built-in macros. To see what particular built-in macros are supported in item key parameters, search the page [Supported macros](/manual/appendix/macros/supported_by_location) for "item key parameters".
ca	#### Paràmetres de les claus  Una clau d'element pot tindre diversos paràmetres, separats per comes.  ![](../../../../../assets/fr/manual/config/items/item/key_parameters.png)  Cada paràmetre de clau pot ésser una cadena entre cometes, una cadena sense cometes o una taula.  ![](../../../../../assets/fr/manual/config/items/item/item_parameter.png)  El paràmetre es pot deixar buit, emprant el valor per defecte. En aquest cas, el nombre adequat de comes s'ha d'ajustar si s'especifiquen altres paràmetres. Per exemple, la clau d'element **icmpping\[,,200,,500\]** especifica que l'interval entre pings individuals és de 200 mil·lisegons, amb un timeout de 500 mil·lisegons, i tots els altres paràmetres es deixen amb els seus valors per defecte.  Es poden incloure macros als paràmetres. Aquestes poden ser [macros d'usuari](/manual/appendix/macros/supported_by_location_user#items-item-prototypes) o algunes de les macros integrades. Per veure concretament quines macros integrades s'admeten als paràmetres clau de l'element, cerqueu a la pàgina de [Macros admeses](/manual/appendix/macros/supported_by_location) "paràmetres clau de l'element".

en-us	#### Kiosk mode  The kiosk mode in supported frontend pages can be activated using URL parameters. For example, in dashboards:  -   `/zabbix.php?action=dashboard.view&kiosk=1` - activate kiosk mode -   `/zabbix.php?action=dashboard.view&kiosk=0` - activate normal mode
ca	#### Mode quiosc  El mode quiosc a les pàgines d'interfície compatibles es pot activar mitjançant els paràmetres d'URL. Per exemple, als taulers de control:  - `/zabbix.php?action=dashboard.view&kiosk=1` - activa el mode kiosque - `/zabbix.php?action=dashboard.view&kiosk=0` - activa el mode normal