en-us	### Parameters  The following parameters are supported for the *Clock* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Time type*|0|time_type|0 - *(default)* Local time;<br>1 - Server time;<br>2 - Host time.| |*Clock type*|0|clock_type|0 - *(default)* Analog;<br>1 - Digital.|  The following parameters are supported if *Time type* is set to "Host time".  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Item*|4|itemid|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|  The following parameters are supported if *Clock type* is set to "Digital".  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Show*|<|0|show|1 - Date;<br>2 - *(default)* Time;<br>3 - Time zone.<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Advanced configuration*|<|0|adv_conf|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>Parameter *Advanced configuration* must be set to "Enabled" to configure *Background color* and all options for *Date*, *Time* and *Time zone*.| |*Background color*|<|1|bg_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Date*|<|<|<|<| |<|*Size*|0|date_size|Valid values range from 1-100.<br><br>Default: 20.| |^|*Bold*|0|date_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |^|*Color*|1|date_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |*Time*|<|<|<|<| |<|*Size*|0|time_size|Valid values range from 1-100.<br><br>Default: 30.| |^|*Bold*|0|time_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |^|*Color*|1|time_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Seconds*|0|time_sec|0 - Disabled;<br>1 - *(default)* Enabled.| |^|*Format*|0|time_format|0 - *(default)* 24-hour;<br>1 - 12-hour.| |*Time zone*|<|<|<|<| |<|*Size*|0|tzone_size|Valid values range from 1-100.<br><br>Default: 20.| |^|*Bold*|0|tzone_bold|0 - *(default)* Disabled;<br>1 - Enabled.| |^|*Color*|1|tzone_color|Hexadecimal color code (e.g. `FF0000`).<br><br>Default: `""` (empty).| |^|*Time zone*|1|tzone_timezone|Valid timezone string (e.g. `Europe/Riga`, `system`, `UTC`, etc.). For the full list of supported time zones please refer to [PHP documentation](https://www.php.net/manual/en/timezones.php).<br><br>Default: `local`.<br><br>Parameter *Time zone* not available if *Time type* is set to "Host time".| |^|*Format*|0|tzone_format|0 - *(default)* Short;<br>1 - Full.<br><br>Parameter *Format* not available if *Time type* is set to "Host time".|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Rellotge*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.| |*Tipus d'hora*|0|tipus_hora|0 - *(per defecte)* Hora local;<br>1 - Hora del servidor;<br>2 - Hora de l'equip.| |*Tipus de rellotge*|0|tipus_rellotge|0 - *(per defecte)* Analògic;<br>1 - Digital.|  Els paràmetres següents s'admeten si el *Tipus de temps* s'estableix a "Hora de l'equip".  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Element*|4|itemid|[Eement](/manual/api/reference/item/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori*|  Els paràmetres següents s'admeten si el *Tipus de rellotge* és configurat a "Digital".  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Mostra*|<|0|mostra|1 - Data;<br>2 - *(per defecte)* Hora;<br>3 - Zona horària.<br><br>Nota: per configurar diversos valors, creeu un objecte camp del giny del tauler de control per a cada valor.| |*Configuració avançada*|<|0|adv_conf|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>El paràmetre *Configuració avançada* s'ha d'establir com a "Habilitat" per configurar *Color de fons* i totes les opcions per a *Data*, *Hora* i *Zona horària*.| |*Color de fons*|<|1|bg_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Data*|<|<|<|<| |<|*Mida*|0|date_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 20.| |^|*Negreta*|0|date_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |^|*Color*|1|date_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |*Hora*|<|<|<|<| |<|*Mida*|0|time_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 30.| |^|*Negreta*|0|time_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |^|*Color*|1|time_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |^|*Segons*|0|time_sec|0 - Inhabilitat;<br>1 - *(per defecte)* Habilitat.| |^|*Format*|0|time_format|0 - *(per defecte)* 24 hores;<br>1 - 12 hores.| |*Fus horari*|<|<|<|<| |<|*Mida*|0|tzone_size|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 20.| |^|*Negreta*|0|tzone_bold|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |^|*Color*|1|tzone_color|Codi de color hexadecimal (p. ex., `FF0000`).<br><br>Per defecte: `""` (buit).| |^|*Zona horària*|1|tzone_timezone|Cadena de zona horària vàlida (p. ex., `Europa/Riga`, `system`, `UTC`, etc.). Per obtindre la llista completa de zones horàries admeses, consulteu [documentació PHP](https://www.php.net/manual/en/timezones.php).<br><br>Per defecte: `local`.<br> <br>El paràmetre *Zona horària* no és disponible si el *Tipus d'hora* és establert a "Hora de l'equip".| |^|*Format*|0|tzone_format|0 - *(per defecte)* Curt;<br>1 - Sencer.<br><br>El paràmetre *Format* no és disponible si el *Tipus d'hora* s'ha establert a "Hora de l'equip ".|

en-us	### Parameters  The following parameters are supported for the *Data overview* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hosts location*|<|0|style|0 - *(default)* Left;<br>1 - Top.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Vista general de dades*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Equips*|<|3|hostids|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de configurar amb almenys un grup d'equips al qual pertanyen els equips configurats.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |*Mostra els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Ubicació de l'equip*|<|0|estil|0 - *(per defecte)* Esquerra;<br>1 - Amunt.|

en-us	### Parameters  The following parameters are supported for the *Discovery status* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny d'*Estat de descoberta*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Favorite graphs* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *Gràfics preferits*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Favorite maps* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *Mapes preferits*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Geomap* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Initial view*|<|1|default_view|Comma separated *latitude*, *longitude*, *zoom level* (*optional*, valid values range from 0-30).<br>Example: `40.6892494,-74.0466891,10`.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Geomapes*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Equips*|<|3|hostids|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de fer amb almenys un grup d'equips al qui pertanyen els equips configurats.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta al llistat d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |*Vista inicial*|<|1|vista_predeterminada|Separat per comes *latitud*, *longitud*, *nivell de zoom* (*opcional*, els valors vàlids van de 0 a 30).<br>Exemple: `40.6892494,-74.0466891 ,10`.|

en-us	### Parameters  The following parameters are supported for the *Graph (classic)* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Source*|0|source_type|0 - *(default)* Graph;<br>1 - Simple graph.| |*Graph*|6|graphid|[Graph](/manual/api/reference/graph/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source* is set to "Graph"| |*Item*|4|itemid|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source* is set to "Simple graph"| |*Show legend*|0|show_legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Enable host selection*|0|dynamic|0 - *(default)* Disabled;<br>1 - Enabled.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Gràfic (clàssic)*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Font*|0|tipus_font|0 - *(per defecte)* Gràfic;<br>1 - Gràfic simple.| |*Gràfic*|6|graphid|[Gràfic](/manual/api/reference/graph/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori* si *Font* s'ha establert a "Gràfic"| |*Element*|4|itemid|[Element](/manual/api/reference/item/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori* si *Font* s'estableix en "Gràfic simple"| |*Mostra la llegenda*|0|mostra la llegenda|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Activa la selecció d'equip*|0|dynamic|0 - *(per defecte)* Inhabilitat;<br>1 - Activat.|

en-us	### Parameters  The following parameters are supported for the *Graph prototype* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Source*|0|source_type|2 - *(default)* Graph prototype;<br>3 - Simple graph prototype.| |*Graph prototype*|7|graphid|[Graph prototype](/manual/api/reference/graphprototype/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source* is set to "Graph prototype"| |*Item prototype*|5|itemid|[Item prototype](/manual/api/reference/itemprototype/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source* is set to "Simple graph prototype"| |*Show legend*|0|show_legend|0 - Disabled;<br>1 - *(default)* Enabled.| |*Enable host selection*|0|dynamic|0 - *(default)* Disabled;<br>1 - Enabled.| |*Columns*|0|columns|Valid values range from 1-24.<br><br> Default: 2.| |*Rows*|0|rows|Valid values range from 1-16.<br><br> Default: 1.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny *Prototip gràfic*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Font*|0|tipus_font|2 - *(per defecte)* Prototip de gràfic;<br>3 - Prototip de gràfic simple.| |*Prototip de gràfic*|7|grafid|[Prototip de gràfic](/manual/api/reference/graphprototype/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatori* si *Font* s'ha establert a "Prototip de gràfics"| |*Prototip d'element*|5|itemid|[Prototip d'element](/manual/api/reference/itemprototype/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior) :<br>- *obligatori* si *Font* s'ha establert a "Prototip de gràfic simple"| |*Mostra la llegenda*|0|mostra la llegenda|0 - Desactivat;<br>1 - *(per defecte)* Activat.| |*Activa la selecció d'equip*|0|dynamic|0 - *(per defecte)* Inhabilitat;<br>1 - Activat.| |*Columnes*|0|columnes|Els valors vàlids oscil·len entre 1 i 24.<br><br> Per defecte: 2.| |*Fileres*|0|fileres|Els valors vàlids oscil·len entre 1 i 16.<br><br> Per defecte: 1.|

en-us	### Parameters  The following parameters are supported for the *Graph* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *Gràfic*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.|

en-us	### Parameters  The following parameters are supported for the *Host availability* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Host groups*|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Interface type*|0|interface_type|0 - None;<br>1 - Zabbix agent;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>Default: 1, 2, 3, 4 (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Layout*|0|layout|0 - *(default)* Horizontal;<br>1 - Vertical.| |*Show hosts in maintenance*|0|maintenance|0 - *(default)* Disabled;<br>1 - Enabled.|
ca	### Paràmetres  S'admeten els paràmetres següents per al giny *Disponibilitat d'equip*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.| |*Grups d'equips*|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny de tauler per a cada grup d'equips.| |*Tipus d'interfície*|0|tipus_interfície|0 - Cap;<br>1 - Agent Zabbix;<br>2 - SNMP;<br>3 - IPMI;<br>4 - JMX.<br><br>Per defecte. : 1, 2, 3, 4 (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Disposició*|0|disposició|0 - *(per defecte)* Horitzontal;<br>1 - Vertical.| |*Mostra equips en manteniment*|0|manteniment|0 - *(per defecte)* Desactivat;<br>1 - Activat.|

en-us	### Parameters  The following parameters are supported for the *Item value* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Item*|4|itemid|[Item](/manual/api/reference/item/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Show*|0|show|1 - Description;<br>2 - Value;<br>3 - Time;<br>4 - Change indicator.<br><br>Default: 1, 2, 3, 4 (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Enable host selection*|0|dynamic|0 - *(default)* Disabled;<br>1 - Enabled.| |*Advanced configuration*|0|adv_conf|0 - *(default)* Disabled;<br>1 - Enabled.|
ca	### Paràmetres  S'admeten els paràmetres següents per al giny *Valor d'element*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - 15 minuts.| |*Element*|4|itemids|ID de l'[Element](/manual/api/reference/item/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |*Veure*|0|veure|1 - Descripció;<br>2 - Valor;<br>3 - Hora;<br>4 - Indicador de canvi.<br><br>Per defecte. : 1, 2, 3, 4 (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Activar la tria d'equips*|0|dinàmic|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Configuració avançada*|0|adv_conf|0 - *(per defecte)* Desactivat;<br>1 - Activat.|

en-us	### Parameters  The following parameters are supported for the *Map navigation tree* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Show unavailable maps*|1|show_unavailable|0 - *(default)* Disabled;<br>1 - Enabled.| |*Reference*|1|reference|Any string value consisting of 5 characters (e.g. `ABCDE`, `JBPNL`, etc.).<br><br>Parameter *Reference* value is used in the [*Map*](/manual/api/reference/dashboard/widget_fields/map) widget (*Linked widget reference*) for linking with the *Map navigation tree* widget.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*|  The following parameters are supported for configuring map navigation tree elements.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Name*|1|navtree.name.1|Any string value.<br><br>Note: The number in the property name sets the element number.| |*Linked map*|8|navtree.sysmapid.1|[Map](/manual/api/reference/map/get) ID.<br><br>Note: The number in the property name references the element to which the map is linked.| |*Parameters for creating element hierarchy*|0|navtree.parent.1|Parent element number.<br><br>Note: The number in the property name references the child element. The property value references the parent element.| |^|0|navtree.order.1|Element position in the map navigation tree.<br><br>Note: The number in the property name references the element number. The property value references the element position in the map navigation tree. Parent element position is determined within the whole map navigation tree. Child element position is determined within the parent element.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Arbre de navegació del mapa*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.| |*Mostra els mapes no disponibles*|1|show_unavailable|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Referència*|1|referència|Qualsevol valor de cadena que consta de 5 caràcters (p. ex., `ABCDE`, `JBPNL`, etc.).<br><br>El valor del paràmetre *Reference* s'empra al [*Mapa*](/manual/api/reference/dashboard/widget_fields/map) giny (*referència del giny enllaçat*) per enllaçar amb el giny *arbre de navegació del mapa*.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *necessari*|  Els paràmetres següents són compatibles per configurar els elements de l'arbre de navegació del mapa.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Nom*|1|navtree.name.1|Qualsevol valor de cadena.<br><br>Nota: el nombre del nom de la propietat estableix el nombre de l'element.| |*Mapa enllaçat*|8|navtree.sysmapid.1|Identificador de [Mapa](/manual/api/reference/map/get).<br><br>Nota: el nombre del nom de la propietat fa referència a l'element al qual el mapa és enllaçat.| |*Paràmetres per crear la jerarquia d'elements*|0|navtree.parent.1|Número d'element principal.<br><br>Nota: el nombre del nom de la propietat fa referència a l'element secundari. El valor de la propietat fa referència a l'element pare.| |^|0|navtree.order.1|Posició de l'element a l'arbre de navegació del mapa.<br><br>Nota: el nombre del nom de la propietat fa referència al nombre de l'element. El valor de la propietat fa referència a la posició de l'element a l'arbre de navegació del mapa. La posició de l'element pare es determina dins de tot l'arbre de navegació del mapa. La posició de l'element fill es determina dins de l'element pare.|

en-us	### Parameters  The following parameters are supported for the *Map* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Source type*|0|source_type|1 - *(default)* Map;<br>2 - Map navigation tree.| |*Map*|8|sysmapid|[Map](/manual/api/reference/map/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source type* is set to "Map"| |*Linked widget reference*|1|filter_widget_reference|Valid [*Map navigation tree*](/manual/api/reference/dashboard/widget_fields/map_tree) widget parameter *Reference* value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if *Source type* is set to "Map navigation tree"|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Map*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.| |*Tipus de font*|0|tipus_font|1 - *(per defecte)* Mapa;<br>2 - Arbre de navegació del mapa.| |*Mapa*|8|sysmapid|[Mapa](/manual/api/reference/map/get) ID.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori* si *Tipus de font* s'estableix a "Mapa"| |*Referència del giny enllaçat*|1|filter_widget_reference|Valor [*Arbre de navegació del mapa*](/manual/api/reference/dashboard/widget_fields/map_tree) vàlid del paràmetre *Referència* del giny.<br><br>[Comportament del paràmetre] (/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si *Tipus de font* s'estableix a "Arbre de navegació del mapa"|

en-us	### Parameters  The following parameters are supported for the *Plain text* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Items*|4|itemids|[Item](/manual/api/reference/item/get) ID.<br><br>Note: To configure multiple items, create a dashboard widget field object for each item.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Items location*|0|style|0 - *(default)* Left;<br>1 - Top.| |*Show lines*|0|show_lines|Valid values range from 1-100.<br><br>Default: 25.| |*Show text as HTML*|0|show_as_html|0 - *(default)* Disabled;<br>1 - Enabled.| |*Enable host selection*|0|dynamic|0 - *(default)* Disabled;<br>1 - Enabled.|
ca	### Paràmetres  S'admeten els paràmetres següents per al giny *Text pla*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br> 600 - 10 minuts;<br>900 - 15 minuts.| |*Elements*|4|itemids|ID de l'[Element](/manual/api/reference/item/get) ID.<br><br>Veieu que per configurar elements múltiples, cal crear un objecte de camp de giny de tauler per cada element.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |*Ubicació d'elements*|0|estil|0 - *(per defecte)* Esquerra;<br>1 - A dalt.| |*Veure línies*|0|show_lines|Rang vàlid, entre 1-100.<br><br>Per defecte: 25.| |*Veure text com HTML*|0|show_as_html|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Activar la tria d'equips*|0|dinàmic|0 - *(per defecte)* Desactivat;<br>1 - Activat.|

en-us	### Parameters  The following parameters are supported for the *Problem hosts* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Exclude host groups*|<|2|exclude_groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To exclude multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities|0 - Not classified;<br>1 - Information;<br>2 - Warning;<br>3 - Average;<br>4 - High;<br>5 - Disaster.<br><br>Default: empty (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hide groups without problems*|<|0|hide_empty_groups|0 - *(default)* Disabled;<br>1 - Enabled.| |*Problem display*|<|0|ext_ack|0 - *(default)* All;<br>1 - Unacknowledged only;<br>2 - Separated.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Equips amb problemes*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Exclou els grups d'equips*|<|2|exclude_groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per excloure diversos grups d'equips, creeu un camp de giny del tauler objecte per a cada grup d'equips.| |*Equips*|<|3|hostids|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grup d'equips* no s'ha de configurar pas o bé s'ha de configurar amb almenys un grup d'equips al qual pertanyen els equips configurats.| |*Problema*|<|1|problema|Problema [nom de l'esdeveniment](/manual/config/triggers/trigger#configuration) (no distingeix entre majúscules i minúscules, nom complet o part).| |*Gravetat*|<|0|gravetats|0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>Per defecte: buit (totes activades).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |*Ensenya els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Amaga els grups sense problemes*|<|0|hide_empty_groups|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Visualització del problema*|<|0|ext_ack|0 - *(per defecte)* Tots;<br>1 - Només no reconegut;<br>2 - Separat.|

en-us	### Parameters  The following parameters are supported for the *Problems by severity* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Exclude host groups*|<|2|exclude_groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To exclude multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities|0 - Not classified;<br>1 - Information;<br>2 - Warning;<br>3 - Average;<br>4 - High;<br>5 - Disaster.<br><br>Default: empty (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show*|<|0|show_type|0 - *(default)* Host groups;<br>1 - Totals.| |*Layout*|<|0|layout|0 - *(default)* Horizontal;<br>1 - Vertical.<br><br>Parameter *Layout* not available if *Show* is set to "Host groups".| |*Show operational data*|<|0|show_opdata|0 - *(default)* None;<br>1 - Separately;<br>2 - With problem name.| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hide groups without problems*|<|0|hide_empty_groups|0 - *(default)* Disabled;<br>1 - Enabled.<br><br>Parameter *Hide groups without problems* not available if *Show* is set to "Totals".| |*Problem display*|<|0|ext_ack|0 - *(default)* All;<br>1 - Unacknowledged only;<br>2 - Separated.| |*Show timeline*|<|0|show_timeline|0 - Disabled;<br>1 - *(default)* Enabled.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Problemes per gravetat*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Exclou els grups d'equips*|<|2|exclude_groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per excloure diversos grups d'equips, creeu un camp de giny del tauler objecte per a cada grup d'equips.| |*Equips*|<|3|hostids|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.| |*Problema*|<|1|problem|Problema [nom de l'esdeveniment](/manual/config/triggers/trigger#configuration) (no distingeix entre majúscules i minúscules, nom complet o part del nom).| |*Gravetat*|<|0|severities|0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>Per defecte: buit (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'ha configurat *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'ha configurat *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'ha configurat *Etiquetes*| |*Visualització*|<|0|show_type|0 - *(per defecte)* Grups d'equips;<br>1 - Totals.| |*Disposició*|<|0|disposició|0 - *(per defecte)* Horitzontal;<br>1 - Vertical.<br><br>El paràmetre *Disposició* no està disponible si *Visualització* està establert a "Grups d'equips" .| |*Veure les dades operatives*|<|0|show_opdata|0 - *(per defecte)* Cap;<br>1 - Per separat;<br>2 - Amb el nom del problema.| |*Veure els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Amaga els grups sense problemes*|<|0|hide_empty_groups|0 - *(per defecte)* Desactivat;<br>1 - Activat.<br><br>Paràmetre *Amaga els grups sense problemes* no disponible si *Visualització* s'ha establert a "Totals".| |*Visualització del problema*|<|0|ext_ack|0 - *(per defecte)* Tots;<br>1 - Només no reconegut;<br>2 - Separat.| |*Veure la línia de temps*|<|0|veure la línia de temps|0 - Desactivat;<br>1 - *(per defecte)* Activat.|

en-us	### Parameters  The following parameters are supported for the *Problems* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Show*|<|0|show|1 - *(default)* Recent problems;<br>2 - History;<br>3 - Problems.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Exclude host groups*|<|2|exclude_groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To exclude multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Problem*|<|1|problem|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Severity*|<|0|severities|0 - Not classified;<br>1 - Information;<br>2 - Warning;<br>3 - Average;<br>4 - High;<br>5 - Disaster.<br><br>Default: empty (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show tags*|<|0|show_tags|0 - *(default)* None;<br>1 - 1;<br>2 - 2;<br>3 - 3.| |*Tag name* (format)|<|0|tag_name_format|0 - *(default)* Full;<br>1 - Shortened;<br>2 - None.<br><br>Parameter *Tag name* (format) not available if *Show tags* is set to "None".| |*Tag display priority*|<|1|tag_priority|Comma-separated list of tags.<br><br>Parameter *Tag display priority* not available if *Show tags* is set to "None".| |*Show operational data*|<|0|show_opdata|0 - *(default)* None;<br>1 - Separately;<br>2 - With problem name.| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Show unacknowledged only*|<|0|unacknowledged|0 - *(default)* Disabled;<br>1 - Enabled.| |*Sort entries by*|<|0|sort_triggers|1 - Severity (descending);<br>2 - Host (ascending);<br>3 - Time (ascending);<br>4 - *(default)* Time (descending);<br>13 - Severity (ascending);<br>14 - Host (descending);<br>15 - Problem (ascending);<br>16 - Problem (descending).<br><br>For all values, except "Time (descending)" and "Time (ascending)", the parameter *Show timeline* must be set to "Disabled".| |*Show timeline*|<|0|show_timeline|0 - Disabled;<br>1 - *(default)* Enabled.<br><br>Parameter *Show timeline* available if *Sort entries by* is set to "Time (descending)" or "Time (ascending)".| |*Show lines*|<|0|show_lines|Valid values range from 1-100.<br><br>Default: 25.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Problemes*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Visualització*|<|0|mostra|1 - *(per defecte)* Problemes recents;<br>2 - Historial;<br>3 - Problemes.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Exclou els grups d'equips*|<|2|exclude_groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per excloure diversos grups d'equips, creeu un camp de giny del tauler objecte per a cada grup d'equips.| |*Equips*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.| |*Problema*|<|1|problema|Problema [nom de l'esdeveniment](/manual/config/triggers/trigger#configuration) (no distingeix entre majúscules i minúscules, nom complet o part).| |*Gravetat*|<|0|gravetats|0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>Per defecte: buit (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |*Veure etiquetes*|<|0|mostra_etiquetes|0 - *(per defecte)* Cap;<br>1 - 1;<br>2 - 2;<br>3 - 3.| |*Nom de l'etiqueta* (format)|<|0|nom_etiqueta_format|0 - *(per defecte)* Complet;<br>1 - Escurçat;<br>2 - Cap.<br><br>Paràmetre *Nom de l'etiqueta* (format) no disponible si *Veure les etiquetes* és establert a "Cap".| |*Prioritat de visualització de l'etiqueta*|<|1|tag_priority|Llistat d'etiquetes separades per comes.<br><br>El paràmetre *Prioritat de visualització de l'etiqueta* no és disponible si *Veure les etiquetes* s'estableix en "Cap".| |*Veure les dades operatives*|<|0|show_opdata|0 - *(per defecte)* Cap;<br>1 - Per separat;<br>2 - Amb el nom del problema.| |*Veure els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Veure només els no reconeguts*|<|0|no reconeguts|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Ordena les entrades per*|<|0|sort_triggers|1 - Gravetat (descendent);<br>2 - Equip (ascendent);<br>3 - Temps (ascendent);<br>4 - *(per defecte)* Temps (descendent);<br>13 - Gravetat (ascendent);<br>14 - Equip (descendent);<br>15 - Problema (ascendent);<br>16 - Problema (descendent).<br><br >Per a tots els valors, excepte "Time (descendent)" i "Time (ascendent)", el paràmetre *Veure la línia de temps* s'ha d'establir a "Desactivat".| |*Veure la cronologia*|<|0|show_timeline|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.<br><br>El paràmetre *Veure la cronologia* és disponible si *Ordena les entrades per* és establert a "Temps (descendent)" o "Temps (ascendent)".| |*Veure les línies*|<|0|mostra les línies|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 25.|

en-us	### Parameters  The following parameters are supported for the *SLA report* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - *(default)* No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*SLA*|10|slaid|[SLA](/manual/api/reference/sla/get) ID.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Service*|9|serviceid|[Service](/manual/api/reference/service/get) ID.| |*Show periods*|0|show_periods|Valid values range from 1-100.<br><br>Default: 20.| |*From*|1|date_from|Valid date string in format `YYYY-MM-DD`.<br>[Relative dates](/manual/config/visualization/graphs/simple#time-period-selector) with modifiers `d`, `w`, `M`, `y` (e.g. `now`, `now/d`, `now/w-1w`, etc.) are supported.| |*To*|1|date_to|Valid date string in format `YYYY-MM-DD`.<br>[Relative dates](/manual/config/visualization/graphs/simple#time-period-selector) with modifiers `d`, `w`, `M`, `y` (e.g. `now`, `now/d`, `now/w-1w`, etc.) are supported.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *informe SLA*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|------|-------------------| |*Interval d'actualització*|0|rf_rate|0 - *(per defecte)* Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*SLA*|10|slaid|ID d'[SLA](/manual/api/reference/sla/get).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):< br>- *obligatori*| |*Servei*|9|serviceid|ID del [servei](/manual/api/reference/service/get).| |*Veure els períodes*|0|show_periods|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 20.| |*Des de*|1|date_from|Cadena de data vàlida en format `AAAA-MM-DD`.<br>[Dates relatives](/manual/config/visualization/graphs/simple#time-period-selector) amb modificadors `d`, `w`, `M`, `y` (per exemple, `now`, `now/d`, `now/w-1w`, etc.) són compatibles.| |*A*|1|date_to|Cadena de data vàlida en format `AAAA-MM-DD`.<br>[Dates relatives](/manual/config/visualization/graphs/simple#time-period-selector) amb modificadors `d`, `w`, `M`, `y` (per exemple, `now`, `now/d`, `now/w-1w`, etc.) són compatibles.|

en-us	### Parameters  The following parameters are supported for the *System Information* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - *(default)* 15 minutes.| |*Show*|0|info_type|0 - *(default)* System stats;<br>1 - High availability nodes.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *Informació de sistema*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - *(per defecte)* 15 minuts.| |*Veure*|0|info_type|0 - *(per defecte)* Estat del sistema;<br>1 - Nodes d'alta disponibilitat.|

en-us	### Parameters  The following parameters are supported for the *Top hosts* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Host Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Columns* (see below)|<|<|<|<| |*Order*|<|0|order|2 - *(default)* Top N;<br>3 - Bottom N.| |*Order column*|<|0|column|Column numeric value from the configured columns.| |*Host count*|<|0|count|Valid values range from 1-100.<br><br>Default: 10.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Equips Top*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Equips*|<|3|hostids|ID d'[equip](/manual/api/reference/host/get).<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grups d'equips* no s'ha de configurar pas o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.| |*Etiquetes d'equips* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |*Columnes* (veieu més avall)|<|<|<|<| |*Ordre*|<|0|ordre|2 - *(per defecte)* N superior;<br>3 - N. inferior| |*Columna d'ordre*|<|0|columna|Valor numèric de la columna de les columnes configurades.| |*Recompte d'equips*|<|0|recompte|Els valors vàlids oscil·len entre 1 i 100.<br><br>Per defecte: 10.|

en-us	### Parameters  The following parameters are supported for the *Trigger Overview* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Show*|<|0|show|1 - *(default)* Recent problems;<br>2 - Any;<br>3 - Problems.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show suppressed problems*|<|0|show_suppressed|0 - *(default)* Disabled;<br>1 - Enabled.| |*Hosts location*|<|0|style|0 - *(default)* Left;<br>1 - Top.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Visió general del trigger*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Mostra*|<|0|mostra|1 - *(per defecte)* Problemes recents;<br>2 - Qualsevol;<br>3 - Problemes.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Equips*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equip, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grup d'equips* no s'ha de configurar en absolut o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |*Mostra els problemes esborrats*|<|0|show_suppressed|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Ubicació de l'equip*|<|0|estil|0 - *(per defecte)* Esquerra;<br>1 - Amunt.|

en-us	### Parameters  The following parameters are supported for the *URL* widget.  |Parameter|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-----|-|-----|-------------------| |*Refresh interval*|0|rf_rate|0 - *(default)* No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*URL*|1|url|Valid URL string.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required*| |*Enable host selection*|0|dynamic|0 - *(default)* Disabled;<br>1 - Enabled.|
ca	### Paràmetres  Els paràmetres següents s'admeten al giny de *URL*.  |Paràmetre|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-----|-|-----|-------------------| |*Interval de refresc*|0|rf_rate|0 - *(per defecte)* Sense refresc;<br>10 - 10 segonds;<br>30 - 30 segonds;<br>60 - 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*URL*|1|url|Cadena URL vàlida.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori*| |*Activar la tria d'equip*|0|dinàmic|0 - *(per defecte)* Desactivat;<br>1 - Activat.|

en-us	### Parameters  The following parameters are supported for the *Web monitoring* widget.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Refresh interval*|<|0|rf_rate|0 - No refresh;<br>10 - 10 seconds;<br>30 - 30 seconds;<br>60 - *(default)* 1 minute;<br>120 - 2 minutes;<br>600 - 10 minutes;<br>900 - 15 minutes.| |*Host groups*|<|2|groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To configure multiple host groups, create a dashboard widget field object for each host group.| |*Exclude host groups*|<|2|exclude_groupids|[Host group](/manual/api/reference/hostgroup/get) ID.<br><br>Note: To exclude multiple host groups, create a dashboard widget field object for each host group.| |*Hosts*|<|3|hostids|[Host](/manual/api/reference/host/get) ID.<br><br>Note: To configure multiple hosts, create a dashboard widget field object for each host. For multiple hosts, the parameter *Host groups* must either be not configured at all or configured with at least one host group that the configured hosts belong to.| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |*Show hosts in maintenance*|<|0|maintenance|0 - Disabled;<br>1 - *(default)* Enabled.|
ca	### Paràmetres  Els paràmetres següents són compatibles amb el giny *Monitoratge web*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Interval d'actualització*|<|0|rf_rate|0 - Sense actualització;<br>10 - 10 segons;<br>30 - 30 segons;<br>60 - *(per defecte)* 1 minut;<br>120 - 2 minuts;<br>600 - 10 minuts;<br>900 - 15 minuts.| |*Grups d'equips*|<|2|groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per configurar diversos grups d'equips, creeu un objecte de camp de giny del tauler de control per a cada grup d'equips.| |*Exclou els grups d'equips*|<|2|exclude_groupids|[Grup d'equips](/manual/api/reference/hostgroup/get) ID.<br><br>Nota: per excloure diversos grups d'equips, creeu un camp de giny del tauler objecte per a cada grup equips.| |*Equips*|<|3|hostids|[Equip](/manual/api/reference/host/get) ID.<br><br>Nota: per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip. Per a diversos equips, el paràmetre *Grup d'equips* no s'ha de configurar en absolut o bé s'ha de configurar com a mínim amb un grup d'equips al qual pertanyen els equips configurats.| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si s'és configurant *Etiquetes*| |*Mostra equips en manteniment*|<|0|manteniment|0 - Desactivat;<br>1 - *(per defecte)* Habilitat.|

en-us	### Parameters  The method accepts the following parameters.  |Parameter|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |extend|boolean|Whether to prolong the user session.<br><br>Default value: "true".<br>Setting the value to "false" allows to check the user session without prolonging it.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *supported* if `sessionid` is set| |sessionid|string|User [authentication token](/manual/api#authentication).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `token` is not set| |secret|string|Random 32 characters string. Is generated on user login.| |token|string|User [API token](/manual/api#authentication).<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if `sessionid` is not set|
ca	### Paràmetres  El mètode admet els paràmetres següents.  |Paràmetre|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |extend|booleà|Si s'ha de perllongar la sessió de l'usuari.<br><br>Valor per defecte: "cert".<br>Ajustar el valor a "fals" permet comprovar la sessió de l'usuari sense allargar-la.<br><br >[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *admès* si `sessionid` és establert| |sessionid|cadena|Usuari [token d'autenticació](/manual/api#authentication).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si `token` no s'ha establert| |secret|cadena|Cadena aleatòria de 32 caràcters. Es genera a l'inici de sessió de l'usuari.| |token|cadena|Usuari [token API](/manual/api#authentication).<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si `sessionid` no s'ha establert|

en-us	#### Parameter - unquoted string  If the key parameter is an unquoted string, any Unicode character is allowed except comma and right square bracket (\]). Unquoted parameter cannot start with left square bracket (\[).  ![](../../../../../assets/en/manual/config/key_param_unquoted_string.png)
ca	#### Paràmetre - cadena sense cometes  Si el paràmetre clau és una cadena sense cometes, es permet qualsevol caràcter Unicode excepte la coma i el claudàtor dret (\]). El paràmetre sense cometes no pot començar amb el claudàtor esquerre (\[).  ![](../../../../../assets/fr/manual/config/items/item/key_param_unquoted_string.png)

en-us	 ### Part 1: Writing the Go code  In this section you will learn how to write the plugin that adds a new metric to Zabbix agent 2.  1. Create a new directory *myip* in */usr/local/zabbix/go/plugins/*.  2. Create the file *main.go* inside *myip* directory and define the name of your Go package.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main ```  ::: notetip Keep the file open to add more lines as described in the next steps. :::  3. Specify the packages to import.   These are the packages that support the plugin.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" ) ```  4. Define the plugin structure.   Embed the *plugin.Base* structure to gain access to the standard plugin functionality.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {     plugin.Base }         var impl Plugin ```  5. Implement plugin interface [Export](/devel/plugins/interfaces).   The Export interface performs a poll and returns a value.   **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {     plugin.Base }         var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ```  6. Add logging.   Log messages will appear in the Zabbix agent 2 log. You can use one of the logging functions available to plugins: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {     plugin.Base }         var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ```  7. Implement the core plugin logic.   This logic fetches the response from the specified URL and reads it, then returns the IP address as a response and closes the request.   In case of an error when executing the GET request or reading a response, the error is returned instead.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {     plugin.Base }         var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params))     resp, err := http.Get("https://api.ipify.org")     if err != nil {         return nil, err     }             defer resp.Body.Close()             body, err := ioutil.ReadAll(resp.Body)     if err != nil {         return nil, err     }             return string(body), nil     } ```  8. Register the metric.   Zabbix agent 2 initiates running *init()* function upon startup.  This function will call *plugin.RegisterMetrics(structure, plugin name, metric name, description)* method to get the plugin data.   The *plugin.RegisterMetrics* method parameter description:   - **structure** - a pointer to plugin implementation; grants access to the plugin structure, including list of available plugin interfaces (for example, *&impl*). - **name** - plugin name; must be unique (for example, *"Myip"*). - **metric name** - metric name (for example, *"myip"*). This is the item key used to gather data from a plugin.  - **description** - metric description; must start with a capital letter and end with a period    (for example, *""Return the external IP address of the host where agent is running."*).  ::: notetip To register several metrics, repeat the parameters **metric name** and **description** for each metric.   For example: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Metric one description.", "metric.two", "Metric two description.")` :::  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {     plugin.Base }         var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params))     resp, err := http.Get("https://api.ipify.org")     if err != nil {         return nil, err     }             defer resp.Body.Close()             body, err := ioutil.ReadAll(resp.Body)     if err != nil {         return nil, err     }             return string(body), nil     }  func init() {     plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") } ```  9. Define the *main()* function, which will create a new plugin handler instance, assign it to be used for logging by the plugin and then execute the plugin handler.    ::: noteimportant Defining the *main()* function is mandatory.  :::  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {     plugin.Base }         var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params))     resp, err := http.Get("https://api.ipify.org")     if err != nil {         return nil, err     }             defer resp.Body.Close()             body, err := ioutil.ReadAll(resp.Body)     if err != nil {         return nil, err     }             return string(body), nil     }  func init() {     plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.") }  func main() {     h, err := container.NewHandler(impl.Name())     if err != nil {         panic(fmt.Sprintf("failed to create plugin handler %s", err.Error()))     }     impl.Logger = &h             err = h.Execute()     if err != nil {         panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error()))     } } ```
ca	### Part 1: Escrivint el codi Go  En aquesta secció aprendreu a escriure el codi del connector que afegeix una mètrica nova a l'agent Zabbix 2.  1. Creeu un directori nou *myip* a */usr/local/zabbix/go/plugins/*.  2. Creeu el fitxer *main.go* dins del directori *myip* i definiu el nom del vostre paquet Go.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main ```  ::: notetip Mantingueu el fitxer obert per afegir més línies tal com es descriu a les passes següents. :::  3. Especifiqueu els paquets que voleu importar. Aquests són els paquets que admeten el connector.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" ) ```  4. Definiu l'estructura del plugin. Incorporeu l'estructura *plugin.Base* per accedir a la funcionalitat estàndard del plugin.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {            plugin.Base        }                var impl Plugin ```  5. Implementació de la interfície [Export](/devel/plugins/interfaces) del plugin. La interfície Export fa una enquesta i retorna un valor.   **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {            plugin.Base        }                var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error) ```  6. Afegir registre d'esdeveniments. El registre de missatges apareixerà al registre de l'agent 2 de Zabbix agent. Podeu emprar una de les funcions de registre disponible per als plugins: *Critf()*, *Errf()*, *Infof()*, *Warningf()*, *Debugf()*, *Tracef()*.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {            plugin.Base        }                var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params)) } ```  7.Implementeu la lògica del plugin bàsic. Aquesta lògica obté la resposta de l'URL especificat i la llegeix, després retorna l'adreça IP com a resposta i tanca la petició. En cas d'error en executar la consulta GET o llegir una resposta, retorna l'error.  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {            plugin.Base        }                var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params))     resp, err := http.Get("https://api.ipify.org")     if err != nil {         return nil, err     }             defer resp.Body.Close()             body, err := ioutil.ReadAll(resp.Body)     if err != nil {         return nil, err     }             return string(body), nil     } ```  8. Registreu la mètrica. L'agent Zabbix 2 inicia l'execució de la funció *init()* a l'inici. Aquesta funció cridarà al mètode *plugin.RegisterMetrics (estructura, nom del plugin, nom de mètrica, descripció)* per obtindre les dades del plugin.  Descripció del paràmetre del mètode *plugin.RegisterMetrics*:  - **estructura** - un punter a la implementació del plugin; concedeix accés a l'estructura del plugin, inclosa la llista d'interfícies de plugins disponibles (per exemple, *&impl*). - **nom** - nom del plugin; ha de ser únic (per exemple, *"Myip"*). - **nom de la mètrica** - nom de la mètrica (per exemple, *"myip"*). Aquesta és la clau d'element que s'empra per recopilar dades d'un plugin. - **descripció** - descripció mètrica; ha de començar amb majúscula i acabar amb un punt (per exemple, *""Retorna l'adreça IP externa de l'equip on s'executa l'agent."*).  ::: notetip Per registrar diverses mètriques, repetiu els paràmetres **nom de la mètrica** i **descripció** per a cada mètrica. Per exemple: `plugin.RegisterMetrics(&impl, "Myip", "metric.one", "Metric one description.", "metric.two", "metric two description.")` :::  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {            plugin.Base        }                var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params))     resp, err := http.Get("https://api.ipify.org")     if err != nil {         return nil, err     }             defer resp.Body.Close()             body, err := ioutil.ReadAll(resp.Body)     if err != nil {         return nil, err     }             return string(body), nil     }  func init() {            plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.")        } ```  9. Definiu la funció *main()*, que implementarà el gestor del plugin Zabbix per crear i iniciar el plugin.    ::: noteimportant És obligatori definir aquesta funció.  :::  **/usr/local/zabbix/go/plugins/myip/main.go**  ```go package main  import (     "fmt"     "io/ioutil"     "net/http"     "git.zabbix.com/ap/plugin-support/plugin/container"     "git.zabbix.com/ap/plugin-support/plugin" )  type Plugin struct {            plugin.Base        }                var impl Plugin  func (p *Plugin) Export(key string, params []string, ctx plugin.ContextProvider) (result interface{}, err error){     p.Infof("received request to handle %s key with %d parameters", key, len(params))     resp, err := http.Get("https://api.ipify.org")     if err != nil {         return nil, err     }             defer resp.Body.Close()             body, err := ioutil.ReadAll(resp.Body)     if err != nil {         return nil, err     }             return string(body), nil     }  func init() {            plugin.RegisterMetrics(&impl, "Myip", "myip", "Return the external IP address of the host where agent is running.")        }  func main() {            h, err := container.NewHandler(impl.Name())            if err != nil {                panic(fmt.Sprintf("failed to create plugin handler %s", err.Error()))            }            impl.Logger = &h                    err = h.Execute()            if err != nil {                panic(fmt.Sprintf("failed to execute plugin handler %s", err.Error()))            }        } ```

en-us	 ### Part 2: Building the plugin  In this section you will learn how to compile the plugin.   1. To create Go files for dependency handling and download the dependencies automatically execute this bash script from the CLI (make sure to specify correct branch name in the line 3 `go get...`).  ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@branchname go mod tidy go build ```  **Make sure** to specify the correct branch name, i.e. replace `branchname` (see Line 2) with one of the following:   -   `release/*` - for the stable release branch, where "\*" is the release version (i.e. `6.4`) -   `master` - for the master branch -   `<commit hash>` - for the specific commit version (use the specific commit hash)  The output should be similar to this:  ```go go: creating new go.mod: module myip go: to add module requirements and sums:     go mod tidy go: finding module for package git.zabbix.com/ap/plugin-support/plugin/container go: finding module for package git.zabbix.com/ap/plugin-support/plugin go: found git.zabbix.com/ap/plugin-support/plugin in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 go: found git.zabbix.com/ap/plugin-support/plugin/container in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 ```  2. Create an executable *myip* for the loadable plugin.   3. Specify the path to the plugin configuration file in the *Plugins.Myip.System.Path* parameter of Zabbix agent 2 configuration file.    ::: noteimportant Plugin name in the configuration parameter name (*Myip* in this tutorial) must match the plugin name defined in the *plugin.RegisterMetrics()* function. :::  ```bash echo 'Plugins.Myip.System.Path=/usr/local/zabbix/go/plugins/myip/myip' > /etc/zabbix_agent2.d/plugins.d/myip.conf ```  4. Test the metric:  ```bash zabbix_agent2 -t myip ```  The response should contain an external IP address of your host.  ::: notetip In case of an error, check whether the user *zabbix* has permissions to access */usr/local/zabbix/go/plugins/myip* directory. :::
ca	### Part 2: Muntant el plugin  En aquesta secció aprendreu a compilar el plugin.   1. Per crear arxius Go per gestionar i descarregar dependències automàticament, executeu aquest script de bash des de CLI (assegureu-vos d'especificar correctament el nom de la branca a la línia 3 `go get...`).  ```bash go mod init myip GOPROXY=direct go get git.zabbix.com/ap/plugin-support/plugin@release/6.4 go mod tidy go build ```  La sortida s'assemblarà a:  ```go go: creating new go.mod: module myip go: to add module requirements and sums:     go mod tidy go: finding module for package git.zabbix.com/ap/plugin-support/plugin/container go: finding module for package git.zabbix.com/ap/plugin-support/plugin go: found git.zabbix.com/ap/plugin-support/plugin in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 go: found git.zabbix.com/ap/plugin-support/plugin/container in git.zabbix.com/ap/plugin-support v0.0.0-20220608100211-35b8bffd7ad0 ```  2. Creeu un executable *myip* per al plugin carregable.  3. Especifiqueu la ruta del fitxer de configuració del plugin al paràmetre *Plugins.Myip.System.Path* del fitxer de configuració de l'agent 2 del Zabbix.  ::: noteimportant El nom del plugin al nom del paràmetre de configuració (*Myip* en aquest tutorial) ha de coincidir amb el nom del plugin definit a la funció *plugin.RegisterMetrics()*. :::  ```bash echo 'Plugins.Myip.System.Path=/usr/local/zabbix/go/plugins/myip/myip' > /etc/zabbix_agent2.d/plugins.d/myip.conf ```  4. Proveu la mètrica:  ```bash zabbix_agent2 -t myip ```  La resposta ha de contindre una adreça IP externa del vostre equip.  ::: notetip En cas d'error, comproveu si l'usuari *zabbix* té permisos per accedir al directori */usr/local/zabbix/go/plugins/myip*. :::

en-us	## Part I - "Hello, world!"  In this section you will learn how to create the minimum required widget elements and add a new widget to Zabbix frontend.
ca	## Part I - "Hola, món!"   En aquesta secció aprendreu a crear els elements mínims de giny necessaris i afegir un nou giny a la interfície Zabbix.

en-us	 ## Part II - Gauge chart
ca	## Part II - Gràfic de mesura

en-us	### Part III - Module action  An action is implemented in two files - *actions/MyAddress.php* and *views/my.address.php*. The ***actions/MyAddress.php*** file takes care of the business logic implementation, while the ***views/my.address.php*** file is responsible for the view.  1. Create a directory *actions* in the *MyAddress* directory.  2. Create a *MyAddress.php* file in the *actions* directory.  The action logic will be defined in the *MyAddress* class. This action class will implement four functions: *init()*, *checkInput()*, *checkPermissions()*, and *doAction()*. Zabbix frontend calls the *doAction()* function when the action is requested. This function is responsible for the business logic of the module.  ::: noteimportant The data must be organized as an associative array. The array can be multidimensional and may contain any data expected by the view. :::  **ui/modules/MyAddress/actions/MyAddress.php**  ```php <?php  namespace Modules\MyAddress\Actions;  use CController,     CControllerResponseData;  class MyAddress extends CController {      public function init(): void {         $this->disableCsrfValidation();     }      protected function checkInput(): bool {         return true;     }      protected function checkPermissions(): bool {         return true;     }      protected function doAction(): void {         $data = ['my-ip' => file_get_contents("https://api.seeip.org")];         $response = new CControllerResponseData($data);         $this->setResponse($response);     } } ```  3. Create a new directory *views* in the *MyAddress* directory.  4. Create a *my.address.php* file in the *views* directory and define the module view.  Note that the variable `$data` is available in the view without specifically defining it. The framework automatically passes the associative array to the view.  **ui/modules/MyAddress/views/my.address.php**  ```php <?php  (new CHtmlPage())     ->setTitle(_('The HTML Title of My Address Page'))     ->addItem(new CDiv($data['my-ip']))     ->show(); ```  5. The module action has to be registered in the *manifest.json* file. Open *manifest.json* and add a new object `actions` that contains:  -   the action key with the action name written in lowercase (a-z) and with words separated by dots (for example, `my.address`); -   the action class name (`MyAddress`) as a value for the `class` key of the `my.address` object; -   the action view name (`my.address`) as a value for the `view` key of the `my.address` object.  **ui/modules/MyAddress/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "my-address",     "name": "My IP Address",     "version": "1.0",     "namespace": "MyAddress",     "description": "My External IP Address",     "actions": {         "my.address": {             "class": "MyAddress",             "view": "my.address"         }     } } ```  6. Open *Module.php* and change the action name in the **setAction()** method to *my.address*.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenuItem;  class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->findOrAdd(_('Monitoring'))                 ->getSubmenu()                     ->insertAfter(_('Discovery'),                         (new CMenuItem(_('My Address')))->setAction('my.address')                     );     } } ```  7. Refresh Zabbix frontend. Click on the *My address* menu section to see the IP address of your computer.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_finished.png){width="600"}
ca	## Part III - Acció del mòdul  Una acció s'implementa a 2 fitxers: *actions/MyAddress.php* i *views/my.address.php*. El fitxer **actions/MyAddress.php** s'encarrega de la implementació de la lògica de negoci, mentre que l'arxiu  **views/my.address.php** s'encarrega de la vista.  1. Afegiu un directori *actions* a *MyAddress*.  2. Creeu el fitxer *MyAddress.php* dins del directori *actions*.  L'acció lògica es definirà a la classe *MyAddress*. Aquesta classe d'acció implementarà quatre funcions: **init()**, **checkInput()**, **checkPermissions()**, **doAction()**. El frontend de Zabbix crida a la funció **doAction()** quan es demana l'acció. Aquesta funció és responsable de la lògica de negoci del mòdul.  ::: notewarning Les dades s'han d'organitzar com una matriu associada. La matriu pot ser multidimensional i pot contindre qualsevol dada esperada per la vista. :::  **ui/modules/MyAddress/actions/MyAddress.php**  ```php <?php  namespace Modules\MyAddress\Actions;  use CController, CControllerResponseData;  class MyAddress extends CController {  public function init(): void { $this->disableCsrfValidation(); }  protected function checkInput(): bool { return true; }  protected function checkPermissions(): bool { return true; }  protected function doAction(): void { $data = ['my-ip' => file_get_contents("https://api.seeip.org")]; $response = new CControllerResponseData($data); $this->setResponse($response); } } ```  3. Afegiu el directori *views* a *MyAddress*.  4. Creeu el fitxer *my.address.php* dins del directori *views* i definiu la vista del mòdul.  Tingueu en compte que la variable `$data` és disponible a la vista sense definir-la específicament. El marc passa automàticament la matriu associada a la vista.  **ui/modules/MyAddress/views/my.address.php**  ```php <?php  (new CHtmlPage())     ->setTitle(_('The HTML Title of My Address Page'))     ->addItem(new CDiv($data['my-ip']))     ->show(); ```  5. L'acció s'ha de registrar al *manifest.json*. Obriu *manifest.json* i afegiu un objecte nou `actions` que contingui:  - clau d'acció - nom de l'acció escrit en minúscula [a-z] amb paraules separades per punts (en aquest tutorial, `la meva.adreça`). - nom de classe d'acció (`MyAddress`) sota la clau `class` de l'objecte `my.address`. - nom de visualització d'acció (`my.address`) sota la clau `view` de l'objecte `my.address`.  **ui/modules/MyAddress/manifest.json**  ```json {     "manifest_version": 2.0,     "id": "my-address",     "name": "My IP Address",     "version": "1.0",     "namespace": "MyAddress",     "description": "My External IP Address",     "actions": {         "my.address": {             "class": "MyAddress",             "view": "my.address"         }     } } ```  6. Obriu *Module.php* i canvieu el nom de l'acció al mètode **setAction()** cap a *my.address*.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenuItem;   class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->findOrAdd(_('Monitoring'))                 ->getSubmenu()                     ->insertAfter(_('Discovery'),((new CMenuItem(_('My Address')))                         ->setAction('my.address'))                     );     } } ```  7. Recarregueu la interfície Zabbix. Feu clic al menú "La meva adreça" per veure l'adreça IP del vostre ordinador.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_finished.png){width="600"}

en-us	### Part II - Menu section location change  In this part, you will move the *My Address* menu section to the *Monitoring* section. As a result, users will be able to access two sub-menu pages from the *Monitoring→My Address* menu section.  1. Open and edit the *Module.php* file.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenuItem;  class Module extends CModule {      public function init(): void {         APP::Component()->get('menu.main')             ->findOrAdd(_('Monitoring'))                 ->getSubmenu()                     ->insertAfter(_('Discovery'),                         (new CMenuItem(_('My Address')))->setAction('userprofile.edit')                     );     } } ```  2. Refresh Zabbix frontend. Expand the *Monitoring* menu section and observe that the *My address* section is now located below the *Discovery* section.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_monitoring.png){width="600"}
ca	## Part II - Canvi d'ubicació d'entrada del menú  En aquesta secció, moureu l'entrada del menú *La Meva Adreça* a la secció *Monitoratge*. Ara els usuaris podran accedir a la informació del seu perfil d'usuari des del submenú *Monitoratge→La meva adreça*.  1. Obriu i editeu l'arxiu *Module.php*.  **ui/modules/MyAddress/Module.php**  ```php <?php  namespace Modules\MyAddress;  use Zabbix\Core\CModule,     APP,     CMenuItem,   class Module extends CModule  {     public function init(): void {         APP::Component()->get('menu.main')             ->findOrAdd(_('Monitoring'))                 ->getSubmenu()                     ->insertAfter(_('Discovery'),((new CMenuItem(_('My Address')))                         ->setAction('userprofile.edit'))                     );     } } ```  2. Recarregueu la interfície Zabbix. Amplieu la secció del menú *Monitoratge i observeu* que *La Meva Adreça* ara és sota la secció *Descoberta*.  ![](../../../../assets/en/devel/modules/tutorials/module/my_address_monitoring.png){width="600"}

en-us	### Part I - New menu section
ca	### Part I - Nova secció de menú

en-us	#### Partitioning of periods  The following table demonstrates the arrangement of returned period slices based on combinations of parameters.  ::: noteclassic The returned periods will not precede the first available period based on the effective date of the SLA and will not exceed the current period. :::  |Parameters|   |   |Description| |--|--|--|----| |**period\_from**|**period\_to**|**periods**|   | |-|-|-|Return the last 20 periods.| |-|-|specified|Return the last periods specified by the **periods** parameter.| |-|specified|-|Return the last 20 periods before the specified **period\_to** date.| |-|specified|specified|Return the last periods specified by the **periods** parameter before the specified **period\_to** date.| |specified|-|-|Return the first 20 periods starting with the specified **period\_from** date.| |specified|-|specified|Return the first periods specified by the **periods** parameter starting with the specified **period\_from** date.| |specified|specified|-|Return up to 100 periods within the specified date range.| |specified|specified|specified|Return periods specified by the **periods** parameter within the specified date range.|
ca	#### Partició de períodes  La taula següent mostra la disposició dels segments de període retornats en funció de combinacions de paràmetres.  ::: noteclassic Els períodes retornats no precederan el primer període disponible en funció de la data d'entrada en vigor de l'SLA i no superaran el període actual. :::  |Paràmetres| | |Descripció| |--|--|--|----| |**període\_de**|**període\_a**|**períodes**| | |-|-|-|Retorna els darrers 20 períodes.| |-|-|especificat|Retorna els últims períodes especificats pel paràmetre **períodes**.| |-|especificat|-|Retorna els darrers 20 períodes abans de la data especificada **període\_a**.| |-|especificat|especificat|Retorna els últims períodes especificats pel paràmetre **períodes** abans de la data especificada **període\_a**.| |especificat|-|-|Retorna els primers 20 períodes a partir de la data especificada **període\_a partir de**.| |especificat|-|especificat|Retorna els primers períodes especificats pel paràmetre **períodes** començant per la data especificada **període\_a partir de**.| |especificat|especificat|-|Retorna fins a 100 períodes dins de l'interval de dates especificat.| |especificat|especificat|especificat|Períodes de retorn especificats pel paràmetre **períodes** dins de l'interval de dates especificat.|

en-us	##### Passive and active checks  Passive checks work similarly to Zabbix agent. Active checks support scheduled/flexible intervals and check concurrency within one active server.   ::: noteclassic   By default, after a restart, Zabbix agent 2 will schedule the first data collection for active checks at a conditionally random time within the item's update interval to prevent spikes in resource usage. To perform active checks that do not have *Scheduling* [update interval](/manual/config/items/item/custom_intervals#scheduling-intervals) immediately after the agent restart, set `ForceActiveChecksOnStart` parameter (global-level) or `Plugins.<Plugin name>.System.ForceActiveChecksOnStart` (affects only specific plugin checks) in the [configuration file](/manual/appendix/config/zabbix_agent2). Plugin-level parameter, if set, will override the global parameter. Forcing active checks on start is supported since Zabbix 6.0.2.  :::
ca	##### Comprovacions actives i passives  Les comprovacions passives funcionen de manera similar a l'agent Zabbix. Les comprovacions actives admeten intervals programats/flexibles i comproven la concurrència dins d'un servidor actiu.  ::: noteclassic Per defecte, l'agent Zabbix 2 programarà la primera recollida de dades per a comprovacions actives en un moment condicionalment aleatori dins de l'interval d'actualització de l'element per evitar pics en l'ús dels recursos. Per realitzar comprovacions actives que no tinguin *Scheduling* [intervals d'actualització](/manual/config/items/item/custom_intervals#scheduling-intervals) programats, immediatament després de reiniciar l'agent, configureu el paràmetre `ForceActiveChecksOnStart` (nivell global) o `Plugins .<Nom del connector>.System.ForceActiveChecksOnStart` (afecta només comprovacions específiques del connector) al [fitxer de configuració](/manual/appendix/config/zabbix_agent2). El paràmetre de nivell de connector, si s'estableix, anul·larà el paràmetre global. Forçar comprovacions actives a l'inici és compatible des de Zabbix 6.0.2. :::

en-us	##### Passive and active checks  Zabbix agents can perform passive and active checks.  In a [passive check](/manual/appendix/items/activepassive#passive_checks) the agent responds to a data request. Zabbix server (or proxy) asks for data, for example, CPU load, and Zabbix agent sends back the result.  [Active checks](/manual/appendix/items/activepassive#active_checks) require more complex processing. The agent must first retrieve a list of items from Zabbix server for independent processing. Then it will periodically send new values to the server.  Whether to perform passive or active checks is configured by selecting the respective monitoring [item type](/manual/config/items/itemtypes/zabbix_agent). Zabbix agent processes items of type 'Zabbix agent' or 'Zabbix agent (active)'.
ca	##### Verificacions passives i actives  Els agents Zabbix poden fer verificacions passives i actives.  En una [verificació passiva](/manual/appendix/items/activepassive#passive_checks), l'agent respon a una petició de dades. El servidor Zabbix (o el proxy) demana informació, per exemple, la càrrega de processador, i l'agent Zabbix retorna el resultat.  Les [verificacions actives](/manual/appendix/items/activepassive#active_checks) necessiten un tractament més complexe. L'agent ha de recuperar primer una llista d'elements del servidor Zabbix per un tractament independent. Després, enviarà periòdicament nous valors al servidor.  Triar entre verificacions passives o actives es configura escollint un [tipus d'element](/manual/config/items/itemtypes/zabbix_agent). L'agent Zabbix tracta els elements de tipus 'Agent Zabbix' o 'Agent Zabbix (actiu)'.

en-us	### Passive checks
ca	 ### Comprovacions passives

en-us	 ### Passive checks
ca	 ### Comprovacions passives

en-us	#### Passive checks  A passive check is a simple data request. Zabbix server or proxy asks for some data (for example, CPU load) and Zabbix agent sends back the result to the server.  **Server request**  For definition of header and data length please refer to [protocol details](/manual/appendix/protocols/header_datalen).      <item key>  **Agent response**      <DATA>[\0<ERROR>]  Above, the part in square brackets is optional and is only sent for not supported items.  For example, for supported items:  1.  Server opens a TCP connection 2.  Server sends **<HEADER><DATALEN>agent.ping** 3.  Agent reads the request and responds with     **<HEADER><DATALEN>1** 4.  Server processes data to get the value, '1' in our case 5.  TCP connection is closed  For not supported items:  1.  Server opens a TCP connection 2.  Server sends **<HEADER><DATALEN>vfs.fs.size\[/nono\]** 3.  Agent reads the request and responds with     **<HEADER><DATALEN>ZBX\_NOTSUPPORTED\\0Cannot obtain     filesystem information: \[2\] No such file or directory** 4.  Server processes data, changes item state to not supported with the     specified error message 5.  TCP connection is closed
ca	#### Verificacions passives  Una verificació passiva és una petició simple de dades. El servidor o el proxy Zabbix demanen dades (per exemple, la càrrega del processador) i l'agent Zabbix retorna el resultat al sevidor.  \*\*Petició del servidor \*\*  Per la definició de l'encapçalament i la longitud de les dades, veieu els [détalls del protocol](/manual/appendix/protocols/header_datalen).   <item key>  **Respossta de l'agent**   <DATA>[\0<ERROR>]  A sota, la part en claudàtors és opcional i només s'envia per als elements no admesos.  Per exemple, per elements admesos:  1. El servidor obre una connexió TCP 2. El servidor envia **<HEADER><DATALEN>agent.ping** 3. L'agent llegeix la petició i respon amb **<HEADER><DATALEN>1** 4. El servidor tracta les dades per obtindre el valor, '1' en el nostre cas 5. Es tanca la connexió TCP  Per els elements no admesos:  1. El servidor obre una connexió TCP 2. El servidor envia **<HEADER><DATALEN>vfs.fs.size\[/nono\]** 3. L'agent llegeix la petició i respon amb **<HEADER><DATALEN>ZBX\_NOTSUPPORTED\\0Cannot obtain filesystem information: \[2\] No such file or directory** 4. El servidor tracta les dades i modifica l'estat de l'element a no suportat, amb el missatge d'error especificat. 5. Es tanca la connexió TCP

en-us	#### Passive proxy
ca	#### Proxy passiu

en-us	##### Passphrase authentication  SSH checks provide two authentication methods - a user/password pair and key-file based.  If you do not intend to use keys, no additional configuration is required, besides linking libssh or libssh2 to Zabbix, if you're building from source.
ca	##### Autenticació per frase de pas  Les verificacions SSH tenen dos mètodes d'autenticació - una parella usuari/mot de pas i un fitxer clau.  Si no teniu pas intenció d'emprar les claus, no cal pas vincular cap altra configuració addicional de la libssh o libssh2 a Zabbix, si instal·leu des dels orígens.

en-us	#### Path syntax  The symbols forward slash ("/") and colon (":") are reserved.  A forward slash can only be used to separate a mount point from a path (e.g., *secret/zabbix* where the mount point is "secret" and the path is "zabbix"). In the case of Vault macros, a colon can only be used to separate a path/query from a key.  It is possible to URL-encode the forward slash and colon symbols if there is a need to create a mount point with the name that is separated by a forward slash (e.g., *foo/bar/zabbix*, where the mount point is "foo/bar" and the path is "zabbix", can be encoded as "foo%2Fbar/zabbix") and if a mount point name or path need to contain a colon.
ca	#### Sintaxi de la ruta  Els símbols barra inclinada ("/") i dos punts (":") són reservats.  Una barra inclinada només es pot emprar per separar un punt de muntatge d'un camí (per exemple, *secret/zabbix* on el punt de muntatge és "secret" i "zabbix" és el camí) i, en el cas de les macros de Vault, els dos punts només poden emprar-se per separar una ruta/consulta d'una clau.  És possible codificar URL "/" i ":" si cal crear un punt de muntatge amb el nom separat per una barra inclinada (per exemple, *foo/bar/zabbix*, on el punt de muntatge és " foo/bar" i el camí és "zabbix", com "foo%2Fbar/zabbix") i si el nom del punt de muntatge o el camí ha de contindre dos punts.

en-us	#### Pattern examples  |Pattern|Description|Matches|No match| |--|------|--|--| |*\**|Matches all possible keys with or without parameters.|Any|None| |*vfs.file.contents*|Matches `vfs.file.contents` without parameters.|vfs.file.contents|vfs.file.contents\[/etc/passwd\]| |*vfs.file.contents\[\]*|Matches `vfs.file.contents` with empty parameters.|vfs.file.contents\[\]|vfs.file.contents| |*vfs.file.contents\[\*\]*|Matches `vfs.file.contents` with any parameters; will not match `vfs.file.contents` without square brackets.|vfs.file.contents\[\]<br>vfs.file.contents\[/path/to/file\]|vfs.file.contents| |*vfs.file.contents\[/etc/passwd,\*\]*|Matches `vfs.file.contents` with first parameters matching /etc/passwd and all other parameters having any value (also empty).|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd,utf8\]|vfs.file.contents\[/etc/passwd\]<br>vfs.file.contents\[/var/log/zabbix\_server.log\]<br>vfs.file.contents\[\]| |*vfs.file.contents\[\*passwd\*\]*|Matches `vfs.file.contents` with first parameter matching \*passwd\* and no other parameters.|vfs.file.contents\[/etc/passwd\]|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd, utf8\]| |*vfs.file.contents\[\*passwd\*,\*\]*|Matches `vfs.file.contents` with only first parameter matching \*passwd\* and all following parameters having any value (also empty).|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd, utf8\]|vfs.file.contents\[/etc/passwd\]<br>vfs.file.contents\[/tmp/test\]| |*vfs.file.contents\[/var/log/zabbix\_server.log,\*,abc\]*|Matches `vfs.file.contents` with first parameter matching /var/log/zabbix\_server.log, third parameter matching 'abc' and any (also empty) second parameter.|vfs.file.contents\[/var/log/zabbix\_server.log,,abc\]<br>vfs.file.contents\[/var/log/zabbix\_server.log,utf8,abc\]|vfs.file.contents\[/var/log/zabbix\_server.log,,abc,def\]| |*vfs.file.contents\[/etc/passwd,utf8\]*|Matches `vfs.file.contents` with first parameter matching /etc/passwd, second parameter matching 'utf8' and no other arguments.|vfs.file.contents\[/etc/passwd,utf8\]|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd,utf16\]| |*vfs.file.\**|Matches any keys starting with `vfs.file.` without any parameters.|vfs.file.contents<br>vfs.file.size|vfs.file.contents\[\]<br>vfs.file.size\[/var/log/zabbix\_server.log\]| |*vfs.file.\*\[\*\]*|Matches any keys starting with `vfs.file.` with any parameters.|vfs.file.size.bytes\[\]<br>vfs.file.size\[/var/log/zabbix\_server.log, utf8\]|vfs.file.size.bytes| |*vfs.\*.contents*|Matches any key starting with `vfs.` and ending with `.contents` without any parameters.|vfs.mount.point.file.contents<br>vfs..contents|vfs.contents|
ca	#### Exemples de patrons  |Patró|Descripció|Coincidències|Sense coincidències| |--|------|--|--| |*\**|Coincideix amb totes les claus possibles amb o sense paràmetres.|Totes|Cap| |*vfs.file.contents*|Coincideix amb `vfs.file.contents` sense paràmetres.|vfs.file.contents|vfs.file.contents\[/etc/passwd\]| |*vfs.file.contents\[\]*|Coincideix `vfs.file.contents` amb paràmetres buits.|vfs.file.contents\[\]|vfs.file.contents| |*vfs.file.contents\[\*\]*|Fa coincidir `vfs.file.contents` amb qualsevol paràmetre; no coincidirà amb `vfs.file.contents` sense claudàtors.|vfs.file.contents\[\]<br>vfs.file.contents\[/path/to/file\]|vfs.file.contents| |*vfs.file.contents\[/etc/passwd,\*\]*|Fa coincidir `vfs.file.contents` amb els primers paràmetres que coincideixen amb /etc/passwd i tots els altres paràmetres amb un valor (també buit).|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd,utf8\]|vfs.file.contents\[/etc/passwd\]<br>vfs.file.contents\[/var/log/zabbix\_server.log\]<br>vfs.file.contents\[\]| |*vfs.file.contents\[\*passwd\*\]*|Coincideix `vfs.file.contents` amb el primer paràmetre que coincideix amb \*passwd\* i sense cap altre paràmetre.|vfs.file.contents\[/etc/passwd\]|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd, utf8\]| |*vfs.file.contents\[\*passwd\*,\*\]*|Coincideix amb `vfs.file.contents` amb només el primer paràmetre que coincideix amb \*passwd\* i sense importar el valor dels següents paràmetres (també buits).|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd, utf8\]|vfs.file.contents\[/etc/passwd\]<br>vfs.file.contents\[/tmp/test\]| |*vfs.file.contents\[/var/log/zabbix\_server.log,\*,abc\]*|Coincideix `vfs.file.contents` amb el primer paràmetre que coincideix amb /var/log/zabbix\_server.log, el tercer paràmetre corresponent a 'abc' i qualsevol segon paràmetre (també buit).|vfs.file.contents\[/var/log/zabbix\_server.log,,abc\]<br>vfs.file.contents\[/var/log/zabbix\_server.log,utf8,abc\]|vfs.file.contents\[/var/log/zabbix\_server.log,,abc,def\]| |*vfs.file.contents\[/etc/passwd,utf8\]*|Coincideix `vfs.file.contents` amb el primer paràmetre que coincideix amb /etc/passwd, el segon paràmetre que coincideix amb 'utf8' i cap altre argument.|vfs.file.contents\[/etc/passwd,utf8\]|vfs.file.contents\[/etc/passwd,\]<br>vfs.file.contents\[/etc/passwd,utf16\]| |*vfs.file.\**|Coincideix amb totes les claus que comencen per `vfs.file.` sense cap paràmetre.|vfs.file.contents<br>vfs.file.size|vfs.file.contents\[\]<br>vfs.file.size\[/var/log/zabbix\_server.log\]| |*vfs.file.\*\[\*\]*|Fa coincidir totes les claus que comencen per `vfs.file.` amb tots els paràmetres.|vfs.file.size.bytes\[\]<br>vfs.file. mida\[/var/log/zabbix\_server.log, utf8\]|vfs.file.size.bytes| |*vfs.\*.contents*|Coincideix amb qualsevol clau que comenci per `vfs.` i acabi amb `.contents` sense cap paràmetre.|vfs.mount.point.file.contents<br>vfs..contents|vfs.contents|

en-us	##### Payload data definition  ###### Common data  These parameters are present in all requests/responses:  |Name|Type|Comments| |-----|--------|----------| |id   |uint32|For requests - the incrementing identifier used to link requests with responses. Unique within a request direction (i.e. from agent to plugin or from plugin to agent).<br>For responses - ID of the corresponding request.| |type|uint32|The request type.|
ca	##### Definició de dades de càrrega útil  ###### Dades comunes  Aquest paràmetres són presents a totes les peticions/respostes:  |Nom|Tipus|Comentaris| |-----|--------|----------| |id   |uint32|Per a les peticions - l'identificador incremental emprat per enllaçar les peticions amb les respostes. Únic dins d'una direcció de petició (és a dir, d'agent a connector o de connector a agent).<br>Per a les respostes - ID de la petició corresponent.| |type|uint32|El tipus de petició.|

en-us	 ### Payload data  |Type|Size|Comments| |-----|-----|----------| |Byte| Defined by the *Size* field |JSON formatted data.|
ca	### Dades de la carga útil  |Tipus|Mida|Comentaris| |-----|-----|----------| |Byte| Definit per el camp *Size*  |Dades en format JSON.|

en-us	 ##### percentile(/host/key,(sec|#num)<:time shift>,percentage) {#percentile}  The P-th percentile of a period, where P (percentage) is specified by the third parameter.<br> Supported value types: *Float*, *Integer*.  Parameters:   -   See [common parameters](#common-parameters);<br> -   **percentage** - a floating-point number between 0 and 100 (inclusive) with up to 4 digits after the decimal point.
ca	 ##### percentile(/host/key,(sec|#num)<:time shift>,percentage) {#percentile}  Percentil P d'un període, on P (percentatge) s'especifica pel tercer paràmetre.<br> Tipus de valors admesos: *Flotant*, *Enter*.  Paràmetres:  - Veieu [paràmetres comuns](#common-parameters);<br> - **percentatge** - un nombre de coma flotant entre 0 i 100 (inclosos) amb fins a 4 dígits després del punt decimal.

en-us	 ##### perf_counter[counter,<interval>] {#perf-counter}  <br> The value of any Windows performance counter.<br> Return value: *Integer*, *float*, *string* or *text* (depending on the request).  Parameters:  -   **counter** - the path to the counter;<br> -   **interval** - the last N seconds for storing the average value. The `interval` must be between 1 and 900 seconds (included) and the default value is 1.  Comments:  -   `interval` is used for counters that require more than one sample (like CPU utilization), so the check returns an average value for last "interval" seconds every time; -   Performance Monitor can be used to obtain the list of available counters.  -   See also: [Windows performance counters](/manual/config/items/perfcounters).
ca	 ##### perf_counter[counter,<interval>] {#perf-counter}  <br> Valor de qualsevol comptador de rendiment de Windows.<br> Valor de retorn: *Enter*, *float*, *cadena* o *text* (segons la petició).  Paràmetres:  - **comptador** - camí cap al comptador;<br> - **interval** - darrers N segons per emmagatzemar el valor mitjà. L''interval' ha de ser entre 1 i 900 segons (inclosos) i el valor per defecte és 1.  Comentaris:  - `interval` s'empra per als comptadors que requereixen més d'una mostra (com la utilització de la CPU), de manera que la comprovació retorna un valor mitjà dels darrers "intervals" cada vegada; - El Monitor de rendiment es pot emprar per obtindre la llista de comptadors disponibles. - Veieu també: [Comptadors de rendiment de Windows](/manual/config/items/perfcounters).

en-us	 ##### PerfCounter  Defines a new parameter <parameter\_name> which is the average value for system performance counter <perf\_counter\_path> for the specified time period <period> (in seconds).<br>Syntax: <parameter\_name>,"<perf\_counter\_path>",<period>  For example, if you wish to receive the average number of processor interrupts per second for the last minute, you can define a new parameter "interrupts" as the following:<br>      PerfCounter = interrupts,"\Processor(0)\Interrupts/sec",60  Please note the double quotes around the performance counter path. The parameter name (interrupts) is to be used as the item key when creating an item. Samples for calculating the average value will be taken every second.<br>You may run "typeperf -qx" to get the list of all performance counters available in Windows.
ca	 ##### PerfCounter  Defineix un nou paràmetre <parameter\_name> que és el valor mitjà del comptador de rendiment del sistema <perf\_counter\_path> durant el període de temps especificat <període> (en segons).<br>Sintaxi: <parameter\_name>," <perf\_counter\_path>",<període>  Per exemple, si voleu rebre el nombre mitjà d'interrupcions del processador per segon durant el darrer minut, podeu definir un nou paràmetre "interrupcions" com el següent:<br>       PerfCounter = interrupcions,"\Processador(0)\Interrupcions/s",60  Tingueu en compte les cometes dobles al voltant del camí del comptador de rendiment. El nom del paràmetre (interrupcions) s'ha d'emprar com a clau d'element quan es crea un element. Es prendran mostres per calcular el valor mitjà cada segon.<br>Podeu executar "typeperf -qx" per obtindre el llistat de tots els comptadors de rendiment disponibles a Windows.

en-us	 ##### perf_counter_en[counter,<interval>] {#perf-counter-en}  <br> The value of any Windows performance counter in English.<br> Return value: *Integer*, *float*, *string* or *text* (depending on the request).  Parameters:  -   **counter** - the path to the counter in English;<br> -   **interval** - the last N seconds for storing the average value. The `interval` must be between 1 and 900 seconds (included) and the default value is 1.  Comments:  -   `interval` is used for counters that require more than one sample (like CPU utilization), so the check returns an average value for last "interval" seconds every time; -   This item is only supported on **Windows Server 2008/Vista** and above; -   You can find the list of English strings by viewing the following registry key: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.
ca	 ##### perf_counter_en[counter,<interval>] {#perf-counter-en}  <br> Valor de qualsevol comptador de rendiment de Windows, en anglès.<br> Valor de retorn: *Enter*, *float*, *cadena* o *text* (segons la petició).  Paràmetres:  - **comptador** - camí cap al comptador, en anglès;<br> - **interval** - darrers N segons per emmagatzemar el valor mitjà. L''interval' ha de ser entre 1 i 900 segons (inclosos) i el valor per defecte és 1.  Comentaris:  - `interval` s'empra per als comptadors que requereixen més d'una mostra (com la utilització de la CPU), de manera que la comprovació retorna un valor mitjà dels darrers "intervals" cada vegada; - Aquest element només s'admet a **Windows Server 2008/Vista** i superiors; - Podeu trobar la llista de cadenes en anglès revisant la clau de registre següent: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.

en-us	 ##### PerfCounterEn  Defines a new parameter <parameter\_name> which is the average value for system performance counter <perf\_counter\_path> for the specified time period <period> (in seconds). Compared to PerfCounter, the perfcounter paths must be in English. Supported only on **Windows Server 2008/Vista** and later.<br>Syntax: <parameter\_name>,"<perf\_counter\_path>",<period>  For example, if you wish to receive the average number of processor interrupts per second for the last minute, you can define a new parameter "interrupts" as the following:<br>      PerfCounterEn = interrupts,"\Processor(0)\Interrupts/sec",60  Please note the double quotes around the performance counter path. The parameter name (interrupts) is to be used as the item key when creating an item. Samples for calculating the average value will be taken every second.<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`.
ca	 ##### PerfCounterEn  Defineix un nou paràmetre <parameter\_name> que és el valor mitjà del comptador de rendiment del sistema <perf\_counter\_path> durant el període de temps especificat <període> (en segons). En comparació amb PerfCounter, els camins de perfcounter han d'ésser en anglès. Només s'admet a **Windows Server 2008/Vista** i posterior.<br>Sintaxi: <parameter\_name>,"<perf\_counter\_path>",<període>  Per exemple, si voleu rebre el nombre mitjà d'interrupcions del processador per segon durant el darrer minut, podeu definir un nou paràmetre "interrupcions" com el següent:<br>       PerfCounterEn = interrupcions,"\Processador(0)\Interruptes/s",60  Tingueu en compte les cometes dobles al voltant del camí del comptador de rendiment. El nom del paràmetre (interrupcions) s'ha d'emprar com a clau d'element quan es crea un element. Es prendran mostres per calcular el valor mitjà cada segon.<br>Podeu trobar la llista de cadenes en anglès si visualitzeu la clau de registre següent: `HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Perflib\009`.

en-us	 ##### perf_instance.discovery[object] {#perf-instance-discovery}  <br> The list of object instances of Windows performance counters. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_perf_instances).<br> Return value: *JSON object*.  Parameter:  -   **object** - the object name (localized).
ca	 ##### perf_instance.discovery[object] {#perf-instance-discovery}  <br> Llistat d'instàncies d'objecte dels comptadors de rendiment de Windows. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_perf_instances).<br> Valor de retorn: *objecte JSON*.  Paràmetre:  - **objecte** - el nom de l'objecte (localitzat).

en-us	 ##### perf_instance_en.discovery[object] {#perf-instance-en-discovery}  <br> The list of object instances of Windows performance counters, discovered using the object names in English. Used for [low-level discovery](/manual/discovery/low_level_discovery/examples/windows_perf_instances).<br> Return value: *JSON object*.  Parameter:  -   **object** - the object name (in English).
ca	 ##### perf_instance_en.discovery[object] {#perf-instance-en-discovery}  <br> Llistat d'instàncies d'objecte dels comptadors de rendiment de Windows, trobats emprant els noms d'objectes en anglès . S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery/examples/windows_perf_instances).<br> Valor de retorn: *objecte JSON*.  Paràmetre:  - **objecte** - el nom de l'objecte (en anglès).

en-us	 ## Performance
ca	 ## Rendiment

en-us	#### Performance counter parameters  You can deploy some PerfCounter parameters for the monitoring of Windows performance counters.  For example, you can add these to the Zabbix agent configuration file:         PerfCounter=UserPerfCounter1,"\Memory\Page Reads/sec",30        or        PerfCounter=UserPerfCounter2,"\4\24",30  With such parameters in place, you can then simply use *UserPerfCounter1* or *UserPerfCounter2* as the keys for creating the respective items.  Remember to restart Zabbix agent after making changes to the configuration file.
ca	#### Paràmetres del comptador de rendiment  Podeu implementar alguns paràmetres de PerfCounter per monitorar els comptadors de rendiment de Windows.  Per exemple, podeu afegir-los al fitxer de configuració de l'agent Zabbix:          PerfCounter=UserPerfCounter1,"\Memory\Page Reads/sec",30        o        PerfCounter=UserPerfCounter2,"\4\24",30  Amb aquests paràmetres al seu lloc, només podeu emprar *UserPerfCounter1* o *UserPerfCounter2* com a claus per crear els elements respectius.  Recordeu reiniciar l'agent Zabbix després de fer canvis al fitxer de configuració.

en-us	#### Performance  Using some internal items may negatively affect performance. These items are:  -   `zabbix[host,,items]` -   `zabbix[host,,items_unsupported]` -   `zabbix[hosts]` -   `zabbix[items]` -   `zabbix[items_unsupported]` -   `zabbix[queue]` -   `zabbix[requiredperformance]` -   `zabbix[stats,,,queue]` -   `zabbix[triggers]`  The [System information](/manual/web_interface/frontend_sections/reports/status_of_zabbix) and [Queue](/manual/web_interface/frontend_sections/administration/queue)  frontend sections are also affected.
ca	#### Rendiment  Emprar alguns elements interns pot afectar negativament al rendiment. Aquests elements són:  -   `zabbix[host,,items]` -   `zabbix[host,,items_unsupported]` -   `zabbix[hosts]` -   `zabbix[items]` -   `zabbix[items_unsupported]` -   `zabbix[queue]` -   `zabbix[requiredperformance]` -   `zabbix[stats,,,queue]` -   `zabbix[triggers]`  Les interfícies de les seccions [Informació del sistema](/manual/web_interface/frontend_sections/reports/status_of_zabbix) i [Cua](/manual/web_interface/frontend_sections/administration/queue) també es veuen afectades.

en-us	### Performing requests  Once you have set up the frontend, you can use remote HTTP requests to call the API. To do that, you need to send HTTP POST requests to the `api_jsonrpc.php` file located in the frontend directory. For example, if your Zabbix frontend is installed under `https://example.com/zabbix`, an HTTP request to call the `apiinfo.version` method may look like this:  ```bash curl --request POST \   --url 'https://example.com/zabbix/api_jsonrpc.php' \   --header 'Content-Type: application/json-rpc' \   --data '{"jsonrpc":"2.0","method":"apiinfo.version","params":{},"id":1}' ```  The request must have the `Content-Type` header set to one of these values: `application/json-rpc`, `application/json` or `application/jsonrequest`.  The request object contains the following properties:  -   `jsonrpc` - the version of the JSON-RPC protocol used by the API (Zabbix API implements JSON-RPC version 2.0); -   `method` - the API method being called; -   `params` - the parameters that will be passed to the API method; -   `id` - an arbitrary identifier of the request.  If the request is correct, the response returned by the API should look like this:  ```json {     "jsonrpc": "2.0",     "result": "6.4.0",     "id": 1 } ```  The response object, in turn, contains the following properties:  -   `jsonrpc` - the version of the JSON-RPC protocol; -   `result` - the data returned by the method; -   `id` - an identifier of the corresponding request.
ca	### Fer peticions  Un cop hàgiu configurat la interfície web, podeu fer peticions HTTP remotes per cridar a l'API. Per fer-ho, heu d'enviar peticions HTTP POST al fitxer `api_jsonrpc.php` situat al directori de la interfície. Per exemple, si la vostra interfície Zabbix és instal·lada a `http://example.com/zabbix`, la sol·licitud HTTP per trucar al mètode `apiinfo.version` pot assemblar-se a:  ``` bash curl --request POST \      --url 'http://exemple.com/zabbix/api_jsonrpc.php'      --header 'Content-Type: application/json-rpc'      --data '{"jsonrpc":"2.0","method":"apiinfo.version","params":{},"id":1}' ```  La petició ha de tindre la capçalera "Tipus de contingut" establerta en un d'aquests valors: `application/json-rpc`, `application/json` o `aplicació/jsonrequest`.  L'objecte de petició conté les propietats següents:  -`jsonrpc` - la versió del protocol JSON-RPC emprada per l'API (l'API Zabbix implementa JSON-RPC versió 2.0); -`method` - el mètode de l'API que s'està cridant; -`params` - els paràmetres que es passaran al mètode API; -`id` - un identificador arbitrari de la petició.  Si la petició és correcta, la resposta retornada per l'API hauria de ser així:  ```json { "jsonrpc": "2.0", "result": "6.4.0", "id": 1 } ```  L'objecte de resposta conté les propietats següents:  -`jsonrpc` - la versió del protocol JSON-RPC; -`result` - les dades retornades pel mètode; -`id` - un identificador de la petició corresponent.

en-us	#### Permissions  The *Permissions* tab contains information on the following elements:  -   User role that can only be changed by a *Super admin* user.  ::: notewarning Since Zabbix 6.4.4, users cannot be created without a [user role](/manual/config/users_and_usergroups/permissions#user-roles) (except with Zabbix [User API](/manual/api/reference/user/object)). Previously created users which do not have a role may still be edited without assigning a role to them. However, once a role is assigned, it can only be changed, not removed. <br><br> Note that users without a role can log into Zabbix only using [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) or [SAML](/manual/web_interface/frontend_sections/users/authentication/saml) authentication, provided their LDAP/SAML information matches the user group mappings configured in Zabbix. :::  -   User type (*User*, *Admin*, *Super admin*) that is defined in the user role configuration. -   Host and template groups that the user has access to.     -   *User* and *Admin* type users, by default, do not have access to any groups, templates, and hosts.         To grant such access, users must be included in user groups configured with permissions to the relevant entities. -   Access rights to sections and elements of Zabbix frontend, modules, and API methods.     -   Elements with allowed access are displayed in green color, while those with denied access - in light gray color. -   Rights to perform specific actions.     -   Actions that the user is allowed to perform are displayed in green color, while those that are denied - in light gray color.  See the [Permissions](permissions) page for details.
ca	#### Permissos  La pestanya *Permisos* conté informació sobre:  - El rol d'usuari. La funció d'usuari només la pot canviar un usuari superadministrador.  ::: notewarning Des de Zabbix 6.4.4, els usuaris no es poden crear sense un [rol d'usuari](/manual/config/users_and_usergroups/permissions#user-roles) (excepte amb l'[API d'usuari](/manual/api/reference/user/object) de Zabbix).Els usuaris creats anteriorment que no tenen cap rol encara es poden editar sense assignar-los un rol. Tanmateix, un cop assignat un rol, només es pot canviar, no eliminar-lo.<br><br>Tingueu en compte que els usuaris sense rol només poden iniciar sessió a Zabbix mitjançant l'autenticació [LDAP](/manual/web_interface/frontend_sections/users/authentication/ldap) o [SAML](/manual/web_interface/frontend_sections/users/authentication/saml), sempre que la seva informació LDAP/SAML coincideix amb els mapatges de grups d'usuaris configurats a Zabbix. :::  - El tipus d'usuari (Usuari, Administrador, Superadministrador) que es defineix a la configuració del rol. - Grups d'equips i plantilles als quals l'usuari té accés. Els usuaris de tipus "Usuari" i "Administrador" no tenen accés per defecte a cap grup, plantilla i equip. Per obtindre l'accés han de ser inclosos en grups d'usuaris que tinguin accés a les entitats respectives. - Drets d'accés a seccions i elements de la interfície, mòduls i mètodes API de Zabbix. Els elements als quals es permet l'accés es mostren en color verd. El color gris clar significa que l'accés a l'element està denegat. - Drets a fer determinades accions. Les accions permeses es mostren en color verd. El color gris clar significa que un usuari no té els drets per dur a terme aquesta acció.  Consulteu la pàgina de [permisos d'usuari](permissions) per obtindre més informació.

en-us	#### Permissions to dashboards  Permissions to dashboards for regular users and users of 'Admin' type are limited in the following way:  -   They can see and clone a dashboard if they have at least READ rights     to it; -   They can edit and delete dashboard only if they have READ/WRITE     rights to it; -   They cannot change the dashboard owner.
ca	#### Permisos dels taulers  Els permisos d'accés als taulers per a usuaris habituals i usuaris de tipus Administrador de Zabbix són limitats de la següent manera:  - Poden veure i clonar un tauler si hi tenen almenys drets de LECTURA; - Només poden modificar i esborrar el tauler si hi tenen drets de LECTURA/ESCRITURA; - No poden canviar el propietari del tauler.

en-us	### Permission  The permission object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |id|string|ID of the host group or template group to add permission to.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*| |permission|integer|Access level to the host group or template group.<br><br>Possible values:<br>0 - access denied;<br>2 - read-only access;<br>3 - read-write access.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* for create operations|
ca	### Permisos  L'objecte té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |id|cadena|ID del grup d'equips on afegir-hi els permisos.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori*| |permission|enter|Nivell d'accés al grup d'equips.<br><br>Valors possibles :<br>0 - accés rebutjat;<br>2 - accés de només lectura ;<br>3 - accés de lectura i escriptura.<br><br>[Comportament de la propietat](/manual/api/reference_commentary#property-behavior):<br>- *obligatori* per operacions de creació|

en-us	##### PersistentBufferFile  The file where Zabbix agent 2 should keep the SQLite database. Must be a full filename. This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).
ca	##### PersistentBufferFile  El fitxer on l'agent Zabbix 2 hauria de mantindre la base de dades SQLite. Ha de ser un nom de fitxer complet. Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (*EnablePersistentBuffer=1*).

en-us	##### PersistentBufferFile  The file where Zabbix agent 2 should keep the SQLite database. Must be a full filename. This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).
ca	##### PersistentBufferFile  El fitxer on l'agent Zabbix 2 hauria de mantindre la base de dades SQLite. Ha de ser un nom de fitxer complet. Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (*EnablePersistentBuffer=1*).

en-us	##### PersistentBufferPeriod  The time period for which data should be stored when there is no connection to the server or proxy. Older data will be lost. Log data will be preserved. This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).  Default: `1h`<br> Range: 1m-365d
ca	##### PersistentBufferPeriod  El període de temps durant el qual s'han d'emmagatzemar les dades quan no hi ha connexió amb el servidor o proxy. Les dades més antigues es perdran. Les dades del registre es conservaran. Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (*EnablePersistentBuffer=1*).  Per defecte: `1h`<br> Rang: 1m-365d

en-us	##### PersistentBufferPeriod  The time period for which data should be stored when there is no connection to the server or proxy. Older data will be lost. Log data will be preserved. This parameter is only used if persistent buffer is enabled (*EnablePersistentBuffer=1*).  Default: `1h`<br> Range: 1m-365d
ca	##### PersistentBufferPeriod  El període de temps durant el qual s'han d'emmagatzemar les dades quan no hi ha connexió amb el servidor o proxy. Les dades més antigues es perdran. Les dades del registre es conservaran. Aquest paràmetre només s'empra si la memòria intermèdia persistent és habilitada (*EnablePersistentBuffer=1*).  Per defecte: `1h`<br> Rang: 1m-365d

en-us	 ##### pgsql.archive[uri,<username>,<password>,<database name>]  <br> The information about archived files.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.archive[uri,<username>,<password>,<database name>]  <br> Informació sobre els fitxers arxivats.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o el nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>  Les dades retornades són processades per elements dependents:  - **pgsql.archive.count_archived_files** - nombre de fitxers WAL que s'han arxivat correctament;<br> - **pgsql.archive.failed_trying_to_archive** - nombre d'intents fallits per arxivar fitxers WAL;<br> - **pgsql.archive.count_files_to_archive** - nombre de fitxers a arxivar;<br> - **pgsql.archive.size_files_to_archive** - mida dels fitxers a arxivar.

en-us	 ##### pgsql.autovacuum.count[uri,<username>,<password>,<database name>]  <br> The number of autovacuum workers.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.autovacuum.count[uri,<username>,<password>,<database name>]  <br> Nombre de treballadors de l'autobuit.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o el nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.bgwriter[uri,<username>,<password>,<database name>]  <br> The combined number of checkpoints for the database cluster, broken down by checkpoint type.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.bgwriter[uri,<username>,<password>,<database name>]  <br> Nombre combinat de punts de control per al clúster de bases de dades, desglossat per tipus de punt de control.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o el nom de la sessió;<br> - **nom d'usuari, mot de pas** - les credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.cache.hit[uri,<username>,<password>,<database name>]  <br> The PostgreSQL buffer cache hit rate.<br> Return value: *Float*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.cache.hit[uri,<username>,<password>,<database name>]  <br> Taxa d'èxits de la memòria cau de la memòria intermèdia de PostgreSQL.<br> Valor de retorn: *Flotant*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.connections[uri,<username>,<password>,<database name>]  <br> Returns connections by type.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.connections[uri,<username>,<password>,<database name>]  <br> Retorna connexions per tipus.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o el nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.custom.query[uri,<username>,<password>,queryName,<args...>] {#pgsql-custom-query}  <br> Returns the result of a custom query.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **queryName** - the name of a custom query, must match the SQL file name without an extension;<br> -   **args** - one or several comma-separated arguments to pass to a query.
ca	 ##### pgsql.custom.query[uri,<username>,<password>,queryName,<args...>] {#pgsql-custom-query}   <br> Retorna el resultat d'una consulta personalitzada.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **queryName** - nom d'una consulta personalitzada, ha de coincidir amb el nom del fitxer SQL sense extensió;<br> - **args**(opcional) - arguments per passar a la consulta.

en-us	 ##### pgsql.db.age[uri,<username>,<password>,<database name>]  <br> The age of the oldest FrozenXID of the database.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.db.age[uri,<username>,<password>,<database name>]  <br> Edat del FrozenXID més antic de la base de dades.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.db.bloating_tables[uri,<username>,<password>,<database name>] {#pgsql-db-bloating-tables}  <br> The number of bloating tables per database.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.db.bloating_tables[uri,<username>,<password>,<database name>] {#pgsql-db-bloating-tables}  <br> Nombre de taules inflades per base de dades.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.db.discovery[uri,<username>,<password>,<database name>]  <br> The list of PostgreSQL databases. Used for [low-level discovery](/manual/discovery/low_level_discovery).<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.db.discovery[uri,<username>,<password>,<database name>]  <br> Llistat de bases de dades PostgreSQL. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery).<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.db.size[uri,<username>,<password>,<database name>]  <br> The database size in bytes.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.db.size[uri,<username>,<password>,<database name>]  <br> Mida de la base de dades, en octets.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.dbstat.sum[uri,<username>,<password>,<database name>]  <br> The summarized data for all databases in a cluster.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.dbstat.sum[uri,<username>,<password>,<database name>]  <br> Dades resumides de totes les bases de dades d'un clúster.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.dbstat[uri,<username>,<password>,<database name>]  <br> Collects the statistics per database. Used for [low-level discovery](/manual/discovery/low_level_discovery).<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.dbstat[uri,<username>,<password>,<database name>]  <br> Recull les estadístiques per base de dades. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery).<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.locks[uri,<username>,<password>,<database name>]  <br> The information about granted locks per database. Used for [low-level discovery](/manual/discovery/low_level_discovery).<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.locks[uri,<username>,<password>,<database name>]  <br> Informació sobre els bloquejos concedits per base de dades. S'empra per a [descoberta de baix nivell](/manual/discovery/low_level_discovery).<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades*- nom de la base de dades.<br>

en-us	 ##### pgsql.oldest.xid[uri,<username>,<password>,<database name>]  <br> The age of the oldest XID.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.oldest.xid[uri,<username>,<password>,<database name>]  <br> Edat de l'XID més antic.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.ping[uri,<username>,<password>,<database name>]  <br> Tests whether a connection is alive or not.<br> Return value: *1* - the connection is alive; *0* - the connection is broken (if there is any error presented including AUTH and configuration issues).  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.ping[uri,<username>,<password>,<database name>]  <br> Comprova si una connexió és activa o no.<br> Valor de retorn: *1* - la connexió és activa; *0*: la connexió no és activa (si presenta algun error inclòs problemes d'AUTH i de configuració).  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.queries[uri,<username>,<password>,<database name>,<time period>]  <br> Queries metrics by execution time.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name;<br> -   **timePeriod** - the execution time limit for the count of slow queries (must be a positive integer).
ca	 ##### pgsql.queries[uri,<username>,<password>,<database name>,<time period>]  <br> Consulta mètriques per temps d'execució.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades;<br> - **timePeriod** - límit de temps d'execució per al recompte de consultes lentes (ha de ser un nombre enter positiu).

en-us	 ##### pgsql.replication.count[uri,<username>,<password>]  <br> The number of standby servers.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication.count[uri,<username>,<password>,<database name>]  <br> Nombre de servidors en espera.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.replication_lag.b[uri,<username>,<password>] {#pgsql-replication-lag-b}  <br> The replication lag in bytes.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication_lag.b[uri,<username>,<password>] {#pgsql-replication-lag-b}  <br> Endarreriment de la replicació, en octets.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.replication_lag.sec[uri,<username>,<password>] {#pgsql-replication-lag-sec}  <br> The replication lag in seconds.<br> Return value: *Integer*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication_lag.sec[uri,<username>,<password>] {#pgsql-replication-lag-sec}  <br> Endarreriment de la replicació, en segons.<br> Valor de retorn: *Enter*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.replication.process.discovery[uri,<username>,<password>]  <br> The replication process name discovery.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication.process.discovery[uri,<username>,<password>]  <br> Descoberta del nom del procés de replicació.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.replication.process[uri,<username>,<password>]  <br> The flush lag, write lag and replay lag per each sender process.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication.process[uri,<username>,<password>]  <br> Endarreriment d'emissió, escriptura i reproducció per cada procés del remitent.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.replication.recovery_role[uri,<username>,<password>] {#pgsql-replication-recovery-role}  <br> The recovery status.<br> Return value: *0* - master mode; *1* - recovery is still in progress (standby mode).  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication.recovery_role[uri,<username>,<password>] {#pgsql-replication-recovery-role}  <br> Estat de recuperació.<br> Valor de retorn: *0* - mode mestre; *1* - la recuperació encara és en curs (mode d'espera).  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.replication.status[uri,<username>,<password>]  <br> The status of replication.<br> Return value: *0* - streaming is down; *1* - streaming is up; *2* - master mode.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials.
ca	 ##### pgsql.replication.status[uri,<username>,<password>]  <br> Estat de la replicació.<br> Valor de retorn: *0* - la reproducció és desactivada; *1* - la reproducció és activada; *2* - mode mestre.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL.

en-us	 ##### pgsql.uptime[uri,<username>,<password>,<database name>]  <br> The PostgreSQL uptime in milliseconds.<br> Return value: *Float*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.uptime[uri,<username>,<password>,<database name>]  <br> Temps d'activitat del PostgreSQL en mil·lisegons.<br> Valor de retorn: *Flotant*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	##### pgsql.version[uri,<username>,<password>,<database name>]  <br> Returns PostgreSQL version.<br> Return value: *String*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.version[uri,<username>,<password>,<database name>]  <br> Retorna la versió de PostgreSQL.<br> Valor de retorn: *Cadena*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	 ##### pgsql.wal.stat[uri,<username>,<password>,<database name>]  <br> The WAL statistics.<br> Return value: *JSON object*.  Parameters:  -   **uri** - the URI or session name;<br> -   **username, password** - the PostgreSQL credentials;<br> -   **database name** - the database name.<br>
ca	 ##### pgsql.wal.stat[uri,<username>,<password>,<database name>]  <br> Estadístiques de WAL.<br> Valor de retorn: *objecte JSON*.  Paràmetres:  - **uri** - URI o nom de la sessió;<br> - **nom d'usuari, mot de pas** - credencials de PostgreSQL;<br> - **nom de la base de dades** - nom de la base de dades.<br>

en-us	#### PHP 7.3 opcache configuration  If "opcache" is enabled in the PHP 7.3 configuration, Zabbix frontend may show a blank screen when loaded for the first time. This is a registered [PHP bug](https://bugs.php.net/bug.php?id=78015). To work around this, please set the "opcache.optimization\_level" parameter to `0x7FFFBFDF` in the PHP configuration (php.ini file).
ca	#### Configuració de l'opcache PHP 7.3  Si "opcache" és habilitat a la configuració de PHP 7.3, el frontal de Zabbix pot mostrar una pantalla en blanc a la primera càrrega. Aquest és un [error registrat](https://bugs.php.net/bug.php?id=78015) de PHP. Per solucionar aquest problema, configureu el paràmetre "opcache.optimization\_level" a `0x7FFFBFDF` a la configuració de PHP (fitxer php.ini).

en-us	#### PHP support  The maximum supported version for PHP is now 8.3.
ca	#### Suport de PHP  La versió més nova admesa de PHP és la 8.3.

en-us	##### PidFile Name of the PID file.  Default: `/tmp/zabbix_server.pid`
ca	##### PidFile  Nom de l'arxiu PID.  Per defecte: `/tmp/zabbix_server.pid`

en-us	##### PidFile  The name of the PID file.  Default: `/tmp/zabbix_agent2.pid`
ca	##### PidFile  Nom de l'arxiu PID.  Per defecte: `/tmp/zabbix_agent2.pid`

en-us	##### PidFile  The name of the PID file.  Default: `/tmp/zabbix_agentd.pid`
ca	##### PidFile  Nom de l'arxiu PID.  Per defecte: `/tmp/zabbix_agentd.pid`

en-us	##### PidFile  The name of the PID file.  Default: `/tmp/zabbix_proxy.pid`
ca	##### PidFile  Nom de l'arxiu PID.  Per defecte: `/tmp/zabbix_proxy.pid`

en-us	 ##### pi {#pi}  The Pi constant (3.14159265358979).  Example:      pi()
ca	 ##### pi {#pi}  Constant Pi (3.14159265358979).  Exemple:      pi()

en-us	## Platforms
ca	## Plataformes

en-us	 ### plugin.Configurator  *Configurator* interface provides plugin configuration parameters from Zabbix agent 2 configuration files.
ca	### plugin.Configurator  La interfície *Configurator* proveeix paràmetres de configuració del plugin des dels arxius de configuració de l'agent 2 de Zabbix.

en-us	 ### plugin.Exporter  *Exporter* is the simplest interface that performs a poll and returns a value (values), nothing, or error. It accepts a preparsed item key, parameters, and context. Access to all other plugin interfaces is exclusive and no method can be called if a plugin is already performing a task. Also, there is a limit of 100 maximum concurrent *Export()* calls per plugin, which can be reduced according to the requirements for each plugin.
ca	### plugin.Exporter  *Exporter* és la interfície més senzilla que realitza una enquesta i retorna un valor (valors), res o un error. Accepta una clau d'element preparat, paràmetres i context. L'accés a totes les altres interfícies de connectors és exclusiu i no es pot cridar cap mètode si un plugin ja està fent una tasca. A més, hi ha un límit de 100 crides simultànies màximes *Export()* per plugin, que es poden reduir segons les necessitats de cada plugin.

en-us	# Plugin interfaces  This section describes available plugin interfaces.
ca	# Interficies plugin  Aquesta secció descriu les interfícies plugin disponibles.

en-us	 ### plugin.Runner  *Runner* interface provides the means for performing initialization when a plugin is started (activated) and deinitialization when a plugin is stopped (deactivated). For example, a plugin can start/stop some background *goroutine* by implementing the Runner interface.
ca	### plugin.Runner  La interfície *Runner* proporciona els mitjans per dur a terme la inicialització quan s'inicia (activa) un plugini la desinicialització quan un plugin s'atura (desactiva). Per exemple, un plugin pot iniciar/aturar algun *goroutine* de fons mitjançant la implementació de la interfície Runner.

en-us	## Plugins
ca	## Plugins

en-us	## Plugins
ca	## Plugins

en-us	## Plugins
ca	## Plugins

en-us	## Plugins
ca	## Plugins

en-us	 # Plugins
ca	# Plugins

en-us	 #### Plugins   All metrics supported by Zabbix agent 2 are collected by plugins.
ca	#### Plugins  Totes les mètriques admeses per l'agent Zabbix 2 són recollides per els plugins.

en-us	##### Plugins.Log.MaxLinesPerSecond  The maximum number of new lines the agent will send per second to Zabbix server or proxy when processing 'log' and 'logrt' active checks. The provided value will be overridden by the 'maxlines' parameter, provided in the 'log' and 'logrt' item key.<br>*Note*: Zabbix will process 10 times more new lines than set in *MaxLinesPerSecond* to seek the required string in log items.  Default: `20`<br> Range: 1-1000
ca	##### Plugins.Log.MaxLinesPerSecond  El nombre màxim de línies noves que l'agent enviarà per segon al servidor o al proxy Zabbix quan processi les comprovacions actives 'log' i 'logrt'. El valor proporcionat serà substituït pel paràmetre 'maxlines', proporcionat a la clau d'element 'log' i 'logrt'.<br>*Nota*: Zabbix processarà 10 vegades més línies noves que les establertes a *MaxLinesPerSecond * per cercar la cadena necessària als elements de registre.  Per defecte: `20`<br> Rang: 1-1000

en-us	##### Plugins.Log.MaxLinesPerSecond  The maximum number of new lines the agent will send per second to Zabbix server or proxy when processing 'log', 'logrt' and 'eventlog' active checks. The provided value will be overridden by the 'maxlines' parameter, provided in the 'log', 'logrt' or 'eventlog' item key.<br>*Note*: Zabbix will process 10 times more new lines than set in *MaxLinesPerSecond* to seek the required string in log items.  Default: `20`<br> Range: 1-1000
ca	##### Plugins.Log.MaxLinesPerSecond  El nombre màxim de línies noves que l'agent enviarà per segon al servidor o al proxy Zabbix quan processi les comprovacions actives 'log', 'logrt' i 'eventlog'. El valor proporcionat serà substituït pel paràmetre 'maxlines', proporcionat a la clau d'element 'log', 'logrt' o 'eventlog'.<br>*Nota*: Zabbix processarà 10 vegades més línies noves que les establertes a *MaxLinesPerSecond * per cercar la cadena necessària als elements de registre.  Per defecte: `20`<br> Rang: 1-1000

en-us	##### PluginSocket  The path to the UNIX socket for loadable plugin communications.  Default: `\\.\pipe\agent.plugin.sock`
ca	##### PluginSocket  El camí al sòcol UNIX per a les comunicacions de plugins carregables.  Per defecte: `\\.\pipe\agent.plugin.sock`

en-us	##### PluginSocket  The path to the UNIX socket for loadable plugin communications.  Default: `/tmp/agent.plugin.sock`
ca	##### PluginSocket  El camí al sòcol UNIX per a les comunicacions de plugins carregables.  Per defecte: `/tmp/agent.plugin.sock`

en-us	 ##### Plugins.<PluginName>.System.Capacity {#plugins.systemcapacity}  The limit of checks per `<PluginName>` plugin that can be executed at the same time.  Default: `100` Range: 1-1000
ca	 ##### Plugins.<PluginName>.System.Capacity {#plugins.systemcapacity}  El límit de comprovacions per plugin `<PluginName>` que es poden executar al mateix temps.  Per defecte: `100`. Interval: 1-1000

en-us	 ##### Plugins.<PluginName>.System.Capacity {#plugins.systemcapacity}  The limit of checks per `<PluginName>` plugin that can be executed at the same time.  Default: `100` Range: 1-1000
ca	 ##### Plugins.<PluginName>.System.Capacity {#plugins.systemcapacity}  El límit de comprovacions per plugin `<PluginName>` que es poden executar al mateix temps.  Per defecte: `100`. Interval: 1-1000

en-us	##### Plugins  [Plugins](/manual/extensions/plugins) provide an alternative to loadable modules (written in C). However, plugins are a way to extend Zabbix agent 2 only.  A plugin is a *Go* package that defines the structure and implements one or several plugin interfaces (*Exporter*, *Collector*, *Configurator*, *Runner*, *Watcher*). Two types of Zabbix agent 2 plugins are supported:  -   [Built-in plugins](https://www.zabbix.com/documentation/guidelines/en/plugins/built_in_plugins)     (supported since Zabbix 4.4.0) -   [Loadable plugins](https://www.zabbix.com/documentation/guidelines/en/plugins/loadable_plugins)     (supported since Zabbix 6.0.0)  See the list of [built-in plugins](/manual/extensions/plugins#built-in).  For instructions and tutorials on writing your own plugins, see [Developer center](/devel/plugins).
ca	##### Plugins  els [Plugins](/manual/extensions/plugins) ofereix una alternativa als mòduls carregables (escrits en C). Tanmateix, els plugins són una manera d'estendre només l'agent Zabbix 2.  Un plugin és un paquet *Go* que defineix l'estructura i implementa una o diverses interfícies de plugins (*Exporter*, *Collector*, *Configurator*, *Runner*, *Watcher*). S'admeten dos tipus de plugins de l'agent 2 de Zabbix:  - [Complements integrats](https://www.zabbix.com/documentation/guidelines/en/plugins/built_in_plugins) (admès des de Zabbix 4.4.0) - [Connexions carregables](https://www.zabbix.com/documentation/guidelines/en/plugins/loadable_plugins) (admet des de Zabbix 6.0.0)  Consulteu la llista de [plugins integrats](/manual/extensions/plugins#built-in).  Per obtindre instruccions i tutorials sobre com escriure els vostres propis plugins, consulteu [Centre de desenvolupadors](/devel/plugins).

en-us	##### Plugins.SystemRun.LogRemoteCommands  Enable the logging of the executed shell commands as warnings. The commands will be logged only if executed remotely. Log entries will not be created if system.run\[\] is launched locally by the HostMetadataItem, HostInterfaceItem or HostnameItem parameters.  Default: `0`<br> Values: 0 - disabled, 1 - enabled
ca	##### Plugins.SystemRun.LogRemoteCommands  Habiliteu el registre de les ordres de l'intèrpret d'ordres executades com a avisos. Les ordres només es registraran si s'executen de forma remota. Les entrades de registre no es crearan si system.run\[\] s'inicia localment mitjançant els paràmetres HostMetadataItem, HostInterfaceItem o HostnameItem.  Per defecte: `0`<br> Valors: 0 - desactivat, 1 - activat

en-us	##### Plugins.SystemRun.LogRemoteCommands  Enable the logging of the executed shell commands as warnings. The commands will be logged only if executed remotely. Log entries will not be created if system.run\[\] is launched locally by the HostMetadataItem, HostInterfaceItem or HostnameItem parameters.  Default: `0`<br> Values: 0 - disabled, 1 - enabled
ca	##### Plugins.SystemRun.LogRemoteCommands  Habiliteu el registre de les ordres de l'intèrpret d'ordres executades com a avisos. Les ordres només es registraran si s'executen de forma remota. Les entrades de registre no es crearan si system.run\[\] s'inicia localment mitjançant els paràmetres HostMetadataItem, HostInterfaceItem o HostnameItem.  Per defecte: `0`<br> Valors: 0 - desactivat, 1 - activat

en-us	##### PluginTimeout  The timeout for connections with loadable plugins, in seconds.  Default: `Timeout`<br> Range: 1-30
ca	##### PluginTimeout  El temps d'espera de les connexions amb plugins carregables, en segons.  Per defecte: `Timeout`<br> Rang: 1-30

en-us	##### PluginTimeout  The timeout for connections with loadable plugins, in seconds.  Default: `Timeout`<br> Range: 1-30
ca	##### PluginTimeout  El temps d'espera de les connexions amb plugins carregables, en segons.  Per defecte: `Timeout`<br> Rang: 1-30

en-us	 #### Possible deadlocks with MySQL/MariaDB  When running under high load, and with more than one LLD worker involved, it is possible to run into a deadlock caused by an InnoDB error related to the row-locking strategy (see [upstream bug](https://github.com/mysql/mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). The error has been fixed in MySQL since 8.0.29, but not in MariaDB. For more details, see [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506).
ca	#### Blocatges possibles amb MySQL/MariaDB  Quan s'executa amb una càrrega pesada i amb més d'un agent LLD implicat, és possible entrar en un bloqueig causat per un error d'InnoDB relacionat amb la política de bloqueig de filera (veieu l'[error](https ://github.com/mysql/). mysql-server/commit/7037a0bdc83196755a3bf3e935cfb3c0127715d5)). L'error s'ha corregit a MySQL des de l'8.0.29, però no a MariaDB. Per obtindre més informació, consulteu [ZBX-21506](https://support.zabbix.com/browse/ZBX-21506).

en-us	##### Possible error messages  You may encounter a situation when no data is displayed and the following error message appears:  ![](../../../../../assets/en/manual/web_interface/error_message_1.png){width="600"}  Error message in this case is the following:      Cannot display item queue. Permission denied  This happens when the PHP configuration parameters in the *zabbix.conf.php* file - `$ZBX_SERVER` or both `$ZBX_SERVER` and `$ZBX_SERVER_PORT` - point to an existing Zabbix server that uses a different database.
ca	##### Possibles missatges d'error  És possible que us trobeu amb una situació en què no es vegin dades i aparegui el missatge d'error següent:  ![](../../../../../assets/en/manual/web_interface/error_message_1.png){width="600"}  El missatge d'error en aquest cas és el següent:       No es pot veure la cua d'elements. Permís denegat  Això passa quan els paràmetres de configuració PHP del fitxer *zabbix.conf.php* - `$ZBX_SERVER` o tots dos `$ZBX_SERVER` i `$ZBX_SERVER_PORT` - apunten a un servidor Zabbix existent que empra una base de dades diferent.

en-us	### PostgreSQL  Export and import must be performed in tmux/screen to ensure that the session isn't dropped. For installations with TimescaleDB, skip this section and proceed to [PostgreSQL + TimescaleDB](#postgresql-timescaledb).  See also: [Important notes](#important-notes)  #### Table upgrade  * Rename tables using `history_pk_prepare.sql`:  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  #### Migration with stopped server  * Export current history, import it to the temp table,  then insert the data into new tables while ignoring duplicates:  ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  See tips for improving INSERT performance: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data), [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal).  * Follow [post-migration instructions](#post-migration) to drop the old tables.
ca	### PostgreSQL  Exportar i importar s'ha de fre des de la tmux/screen, per assegurar-nos que la sessió no es perd. Per instal·lacions amb TimescaleDB, salteu aquesta secció i procediu amb [PostgreSQL + TimescaleDB](#postgresql-timescaledb).  Veieu també: [Notes importants](#important-notes)  #### Actualització de la taula  * Reanomeneu les taules emprant `history_pk_prepare.sql`:  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ```  #### Migració amb el servidor aturat  * Exporteu l'historial actual, importeu-lo a la taula temporal, i després inseriu la informació a noves taules ignorant duplicitats:  ``` {.sql} INSERT INTO history SELECT * FROM history_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_uint SELECT * FROM history_uint_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_str SELECT * FROM history_str_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_log SELECT * FROM history_log_old ON CONFLICT (itemid,clock,ns) DO NOTHING;  INSERT INTO history_text SELECT * FROM history_text_old ON CONFLICT (itemid,clock,ns) DO NOTHING; ```  Veieu els consells per millorar el rendiment d'INSERT: [PostgreSQL: Bulk Loading Huge Amounts of Data](https://www.cybertec-postgresql.com/en/postgresql-bulk-loading-huge-amounts-of-data), [Checkpoint Distance and Amount of WAL](https://www.cybertec-postgresql.com/en/checkpoint-distance-and-amount-of-wal).  * Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues.

en-us	#### PostgreSQL  If a value contains a non-ASCII character in non UTF8 encoding - this will lead to a failed SQL query (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) and data will not be stored. An appropriate warning message will be written to the *zabbix\_server.log*.\ Relevant for at least PostgreSQL version 9.1.3
ca	#### PostgreSQL  Si un valor conté un caràcter no-ASCII amb una codificació no-UTF8, hi haurà una petició SQL fallida (PGRES\_FATAL\_ERROR:ERROR invalid byte sequence for encoding) i les dades no s'emmagatzemaran pas. S'escriurà un missatge d'avís a *zabbix\_server.log*.\ Pertinent com a mínim per la versió 9.1.3 de PostgreSQL.

en-us	 #### PostgreSQL plugin parameters  The following PostgreSQL plugin parameters are no longer mandatory if Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect is set to *verify_ca* or *verify_full*:  -   Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile -   Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile
ca	 #### Paràmetres del plugin PostgreSQL**  Els paràmetres del connector PostgreSQL següents ja no són obligatoris si Plugins.PostgreSQL.Sessions.<SessionName>.TLSConnect s'estableix a *verify_ca* o *verify_full*:  - Plugins.PostgreSQL.Sessions.<SessionName>.TLSCertFile - Plugins.PostgreSQL.Sessions.<SessionName>.TLSKeyFile

en-us	 #### PostgreSQL-TimescaleDB combination no longer checked  Zabbix no longer checks for the supported PostgreSQL-TimescaleDB combination. As before, Zabbix does check for the supported PostgreSQL version or TimescaleDB version separately.
ca	 #### La combinació PostgreSQL-TimescaleDB ja no és pas marcada  Zabbix ja no comprova la combinació PostgreSQL-TimescaleDB. Com abans, Zabbix comprova per separat la versió PostgreSQL compatible o la versió TimescaleDB.

en-us	 ### PostgreSQL + TimescaleDB  Export and import must be performed in tmux/screen to ensure that the session isn't dropped. Zabbix server should be down during the upgrade.  See also: [Important notes](#important-notes)  * Rename tables using `history_pk_prepare.sql`.  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` * Run TimescaleDB hypertable migration scripts (compatible with both TSDB v2.x and v1.x version) based on compression settings:   * If compression is enabled (on default installation), run scripts from `/usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```   * If compression is disabled, run scripts from `/usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```  See also: [Tips](https://blog.timescale.com/blog/13-tips-to-improve-postgresql-insert-performance/) for improving INSERT performance.  * Follow [post-migration instructions](#post-migration) to drop the old tables.
ca	### PostgreSQL + TimescaleDB  La exportació i importació s'ha de fer amb tmux/screen per assegurar que la sessió no es tanca. El servidor de Zabbix ha d'ésser aturat durant l'actualització.  Veieu també: [Notes importants](#important-notes)  * Reanomeneu les taules emprant `history_pk_prepare.sql`.  ``` {.bash} sudo -u zabbix psql zabbix < /usr/share/zabbix-sql-scripts/postgresql/history_pk_prepare.sql ``` * Executeu els scripts de migració d'hipertaula TimescaleDB (compatible amb les versions v2.x i v1.x de TSDB) en base a la configuració de compressió:   * Si la compressió és activa (a les instal·lacions per defecte), executeu els scripts des de `database/postgresql/tsdb_history_pk_upgrade_with_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_with_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```   * Si la compressió és desactivada, executeu els scripts des de `database/postgresql/tsdb_history_pk_upgrade_no_compression`:     ``` {.bash}     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_uint.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_log.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_str.sql | sudo -u zabbix psql zabbix     cat /usr/share/zabbix-sql-scripts/postgresql/tsdb_history_pk_upgrade_no_compression/history_pk_text.sql | sudo -u zabbix psql zabbix     ```  Veieu també: [Consells](https://blog.timescale.com/blog/13-tips-to-improve-postgresql-insert-performance/) per millorar el rendiment de l'INSERT.  * Seguiu les [instruccions de post-migració](#post-migration) per buidar les taules antigues.

en-us	#### PostgreSQL  You need to have database user with permissions to create database objects.   If you are installing from Zabbix **packages**, proceed to the [instructions](https://www.zabbix.com/download) for your platform.  If you are installing Zabbix from sources:  * Create a database user.  The following shell command will create user `zabbix`. Specify a password when prompted and repeat the password (note, you may first be asked for `sudo` password):  ```bash sudo -u postgres createuser --pwprompt zabbix ```  * Create a database.  The following shell command will create the database `zabbix` (last parameter) with the previously created user as the owner (`-O zabbix`).  ```bash sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix ```  * Import the initial schema and data (assuming you are in the root directory of Zabbix sources). For a Zabbix proxy database, only `schema.sql` should be imported (no images.sql nor data.sql).  ```bash cd database/postgresql cat schema.sql | sudo -u zabbix psql zabbix # stop here if you are creating database for Zabbix proxy cat images.sql | sudo -u zabbix psql zabbix cat data.sql | sudo -u zabbix psql zabbix ```  ::: noteimportant The above commands are provided as an example that will work in most of GNU/Linux installations. You can use different commands depending on how your system/database is configured, for example: <br><br> `psql -U <username>` <br><br> If you have any trouble setting up the database, please consult your Database administrator. :::
ca	#### PostgreSQL  Us cal tindre un usuari de la base de dades amb permisos per crear objectes a la base de dades.  Si instal·leu des dels **packages** Zabbix, seguiu les [instruccions](https://www.zabbix.com/download) de la vostra plataforma.  Si instal·leu Zabbix des de les fonts:  * Creeu un usuari de la base de dades.  Aquesta comanda crearà l'usuari `zabbix`. Definiu una paraula de pas quan us ho demani, i repetiu-la (fixeu-vos que primer us demanarà la paraula de pas per executar la comanda `sudo`):  ```bash sudo -u postgres createuser --pwprompt zabbix ```  * Crear la base de dades.  La següent comanda crearà la base de dades `zabbix` (darrer paràmetre), definint com a propietari l'usuari crear abans (`-O zabbix`).  ```bash sudo -u postgres createdb -O zabbix -E Unicode -T template0 zabbix ```  * Importeu l'esquema inicial i la informació (assumint que sou al directory arrel de les fonts de Zabbix). Per la base de dades del proxy de Zabbix, només s'ha d'importar `schema.sql` (ni images.sql ni data.sql).  ```bash cd database/postgresql cat schema.sql | sudo -u zabbix psql zabbix # stop here if you are creating database for Zabbix proxy cat images.sql | sudo -u zabbix psql zabbix cat data.sql | sudo -u zabbix psql zabbix ```  ::: noteimportant Les comandes de més amunt són un exemple que funcionarà a la majoria d'instal·lacions GNU/Linux. Podeu emprar comandes diferents segons on sigui configurat el vostre sistema/base de dades, per exemple: <br><br> `psql -U <username>` <br><br> Si teniu cap problema configurant la base de dades, consulteu l'administrador de bases de dades. :::

en-us	 ### Post-migration  For all databases, once the migration is completed, do the following:  * Verify that everything works as expected.  * Drop old tables:  ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```
ca	### Post-migració  Per a totes les bases de dades, una vegada hagueu enllestit la migració, procediu així:  * Verifiqueu que tot funciona com hagueu previst.  * Esborreu les taules antigues:  ``` {.sql} DROP TABLE history_old; DROP TABLE history_uint_old; DROP TABLE history_str_old; DROP TABLE history_log_old; DROP TABLE history_text_old; ```

en-us	#### - Potential errors  Functions return -1 in such situations:  -   specified evaluation period contains no data;  ```{=html} <!-- --> ``` -   result of mathematical operation is not defined[^3];  ```{=html} <!-- --> ``` -   numerical complications (unfortunately, for some sets of input data     range and precision of double-precision floating-point format become     insufficient)[^4].  ::: notetip No warnings or errors are flagged if chosen fit poorly describes provided data or there is just too few data for accurate prediction. :::
ca	#### - Errades potencials  Les funcions tornen -1 en aquestes situacions:  - el període d'avaluació especificat no conté cap dada;  ```{=html} <!-- --> ``` - el resultat de l'operació matemàtica no és pas definit [^3];  ```{=html} <!-- --> ``` - complicacions numèriques (malauradament, per a alguns conjunts de dades d'entrada, la doble precisió i el punt flotant són insuficients) [^4].  ::: notetip No es notifica cap avís ni error si l'ajust escollit descriu malament les dades proporcionades o si hi ha massa poques dades per a una predicció precisa. :::

en-us	 ##### power(value,power value) {#power}  The power of a value.  Parameter:   -   **value** - the value to check; -   **power value** - the Nth power to use.  For example, the 3rd power of a value '2' will be '8'.  Example:      power(last(/host/key),3)
ca	 ##### power(value,power value) {#power}  Potència d'un valor.  Paràmetre:  - **valor** - valor a comprovar; - **valor de potència** - la potència enèssima a emprar.  Per exemple, la tercera potència d'un valor '2' serà '8'.  Exemple:      power(last(/host/key),3)

en-us	#### Predefined scripts  Scripts that are available for action operations (webhook, script, SSH, Telnet, IPMI) are defined in  [global scripts](/manual/web_interface/frontend_sections/alerts/scripts).  For example:      sudo /etc/init.d/apache restart   In this case, Zabbix will try to restart an Apache process. With this command, make sure that the command is executed on Zabbix agent (click the *Zabbix agent* button against *Execute on*).  ::: noteimportant Note the use of **sudo** - Zabbix user does not have permissions to restart system services by default. See below for hints on how to configure **sudo**. :::  ::: noteclassic Zabbix agent should run on the remote host and accept incoming connections. Zabbix agent executes commands in background. :::  Remote commands on Zabbix agent are executed without timeout by the system.run\[,nowait\] key and are not checked for execution results. On Zabbix server and Zabbix proxy, remote commands are executed with timeout as set in the TrapperTimeout parameter of zabbix\_server.conf or zabbix\_proxy.conf file and are [checked](/manual/appendix/command_execution#exit_code_checking) for execution results.
ca	#### Scripts predefinits  Tots els scripts (webhook, script, SSH, Telnet, IPMI) disponibles per a operacions d'acció es defineixen als [scripts globals](/manual/web_interface/frontend_sections/administration/scripts).  Per exemple :       sudo /etc/init.d/apache restart  En aquest cas, Zabbix intentarà reiniciar un procés Apache. Amb aquesta ordre, assegureu-vos que l'ordre s'executa a l'agent Zabbix (feu clic al botó *Agent Zabbix* al costat d'*Executar*).  ::: noteimportant Tingueu en compte que per emprar **sudo** l'usuari de Zabbix no té permisos per reiniciar els serveis del sistema de manera predeterminada. Consulteu els consells de configuració de **sudo** a continuació. :::  :::noteclassic L'agent Zabbix s'ha d'executar a l'equip remot i acceptar connexions entrants. L'agent Zabbix executa ordres en segon pla. :::  Les ordres remotes de l'agent Zabbix s'executen sense demora mitjançant la clau system.run\[,nowait\] i els resultats de l'execució no es comproven. Al servidor Zabbix, les ordres remotes s'executen amb el temps d'espera definit al paràmetre TrapperTimeout al fitxer zabbix\_server.conf i els seus resultats són [comprovats](/manual/appendix/command_execution#exit_code_checking).

en-us	#### Pre-installation summary  Review a summary of settings.  ![](../../../assets/en/manual/installation/install_5.png){width="550"}
ca	#### resum de la pre-instal·lació  Reviseu el resum de la configuració.  ![](../../../assets/en/manual/installation/install_5.png){width="550"}

en-us	##### Preparation  Zabbix agent is distributed as a zip archive. After you download the archive you need to unpack it. Choose any folder to store Zabbix agent and the configuration file, e. g.      C:\zabbix  Copy bin\\zabbix\_agentd.exe and conf\\zabbix\_agentd.conf files to c:\\zabbix.  Edit the c:\\zabbix\\zabbix\_agentd.conf file to your needs, making sure to specify a correct "Hostname" parameter.
ca	##### Preparació  L’agent Zabbix es distribueix en forma d'arxiu zip. Després de descarregar l'arxiu, haureu de descomprimir-lo. Podeu triar la carpeta que vulgueu per emmagatzemar l’agent Zabbix i l'arxiu de configuració. Per exemple:      C:\zabbix  Copieu els arxius bin\\zabbix\_agentd.exe i conf\\zabbix\_agentd.conf a la destinació triada abans.  Editeu l'arxiu c:\\zabbix\\zabbix\_agentd.conf segons la vostra necessitat, i tingueu cura d'especificar correctament el paràmetre “Hostname”.

en-us	 ## Prepare Apache  1\. Check, which Apache version you are using:  On RHEL-based system, run:      httpd -v  On Debian/Ubuntu, run:      apache2 -v  2\. Make sure that the [Status module](https://httpd.apache.org/docs/2.4/mod/mod_status.html) is enabled in your Apache  instance.   On RHEL-based system, run:      httpd -M | grep status     status_module (shared)      On Debian/Ubuntu, run:          apache2ctl -M | grep status     status_module (shared)  If you don't see status_module in the list, enable the module  by running:  On RHEL-based system, run:      LoadModule status_module /usr/lib/apache2/modules/mod_status.so     On Debian/Ubuntu, run:      sudo /usr/sbin/a2enmod status  3\. Edit Apache configuration file to allow access to status reports from Zabbix server IP.   On an RHEL-based system: `/etc/httpd/conf.modules.d/status.conf`:      sudo vi /etc/httpd/conf.modules.d/status.conf  On Debian/Ubuntu:  `/etc/apache2/mods-enabled/status.conf`:      sudo vi /etc/apache2/mods-enabled/status.conf  Add the following lines to the file (**replace 198.51.100.255** with your Zabbix server IP address):  * For Apache 2.2: \     <Location /server-status>     SetHandler server-status      Order Deny,Allow     Deny from all     Allow from 198.51.100.255     </Location>  - For Apache 2.4: \     <Location "/server-status">     SetHandler server-status     Require ip 198.51.100.255     </Location>  4\. Restart Apache  On an RHEL-based system, run:      sudo systemctl restart httpd     On Debian/Ubuntu, run:      sudo systemctl restart apache2   5\. To check, if everything is configured correctly, run (**replace 198.51.100.255** with your Zabbix server IP address):      curl 198.51.100.255/server-status  The response should contain Apache web server statistics. 
ca	 ## Preparar Apache  1\. Reviseu quina versió d'Apache teniu:  A sistemes basats en RHEL, executeu:      httpd -v  A Debian/Ubuntu, executeu:      apache2 -v  2\. Assegureu-vos que el [mòdul status](https://httpd.apache.org/docs/2.4/mod/mod_status.html) és actiu a la vostra instància d'Apache.   A sistemes basats en RHEL, executeu:      httpd -M | grep status     status_module (shared)      A Debian/Ubuntu, executeu:          apache2ctl -M | grep status     status_module (shared)  Si no veieu status_module a la llista, activeu el mòdul executant:  A sistemes basats en RHEL, executeu:      LoadModule status_module /usr/lib/apache2/modules/mod_status.so     A Debian/Ubuntu, executeu:      sudo /usr/sbin/a2enmod status  3\. Editeu la configuració de l'arxiu d'per permetre accés als informes d'estat des de la IP del servidor Zabbix.   A sistemes basats en RHEL: `/etc/httpd/conf.modules.d/status.conf`:      sudo vi /etc/httpd/conf.modules.d/status.conf  A Debian/Ubuntu:  `/etc/apache2/mods-enabled/status.conf`:      sudo vi /etc/apache2/mods-enabled/status.conf  Afegiu les línies següents a l'arxiu (**substituïu 198.51.100.255** amb l'adreça IP del vostre servidor de Zabbix):  * Per Apache 2.2: \     <Location /server-status>     SetHandler server-status      Order Deny,Allow     Deny from all     Allow from 198.51.100.255     </Location>  - Per Apache 2.4: \     <Location "/server-status">     SetHandler server-status     Require ip 198.51.100.255     </Location>  4\. Reinicieu Apache  A sistemes basats en RHEL, executeu:      sudo systemctl restart httpd     A Debian/Ubuntu, executeu:      sudo systemctl restart apache2   5\. Per veure si tot funciona correctament, executeu (**substituïu 198.51.100.255** amb l'areça IP del vostre servidor de Zabbix):      curl 198.51.100.255/server-status  La resposta ha de contindre les estadístiques del servidor web Apache.

en-us	##### Preparing frontend  Make sure that Zabbix server address:port is **not defined** in the  frontend configuration (found in `conf/zabbix.conf.php` of the frontend  files directory).  ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"}  Zabbix frontend will autodetect the active node by reading settings  from the nodes table in Zabbix database. Node address of the active node  will be used as the Zabbix server address.
ca	##### Preparant la interfície  Assegureu-vos que l'adreça:port del servidor Zabbix sigui **no definida** a la configuració de la interfície (situada a `conf/zabbix.conf.php' del directori de fitxers de la interfície).  ![](../../../../assets/en/manual/config/frontend_conf_server_port.png){width="600"}  La interfície Zabbix detectarà automàticament el node actiu llegint els paràmetres de la taula de nodes a la base de dades Zabbix. L'adreça del node actiu s'emprarà com a adreça del servidor Zabbix.

en-us	 #### Preprocessing caching  Preprocessing caching was introduced to improve the preprocessing performance for multiple dependent items having similar preprocessing steps (which is a common LLD outcome).  Caching is done by preprocessing one dependent item and reusing some of the internal preprocessing data for the rest of the dependent items. The preprocessing cache is supported only for the first preprocessing step of the following types:  *   Prometheus pattern (indexes input by metrics) *   JSONPath (parses the data into object tree and indexes the first expression `[?(@.path == "value")]`)
ca	 #### Preprocessament de la memòria cau  La memòria cau del preprocessament es va introduir per millorar el rendiment del preprocessament per a diversos elements dependents amb passes de preprocessament similars (que és un resultat comú de LLD).  La memòria cau es fa preprocessant un element dependent i reutilitzant algunes de les dades de preprocessament intern per a la resta d'elements dependents. La memòria cau de preprocessament només s'admet a la primera passa de preprocessament dels tipus següents:  * Patró Prometheus (índexs introduïts per mètriques) * JSONPath (analitza les dades a l'arbre d'objectes i indexa la primera expressió `[?(@.path == "valor")]`)

en-us	#### Preprocessing queue  The preprocessing queue is organized as:  *   the list of pending tasks:     *   tasks created directly from value preprocessing requests in the order they were received.  *   the list of immediate tasks (processed before pending tasks):     *   testing tasks (created in response to item/preprocessing testing requests by the frontend)     *   dependent item tasks     *   sequence tasks (tasks that must be executed in a strict order):         *   having preprocessing steps using the last value:             *   change             *   throttling             *   JavaScript (bytecode caching)         *   dependent item preprocessing caching  *   the list of finished tasks
ca	#### Cua de preprocessament  La cua de preprocessament s'organitza com:  * llista de tasques pendents:      * tasques creades directament a partir de peticions de preprocessament de valors en l'ordre en què es van rebre.  * llista de tasques immediates (processades abans de les tasques pendents):      * tasques de prova (creades com a resposta a les peticions de prova d'elements/preprocessament per part del frontend)      * tasques d'elements dependents      * tasques de seqüència (tasques que s'han d'executar en un ordre estricte):          * tenir passos de preprocessament emprant el darrer valor:              * canviar              * estrangulament              * JavaScript (emmagatzematge en memòria cau de bytecode)          * memòria cau del preprocessament d'elements dependents  * la llista de tasques acabades

en-us	#### Preprocessing test result truncation  When [testing preprocessing steps](/manual/config/items/preprocessing#testing), test results are now truncated to a maximum size of 512KB when sent to the frontend. Note that data larger than 512KB is still processed fully by Zabbix server.
ca	#### Preprocessament de l'escurçament del resultat de la prova  Quan es [proven les passes de preprocessament](/manual/config/items/preprocessing#testing), els resultats de la prova s'escurcen ara a una mida màxima de 512 Ko quan s'envien a la interfície. Tingueu en compte que les dades de més de 512 Ko encara es processen completament al servidor Zabbix.

en-us	#### Preprocessing  The **Preprocessing** tab allows to define transformation rules to apply to the result of discovery. One or several transformations are possible in this step. Transformations are executed in the order in which they are defined. All preprocessing is done by Zabbix server.  See also:  -   [Preprocessing     details](/manual/config/items/preprocessing/preprocessing_details) -   [Preprocessing testing](/manual/config/items/preprocessing#testing)  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_b.png)   |Type|<|<| |-|----------|----------------------------------------| | |*Transformation*|Description| |Text|<|<| |<|*Regular expression*|Match the received value to the <pattern> regular expression and replace value with the extracted <output>. The regular expression supports extraction of maximum 10 captured groups with the \\N sequence.<br>Parameters:<br>**pattern** - regular expression<br>**output** - output formatting template. An \\N (where N=1…9) escape sequence is replaced with the Nth matched group. A \\0 escape sequence is replaced with the matched text.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Replace*|Find the search string and replace it with another (or nothing). All occurrences of the search string will be replaced.<br>Parameters:<br>**search string** - the string to find and replace, case-sensitive (required)<br>**replacement** - the string to replace the search string with. The replacement string may also be empty effectively allowing to delete the search string when found.<br>It is possible to use escape sequences to search for or replace line breaks, carriage return, tabs and spaces "\\n \\r \\t \\s"; backslash can be escaped as "\\\\" and escape sequences can be escaped as "\\\\n". Escaping of line breaks, carriage return, tabs is automatically done during low-level discovery.<br>Supported since 5.0.0.| |Structured data|<|<| |<|*JSONPath*|Extract value or fragment from JSON data using [JSONPath functionality](/manual/config/items/preprocessing/jsonpath_functionality).<br>If you mark the Custom on fail checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |<|*XML XPath*|Extract value or fragment from XML data using XPath functionality.<br>For this option to work, Zabbix server must be compiled with libxml support.<br>Examples:<br>`number(/document/item/value)` will extract `10` from `<document><item><value>10</value></item></document>`<br>`number(/document/item/@attribute)` will extract `10` from `<document><item attribute="10"></item></document>`<br>`/document/item` will extract `<item><value>10</value></item>` from `<document><item><value>10</value></item></document>`<br>Note that namespaces are not supported.<br>Supported since 4.4.0.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |<|*CSV to JSON*|Convert CSV file data into JSON format.<br>For more information, see: [CSV to JSON preprocessing](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).<br>Supported since 4.4.0.| |^|*XML to JSON*|Convert data in XML format to JSON.<br>For more information, see: [Serialization rules](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |SNMP|<|<| | |*SNMP walk value*|Extract value by the specified OID/MIB name and apply formatting options:<br>**Unchanged** - return Hex-STRING as unescaped hex string;<br>**UTF-8 from Hex-STRING** - convert Hex-STRING to UTF-8 string;<br>**MAC from Hex-STRING** - convert Hex-STRING to MAC address string (which will have  `' '` replaced by `':'`);<br>**Integer from BITS** - convert the first 8 bytes of a bit string expressed as a sequence of hex characters (e.g. "1A 2B 3C 4D") into a 64-bit unsigned integer. In bit strings longer than 8 bytes, consequent bytes will be ignored.<br>If you mark the Custom on fail checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| | |*SNMP walk to JSON*|Convert SNMP values to JSON. Specify a field name in the JSON and the corresponding SNMP OID path. Field values will be populated by values in the specified SNMP OID path.<br>You may use this preprocessing step for [SNMP OID discovery](/manual/discovery/low_level_discovery/examples/snmp_oids_walk).<br>Similar value formatting options as in the *SNMP walk value* step are available.<br>If you mark the Custom on fail checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |Custom scripts|<|<| |<|*JavaScript*|Enter JavaScript code in the block that appears when clicking in the parameter field or on the pencil icon.<br>Note that available JavaScript length depends on the [database used](/manual/config/items/item#custom_script_limit).<br>For more information, see: [Javascript preprocessing](/manual/config/items/preprocessing/javascript)| |Validation|<|<| |<|*Does not match regular expression*|Specify a regular expression that a value must not match.<br>E.g. `Error:(.*?)\.`<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Check for error in JSON*|Check for an application-level error message located at JSONPath. Stop processing if succeeded and message is not empty; otherwise continue processing with the value that was before this preprocessing step. Note that these external service errors are reported to user as is, without adding preprocessing step information.<br>E.g. `$.errors`. If a JSON like `{"errors":"e1"}` is received, the next preprocessing step will not be executed.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |^|*Check for error in XML*|Check for an application-level error message located at xpath. Stop processing if succeeded and message is not empty; otherwise continue processing with the value that was before this preprocessing step. Note that these external service errors are reported to user as is, without adding preprocessing step information.<br>No error will be reported in case of failing to parse invalid XML.<br>Supported since 4.4.0.<br>If you mark the *Custom on fail* checkbox, it is possible to specify custom error-handling options: either to discard the value, set a specified value or set a specified error message.| |Throttling|<|<| |<|*Discard unchanged with heartbeat*|Discard a value if it has not changed within the defined time period (in seconds).<br>Positive integer values are supported to specify the seconds (minimum - 1 second). Time suffixes can be used in this field (e.g. 30s, 1m, 2h, 1d). User macros and low-level discovery macros can be used in this field.<br>Only one throttling option can be specified for a discovery item.<br>E.g. `1m`. If identical text is passed into this rule twice within 60 seconds, it will be discarded.<br>*Note*: Changing item prototypes does not reset throttling. Throttling is reset only when preprocessing steps are changed.| |Prometheus|<|<| |<|*Prometheus to JSON*|Convert required Prometheus metrics to JSON.<br>See [Prometheus checks](/manual/config/items/itemtypes/prometheus) for more details.|  Note that if the discovery rule has been applied to the host via template then the content of this tab is read-only.
ca	#### Preprocessament  La pestanya **Preprocessament** permet definir regles de transformació per aplicar al resultat de la descoberta. En aquesta passa són possibles una o diverses transformacions. Les transformacions s'executen en l'ordre en què es defineixen. Tot el preprocessament el fa el servidor Zabbix.  Veieu també:  - [Detalls del preprocessament](/manual/config/items/preprocessing/preprocessing_details) - [Proves de preprocessament](/manual/config/items/preprocessing#testing)  ![](../../../assets/en/manual/discovery/low_level_discovery/lld_fs_b.png)   |Tipus|<|<| |-|-----------|-------------------------------------- ----| | |*Transformació*|Descripció| |Text|<|<| |<|*Expressió regular*|Fa coincidir el valor rebut amb l'expressió regular <patró> i substitueix el valor amb la <sortida> extreta. L'expressió regular admet l'extracció d'un màxim de 10 grups capturats amb la seqüència \\N.<br>Paràmetres:<br>**patró** - expressió regular<br>**sortida** - plantilla de format de sortida. Una seqüència d'escapada \\N (on N=1...9) es substitueix per l'enèssim grup coincident. Una seqüència d'escapada \\0 es substitueix pel text coincident.<br>Si marqueu la casella de selecció *Personalitzada en cas d'error*, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*Reemplaça*|Cerca la cadena de cerca i substitueix-la per una altra (o res). Se substituiran totes les ocurrències de la cadena de cerca.<br>Paràmetres:<br>**cadena de cerca** - la cadena a cercar i substituir, distingeix entre majúscules i minúscules (obligatori)<br>**reemplaçament** - la cadena a cercar per substituir. La cadena de substitució també pot ésser buida de manera efectiva, permetent esborrar la cadena de cerca quan es trobi.<br>És possible emprar seqüències d'escapada per cercar o substituir salts de línia, retorn de carro, tabulacions i espais "\\n \\r \\ t \\s"; La barra invertida es pot escapar com a "\\\\" i les seqüències d'escapament es poden escapar com a "\\\\n". L'escapament dels salts de línia, el retorn de carro i les pestanyes es fa automàticament durant la descoberta de baix nivell.<br>Suportat des de la versió 5.0.0.| |Dades estructurades|<|<| |<|*JSONPath*|Extreu el valor o el fragment de les dades JSON mitjançant la [funcionalitat JSONPath](/manual/config/items/preprocessing/jsonpath_functionality).<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, l'element no s'admetrà en cas d'error en el passa de preprocessament i és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |<|*XML XPath*|Extreu valor o fragment de dades XML mitjançant la funcionalitat XPath.<br>Per tal que aquesta opció funcioni, el servidor Zabbix s'ha de compilar amb suport libxml.<br>Exemples:<br>`number(/document /item/value)` extreu `10` de `<document><item><value>10</value></item></document>`<br>`number(/document/item/@attribute)` extreu `10` de `<document><item attribute="10"></item></document>`<br>`/document/item` extreu `<item><value>10</value ></item>` de `<document><item><value>10</value></item></document>`<br>Tingueu en compte que els espais de noms no són compatibles.<br>S'admet des de la versió 4.4.0. <br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |<|*CSV a JSON*|Convertir les dades del fitxer CSV al format JSON.<br>Per obtindre més informació, consulteu: [Preprocessament de CSV a JSON](/manual/config/items/preprocessing/csv_to_json#csv_header_processing).<br> Suportat des de la versió 4.4.0.| |^|*XML a JSON*|Converteix les dades en format XML a JSON.<br>Per obtindre més informació, veieu: [Regles de serialització](/manual/config/items/preprocessing/javascript/javascript_objects#serialization_rules).<br> Si marqueu la casella de selecció *Personalitzat en cas d'error*, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Scripts personalitzats|<|<| |<|*JavaScript*|Introduïu el codi JavaScript al bloc que apareix quan feu clic al camp de paràmetres o a *Obrir*.<br>Tingueu en compte que la longitud de JavaScript disponible depèn de la [base de dades emprada](/manual/config/items/ item#custom_script_limit).<br>Per obtindre més informació, veieu: [Preprocessament de JavaScript](/manual/config/items/preprocessing/javascript)| |Validació|<|<| |<|*No coincideix amb l'expressió regular*|Especifiqueu una expressió regular amb la qual un valor no ha de coincidir.<br>Ex. `Error:(.*?)\.`<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*Comprovar si hi ha errors a JSON*|Comprova si hi ha un missatge d'error a nivell d'aplicació situat a JSONPath. Atura el processament si s'ha realitzat correctament i el missatge no és buit; en cas contrari, continua el processament amb el valor que hi havia abans d'aquesta passa de preprocessament. Tingueu en compte que aquests errors de servei extern s'informa a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.<br>P. `$.errors`. Si es rep un JSON com `{"errors":"e1"}`, la següent passa de preprocessament no s'executarà.<br>Si marqueu la *Casella de selecció personalitzada en cas d'error*, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |^|*Comprovar si hi ha errors a l'XML*|Comprova si hi ha un missatge d'error a nivell d'aplicació situat a xpath. Atura el processament si s'ha realitzat correctament i el missatge no és buit; en cas contrari, continueu el processament amb el valor que hi havia abans d'aquest passa de preprocessament. Tingueu en compte que aquests errors de servei extern s'informaran a l'usuari tal qual, sense afegir informació sobre la passa de preprocessament.<br>No s'informarà d'error en cas de no poder analitzar un XML no vàlid.<br>Suportat des de la versió 4.4.0.<br>Si marqueu la casella de selecció *Personalitzat en cas d'error*, és possible especificar opcions de gestió d'errors personalitzades: per descartar el valor, establir un valor especificat o establir un missatge d'error especificat.| |Accelerar|<|<| |<|*Descartar sense canvis amb heartbeat*|Descartar un valor si no ha canviat dins del període de temps definit (en segons).<br>S'admeten valors enters positius per especificar els segons (mínim - 1 segon). Els sufixos de temps es poden emprar en aquest camp (per exemple, 30 s, 1 m, 2 h, 1 d). En aquest camp es poden emprar macros d'usuari i macros de descoberta de baix nivell.<br>Només es pot especificar una opció d'acceleració per a un element de descoberta.<br>Ex. `1m`. Si es passa un text idèntic a aquesta regla dues vegades en 60 segons, es descartarà.<br>*Nota*: Canviar els prototips d'elements no restableix l'acceleració. L'acceleració només es restableix quan es canvien els passos de preprocessament.| |Prometheus|<|<| |<|*Prometheus a JSON*|Convertiu les mètriques de Prometheus requerides a JSON.<br>Consulteu les [comprovacions de Prometheus](/manual/config/items/itemtypes/prometheus) per a més detalls.|  Tingueu en compte que si la regla de descoberta s'ha aplicat a l'equip mitjançant una plantilla, el contingut d'aquesta pestanya és només de lectura.

en-us	#### Preprocessing workers  The Zabbix server configuration file allows users to set the count of preprocessing worker threads. The StartPreprocessors configuration parameter should be used to set the number of pre-started instances of preprocessing workers. The optimal number of preprocessing workers can be determined by many factors, including the count of "preprocessable" items (items that require to execute any preprocessing steps), the count of data gathering processes, the average step count for item preprocessing, etc.  But assuming that there are no heavy preprocessing operations like parsing large XML/JSON chunks, the number of preprocessing workers can match the total number of data gatherers. This way, there will mostly (except for the cases when data from the gatherer comes in bulk) be at least one unoccupied preprocessing worker for collected data.  ::: notewarning Too many data gathering processes (pollers, unreachable pollers, ODBC pollers, HTTP pollers,  Java pollers, pingers, trappers, proxypollers) together with IPMI manager, SNMP trapper  and preprocessing workers can exhaust the per-process file descriptor limit for the  preprocessing manager. This will cause Zabbix server to stop (usually shortly after  the start, but sometimes it can take more time). The configuration file should be  revised or the limit should be raised to avoid this situation. :::
ca	#### Processos de treball de preprocessament  El fitxer de configuració del servidor Zabbix permet als usuaris establir el nombre de processos de treball de preprocessament. El paràmetre de configuració StartPreprocessors s'ha d'emprar per establir el nombre d'instàncies pre-bifurcades dels processos de treball de preprocessament. El nombre òptim de processos de treball de preprocessament es pot determinar per molts factors, inclòs el nombre d'elements "preprocessables" (elements que requereixen que es facin passes de preprocessament), el nombre de processos de recollida de dades, el nombre mitjà de passes per al preprocessament d'elements, etc. .  Però suposant que no hi hagi operacions de preprocessament pesades com ara l'anàlisi de grans blocs XML/JSON, el nombre de processos de treball de preprocessament pot coincidir amb el nombre total de recopiladors de dades. D'aquesta manera hi haurà la majoria de les vegades (excepte en els casos en què les dades del col·lector arriben mica en mica) almenys un preprocessador inactiu per a les dades recollides.  ::: notewarning Massa processos de recollida de dades (enquestadors, enquestadors d'inaccessibilitat, enquestadors ODBC, enquestadors HTTP, pollers Java, pingers, trappers, proxypollers) associats amb el gestor IPMI, el trapper SNMP i els agents de preprocessament poden esgotar el límit de descriptors de fitxer per procés per al gestor de preprocessament. Això farà que el servidor Zabbix s'aturi (normalment poc després de l'inici, però de vegades pot trigar més). S'ha de revisar el fitxer de configuració o pujar el límit per evitar aquesta situació. :::

en-us	## Pre-requisites  Before proceeding make sure, that:  - The module is located inside the *modules* directory of your Zabbix frontend installation (for example, *zabbix/ui/modules*). - The module has at least a basic version of [manifest.json](/devel/modules/file_structure/manifest) file. - You have access to the Administration menu section in Zabbix (requires Super admin user role type).  :::notetip The frontend will not install or even recognize incompatible modules. :::
ca	## Pre-requisits  Abans de continuar, assegureu-vos que:  - El mòdul és al directori de *mòduls* de la vostra instal·lació de Zabbix (com ara *zabbix/ui/modules*). - El mòdul té almenys una versió bàsica del fitxer [manifest.json](/devel/modules/file_structure/manifest). - Teniu accés a la secció del menú Administració a Zabbix (requereix el tipus de rol d'usuari superadministrador).  :::notetip La interfície no instal·larà ni reconeixerà mòduls incompatibles. :::

en-us	**Prerequisites**  Before proceeding with this guide, you need to [download and install](https://www.zabbix.com/download) Zabbix server and Zabbix frontend according to the instructions for your OS.  This guide is based on the following setup:  - Zabbix version: 6.4 (installed from packages) - OS distribution: Ubuntu - OS version: 22.04 (Jammy) - Zabbix components: Server, Frontend, Agent - Database: MySQL - Web server: Apache  It is assumed that VMware is already configured. This guide does not cover the configuration of VMware.
ca	**Prerequisits**  Abans de continuar amb aquesta guia, heu de [descarregar i instal·lar](https://www.zabbix.com/download) el servidor Zabbix i la interfície Zabbix segons les instruccions del vostre sistema operatiu.  Aquesta guia es basa en la configuració següent:  - Versió Zabbix: 6.4 (instal·lat des de paquets) - Distribució del sistema operatiu: Ubuntu - Versió del sistema operatiu: 22.04 (Jammy) - Components Zabbix: Servidor, Frontend, Agent - Base de dades: MySQL - Servidor web: Apache  Assumim que VMware ja és configurat. Aquesta guia no expecifica la configuració de VMware.

en-us	**Prerequisites**  Before proceeding with this guide, you need to [download and install](https://www.zabbix.com/download) Zabbix server, Zabbix frontend and Zabbix agent 2 according to the instructions for your OS.  Based on your setup, some of the steps in this guide may slightly differ. This guide is based on the following setup:  -   Zabbix version: Zabbix 6.4 (installed from packages) -   OS distribution: Ubuntu -   OS version: 22.04 (Jammy) -   Zabbix components: Server, Frontend, Agent 2 -   Database: MySQL -   Web server: Apache
ca	**Prerequisits**  Abans de continuar amb aquesta guia, heu de [descarregar i instal·lar](https://www.zabbix.com/download) el servidor Zabbix, la interfície Zabbix i l'agent Zabbix 2 segons les instruccions del vostre sistema operatiu.  Segons la vostra configuració, algunes de les passes d'aquesta guia poden diferir lleugerament. Aquesta guia es basa en la configuració següent:  - Versió Zabbix: Zabbix 6.4 (instal·lat des de paquets) - Distribució del sistema operatiu: Ubuntu - Versió del sistema operatiu: 22.04 (Jammy) - Components Zabbix: Servidor, Frontend, Agent 2 - Base de dades: MySQL - Servidor web: Apachee

en-us	 **Prerequisites**  Before proceeding with this installation guide, you must [download and install](https://www.zabbix.com/download) Zabbix  server and Zabbix frontend according to instructions for your OS.  
ca	 **Prerequisits**  Abans de continuar amb aquesta guia d'instal·lació, heu de [baixar i instal·lar](https://www.zabbix.com/download) el servidor Zabbix i la interfície Zabbix segons les instruccions del vostre sistema operatiu.

en-us	 **Prerequisites**  Before proceeding with this installation guide, you must [download and install](https://www.zabbix.com/download) Zabbix  server and Zabbix frontend according to instructions for your OS.  
ca	 **Prerequisits**  Abans de continuar amb aquesta guia d'instal·lació, heu de [baixar i instal·lar](https://www.zabbix.com/download) el servidor Zabbix i la interfície Zabbix segons les instruccions del vostre sistema operatiu.

en-us	### Pre-requisites  Install MySQL database from the [official repository](https://dev.mysql.com/downloads/repo/yum/).  See [MySQL documentation](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) for details on how to use MySQL repo.  MySQL server is ready to accept secure connections using a self-signed certificate.  To see, which users are using an encrypted connection, run the following query (Performance Schema should be turned ON):      mysql> SELECT sbt.variable_value AS tls_version, t2.variable_value AS cipher, processlist_user AS user, processlist_host AS host              FROM performance_schema.status_by_thread  AS sbt             JOIN performance_schema.threads AS t ON t.thread_id = sbt.thread_id             JOIN performance_schema.status_by_thread AS t2 ON t2.thread_id = t.thread_id             WHERE sbt.variable_name = 'Ssl_version' and t2.variable_name = 'Ssl_cipher'             ORDER BY tls_version;
ca	### Pre-requisits  instal·leu la base de dades MySQL des del [repositori oficial](https://dev.mysql.com/downloads/repo/yum/).  Veieu la [documentació MySQL](https://dev.mysql.com/doc/mysql-yum-repo-quick-guide/en/) per tindre més detalls sobre com emprar el repositori de MySQL.  El servidor MySQL pot acceptar connexions segures emprant un certificat auto-signat.  Per veure quins usuaris empren una connexió xifrada, executeu la següent comanda (l'esquema de rendiment ha d'ésser actiu):      mysql> SELECT sbt.variable_value AS tls_version, t2.variable_value AS cipher, processlist_user AS user, processlist_host AS host              FROM performance_schema.status_by_thread  AS sbt             JOIN performance_schema.threads AS t ON t.thread_id = sbt.thread_id             JOIN performance_schema.status_by_thread AS t2 ON t2.thread_id = t.thread_id             WHERE sbt.variable_name = 'Ssl_version' and t2.variable_name = 'Ssl_cipher'             ORDER BY tls_version;

en-us	### Pre-requisites  Install the PostgreSQL database using the [official repository](https://www.postgresql.org/download/linux/redhat/).  PostgreSQL is not configured to accept TLS connections out-of-the-box. Please follow instructions from PostgreSQL documentation for [certificate preparation with postgresql.conf](https://www.postgresql.org/docs/13/ssl-tcp.html) and also for [user access control](https://www.postgresql.org/docs/13/auth-pg-hba-conf.html) through ph\_hba.conf.  By default, the PostgreSQL socket is binded to the localhost, for the network remote connections allow to listen on the real network interface.  PostgreSQL settings for all [modes](/manual/appendix/install/db_encrypt#terminology) can look like this:  **/var/lib/pgsql/13/data/postgresql.conf:**      ...     ssl = on     ssl_ca_file = 'root.crt'     ssl_cert_file = 'server.crt'     ssl_key_file = 'server.key'     ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'     ssl_prefer_server_ciphers = on     ssl_min_protocol_version = 'TLSv1.3'     ...  For access control adjust */var/lib/pgsql/13/data/pg\_hba.conf*:      ...     ### require     hostssl all all 0.0.0.0/0 md5      ### verify CA     hostssl all all 0.0.0.0/0 md5 clientcert=verify-ca      ### verify full     hostssl all all 0.0.0.0/0 md5 clientcert=verify-full     ...
ca	### Pre-requisits  Instal·leu la base de dades PostgreSQL en base a la [referència oficial](https://www.postgresql.org/download/linux/redhat/).  PostgreSQL no és pas confiurada per defecte per admetre connexions TLS. Haureu de seguir les instruccions de la documentació PostgreSQL per [preparar el certificat amb postgresql.conf](https://www.postgresql.org/docs/13/ssl-tcp.html), així com per [el control d'accés d'usuari](https://www.postgresql.org/docs/13/auth-pg-hba-conf.html) via ph\_hba.conf.  Per defecte, el socket PostgreSQL és vinculat a l'equip local, doncs les connexions de xarxa a distància permeten escoltar per la interfície de xarxa real.  Els paràmetres PostgreSQL per tots els [modes](/manual/appendix/install/db_encrypt#terminology) es troben aquí:  **/var/lib/pgsql/13/data/postgresql.conf :**      ...     ssl = on     ssl_ca_file = 'root.crt'     ssl_cert_file = 'server.crt'     ssl_key_file = 'server.key'     ssl_ciphers = 'HIGH:MEDIUM:+3DES:!aNULL'     ssl_prefer_server_ciphers = on     ssl_min_protocol_version = 'TLSv1.3'     ...  Per al control d'accés, refineu */var/lib/pgsql/13/data/pg\_hba.conf* :       ...     ### require     hostssl all all 0.0.0.0/0 md5      ### verify CA     hostssl all all 0.0.0.0/0 md5 clientcert=verify-ca      ### verify full     hostssl all all 0.0.0.0/0 md5 clientcert=verify-full     ...

en-us	#### Prerequisites  ::: noteclassic This example does not cover the configuration of VMware. It is assumed that VMware is already configured. :::  Before proceeding, set the [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) parameter in Zabbix server configuration file to `2` [or more](/manual/vm_monitoring#configuration) (the default value is `0`).
ca	#### Requisits previs  ::: noteclassic Aquest exemple no cobreix la configuració de VMware. Suposem que VMware ja és configurat. :::  Abans de continuar, configureu el paràmetre [`StartVMwareCollectors`](/manual/appendix/config/zabbix_server#startvmwarecollectors) al fitxer de configuració del servidor Zabbix a `2` [o més](/manual/vm_monitoring#configuration) (el valor predeterminat és ` 0`).

en-us	 ### Pre-requisites  Prior to configuring service monitoring, you need to have the hosts configured:  - *HA node 1* with at least one trigger and a tag (preferably set on a trigger level) `component:HA node 1` - *HA node 2* with at least one trigger and a tag (preferably set on a trigger level) `component:HA node 2`
ca	### Requisits previs  Abans de configurar el monitoratge del servei, heu de configurar els equips:  - *Node HA 1* amb almenys un trigger i una etiqueta (preferiblement establerta a nivell de trigger) `component: node HA 1` - *Node HA 2* amb almenys un trigger i una etiqueta (preferiblement establerta a nivell de trigger) `component: node HA 2`

en-us	#### Prerequisites  You will need command line developer tools (Xcode is not required), Automake, pkg-config and PCRE (v8.x) or PCRE2 (v10.x). If you want to build agent binaries with TLS, you will also need OpenSSL or GnuTLS.  To install Automake and pkg-config, you will need a Homebrew package manager from <https://brew.sh/>. To install it, open terminal and run the following command:      $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"  Then install Automake and pkg-config:      $ brew install automake     $ brew install pkg-config  Preparing PCRE, OpenSSL and GnuTLS libraries depends on the way how they are going to be linked to the agent.  If you intend to run agent binaries on a macOS machine that already has these libraries, you can use precompiled libraries that are provided by Homebrew. These are typically macOS machines that use Homebrew for building Zabbix agent binaries or for other purposes.  If agent binaries will be used on macOS machines that don't have the shared version of libraries, you should compile static libraries from sources and link Zabbix agent with them.
ca	#### Prerrequisits  Us caldran les eines de desenvolupament de línia de comandes (no cal Xcode), Automake, pkg-config i PCRE (v8.x) o PCRE2 (v10.x). Si voleu crear binaris d'agent amb TLS, també haureu de menester OpenSSL o GnuTLS.  Per instal·lar Automake i pkg-config us caldrà el gestor de paquets, Homebrew disponible a <https://brew.sh/>. Per instal·lar-lo, obriu el terminal i executeu l'ordre següent:       $ /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"  Tot seguit, instal·leu Automake i pkg-config:       $ brew install automake      $ brew install pkg-config  La preparació de les biblioteques PCRE, OpenSSL i GnuTLS depèn de com s'enllaçaran a l'agent.  Si teniu intenció d'executar binaris d'agent en una màquina macOS que ja té aquestes biblioteques, podeu emprar biblioteques precompilades proporcionades per Homebrew. Normalment són màquines macOS que empren Homebrew per crear binaris d'agent Zabbix o amb altres finalitats.  Si els binaris d'agent s'empren a màquines macOS que no tenen la versió compartida de les biblioteques, haureu de compilar les biblioteques estàtiques des de la font i enllaçar l'agent Zabbix amb elles.

en-us	##### Presentation modification methods  The widget presentation modification methods are responsible for modifying widget appearance.
ca	##### Mètodes de modificació de la presentació  Els mètodes de modificació de la presentació del giny són els responsables de modificar l'aparença del giny.

en-us	# Presentation  This page describes the components that can be used to create a widget presentation view. The widget presentation view is the part of the widget that receives the data according to its [configuration](/configuration) and displays it on the dashboard in a container.  The presentation view consists of three parts:  -   [Widget action](#widget-action) -   [Widget view](#widget-view) -   [JavaScript](#javascript)
ca	# Presentació  La presentació del giny forma part del mòdul del giny que rep les dades segons la [configuració](/configuration) i les mostra al tauler en un contenidor. El contenidor de presentació de ginys es pot col·locar i canviar la mida.  La vista del giny consta de dues parts opcionals:  -   [Acció](#widget-actions) -   [Vista](#widget-view)

en-us	#### Principle of least privilege  The principle of least privilege should be used at all times for Zabbix. This principle means that user accounts (in Zabbix frontend) or process user (for Zabbix server/proxy or agent) have only those privileges that are essential to perform intended functions. In other words, user accounts at all times should run with as few privileges as possible.  ::: noteimportant Giving extra permissions to 'zabbix' user will allow it to access configuration files and execute operations that can compromise the overall security of the infrastructure. :::  When implementing the least privilege principle for user accounts, Zabbix [frontend user types](/manual/config/users_and_usergroups/permissions) should be taken into account. It is important to understand that while a "Admin" user type has less privileges than "Super Admin" user type, it has administrative permissions that allow managing configuration and execute custom scripts.  ::: noteclassic Some information is available even for non-privileged users. For example, while *Alerts* → *Scripts* is not available for non-Super Admins, scripts themselves are available for retrieval by using Zabbix API. Limiting script permissions and not adding sensitive information (like access credentials, etc) should be used to avoid exposure of sensitive information available in global scripts. :::
ca	#### Principi de privilegi mínim  El principi del mínim privilegi s'ha d'emprar en tot moment a Zabbix. Aquest principi significa que els comptes d'usuari (a la interfície Zabbix) o els usuaris de procés (per al servidor/proxy o agent Zabbix) només tenen privilegis essencials per dur a terme les funcions previstes. En altres paraules, els comptes d'usuari haurien de funcionar amb el mínim de privilegis en tot moment.  ::: noteimportant Donar permisos addicionals a l'usuari 'zabbix' permetrà accedir als fitxers de configuració i realitzar operacions que poden comprometre la seguretat global de la infraestructura. :::  Quan s'implementa el principi de privilegis mínims per als comptes d'usuari, s'ha de tindre en compte el [tipus d'usuari frontal](/manual/config/users_and_usergroups/permissions) de Zabbix. És important entendre que, tot i que un tipus d'usuari "Administrador" té menys privilegis que un tipus d'usuari "Super Administrador", sí que té permisos administratius que permeten la gestió de la configuració i l'execució d'scripts personalitzats.  :::noteclassic Alguna informació és disponible fins i tot per a usuaris sense privilegis. Per exemple, mentre que *Administració* → *Scripts* no és disponible per a administradors que no siguin superadministradors, els scripts es poden recuperar mitjançant l'API Zabbix. S'haurien de limitar els permisos dels scripts i no afegir informació sensible (com ara credencials d'accés, etc.) per evitar l'exposició de la informació sensible disponible als scripts globals. :::

en-us	#### Problem events  A problem event is created:  -   when a trigger expression evaluates to TRUE if the trigger is in OK     state; -   each time a trigger expression evaluates to TRUE if multiple problem     event generation is enabled for the trigger.
ca	#### Esdeveniments problema  Un esdeveniment de tipus problema es crea:  - quan un trigger s'avalua com a CERT si el trigger es troba en l'estat OK; - sempre que un trigger s'avalui com a CERT si la generació d'esdeveniments de problema múltiple és habilitada per al trigger.

en-us	# problem.get
ca	# problem.get

en-us	##### ProblemHousekeepingFrequency Determines how often Zabbix will delete problems for deleted triggers in seconds.  Default: `60`<br> Range: 1-3600
ca	##### ProblemHousekeepingFrequency Determina amb quina freqüència Zabbix esborrarà els problemes dels triggers esborrats en segons.  Per defecte: `60`<br> Rang: 1-3600

en-us	### Problem  ::: noteclassic Problems are created by the Zabbix server and cannot be modified via the API. :::  The problem object has the following properties.  |Property|[Type](/manual/api/reference_commentary#data_types)|Description| |--|--|------| |eventid|string|ID of the problem event.| |source|integer|Type of the problem event.<br><br>Possible values:<br>0 - event created by a trigger;<br>3 - internal event;<br>4 - event created on service status update.| |object|integer|Type of object that is related to the problem event.<br><br>Possible values if `source` is set to "event created by a trigger":<br>0 - trigger.<br><br>Possible values if `source` is set to "internal event":<br>0 - trigger;<br>4 - item;<br>5 - LLD rule.<br><br>Possible values if `source` is set to "event created on service status update":<br>6 - service.| |objectid|string|ID of the related object.| |clock|timestamp|Time when the problem event was created.| |ns|integer|Nanoseconds when the problem event was created.| |r\_eventid|string|Recovery event ID.| |r\_clock|timestamp|Time when the recovery event was created.| |r\_ns|integer|Nanoseconds when the recovery event was created.| |cause_eventid|string|Cause event ID.| |correlationid|string|Correlation rule ID if this event was recovered by global correlation rule.| |userid|string|User ID if the problem was manually closed.| |name|string|Resolved problem name.| |acknowledged|integer|Acknowledge state for problem.<br><br>Possible values:<br>0 - not acknowledged;<br>1 - acknowledged.| |severity|integer|Problem current severity.<br><br>Possible values:<br>0 - not classified;<br>1 - information;<br>2 - warning;<br>3 - average;<br>4 - high;<br>5 - disaster.| |suppressed|integer|Whether the problem is suppressed.<br><br>Possible values:<br>0 - problem is in normal state;<br>1 - problem is suppressed.| |opdata|string|Operational data with expanded macros.| |urls|array|Active [media type URLs](/manual/api/reference/problem/object#media-type-url).|
ca	### Problemes  ::: noteclassic Els problemes els crea el servidor Zabbix i no es poden modificar mitjançant l'API. :::  L'objecte problema té les propietats següents.  |Propietat|[Tipus](/manual/api/reference_commentary#data_types)|Descripció| |--|--|------| |eventid|cadena|ID de l'esdeveniment problema.| |source|enter|Tipus de l'esdeveniment del problema.<br><br>Valors possibles:<br>0 - esdeveniment creat per un trigger;<br>3 - esdeveniment intern;<br>4 - esdeveniment creat a l'actualització de l'estat del servei.| |objecte|enter|Tipus d'objecte relacionat amb l'esdeveniment del problema.<br><br>Valors possibles si `source` s'estableix a "esdeveniment creat per un trigger":<br>0 - disparador.<br>< br>Valors possibles si `source` és establert com a "esdeveniment intern":<br>0 - trigger;<br>4 - element;<br>5 - regla LLD.<br><br>Valors possibles si `source` s'estableix a "esdeveniment creat a l'actualització de l'estat del servei":<br>6 - servei.| |objectid|cadena|ID de l'objecte relacionat.| |clock|timestamp|Hora en què es va crear l'esdeveniment problema.| |ns|enter|Nanosegons quan es va crear l'esdeveniment problema.| |r\_eventid|cadena|ID d'esdeveniment de recuperació.| |r\_clock|timestamp|Hora en què es va crear l'esdeveniment de recuperació.| |r\_ns|enter|Nanosegons quan es va crear l'esdeveniment de recuperació.| |cause_eventid|cadena|ID de l'esdeveniment de la causa.| |correlationid|cadena|ID de la regla de correlació si aquest esdeveniment s'ha recuperat per la regla de correlació global.| |identificador d'usuari|cadena|ID d'usuari si el problema s'ha tancat manualment.| |nom|cadena|Nom del problema resolt.| |acknowledged|enter|Reconeix l'estat del problema.<br><br>Valors possibles:<br>0 - no reconegut;<br>1 - reconegut.| |severity|nombre enter|Gravetat actual del problema.<br><br>Valors possibles:<br>0 - no classificat;<br>1 - informació;<br>2 - advertència;<br>3 - mitjana;<br> 4 - alt;<br>5 - desastre.| |suppressed|enter|Si el problema s'ha esborrat.<br><br>Valors possibles:<br>0 - el problema està en estat normal;<br>1 - el problema s'ha esborrat.| |opdata|cadena|Dades operatives amb macros expandides.| |urls|array|Actives [URL de tipus de suport](/manual/api/reference/problem/object#media-type-url).|

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

en-us	#### Problems  Retrieve problems according to the given parameters.  [Problem API](/manual/api/reference/problem)
ca	#### Problemes  Recuperar els problemes en funció dels paràmetres donats.  [API Problema](/manual/api/reference/problem)

en-us	#### Problems  The following parameters are supported for configuring *Problems*.  |Parameter|<|[type](/manual/api/reference/dashboard/object#dashboard-widget-field)|name|value| |-|--------|--|--------|-------------------------------| |*Show problems*|<|0|show_problems|0 - *(default)* Disabled;<br>1 - Enabled.| |*Selected items only*|<|0|graph_item_problems|0 - Disabled;<br>1 - *(default)* Enabled.| |*Problem hosts*|<|1|problemhosts.0|[Host](/manual/api/reference/host/get) name.<br><br>Note: The number in the property name references the configured host.<br>To configure multiple hosts, create a dashboard widget field object for each host.| |*Severity*|<|0|severities|0 - Not classified;<br>1 - Information;<br>2 - Warning;<br>3 - Average;<br>4 - High;<br>5 - Disaster.<br><br>Default: empty (all enabled).<br><br>Note: To configure multiple values, create a dashboard widget field object for each value.| |*Problem*|<|1|problem_name|Problem [event name](/manual/config/triggers/trigger#configuration) (case insensitive, full name or part of it).| |*Tags* (the number in the property name (e.g. tags.tag.0) references tag order in the tag evaluation list)|<|<|<|<| |<|*Evaluation type*|0|evaltype|0 - *(default)* And/Or;<br>2 - Or.| |^|*Tag name*|1|tags.tag.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Operator*|0|tags.operator.0|0 - Contains;<br>1 - Equals;<br>2 - Does not contain;<br>3 - Does not equal;<br>4 - Exists;<br>5 - Does not exist.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*| |^|*Tag value*|1|tags.value.0|Any string value.<br><br>[Parameter behavior](/manual/api/reference_commentary#parameter-behavior):<br>- *required* if configuring *Tags*|
ca	#### Problemes  S'admeten els paràmetres següents per configurar els *Problemes*.  |Paràmetre|<|[tipus](/manual/api/reference/dashboard/object#dashboard-widget-field)|nom|valor| |-|--------|--|---------|---------------------------- -----| |*Mostra problemes*|<|0|mostra_problemes|0 - *(per defecte)* Desactivat;<br>1 - Activat.| |*Només elements seleccionats*|<|0|graph_item_problems|0 - Inhabilitat;<br>1 - *(per defecte)* Activat.| |*Equips amb problemes*|<|1|problemhosts.0|Nom d'[Equip](/manual/api/reference/host/get).<br><br>Nota: el nombre del nom de la propietat fa referència a l'equip configurat. <br>Per configurar diversos equips, creeu un objecte de camp de giny de tauler per a cada equip.| |*Gravetat*|<|0|graveses|0 - No classificat;<br>1 - Informació;<br>2 - Avís;<br>3 - Mitjana;<br>4 - Alta;<br>5 - Desastre.<br><br>Per defecte: buit (tots activats).<br><br>Nota: per configurar diversos valors, creeu un objecte de camp de giny de tauler per a cada valor.| |*Problema*|<|1|nom_problema|Problema [nom de l'esdeveniment](/manual/config/triggers/trigger#configuration) (no distingeix entre majúscules i minúscules, nom complet o part d'aquest).| |*Etiquetes* (el nombre del nom de la propietat (per exemple, tags.tag.0) fa referència a l'ordre de l'etiqueta a la llista d'avaluació d'etiquetes)|<|<|<|<| |<|*Tipus d'avaluació*|0|evaltype|0 - *(per defecte)* I/O;<br>2 - O.| |^|*Nom de l'etiqueta*|1|tags.tag.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Operador*|0|tags.operator.0|0 - Conté;<br>1 - És igual;<br>2 - No conté;<br>3 - No és igual;<br>4 - Existeix ;<br>5 - No existeix.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*| |^|*Valor de l'etiqueta*|1|tags.value.0|Qualsevol valor de cadena.<br><br>[Comportament del paràmetre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatori* si es són configurant *Etiquetes*|